Show Menu
主題×

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 字串
包含未列舉Analytics變數(如、 等)的字串 pageName channel campaign product 陣列。
iteratedNames 物件
包含列舉的 Analytics變數( 例如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 事件清單(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.submitUniversalAnalytics(); 數會從Google的資料傳送 Universal Analytics 至Audience Manager。 此函 DIL 數的設計目的是搭配 analytics.js Google最新的程式碼庫使用 Universal Analytics。
  • Audience Manager 對Google程式碼庫沒有任何洞察或 analytics.js 控制。 當Google發行新版 DIL 本時,您應確認資料收集仍然有效 analytics.js
  • 如果您 GA.submitUniversalAnalytics(); 仍在使用Google的舊版分析追蹤代碼(例如,或),則 ga.js 無法 dc.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() 數會將舊版/已過時版本的資料 Google Analytics 傳送至Audience Manager。
GA.init() 僅能與Google的舊有分析追蹤代碼搭配使 ga.js 用, dc.js 或 如果您使用 DIL Google的最新程式碼 analytics.js 庫,則無法叫用此函式 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資料的金鑰
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