Módulos DIL dil-modules

WARNING
A partir de julho de 2023, o Adobe descontinuou o desenvolvimento da extensão Data Integration Library (DIL) e DIL.
Os clientes existentes podem continuar usando a implementação DIL. Entretanto, o Adobe não desenvolverá DIL além deste ponto. Os clientes são incentivados a avaliar o SDK da Web do Experience Platform para sua estratégia de coleta de dados de longo prazo.
Os clientes que desejam implementar novas integrações de coleção de dados após julho de 2023 devem usar o SDK da Web do Experience Platform.

Descreve métodos no namespace DIL.modules. Esses módulos permitem coletar dados de forma programática e trabalhar com objetos Audience Manager.

siteCatalyst.init sitecat-init

Funciona com DIL para enviar elementos de tag Analytics (variáveis, props, eVars etc.) para Audience Manager. Retorna dados em uma lista separada por vírgulas. Disponível na versão 2.6.

Assinatura da Função: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

NOTE
Você deve colocar este código na página antes da função s.t();.

Parâmetros

Nomes
Tipo
Descrição
names
String
Uma matriz de cadeias de caracteres que contém variáveis do Analytics não enumeradas como pageName , channel , campaign , product , etc.
iteratedNames
Objeto
Uma matriz de objetos que contém variáveis do Analytics enumeradas, como props e evars (por exemplo, prop1 , prop2 , evar3 , evar4 ).
maxIndex
Número inteiro
Indica quantos nomes iterados você deseja retornar. Por exemplo, para retornar duas props ou evars, defina maxIndex:2 .
siteCatalystReportingSuite
Objeto
Um objeto que representa o objeto do Analytics .
dilInstance
Objeto
Um objeto que representa DIL .
options
Objeto

Opções adicionais:

  • replaceContextDataPeriodsWith

    Se você não especificar mais nada, os pontos serão substituídos pelo sublinhado padrão ( _ ).

    Por exemplo, s.contextData = {abc.def = '123'} resultaria em c_contextData_abc_def=123 na cadeia de caracteres de consulta da chamada de evento.

    Esta opção está disponível somente no DIL versão 5.0 ou posterior.

  • filterFromContextVariables

    Por exemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] resultaria na matriz de cadeias de caracteres sendo filtrada da coleção de dados de contexto. Essa opção exclui informações pessoais identificáveis (PII).

Dados capturados pelo siteCatalyst.init

Esta função retorna detalhes sobre as seguintes propriedades Analytics:

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

Código de exemplo

Esse código cria uma lista separada por vírgulas de Analytics eventos (props, eVars etc.) se existirem valores para eles.

// 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 os pontos de dados Analytics monitorados sem a função adicional mostrada acima, chame siteCatalyst.init sozinho da seguinte maneira:

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

A função GA.submitUniversalAnalytics(); envia dados do Universal Analytics da Google para o Audience Manager. Esta função DIL foi projetada para funcionar com analytics.js, que é a biblioteca de códigos mais recente do Google Universal Analytics.

IMPORTANT
  • Audience Manager não tem nenhum insight nem controle sobre a biblioteca de códigos analytics.js do Google. Você deve verificar se a coleta de dados do DIL ainda está funcionando se ou quando a Google lançar novas versões do analytics.js.

  • Você não pode usar GA.submitUniversalAnalytics(); se ainda estiver trabalhando com o código de rastreamento de análise herdado do Google (por exemplo, ga.js ou dc.js). Consulte GA.init.

Assinatura da Função: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

Propriedades

A função GA.submitUniversalAnalytics(); aceita as seguintes propriedades.

Propriedade
Descrição
gaObject
A variável global da sua instância de Google Analytics . Isso geralmente é ga por padrão, a menos que você tenha personalizado seu código Google Analytics .
dilInstance
A variável que representa a instância do DIL .
internalPropertyName

(Opcional) Na biblioteca analytics.js , a propriedade interna é a variável minificada 'b' . Esta variável contém dados de Google Analytics .

Essa propriedade é opcional porque você não precisa defini-la, a menos que o Google altere o nome de sua variável interna. Por exemplo, se essa variável minificada mudasse para 'a' , você chamaria GA.submitUniversalAnalytics(); desta forma:

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

Exemplo

Lembre-se de definir o objeto Google Analytics ga primeiro, antes de chamar DIL e GA.submitUniversalAnalytics();. O código pode ser semelhante a:

//Instantiate DIL
var dilInstance = DIL.create({
     partner:"adobe"
});

//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init ga-init

A função GA.init() envia dados da versão herdada/obsoleta de Google Analytics para o Audience Manager.

IMPORTANT
GA.init() funciona somente com o código de rastreamento de análise herdado do Google, ga.js ou dc.js. Você não pode invocar esta função DIL se usar analytics.js, que é a biblioteca de códigos mais recente para o Google Universal Analytics. Audience Manager clientes que usam DIL e Universal Analytics devem ver GA.submitUniversalAnalytics.

Assinatura da Função: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

Parâmetros

Nome
Tipo
Descrição
_gaq
Matriz
Um array que contém comandos do GA.
dilInstance
Objeto
Um objeto que contém a instância DIL.
trackVars
Objeto
(Opcional) Um objeto que consiste na propriedade names. Essa propriedade é uma matriz de nomes de comando do GA que você deseja rastrear.

Chamadas de Função GA com Suporte

Por padrão, GA.init captura dados das seguintes funções:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL Cria Chaves para Dados do GA

O Audience Manager aceita dados na forma de pares de valores chave, enquanto o GA funciona com itens em uma matriz. Para trabalhar com dados do GA, o DIL cria automaticamente um par de valores chave e forma uma chave como esta: c_ <key name>. Além disso, os itens nos arrays GA aparecem em uma ordem específica. Como resultado, você deve fornecer todos os parâmetros nessa ordem, mesmo quando eles não contêm dados. DIL mapeia chaves para os seguintes métodos do 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 exemplo

// 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 as métricas de GA monitoradas sem a função adicional mostrada acima, chame GA.init sozinho, da seguinte maneira:

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

Exemplo de chamada de evento

A chamada de evento de URL para o Audience Manager pode ser semelhante a:

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