Show Menu
TEMAS×

Módulos DIL

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

siteCatalyst.init

Funciona con DIL para enviar elementos Analytics de etiqueta (variables, props, eVars, etc.) a 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)
Debe colocar este código en la página antes de la s.t(); función.
Parámetros
variable Tipo Descripción
nombres Cadena
Una matriz de cadenas que contiene variables de Analytics no enumeradas como pageName , channel , campaign , product , etc.
iteratedNames Objeto
Matriz de objetos que contiene variables de Analytics enumeradas como props y evars (por ejemplo, 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
Objeto que representa el objeto de Analytics .
dilInstance Objeto
Objeto que representa DIL .
opciones Objeto
Opciones adicionales:
  • replaceContextDataPeriodsWith
    Si no especifica otra cosa, los puntos se reemplazan con 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 DIL versión 5.0 o posterior.
  • filterFromContextVariables
    Por ejemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] resultaría en el filtrado de la matriz de cadenas de 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 de Analytics eventos separados por coma (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 monitoreados sin la función adicional que se muestra arriba, invoque Analytics siteCatalyst.init por sí misma de esta manera:
DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

La GA.submitUniversalAnalytics(); función envía datos de Google Universal Analytics a Audience Manager. Esta DIL función está diseñada para funcionar con analytics.js , que es la biblioteca de códigos más reciente para Google Universal Analytics.
  • Audience Manager no tiene ninguna perspectiva ni control sobre la biblioteca de códigos de Google analytics.js . Debe comprobar que la recopilación de datos sigue funcionando si Google lanza nuevas versiones de DIL analytics.js .
  • No puede usar 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 GA.submitUniversalAnalytics(); función acepta las siguientes propiedades.
Propiedad Descripción
gaObject
La variable global de su instancia de Google Analytics . Esto suele ser ga de forma predeterminada, a menos que haya personalizado el código de Google Analytics .
dilInstance
La variable que representa la instancia de DIL .
internalPropertyName
(Opcional) En la biblioteca analytics.js , la propiedad interna es la variable 'b' minimizada. Esta variable contiene datos de 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 minimizada cambiara a "a" , llamaría a GA.submitUniversalAnalytics(); así:
DIL.module.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Ejemplo
Recuerde definir el Google Analytics objeto primero, antes de llamar ga y DIL GA.submitUniversalAnalytics(); . El código podría tener un aspecto similar al siguiente:
//Instantiate DIL 
var dilInstance = DIL.create({ 
     partner:"adobe" 
}); 
 
//Call the DIL Universal Analytics function 
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init

La GA.init() función envía datos de la versión heredada o en desuso de Google Analytics Audience Manager.
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 DIL función si utiliza analytics.js , que es la biblioteca de códigos más reciente para Google Universal Analytics. Audience Manager 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
Objeto que contiene la instancia DIL.
trackVars
Objeto
(Opcional) Objeto que consta de la names propiedad. Esta propiedad es una matriz de nombres de comandos 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 de una matriz. Para trabajar con datos de GA, DIL crea automáticamente un par de 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 a Audience Manager podría 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