DIL 模块 dil-modules

WARNING
自2023年7月起,Adobe已停止开发新能源。 Data Integration Library (DIL) 和 DIL 扩展。
现有客户可继续使用其 DIL 实现。 但是,Adobe将不会开发 DIL 超越这一步。 我们鼓励客户对 Experience PlatformWeb SDK 长期数据收集策略。
如果客户希望在2023年7月之后实施新的数据收集集成,则应使用 Experience PlatformWeb SDK 而是。

介绍中的方法 DIL.modules 命名空间。 利用这些模块,可按编程方式收集数据并处理Audience Manager对象。

siteCatalyst.init sitecat-init

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

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

NOTE
您必须将此代码放在页面上 早于s.t(); 函数。

参数

名称
类型
描述
names
字符串
包含未枚举的字符串数组 分析 变量,如 pageName channel campaign product ,等等。
iteratedNames
对象
包含枚举的对象数组 分析 prop和evar等变量(例如 prop1 prop2 evar3 evar4 )。
maxIndex
整数
指示要返回多少个迭代名称。 例如,要返回两个prop或evar,请设置 maxIndex:2 .
siteCatalystReportingSuite
对象
表示 分析 对象。
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-submit-universal-analytics

GA.submitUniversalAnalytics(); 函数从Google发送数据 Universal Analytics Audience Manager。 此 DIL 功能设计用于 analytics.js,这是Google的最新代码库 Universal Analytics.

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

  • 您无法使用 GA.submitUniversalAnalytics(); 如果您仍在使用Google的旧版Analytics跟踪代码(例如, ga.jsdc.js)。 请参阅 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

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

IMPORTANT
GA.init() 仅适用于Google的旧版Analytics跟踪代码, ga.jsdc.js. 您无法调用此 DIL 函数(如果使用) analytics.js,这是Google的最新代码库 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数据的键

当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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695