說明DIL.modules
命名空間中的方法。 這些模組可讓您以程式設計方式收集資料並使用Audience Manager物件。
與DIL搭配使用,以傳送Analytics標籤元素(變數、prop、eVar等) 至Audience Manager。 以逗號分隔的清單傳回資料。 2.6版提供。
函式簽名: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
您必須將此代碼放在**s.t();
函式之前的頁面上。
參數
名稱 | 類型 | 說明 |
---|---|---|
names |
字串 | 包含未列舉 Analytics 變數(例如 |
iteratedNames |
物件 | 包含列舉 Analytics 變數(例如prop和evar)的物件陣列(例如 |
maxIndex |
整數 | 指出您要傳回的重複名稱數。 例如,若要傳回兩個prop或evar,請設定 |
siteCatalystReportingSuite |
物件 | 代表 Analytics 物件的物件。 |
dilInstance |
物件 | 代表 DIL 的物件。 |
options |
物件 | 其他選項:
|
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();
函式會將資料從Google的[!DNL Universal Analytics]傳送至Audience Manager。 此[!UICONTROL DIL]函式旨在與analytics.js
搭配使用,後者是Google Universal Analytics的最新程式碼庫。
Audience Manager 對Google程式碼庫沒有任何洞察或 analytics.js
控制。當Google發行新版analytics.js
時,您應確認DIL資料收集仍然有效。
如果您仍在使用Google的舊有分析追蹤代碼(例如ga.js
或dc.js
),則無法使用GA.submitUniversalAnalytics();
。 請參閱GA.init。
函式簽名: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
屬性
GA.submitUniversalAnalytics();
函式接受以下屬性。
屬性 | 說明 |
---|---|
|
您的 Google Analytics 例項的全域變數。 這通常是預設的 |
|
代表您 DIL 例項的變數。 |
|
(可選) 在程 此屬性是選用的,因為您不需要設定它,除非Google變更其內部變數的名稱。 例如,如果此精簡變數變更為 |
範例
請記得先定義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()
函式會從Google Analytics的舊版/已過時版本傳送資料至Audience Manager。
GA.init()
僅能與Google的舊有分析追蹤代碼 ga.js
或 dc.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