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發行新版本analytics.js時，您應確認DIL資料收集仍然有效。

  • 如果您仍在使用Google的舊版分析追蹤代碼（例如ga.js或dc.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的舊版analytics追蹤代碼， 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

相關文章

本頁內容