Use o Livefyre com o 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 para aplicativos Livefyre.

Etapa 1: Configurar Eventos no Adobe Analytics

Mapeie eventos do Livefyre para um ou mais Eventos de sucesso personalizados no Adobe Analytics Report Suite Manager.

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 Adobe Analytics Admin Report Suite Manager.
  3. Crie um novo conjunto de relatórios ou escolha um existente.
  4. Edite o conjunto de relatórios clicando no conjunto de relatórios para modificá-lo e navegue até Edit Settings > Conversion > Success Events.
  5. Mapeie os eventos do Livefyre para um ou mais Eventos personalizados de sucesso.

Etapa 2: Configurar variáveis de conversão

Mapeie variáveis de conversão do Livefyre (eVars) para variáveis de conversão no Adobe Analytics Admin Report Suite Manager. 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
  • Fornecer um tipo para a variável de conversão
  1. Salve as variáveis de conversão personalizadas.

Etapa 3: Use 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 do Livefyre à propriedade. Para obter mais informações sobre o DTM, consulte DTM.

Não é necessário executar essa etapa se você 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 como Adobe Analytics.
    • Ativar Automatic Configuration.
    • Ativar Authenticate via Marketing Cloud.
  4. Adicione ou confirme o nome do conjunto de relatórios com eventos Livefyre ao campo Report Suites.

Etapa 4: Configure uma regra de carregamento de página para configurar o processamento do Analytics

Configure uma regra de carregamento de página para extrair todos os dados. A regra de carregamento de página permite que você coloque 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 acionadores DOM Ready ou Onload se desejar atrasar ou implementar a regra de forma assíncrona.

  6. (Opcional) Adicione outros parâmetros para limitar as páginas que exibem os aplicativos 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 ao editor de código e clique em Save Code.

    O script a seguir chama a regra de chamada direta livefyre_analytics depois que o Livefyre JavaScript é 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: Criar uma regra de chamada direta para construir a configuração de mapeamento do Adobe Analytics para Livefyre

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

  1. No DTM, selecione a guia Regras e clique em Regras de chamada direta.

  2. Clique no botão Criar nova regra.

  3. Nomeie a nova regra Livefyre Analytics.

  4. Expanda a área de configuração condições.

  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. Digite Livefyre Analytics Config na caixa de entrada Nome da tag.

  8. Selecione Javascript não sequencial.

  9. Digite 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 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 para Regra de Carregamento de Página

  1. Vá para a guia Approvals.
  2. Clique em Approve.
  3. Clique em Yes, approve para confirmar sua 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 que você configurou no Gerenciador de conjunto de relatórios com eventos Livefyre disponíveis. Neste exemplo, event82 é configurado como qualquer evento de interação do usuário sem diferenciar o 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 indica que se não houver um evento nessa lista, não faça nada. Não é necessário modificar esta 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. Portanto, eVar83 permite que você detalhe os dados gravados 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 da página quando carregada, 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now