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