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 字符串

包含未枚举的分析变量(如 pageName channel campaign product 等)的字符串数组。

iteratedNames 对象

包含枚举的分析变量(如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();函数将数据从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的旧版分析跟踪代码或 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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now