DIL 模組 dil-modules

WARNING
自2023年7月起,Adobe已停止開發 Data Integration Library (DIL) 和 DIL 副檔名。
現有客戶可繼續使用其 DIL 實作。 不過,Adobe將不會開發 DIL 超出此點。 建議客戶評估 Experience PlatformWeb SDK 長期資料收集策略的影響。
如果客戶希望在2023年7月之後實作新的資料收集整合,則應使用 Experience PlatformWeb SDK 而非。

說明中的方法 DIL.modules 名稱空間。 這些模組可讓您以程式設計方式收集資料並處理Audience Manager物件。

siteCatalyst.init sitecat-init

搭配使用 DIL 以傳送 Analytics 標籤元素(變數、prop、eVar等) 以Audience Manager。 以逗號分隔的清單傳回資料。 2.6版提供。

函式簽章: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

NOTE
您必須將此程式碼放置在頁面上 早於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-submit-universal-analytics

GA.submitUniversalAnalytics(); 函式從Google傳送資料 Universal Analytics 以Audience Manager。 這個 DIL 功能專為搭配下列專案而設計: analytics.js,此元件為Google的最新程式碼庫 Universal Analytics.

IMPORTANT
  • Audience Manager 無法深入瞭解或控制Google analytics.js 程式碼程式庫。 您應確認 DIL 如果Google發行新版本的 analytics.js.

  • 您無法使用 GA.submitUniversalAnalytics(); 如果您仍在使用Google的舊版Analytics追蹤代碼(例如 ga.jsdc.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

GA.init() 函式會從舊版/已棄用的版本傳送資料 Google Analytics 以Audience Manager。

IMPORTANT
GA.init() 僅適用於Google的舊版Analytics追蹤代碼、 ga.jsdc.js. 您無法叫用此功能 DIL 函式(若您使用 analytics.js,此元件為Google的最新程式碼庫 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資料的索引鍵

當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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695