Show Menu
主题×

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 事件列表(props、eVars等) 是否存在这些值。
// 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(); 能将数据从谷歌发送到 Universal Analytics Audience Manager。 此 DIL 函数设计为可与 analytics.js Google的最新代码库一起使用 Universal Analytics。
  • Audience Manager 对Google代码库没有任何见解或 analytics.js 控制。 Google发布新 DIL 版本时,应验证数据收集是否仍然有效 analytics.js
  • 如果仍 GA.submitUniversalAnalytics(); 在使用Google的旧版分析跟踪代码(如或),则无法 ga.js 使 dc.js 用。 请 改为参见GA .init。
函数签名: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
属性
该函 GA.submitUniversalAnalytics(); 数接受以下属性。
属性 描述
gaObject
GoogleAnalytics的全 局变 量 通常,这 ga 是默认值,除非您已自定义了 GoogleAnalytics 代码。
dilInstance
表示DIL实例的 变量
internalPropertyName
(可选 )在库 analytics.js 中,内部属性是微型变量 'b' 。 此变量包含 谷歌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的传统分析跟踪代码配合使用, ga.js 或者 dc.js 。 如果您使用 DIL Google的最 analytics.js 新代码库,则无法调用此函数 Universal Analytics。 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