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 。siteCatalystReportingSuitedilInstanceoptions其他選項：
-
replaceContextDataPeriodsWith如果您未指定其他專案，句點會取代為預設底線( _ )。
例如，
s.contextData = {abc.def = '123'}會在事件呼叫查詢字串中產生c_contextData_abc_def=123。此選項僅適用於DIL 5.0或更新版本。
-
filterFromContextVariables例如，
filterFromContextVariables: ['email', 'zip', 'accountNumber']會導致字串陣列從內容資料的資料集合中篩選。 此選項不包含個人識別資訊(PII)。
由siteCatalyst.init擷取的資料
此函式傳回下列Analytics屬性的詳細資料：
pageNamechannelcampaignproductseventseVar(1 - 250)prop(1 - 75)pepev1pev2pev3
程式碼範例
此程式碼會建立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程式碼資料庫沒有任何深入分析或控制權。 當Google發行analytics.js的新版本時，您應該確認DIL資料收集仍在運作。 -
如果您仍在使用Google的舊版Analytics追蹤代碼（例如
ga.js或dc.js），則無法使用GA.submitUniversalAnalytics();。 請參閱GA.init。
函式簽章： DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
屬性
GA.submitUniversalAnalytics();函式接受下列屬性。
gaObject ga ，除非您已自訂您的Google Analytics程式碼。dilInstanceinternalPropertyName（選擇性） 在 analytics.js 資料庫中，內部屬性是縮制的變數 'b' 。 此變數保留個Google Analytics資料。
此屬性是選用性的，因為除非Google變更其內部變數的名稱，否則您不需要進行設定。 例如，如果此縮制變數變更為 'a' ，您應呼叫 GA.submitUniversalAnalytics(); 如下：
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
範例
記得在呼叫DIL和GA.submitUniversalAnalytics();之前，先定義Google Analytics ga物件。 您的程式碼可能如下所示：
//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。 如果您使用Google Universal Analytics的最新程式碼庫analytics.js，則無法叫用此DIL函式。 使用DIL和Universal Analytics的Audience Manager客戶應該會看到GA.submitUniversalAnalytics。函式簽章： DIL.modules.GA.init(_gaq, dilInstance, trackVars);
參數
_gaqdilInstancetrackVarsnames屬性的物件。 此屬性是您要追蹤的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