Uso de Livefyre con Adobe Analytics y Dynamic Tag Manager (DTM)

Configure Adobe Analytics y Dynamic Tag Manager (DTM) para recopilar datos para aplicaciones de Livefyre.

Paso 1: Configuración de eventos en Adobe Analytics

Asigne eventos de Livefyre a uno o más eventos de éxito personalizados en el Administrador de grupos de informes de Adobe Analytics.

Para obtener más información sobre el Administrador del grupo de informes, consulte Administrador del grupo de informes.

  1. Inicie sesión en Adobe Analytics como usuario administrador.
  2. Abra el Administrador del grupo de informes de administración de Adobe Analytics.
  3. Cree un nuevo grupo de informes o elija uno existente.
  4. Edite el grupo de informes haciendo clic en el grupo de informes que desea modificar y, a continuación, vaya a Edit Settings > Conversion > Success Events.
  5. Asigne los eventos de Livefyre a uno o más eventos de éxito personalizados.

Paso 2: Configuración de variables de conversión

Asigne variables de conversión de Livefyre (eVars) a variables de conversión en el Administrador del grupo de informes de administración de Adobe Analytics. Las variables de conversión actúan como una función de clasificación para determinar cómo se planea identificar los datos recopilados de los eventos de Livefyre.

  1. En el Administrador del grupo de informes, haga clic en Edit Settings > Conversion > Conversion Variables.

  2. Elija las variables de conversión personalizadas (eVars) que desee usar y asígnelas a las variables de conversión de Livefyre. Para asignar una variable de conversión de Livefyre a una variable de conversión personalizada:

    • Habilitar la variable de conversión
    • Asigne un nombre a la variable de conversión.
    • Asigne un tipo a la variable de conversión
  3. Guarde las variables de conversión personalizadas.

Paso 3: Usar DTM para agregar su grupo de informes con eventos de Livefyre

Utilice etiquetas para integrar Analytics con eventos de Livefyre. Para ello, cree una nueva propiedad y herramienta y añada el nuevo grupo de informes con eventos de Livefyre a la propiedad . Para obtener más información, consulte Información general sobre etiquetas.

No es necesario realizar este paso si ya tiene una propiedad o herramienta configurada para el grupo de informes configurado con eventos de Livefyre.

  1. En DTM, cree o edite una propiedad existente.

  2. Cree o edite una herramienta Adobe Analytics existente.

  3. Si no existe una herramienta Adobe Analytics existente, haga clic en el botón Add a Tool.
    Establezca los siguientes parámetros para la herramienta:

    • Establezca Tool Type en Adobe Analytics.
    • Activar Automatic Configuration.
    • Activar Authenticate via Marketing Cloud.
  4. Agregue o confirme el nombre del grupo de informes con eventos de Livefyre al campo Report Suites.

Paso 4: Configurar una regla de carga de página para configurar la administración de Analytics

Configure una regla de carga de página para extraer todos los datos. La regla de carga de página permite colocar el código javascript personalizado en la regla que registra el evento cuando se carga la página.

NOTA

No utilice reglas basadas en eventos o reglas de llamada directa.

  1. En DTM, seleccione la pestaña Rules .

  2. Haga clic Page Load Rules.

  3. Haga clic en el botón Create New Rule.

  4. Abra la sección Conditions haciendo clic en el botón Plus.

  5. Déclencheur la regla. Elija los tipos de déclencheur DOM Ready o Onload si desea retrasar o implementar la regla de forma asíncrona.

  6. (Opcional) Añada parámetros adicionales para limitar las páginas que muestran aplicaciones de Livefyre. Para obtener más información sobre las opciones de configuración adicionales, consulte Información general sobre etiquetas.

  7. En Javascript/ Third Party Tags, haga clic en la pestaña Non-sequential y, a continuación, haga clic en Add New Script.

  8. Seleccione Sequential HTML como tipo de script.

  9. Agregue la siguiente secuencia de comandos al editor de código y haga clic en Save Code.

    La siguiente secuencia de comandos llama a la regla de llamada directa livefyre_analytics después de que se cargue JavaScript de Livefyre. El siguiente ejemplo de script comprueba cada 400 ms para ver si livefyre.analytics está en la página. Una vez que la página se carga, livefyre.analytics envía la información de seguimiento.

    /**
    * 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. Haga clic Save Code.

  11. Haga clic Save Rule.

Paso 5: Crear una regla de llamada directa para crear la configuración de asignación de Adobe Analytics para Livefyre

Existen otras formas de implementar Livefyre con DTM mediante eventos personalizados, campos de interfaz de usuario de Adobe Analytics en DTM y elementos de datos. Este documento utiliza JavaScript personalizado para lograr el mismo efecto.

  1. En DTM, seleccione la pestaña Rules y haga clic en Direct Call Rules.

  2. Haga clic en el botón Crear nueva regla.

  3. Asigne un nombre a la nueva regla Livefyre Analytics.

  4. Expanda el área de configuración conditions.

  5. En el campo String, introduzca livefyre_analytics.

  6. Expanda la sección Javascript / Etiqueta de terceros y haga clic en el botón Agregar nuevo script.

  7. Introduzca Configuración de análisis de Livefyre en el cuadro de entrada Nombre de etiqueta.

  8. Seleccione Javascript no secuencial.

  9. Introduzca el siguiente código de configuración de Livefyre en el editor de código y haga clic en el botón Save Code.

    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();
      }
      ]
    
      /**
    
    • Agrega un controlador de análisis para todos los eventos de análisis de Livefyre. Para cada evento, establece los datos en un objeto global y, a continuación, envía el evento.
    */
    function addAnalyticsHandler() {
      Livefyre.analytics.addHandler(function (events) {
        (events || []).forEach(function (data) {
          console.log('Event handled:', data.type);
          trackLivefyreEvent(data);
        });
      });
    }
    addAnalyticsHandler();
    
  10. Haga clic en Guardar regla.

Paso 6: Aprobar cambios para la regla de carga de página

  1. Vaya a la pestaña Approvals.
  2. Haga clic Approve.
  3. Haga clic en Yes, approve para confirmar la aprobación.
  4. Ir a Overview > Publish Queue.
  5. Seleccione la regla que desea publicar.
  6. Haga clic Publish Selected.
  7. Haga clic en Publish para confirmar que desea publicar.

Script

El siguiente código de ejemplo asigna las eVars específicas a las eVars de Livefyre disponibles. El nombre de la variable de conversión de Livefyre ( eVar) (por ejemplo, appId) se asigna al nombre configurado en el Administrador del grupo de informes (por ejemplo, eVar81). Cambie los nombres eVar de esta secuencia de comandos por las variables de conversión personalizadas.

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

El siguiente código de ejemplo asigna los eventos específicos configurados en el Administrador de grupos de informes con los eventos de Livefyre disponibles. En este ejemplo, event82 se configura como cualquier evento de interacción del usuario sin diferenciar qué tipo de evento de interacción del usuario (por ejemplo, indicar que gusta o compartir contenido). Esta es una forma eficaz de registrar toda la información de interacción del usuario en un bloque. También puede asignar los eventos en la interfaz de usuario de DTM Analytics con referencias a elementos de datos.

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'
};

El siguiente ejemplo indica que si no hay ningún evento en esta lista, no haga nada. No es necesario modificar esta sección de 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;
  }

El siguiente código diferencia los tipos de eventos que event82 registra. La variable de conversión, eVar83 registra el tipo de interacción del usuario y la secuencia de comandos configura eVar83 para separar los datos de interacción del usuario por tipo. Por lo tanto, eVar83 le permite dividir los datos registrados en tipos específicos de interacciones del usuario.

  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();
}

El siguiente ejemplo de código añade un controlador para escuchar todos los eventos que se producen. Utiliza la regla de carga de página al cargar, espera a que existan eventos, luego configura el controlador para todos los eventos de la aplicación y los rastrea. No es necesario modificar este 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);
    });
  });
}

Más información

Para obtener más información sobre los temas tratados en esta página, consulte:

En esta página