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)

パラメーター

siteCatalyst.init によりキャプチャされるデータ

この関数は、次の Analytics プロパティの詳細を返します。

サンプルコード

このコードは、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の最新コードライブラリ）と連携するように設計されています。

関数シグネチャ：DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

プロパティ

GA.submitUniversalAnalytics(); 関数は次のプロパティを受け取ります。

例

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 にデータを送信します。

関数シグネチャ：DIL.modules.GA.init(_gaq, dilInstance, trackVars);

パラメーター

サポートされている GA 関数呼び出し

デフォルトでは、GA.init は次の関数からのデータをキャプチャします。

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