Módulos de DIL dil-modules

WARNING
A partir de julio de 2023, el Adobe ha interrumpido el desarrollo de la extensión Data Integration Library (DIL) y DIL.
Los clientes existentes pueden seguir usando su implementación de DIL. Sin embargo, el Adobe no se desarrollará DIL más allá de este punto. Se recomienda a los clientes que evalúen SDK web de Experience Platform para su estrategia de recopilación de datos a largo plazo.
Los clientes que deseen implementar nuevas integraciones de recopilación de datos a partir de julio de 2023 deben utilizar SDK web de Experience Platform en su lugar.

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

siteCatalyst.init sitecat-init

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

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

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

Parámetros

Nombres
Tipo
Descripción
names
Cadena
Matriz de cadenas que contiene variables de Analytics sin enumerar, 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 iterados desea devolver. Por ejemplo, para devolver dos props o evars, establezca maxIndex:2 .
siteCatalystReportingSuite
Objeto
Objeto que representa el objeto de Analytics .
dilInstance
Objeto
Un objeto que representa el DIL .
options
Objeto

Opciones adicionales:

  • replaceContextDataPeriodsWith

    Si no especifica nada más, los puntos se sustituyen por el guion 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'] haría que la matriz de cadenas se filtrara de la recopilación de datos de contexto. Esta opción excluye la información de identificación personal (PII).

Datos capturados por siteCatalyst.init

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

  • 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 Analytics eventos (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 realizar un seguimiento de todos los puntos de datos Analytics supervisados sin la función adicional mostrada arriba, invoque siteCatalyst.init de esta manera:

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

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

IMPORTANT
  • Audience Manager no tiene ninguna perspectiva ni control sobre la biblioteca de código de Google analytics.js. Debe comprobar que la recopilación de datos de DIL sigue funcionando si Google publica nuevas versiones de analytics.js o en el momento en que lo haga.

  • No puede usar GA.submitUniversalAnalytics(); si todavía está 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 . Esto suele ser ga de manera predeterminada, a menos que haya personalizado el código de los Google Analytics de .
dilInstance
La variable que representa su instancia del DIL .
internalPropertyName

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

Esta propiedad es opcional porque no es necesario configurarla 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 ser 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 ga-init

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

IMPORTANT
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 usa analytics.js, la biblioteca de código más reciente para Google Universal Analytics. Los clientes de Audience Manager que usen DIL y Universal Analytics deberían 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 de GA.
dilInstance
Objeto
Un objeto que contiene la instancia de DIL.
trackVars
Objeto
(Opcional) Un objeto que consta de la propiedad names. Esta propiedad es una matriz de nombres de comandos de GA que desea rastrear.

Llamadas de función GA compatibles

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

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL crea claves para los datos de GA

El Audience Manager acepta datos en forma de pares clave-valor mientras que GA trabaja con elementos en una matriz. Para trabajar con datos de 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 de 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 de 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 supervisadas sin la función adicional mostrada arriba, invoque GA.init por sí mismo 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 al siguiente:

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695