Analytics Platform Integration (Integração de Plataforma de Análise)

A Analytics Platform Integration é uma extensão do Experience OS que permite a você rastrear e analisar o desempenho das suas experiências personalizadas.

O conector da Analytics Platform Integration permite que você faça integração com a plataforma de análise que preferir para criar relatórios para suas campanhas na Dynamic Yield. Veja dados de sessões e de comportamento do usuário relacionados às experiências ou variações, ou marque os usuários que foram expostos a uma experiência específica.

Configurando uma integração de plataforma de análise

1. Acesse a App Store do Experience OS › Analytics Platform Integration e clique em Install (Instalar).
2. Clique em Configure extension (Configurar extensão).
   

3. Selecione as condições que determinarão quando o código de integração personalizado será executado.

   • Variation Impressions (Impressões de Variação) (padrão): analise o comportamento dos usuários que receberam uma variação.
   • Recommendation Impressions (Impressões de Recomendação): analise o comportamento de usuários que receberam uma estratégia específica.
   • Variations Rendered on a Page (Variações Renderizadas em uma Página): analise o comportamento de usuários que clicaram nas campanhas de Dynamic Content (Conteúdo Dinâmico) ou Recommendation (Recomendação).

4. Escreva códigos de JavaScript personalizados que estejam em conformidade com a API da plataforma relevante.

   • O código de JavaScript pode incluir metadados como o nome da variação, o nome da experiência ou campanha, a estratégia (para recomendações) e mais.

   • Ao selecionar os ganchos, consulte as orientações a seguir na documentação inclusa:

     • Como o código funciona?
     • Exemplo de objeto
     • Descrições de atributos
     • Amostra de código
       
   • Somente em caso de consentimento presumido para cookies: se estiver usando alguma das nossas APIs de gestão de privacidade de dados de visitantes, você precisará usar uma API dedicada para garantir que nenhum dado de usuários que não consentirem seja enviado a terceiros. 

   • A nova sintaxe inclusa no JavaScript ES6 não é suportada.

5. Por padrão, a integração de plataforma de análise é ativada quando alguma campanha é disparada de acordo com essa configuração. Você pode habilitar ou desabilitar manualmente a integração para campanhas individuais usando o procedimento descrito em Habilitando e desabilitando uma integração personalizada para cada campanha. 

Gerenciando o conector de Analytics Platform Integration

No aplicativo Web Personalization (Personalização da Web), acesse a guia Extensions (Extensões). Nela, você pode selecionar uma das três opções a seguir:

• Activate (Ativar)
• Deactivate (Desativar)
• Uninstall  (Desinstalar)

Habilitando e desabilitando uma integração personalizada para cada campanha

Por padrão, a integração de plataforma de análise personalizada fica habilitada para todas as campanhas. A integração pode ser desativada para cada campanha. Isso é feito através das Configurações Avançadas (Advanced Settings) da campanha.

1. Ao editar ou criar uma campanha, acesse Advanced Settings. 
2. Desative (ou ative) Track campaign performance in your analytics platform (Rastrear o desempenho da campanha na sua plataforma de análise).
   

Solução de problemas de integrações de análise personalizadas

Se você configurou sua integração de análise personalizada, mas não está vendo os dados da campanha da Dynamic Yield na sua plataforma de análise, experimente estes métodos para solucionar problemas no código da integração e confirmar que está tudo funcionando como esperado.

Se, depois de tentar essas ações, os eventos ainda não forem disparados para as campanhas da Dynamic Yield, entre em contato com o suporte técnico.

Console.log

Usar console.log() é um método clássico para depurar o código. Ele escreve strings de texto no console das ferramentas do desenvolvedor do seu navegador (pressione ⌘+⌥+J para MacOS ou Ctrl+Shift+J para Windows). No exemplo a seguir, console.log() é usado para verificar se o nosso código é executado com sucesso e se os valores estão sendo atribuídos às nossas variáveis.

Para ir um passo adiante, você pode usar o console.log() para se certificar de que os dados de campanha da Dynamic Yield estão sendo atribuídos às variáveis passadas na função afterVariationSelected.

Pontos de interrupção

Os pontos de interrupção podem ser usados para parar a execução do código no navegador, o que permite a você avançar linha por linha para revisar o código.

Para adicionar pontos de interrupção ao código contido na sua integração de análise personalizada:

1. Abra as ferramentas do desenvolvedor do seu navegador (pressione ⌘+⌥+J para MacOS ou Ctrl+Shift+J para Windows).
2. Clique nos três pontos na barra lateral e depois em Open File (Abrir Arquivo).
3. Procure por “api_dynamic” e clique no arquivo JS para abri-lo.
4. Clique em Pretty-Print (Indentar).
5. Procure pelo nome da função no código da sua integração de análise personalizada. Neste exemplo, nós procuramos por “afterVariationSelected”. Mas ela pode ser diferente dependendo do tipo de integração personalizada que você estiver usando. Consulte sua integração na Dynamic Yield se não souber ao certo o que usar na sua busca.
   
6. Clique nos números das linhas para adicionar pontos de interrupção onde deseja parar a execução do código. Neste exemplo, adicionamos um ponto de interrupção para parar o código antes de ele executar o evento gtag.
   
7. Atualize a página que está tentando corrigir. No console das ferramentas do desenvolvedor, você pode ver a página parar de carregar, e seu ponto de interrupção é exibido.
   
   Agora você pode ver quais valores foram atribuídos às variáveis minificadas que são passadas na função afterVariationSelected. Se retomar a execução do código, é possível ver que ele faz iterações e para no mesmo ponto de interrupção várias vezes se você estiver acionando o código de integração de análise personalizada em várias campanhas na página.
   Note que você não verá o código iterar em campanhas que não estejam com a integração de análise personalizada habilitada nas configurações da campanha.
8. Faça experiências incluindo pontos de interrupção adicionais no código ou use Step (Passo a Passo) para executar o código linha por linha depois de chegar ao ponto de interrupção.
   

Uso o código de medição de eventos correto para o Google Analytics

Se ainda não estiver vendo os eventos de campanha da Dynamic Yield no Google Analytics, você talvez esteja usando a sinaxe errada no seu código de medição de eventos. Dependendo da sua implementação, você deve usar as sintaxes ga() ou gtag().

Para verificar a sintaxe correta do código para o seu site, veja o artigo do Google Analytics 4.