Use o Livefyre com Adobe Analytics e o Gerenciador dinâmico de tags (DTM)

Configure o Adobe Analytics e o Gerenciador dinâmico de tags (DTM) para coletar dados dos aplicativos do Livefyre.

Etapa 1: Configurar eventos no Adobe Analytics

Mapeie eventos do Livefyre para um ou mais Eventos bem-sucedidos personalizados no Gerenciador de conjunto de relatórios do Adobe Analytics.

Para obter mais informações sobre o Gerenciador de conjunto de relatórios, consulte Gerenciador de conjunto de relatórios.

  1. Faça logon no Adobe Analytics como um usuário administrador.
  2. Abra o Gerenciador do Conjunto de relatórios do Administrador do Adobe Analytics.
  3. Crie um novo Conjunto de relatórios ou escolha um existente.
  4. Edite o conjunto de relatórios clicando em seu conjunto para modificar e navegue até Edit Settings > Conversion > Success Events.
  5. Mapeie os eventos do Livefyre a um ou mais Eventos bem-sucedidos personalizados.

Etapa 2: Configurar variáveis de conversão

Mapeie variáveis de conversão do Livefyre (eVars) para variáveis de conversão no Gerenciador de conjunto de relatórios do Administrador do Adobe Analytics. As variáveis de conversão funcionam como uma função de classificação para determinar como você planeja identificar os dados coletados dos eventos do Livefyre.

  1. No Gerenciador de conjunto de relatórios, clique em Edit Settings > Conversion > Conversion Variables.
  2. Escolha as variáveis de conversão personalizadas (eVars) a serem usadas e mapeie-as para as variáveis de conversão do Livefyre. Para mapear uma variável de conversão do Livefyre para uma variável de conversão personalizada:
  • Ativar a variável de conversão
  • Nomeie a variável de conversão
  • Atribua à variável de conversão um tipo
  1. Salve as variáveis de conversão personalizadas.

Etapa 3: Usar o DTM para adicionar seu conjunto de relatórios com eventos do Livefyre

Adicione o Adobe Analytics ao DTM para fazer com que o Analytics funcione. Para fazer isso, crie uma nova propriedade e ferramenta e adicione o novo conjunto de relatórios com eventos Livefyre à propriedade. Para obter mais informações sobre o DTM, consulte DTM.

Não é necessário executar essa etapa se já tiver uma propriedade ou ferramenta configurada para o conjunto de relatórios configurado com eventos do Livefyre.

  1. No DTM, crie ou edite uma propriedade existente.

  2. Crie ou edite uma ferramenta Adobe Analytics existente.

  3. Se uma Ferramenta Adobe Analytics existente não existir, clique no botão Add a Tool.
    Defina os seguintes parâmetros para a ferramenta:

    • Defina Tool Type para Adobe Analytics.
    • Ativar Automatic Configuration.
    • Ativar Authenticate via Marketing Cloud.
  4. Adicione ou confirme o nome do conjunto de relatórios com eventos do Livefyre ao campo Report Suites.

Etapa 4: Configurar uma regra de carregamento de página para configurar o tratamento do Analytics

Configure uma regra de carregamento de página para extrair todos os dados. A regra de carregamento de página permite colocar um javascript personalizado na regra que registra o evento quando a página é carregada.

OBSERVAÇÃO

Não use Regras baseadas em eventos ou Regras de chamada direta.

  1. No DTM, selecione a guia Rules .

  2. Clique em Page Load Rules.

  3. Clique no botão Create New Rule.

  4. Abra a seção Conditions clicando no botão Plus.

  5. Acione a regra. Escolha os tipos de acionador DOM Ready ou Onload se desejar atrasar ou implementar a regra de forma assíncrona.

  6. (Opcional) Adicione parâmetros adicionais para limitar as páginas que exibem os aplicativos do Livefyre. Para obter mais informações sobre opções de configuração adicionais, consulte DTM.

  7. Em Javascript/ Third Party Tags, clique na guia Non-sequential e, em seguida, clique em Add New Script.

  8. Selecione Sequential HTML como o tipo de script.

  9. Adicione o script a seguir no editor de código e clique em Save Code.

    O script a seguir chama a regra de chamada direta livefyre_analytics depois que o JavaScript do Livefyre é carregado. O exemplo de script a seguir verifica a cada 400 ms para ver se livefyre.analytics está na página. Depois que a página é carregada, o livefyre.analytics envia informações de rastreamento.

    /** 
    * Poll for Livefyre.analytics object to exist since it gets loaded via the 
    * Livefyre.js JavaScript file. Depending on the timing, this could already 
    * exist or need a little time. 
    */ 
    function pollForAnalytics() {  
    if (Livefyre.analytics) { 
      _satellite.track('livefyre_analytics'); 
        return true; 
      } 
      setTimeout(pollForAnalytics, 400); 
    } 
    setTimeout(pollForAnalytics, 400);
    
  10. Clique em Save Code.

  11. Clique em Save Rule.

Etapa 5: Crie uma regra de chamada direta para construir a configuração de mapeamento do Adobe Analytics para o Livefyre

Há outras maneiras de implementar o Livefyre com DTM usando eventos personalizados, campos da interface do usuário do Adobe Analytics no DTM e elementos de dados. Este documento usa o Javascript personalizado para obter o mesmo efeito.

  1. No DTM, selecione a guia Rules e clique em Direct Call Rules.

  2. Clique no botão Criar nova regra.

  3. Nomeie a nova regra Livefyre Analytics.

  4. Expanda a área de configuração conditions.

  5. No campo String, digite livefyre_analytics.

  6. Expanda a seção Javascript / Tag de terceiros e clique no botão Adicionar novo script.

  7. Insira Livefyre Analytics Config na caixa de entrada Tag Name.

  8. Selecione Javascript não sequencial.

  9. Insira o seguinte código de configuração do Livefyre no editor de código e clique no botão Salvar código.

    var s = _satellite.getToolsByType('sc')[0].getS(); 
    
    var evarMap = {  
      appId: 'eVar81',  
      appType: 'eVar82' 
    }; 
    
    var eventMap = { 
      FlagCancel: 'event82',  
      FlagClick: 'event82',  
      FlagDisagree: 'event82',  
      FlagOffensive: 'event82',  
      FlagOffTopic: 'event82',  
      FlagSpam: 'event82',  
      Like: 'event82', 
      Load: 'event81',  
      RequestMore: 'event82',  
      ShareButtonClick: 'event82',  
      ShareFacebook: 'event82',  
      ShareOnPostClick: 'event82',  
      ShareTwitter: 'event82',  
      ShareURL: 'event82',  
      SortStream: 'event82',  
      TwitterLikeClick: 'event82', 
      TwitterReplyClick: 'event82',  
      TwitterRetweetClick: 'event82',  
      TwitterUserFollow: 'event82' 
    }; 
    
     function trackLivefyreEvent(data) {  
      var event = eventMap[data.type]; 
      console.log('Track:', data.type, event); 
    
      if (!event) { 
        console.warn(data.type, 'is not mapped   to an event in AA');  
        return; 
      } 
      var vars = ['events'];  
      switch (event) { 
        case 'event82': s.eVar83 = data.type;  
          vars.push('eVar83');  
          break; 
        default: 
      } 
        ['generator', 'evars'].forEach(function (type) {  
        var obj = data[type]; 
        for (var d in obj) { 
          if (obj.hasOwnProperty(d) && evarMap[d]) {  
            s[evarMap[d]] = obj[d];  
            vars.push(evarMap[d]); 
          } 
        } 
      }); 
      s.linkTrackVars = vars.join(',');  
      s.linkTrackEvents = event;  
      s.events = event; 
    
      console.log('linkTrackVars:',  s.linkTrackVars);  
      console.log('linkTrackEvents:',  s.linkTrackEvents);  
      console.log('events:', s.events); 
      s.tl(); 
      } 
      ]
    
      /** 
    
    • Adiciona um manipulador de análise para todos os eventos de análise do Livefyre. Para cada evento, ele define os dados em um objeto global e, em seguida, despacha o evento.
    */ 
    function addAnalyticsHandler() {  
      Livefyre.analytics.addHandler(function (events) { 
        (events || []).forEach(function (data) {  
          console.log('Event handled:', data.type);  
          trackLivefyreEvent(data); 
        }); 
      }); 
    } 
    addAnalyticsHandler();  
    
  10. Clique em Salvar Regra.

Etapa 6: Aprovar alterações na regra de carregamento de página

  1. Vá para a guia Approvals .
  2. Clique em Approve.
  3. Clique em Yes, approve para confirmar a aprovação.
  4. Ir para Overview > Publish Queue.
  5. Selecione a Regra a ser publicada.
  6. Clique em Publish Selected.
  7. Clique em Publish para confirmar que deseja publicar.

Script

O código de amostra a seguir mapeia as eVars específicas para eVars do Livefyre disponíveis. O nome da variável de conversão do Livefyre ( eVar) (por exemplo, appId) mapeia para o nome que você configurou no Gerenciador de conjunto de relatórios (por exemplo, eVar81). Altere os nomes eVar neste script para as variáveis de conversão personalizadas.

var s = _satellite.getToolsByType`('sc')[0]`.getS(); 
var evarMap = { 
  appId: 'eVar81', 
  appType: 'eVar82' 
};

O código de amostra a seguir mapeia os eventos específicos configurados no Gerenciador de conjunto de relatórios com eventos do Livefyre disponíveis. Neste exemplo, event82 é configurado como qualquer evento de interação do usuário sem diferenciar qual tipo de evento de interação do usuário (por exemplo, curtir ou compartilhar conteúdo). Essa é uma maneira eficiente de registrar todas as informações de interação do usuário em um bloco. Também é possível mapear os eventos na interface do usuário do DTM Analytics com referência ao elemento de dados.

var eventMap = { 
  FlagCancel: 'event82',  
  FlagClick: 'event82',  
  FlagDisagree: 'event82',  
  FlagOffensive: 'event82',  
  FlagOffTopic: 'event82',  
  FlagSpam: 'event82',  
  Like: 'event82', 
  Load: 'event81',  
  RequestMore: 'event82',  
  ShareButtonClick: 'event82',  
  ShareFacebook: 'event82',  
  ShareOnPostClick: 'event82',  
  ShareTwitter: 'event82',  
  ShareURL: 'event82',  
  SortStream: 'event82',  
  TwitterLikeClick: 'event82', 
  TwitterReplyClick: 'event82',  
  TwitterRetweetClick: 'event82',  
  TwitterUserFollow: 'event82' 
};

A amostra a seguir declara que, se não houver um evento nessa lista, não faça nada. Não é necessário modificar essa seção do código.

function trackLivefyreEvent(data) {  
  var event = eventMap[data.type]; 
  console.log('Track:', data.type, event); 
   
  if (!event) { 
    console.warn(data.type, 'is not mapped to an event in AA');  
    return; 
  }

O código a seguir diferencia os tipos de evento que event82 registra. A variável de conversão, eVar83 registra o tipo de interação do usuário e o script configura eVar83 para separar os dados de interação do usuário por tipo. Assim, eVar83 permite dividir os dados registrados em tipos específicos de interações do usuário.

  var vars = ['events'];  
  switch (event) { 
    case 'event82': s.eVar83 = data.type;  
      vars.push('eVar83');  
      break; 
    default: 
  } 
   
  ['generator', 'evars'].forEach(function (type) {  
    var obj = data[type]; 
    for (var d in obj) { 
      if (obj.hasOwnProperty(d) && evarMap[d]) {  
        s[evarMap[d]] = obj[d];  
        vars.push(evarMap[d]); 
      } 
    } 
  }); 
   
  s.linkTrackVars = vars.join(',');  
  s.linkTrackEvents = event;  
  s.events = event; 
   
  console.log('linkTrackVars:', s.linkTrackVars);  
  console.log('linkTrackEvents:', s.linkTrackEvents);  
  console.log('events:', s.events); 
   
  s.tl(); 
}

A amostra de código a seguir adiciona um manipulador para ouvir todos os eventos que ocorrem. Ela usa a regra de carregamento de página ao carregar, aguarda a existência de eventos e configura o manipulador para todos os eventos do aplicativo e os rastreia. Não é necessário modificar esse código.

/** 
* Adds an analytics handler for all analytics events from Livefyre. For each event, it sets the data on a global object and then dispatches the event. 
*/ 
function addAnalyticsHandler() { 
  Livefyre.analytics.addHandler(function (events) { 
    (events || []).forEach(function (data) { 
      console.log('Event handled:', data.type); 
      trackLivefyreEvent(data); 
    }); 
  }); 
}

Mais informações

Para obter mais informações sobre os tópicos discutidos nesta página, consulte:

Nesta página