Módulos DIL

Describe los métodos del espacio de nombres DIL.modules. Estos módulos permiten recopilar datos mediante programación y trabajar con objetos de Audience Manager.

siteCatalyst.init

Funciona con DIL para enviar elementos de etiqueta Analytics (variables, props, eVars, etc.) al Audience Manager. Devuelve datos de una lista separada por comas. Disponible en la versión 2.6.

Firma de función: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

NOTA

Debe colocar este código en la página antes de la función s.t();.

Parámetros

variable Tipo Descripción
names Cadena

Matriz de cadenas que contiene variables Analytics no enumeradas como pageName , channel , campaign , product , etc.

iteratedNames Objeto

Matriz de objetos que contiene variables enumeradas de Analytics, como props y evars (p. ej. prop1 , prop2 , evar3 , evar4 ).

maxIndex Número entero

Indica cuántos nombres repetidos desea devolver. Por ejemplo, para devolver dos props o evars, establezca maxIndex:2 .

siteCatalystReportingSuite Objeto

Un objeto que representa el objeto Analytics .

dilInstance Objeto

Un objeto que representa el DIL .

options Objeto

Opciones adicionales:

  • replaceContextDataPeriodsWith

    Si no especifica otra cosa, los puntos se sustituyen por el guión bajo predeterminado ( _ ).

    Por ejemplo, s.contextData = {abc.def = '123'} resultaría en c_contextData_abc_def=123 en la cadena de consulta de llamada de evento.

    Esta opción solo está disponible en el DIL versión 5.0 o posterior.

  • filterFromContextVariables

    Por ejemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] resultaría en que la matriz de cadenas se filtrara desde la recopilación de datos de contexto. Esta opción excluye Información de identificación personal (PII).

Datos capturados por siteCatalyst.init

Esta función devuelve detalles sobre las siguientes Analytics propiedades:

  • pageName
  • channel
  • campaign
  • products
  • events
  • eVar (1 - 250)
  • prop (1 - 75)
  • pe
  • pev1
  • pev2
  • pev3

Código de ejemplo

Este código crea una lista separada por comas de eventos Analytics (props, eVars, etc.) si existen valores para ellos.

// Get the Site Catalyst object instance: 
var s = s_gi(s_account); 
  
// Instantiate DIL code: 
var scDil = DIL.create({ 
        partner: 'adobe', 
        containerNSID: 5 
}); 
 
// Use the module: 
DIL.modules.siteCatalyst.init(s, scDil, { 
        //Specify the Site Catalyst variables you want to capture: 
        names: ['pageName', 'channel', 'campaign'], 
        //Use this to create iterated variable names: 
        iteratedNames: [{ 
               name: 'eVar', 
               maxIndex: 75 
        }, { 
               name: 'prop', 
               maxIndex: 75 
        }] 
});

Para rastrear todos los puntos de datos Analytics monitorizados sin la función adicional mostrada arriba, invoque siteCatalyst.init de esta manera:

DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

La función GA.submitUniversalAnalytics(); envía datos del Universal Analytics de Google al Audience Manager. Esta función DIL está diseñada para funcionar con analytics.js, que es la última biblioteca de códigos para Google Universal Analytics.

IMPORTANTE
  • Audience Manager no tiene ninguna perspectiva ni control sobre la biblioteca de analytics.js código de Google. Debe verificar que la recopilación de datos DIL sigue funcionando si Google publica nuevas versiones de analytics.js o cuándo lo hace.

  • No puede utilizar GA.submitUniversalAnalytics(); si sigue trabajando con el código de seguimiento de análisis heredado de Google (por ejemplo, ga.js o dc.js). Consulte GA.init en su lugar.

Firma de función: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

Propiedades

La función GA.submitUniversalAnalytics(); acepta las siguientes propiedades.

Propiedad Descripción

gaObject

La variable global para su instancia de Google Analytics . Normalmente es ga de forma predeterminada, a menos que haya personalizado el código de los Google Analytics .

dilInstance

La variable que representa la instancia del DIL .

internalPropertyName

(Opcional) En la analytics.js biblioteca, la propiedad interna es la variable minificada 'b' . Esta variable contiene datos de los Google Analytics.

Esta propiedad es opcional porque no es necesario establecerla a menos que Google cambie el nombre de su variable interna. Por ejemplo, si esta variable minificada cambiara a 'a' , llamaría a GA.submitUniversalAnalytics(); de esta manera:

DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');

Ejemplo

Recuerde definir primero el objeto Google Analytics ga antes de llamar a DIL y GA.submitUniversalAnalytics();. Su código podría tener un aspecto similar a este:

//Instantiate DIL 
var dilInstance = DIL.create({ 
     partner:"adobe" 
}); 
 
//Call the DIL Universal Analytics function 
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init

La función GA.init() envía datos de la versión heredada/obsoleta de Google Analytics al Audience Manager.

IMPORTANTE

GA.init() solo funciona con el código de seguimiento de análisis heredado de Google, ga.js o dc.js. No puede invocar esta función DIL si utiliza analytics.js, que es la última biblioteca de códigos para Google Universal Analytics. Audience Manager los clientes que utilizan DIL y Universal Analytics deben ver GA.submitUniversalAnalytics.

Firma de función: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

Parámetros

Nombre Tipo Descripción
_gaq Matriz Matriz que contiene comandos GA.
dilInstance Objeto Un objeto que contiene la instancia de DIL.
trackVars Objeto (Opcional) Un objeto que consta de la names propiedad. Esta propiedad es una matriz de nombres de comando GA que desea rastrear.

Llamadas a funciones GA admitidas

De forma predeterminada, GA.init captura datos de las siguientes funciones:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL crea claves para datos GA

Audience Manager acepta datos en forma de pares clave-valor mientras GA trabaja con elementos en una matriz. Para trabajar con datos GA, DIL crea automáticamente un par clave-valor y forma una clave como esta: c_ <key name>. Además, los elementos de las matrices GA aparecen en un orden específico. Como resultado, debe proporcionar todos los parámetros en ese orden, incluso cuando no contengan datos. DIL asigna claves para los siguientes métodos GA:

// Tracking Social Interactions 
_gaq.push(['_trackSocial', 
    'facebook',                        // c_socialNetwork 
    'like',                            // c_socialAction 
    'https://www.adobe.com/cool.php',   // c_socialTarget 
    '/cool.php'                        // c_socialPagePath 
]);  
 
// Tracking a Transaction 
_gaq.push(['_addTrans', 
   '1234',           // c_transOrderId 
   'Womens Apparel', // c_transAfflication 
   '28.28',          // c_transTotal 
   '1.29',           // c_tranTax 
   '15.00',          // c_transShipping 
   'San Jose',       // c_transCity 
   'California',     // c_transState 
   'USA'             // c_transCountry 
]); 
 
// Tracking an item 
_gaq.push(['_addItem', 
   '1234',           // c_itemOrderId=1234 
   'DD44',           // c_itemSku 
   'T-Shirt',        // c_itemName 
   'Olive Medium',   // c_itemCategory 
   '11.99',          // c_itemPrice 
   '1'               // c_itenQuantity 
]);

Código de ejemplo

// DIL JavaScript library needs to be loaded and executed here 
var dilInstance = DIL.create({ 
    partner : "adobe" 
}); 
 
// Assume ga.js has not loaded 
var _gaq = _gaq || []; 
_gaq.push( 
  ['_setAccount', 'UA-XXXXX-X'], 
  ['_setDomainName', 'example.com'], 
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3], 
  ['_trackPageview'] 
); 
_gaq.push([ 
  '_addItem', 
  '1234',         // order ID - necessary to associate item with transaction 
  'DD44',         // SKU/code - required 
  'T-Shirt',      // product name - necessary to associate revenue with product 
  'Olive Medium', // category or variation 
  '11.99',        // unit price - required 
  '1'             // quantity - required 
]); 

Para rastrear todas las métricas de GA monitoreadas sin la función adicional que se muestra arriba, invoque GA.init de esta manera:

DIL.modules.GA.init(_gaq, dilInstance).submit();

Ejemplo de llamada de evento

La llamada de evento de URL al Audience Manager puede tener un aspecto similar a este:

https://adobe.demdex.com/event?...c_accountId=UA-XXXXX-X&c_Section=Life%20%26%20Style &c_itemOrderId=1234&c_itemSku=DD44&c_itemName=T-Shirt&c_itemCategory=Olive%20Medium& c_itemPrice=11.99&c_itemQuantity=1

En esta 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