Atualizar suas marcas do UET para a nova sintaxe
Atualizar suas marcas do UET para a nova sintaxe
Saiba por que você deve atualizar suas marcas do UET para nossa nova sintaxe e como fazê-lo.Observação
Não sabe o que é UET? Confira O que é o UET e como ele pode me ajudar?
Atualizamos a sintaxe das marcas UET do JavaScript. Recomendamos que você atualize todas as marcas UET existentes no código do seu site para aproveitar a nova sintaxe.
Benefícios do uso da nova sintaxe
A nova sintaxe:
- Codifica automaticamente por URL (codificação de porcentagem) seus valores de parâmetro, garantindo que as URLs não sejam convertidas incorretamente.
- Dá suporte a sites de aplicativos de página única (SPA).
- Permite definir parâmetros no nível de página para qualquer evento compatível do UET em sua página da Web.
- Tem nomes de parâmetros fáceis de entender, ajudando você a organizá-los e gerenciá-los.
O que há de diferente nas marcas atualizadas?
- O parâmetro de ação do evento agora é necessário nas marcas do UET de evento personalizado e de receita variável, e esse parâmetro aparece primeiro nos dois casos.
- Os nomes de parâmetros JavaScript para eventos personalizados e receita variável agora são mais fáceis de entender:
| Sintaxe antiga | Nova sintaxe |
|---|---|
| ea | event |
| ec | event_category |
| el | event_label |
| ev | event_value |
| gv | revenue_value |
| gc | currency |
Comparação das sintaxes
Sintaxe antiga (evento personalizado):
<script>
window.uetq = window.uetq || [];
window.uetq.push ({'ec': 'Replace_with_Event_Category', 'ea': 'Replace_with_Event_Action', 'el': 'Replace_with_Event_Label', 'ev': 'Replace_with_Event_Value'});
</script>
Nova sintaxe (evento personalizado):
<script>
window.uetq = window.uetq || [];
window.uetq.push ('event', 'Replace_with_Event_Action', {'event_category': 'Replace_with_Event_Category', 'event_label': 'Replace_with_Event_Label', 'event_value': 'Replace_with_Event_Value'});
</script>
Sintaxe antiga (receita variável):
<script>
window.uetq = window.uetq || [];
window.uetq.push ({'gv': 'Replace_with_Revenue_Value', 'gc': 'Replace_with_Currency_Code'});
</script>
Nova sintaxe (receita variável):
<script>
window.uetq = window.uetq || [];
window.uetq.push ('event', '', {'revenue_value': 'Replace_with_Revenue_Value', 'currency': 'Replace_with_Currency_Code'});
</script>
Exemplos
Acompanhamento de todos os quatro tipos de eventos personalizados:
<script>
window.uetq = window.uetq || [];
window.uetq.push ('event', 'Contoso_Event_Action', {'event_category': 'Contoso_Event_Category', 'event_label': 'Contoso_Event_Label', 'event_value': 'Contoso_Event_Value'});
</script>
Não há acompanhamento de ação de evento, mas acompanha os outros três tipos de eventos (observe que 'event' permanece com seu valor vazio):
<script>
window.uetq = window.uetq || [];
window.uetq.push ('event', '', {'event_category': 'Contoso_Event_Category', 'event_label': 'Contoso_Event_Label', 'event_value': 'Contoso_Event_Value'});
</script>
Apenas acompanhamento de ação de evento (observe que os outros tipos de eventos desnecessários foram removidos):
<script>
window.uetq = window.uetq || [];
window.uetq.push ('event', 'Contoso_Event_Action', {});
</script>