Módulos DIL dil-modules

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

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

siteCatalyst.init sitecat-init

Funciona con DIL para enviar Analytics elementos etiqueta (variables, props, eVars, etc.) a Audience Manager. Devuelve datos en un lista separados 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 s.t(); función.

Parámetros

Nombres
Tipo
Descripción
names
Cadena
Matriz de cadenas que contiene variables de Analytics sin enumerar gustar pageName , channel , campaign , product , etc.
iteratedNames
Objeto
Matriz de objetos que contiene variables de Analytics enumeradas gustar props y evars (por ejemplo, , prop1 , prop2 , evar3 ). evar4
maxIndex
Número entero
Indica el número de nombres iterados que 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 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 la llamada de evento cadena de consulta.

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

  • filterFromContextVariables

    Por ejemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] provocaría que la matriz de cadenas se filtrara de la recopilación de datos 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 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 un lista de Analytics eventos separados por comas (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 Analytics sin la función adicional que se muestra arriba, invoque siteCatalyst.init por sí mismo gustar esto:

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

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 última biblioteca de código para Google Universal Analytics.

IMPORTANT
  • Audience Manager no tiene ningún conocimiento ni control sobre el código de Google analytics.js biblioteca. Debe verificar que DIL recopilación de datos sigue funcionando cuando Google lance nuevas versiones de analytics.js.

  • No puede usarlo 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 GA.submitUniversalAnalytics(); función acepta las siguientes propiedades.

Propiedad
Descripción
gaObject
El variable global para su instancia de Google Analytics . Normalmente ga , esto sucede de forma predeterminada, a menos que haya personalizado el código Google Analytics .
dilInstance
El variable que representa su instancia de DIL .
internalPropertyName

(Opcional) En el analytics.js biblioteca, el Propiedad interno es el variable 'b' minificado. Este variable contiene Google Analytics datos.

Este Propiedad es opcional porque no es necesario configurarlo a menos que Google cambie el nombre de su variable interno. Por ejemplo, si este variable minimizado cambiara a 'a' , llamaría GA.submitUniversalAnalytics(); gustar esto:

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

Ejemplo

Recuerde definir primero el objeto, antes de Google Analytics llamar y ga DIL.GA.submitUniversalAnalytics(); Su 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 ga-init

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

IMPORTANT
GA.init()solo funciona con el análisis heredado de Google código de seguimiento, o bienga.js. dc.js No puede invocar esta DIL función si utiliza analytics.js, que es el código más reciente biblioteca para Google Universal Analytics. Audience Manager clientes que usan 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 GA.
dilInstance
Objeto
Objeto que contiene el instancia DIL.
trackVars
Objeto
(Opcional) Un objeto que consiste en el names Propiedad. Este Propiedad es una matriz de nombres de comandos de GA que desea rastrear.

Llamadas a funciones de GA admitidas

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

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL crea claves para datos de GA

Audience Manager acepta datos en forma de pares clave-valor, mientras que GA trabaja con elementos de una matriz. Para trabajar con datos GA, DIL crea un par clave-valor automáticamente y forma una clave gustar esto: c_ <key name>. Además, los elementos de las matrices GA aparecen en un orden específico. En consecuencia, debe proporcionar todos los parámetros en ese orden, igualado 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 monitoreadas sin la función adicional que se muestra arriba, invoque GA.init por sí sola gustar esto:

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

Llamada de evento de muestra

La URL evento llamada a Audience Manager podría 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