DIL 模块

描述DIL.modules命名空间中的方法。 这些模块允许您以编程方式收集数据并使用Audience Manager对象。

siteCatalyst.init

与DIL配合使用以发送Analytics标记元素(变量、prop、eVar等) Audience Manager。 以逗号分隔列表的形式返回数据。 在版本2.6中提供。

函数签名: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

注意

必须在​页面s.t();函数之前放置此代码。

参数

名称 类型 描述
names 字符串

一个字符串数组,其中包含未枚举的 Analytics 变量,例如 pageName channel campaign product 等。

iteratedNames 对象

包含枚举的 Analytics 变量(如prop和evar)的对象数组(例如, prop1 prop2 evar3 evar4 )。

maxIndex 整数

指示要返回的迭代名称数量。 例如,要返回两个prop或evar,请设置 maxIndex:2

siteCatalystReportingSuite 对象

表示 Analytics 对象的对象。

dilInstance 对象

表示DIL的对象。

options 对象

其他选项:

  • replaceContextDataPeriodsWith

    如果没有指定其他内容,句点将替换为默认下划线(_)。

    例如, s.contextData = {abc.def = '123'} 将导致事件调用查询字符串中出现 c_contextData_abc_def=123

    此选项仅在DIL版本5.0或更高版本中可用。

  • filterFromContextVariables

    例如, filterFromContextVariables: ['email', 'zip', 'accountNumber'] 会导致从上下文数据的数据收集中过滤字符串数组。 此选项不包括个人身份信息(PII)。

siteCatalyst.init捕获的数据

此函数返回有关以下Analytics属性的详细信息:

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

示例代码

此代码创建一个以逗号分隔的Analytics事件(prop、eVar等)列表 值是否存在。

// 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 
        }] 
});

要跟踪所有受监控的Analytics数据点,而不使用上面显示的附加函数,请自行调用siteCatalyst.init,如下所示:

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

GA.submitUniversalAnalytics

GA.submitUniversalAnalytics();函数将Google [!DNL Universal Analytics]中的数据发送到Audience Manager。 此[!UICONTROL DIL]函数旨在与analytics.js一起使用,后者是Google Universal Analytics的最新代码库。

重要
  • Audience Manager 对Google代码库没有任何洞察或 analytics.js 控制。当或当Google发布新版本的analytics.js时,您应验证DIL数据收集是否仍在工作。

  • 如果您仍在使用Google的旧版分析跟踪代码(例如,ga.jsdc.js),则不能使用GA.submitUniversalAnalytics();。 请参阅GA.init

函数签名: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

属性

GA.submitUniversalAnalytics();函数接受以下属性。

属性 描述

gaObject

Google Analytics实例的全局变量。 默认情况下,此值通常为 ga ,除非您已自定义Google Analytics代码。

dilInstance

表示DIL实例的变量。

internalPropertyName

(可选) 在库中, analytics.js 内部属性是缩小的变量 'b' 。此变量包含Google Analytics数据。

此属性是可选的,因为除非Google更改其内部变量的名称,否则您无需设置此属性。 例如,如果此缩小的变量更改为 'a' ,则将调用 GA.submitUniversalAnalytics(); ,如下所示:

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

示例

请记得先定义Google Analytics ga对象,然后再调用DIL和GA.submitUniversalAnalytics();。 您的代码可能类似于以下内容:

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

GA.init

GA.init()函数将数据从Google Analytics的旧版/已弃用版本发送到Audience Manager。

重要

GA.init() 仅适用于Google旧版Analytics跟踪代码, ga.jsdc.js。如果使用analytics.js(Google Universal Analytics的最新代码库),则无法调用此DIL函数。 Audience Manager 使用和 DIL 的客 Universal Analytics 户应会 看到GA.submitUniversalAnalytics

函数签名: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

参数

名称 类型 描述
_gaq 数组 包含GA命令的数组。
dilInstance 对象 包含DIL实例的对象。
trackVars 对象 (可选) 包含属性的对 names 象。此属性是要跟踪的GA命令名称数组。

支持的GA函数调用

默认情况下,GA.init会从以下函数中捕获数据:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL为GA数据创建键

Audience Manager以键值对的形式接受数据,而GA则用于数组中的项目。 要处理GA数据,DIL会自动创建一个键值对,并形成如下的键:c_ <key name>。 此外,GA数组中的项目以特定顺序显示。 因此,您必须按该顺序提供所有参数,即使它们不包含任何数据也是如此。 DIL 映射以下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 
]);

示例代码

// 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 
]); 

要跟踪所有受监控的GA量度,而不使用上面显示的附加函数,请自行调用GA.init,如下所示:

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

事件调用示例

对Audience Manager的URL事件调用可能类似于以下内容:

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

在此页面上