DIL 模块 dil-modules
介绍中的方法 DIL.modules
命名空间。 利用这些模块,可按编程方式收集数据并处理Audience Manager对象。
siteCatalyst.init sitecat-init
与配合使用 DIL 发送 Analytics 标记元素(变量、prop、eVar等) Audience Manager。 以逗号分隔的列表形式返回数据。 在版本2.6中提供。
函数签名: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
函数。参数
names
pageName
, channel
, campaign
, product
,等等。iteratedNames
prop1
, prop2
, evar3
, evar4
)。maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
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-submit-universal-analytics
此 GA.submitUniversalAnalytics();
函数从Google发送数据 Universal Analytics Audience Manager。 此 DIL 功能设计用于 analytics.js
,这是Google的最新代码库 Universal Analytics.
-
Audience Manager 对Google没有任何洞察或控制
analytics.js
代码库。 您应该验证 DIL 当Google发布新版本时,数据收集仍在工作analytics.js
. -
您无法使用
GA.submitUniversalAnalytics();
如果您仍在使用Google的旧版Analytics跟踪代码(例如,ga.js
或dc.js
)。 请参阅 GA.init 而是。
函数签名: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
属性
此 GA.submitUniversalAnalytics();
函数接受以下属性。
gaObject
ga
默认情况下,除非您自定义了 Google Analytics 代码。dilInstance
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
此 GA.init()
函数发送来自旧版/已弃用版本的数据 Google Analytics Audience Manager。
GA.init()
仅适用于Google的旧版Analytics跟踪代码, ga.js
或 dc.js
. 您无法调用此 DIL 函数(如果使用) analytics.js
,这是Google的最新代码库 Universal Analytics. Audience Manager 使用的客户 DIL 和 Universal Analytics 应该会看到 GA.submitUniversalAnalytics.函数签名: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
参数
_gaq
dilInstance
trackVars
names
属性。 此属性是您希望跟踪的GA命令名称数组。支持的GA函数调用
默认情况下, GA.init
从以下函数捕获数据:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL创建GA数据的键
当GA处理数组中的项时,Audience Manager接受键值对形式的数据。 要处理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