DIL のユースケースとコードサンプル dil-use-cases-and-code-samples

WARNING
2023 年 7 月以降、Adobeは Data Integration Library (DIL) と DIL の開発を廃止しました。
既存のお客様は、DIL 実装を引き続き使用できます。 ただし、Adobeはこの先 DIL は発展しません。 お客様は、長期的なデータ収集戦略について 🔗0}Experience Platform Web SDK} を評価することをお勧めします。
2023 年 7 月以降、新しいデータ収集統合機能の実装を検討しているお客様は、代わりに Experience Platform Web SDK を使用する必要があります。

特定の DIL ユースケースのコードサンプルおよび説明です。

DIL を使用した Audience Manager へのデータ要素の送信 send-data-elements-dil

ページ要素に関する情報を Audience Manager に送信するオブジェクト変数を作成します。これは、一般的なデータ収集に役に立ち、Analytics 変数でデータを収集する代替手段としても有用です。

説明

DIL を使用してページデータを収集し、Audience Manager に送信する方法の例を以下のコードで示します。これらの例では、フラットリストまたは配列にデータ要素を保持する変数を使用します。変数を キーと値のペアとして渡すことに注意してください。 また、キーと値のペアのキーの前に付いている c_ プレフィックスにも注意してください。これは必須のプレフィックスであり、情報がユーザー定義データであることを明示します。最初の例では、c_ を手動でキーに付加する必要があります。2 番目の例では、DIL がこれを自動的におこないます。

値プロパティの一貫性の維持

データを渡す際には、値プロパティを同じにすることを忘れないでください。例えば、2 つの同一のキーが異なる値を持つ場合、最後のキーと値のペアの値が、それより前の値オブジェクトよりも優先されます。例えば、color:bluecolor:red を渡すと、返される値は red に設定されます(blue が上書きされます)。

例 1:データをキーと値のペアとして送信

この基本的な例では、色と価格のデータをキーと値のペアの形式で Audience Manager に送信しています。次のようなコードになります。


var sample_dil = DIL.create({partner:"partner name"});
sample_dil.api.signals({
   c_color:"blue",
   c_price:"900"
});
sample_dil.api.submit();

例 2:データをオブジェクトで送信

この高度な例では、データをオブジェクトで Audience Manager に送信する方法を示します。このメソッドを扱う場合は、DIL を使用すると、オブジェクトを関数パラメーターとして signals() メソッドに渡すことができます。DIL 次のようなコードになります。


var my_object = {
   color : "blue",
   price : "900"
};

var sample_dil = DIL.create({ partner : "partner name" });
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager.
sample_dil.api.signals(my_object,"c_").submit();

例 3:配列でのデータの送信

この場合、変数 my_object は、配列を使用してデータを保持します。この例は、前述の推奨メソッドで渡された情報に基づいて構築されていますが、製品タイプおよびモデルに適応させるためにレイヤーを追加しています。次のようなコードになります。


var my_objects = [{
   color : "blue",
   price : "900"
}, {
   type : "acura",
   model : "tl"
}];

var sample_dil = DIL.create({ partner : "partner name" });

for (var i = 0; i < my_objects.length; i++)
//Load the object and append "c_" to all the keys in the key-value pairs.
{
    sample_dil.api.signals(my_objects[i], "c_");
}
sample_dil.api.submit();

参照 URL のキャプチャ capture-referring-url

参照 URL をキャプチャして Audience Manager に送信します。

NOTE
このメソッドは、ユーザーが同じプロトコル(HTTP または HTTPS)のページ間を移動する場合にのみ機能します。例えば、セキュリティで保護されたサイトから、セキュリティで保護された別のサイトに移動する場合、ブラウザーは、参照 URL を保持します。セキュリティで保護されたサイトとセキュリティで保護されていないサイトの間を移動する場合、ブラウザーは、参照 URL を保持しません。この動作は、通常のブラウザー機能であり、DIL で回避することはできません。

コードサンプル

次のようなコードになります。


var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

検索エンジンのタイプおよびキーワード検索語句のキャプチャ capture-search-engine-types

検索エンジンのタイプおよびキーワード検索に関する情報を Audience Manager に送信します。

IMPORTANT
ここでは、最新バージョンの DIL でサポートされていない従来の機能について説明します。

サポートされている検索エンジン

デフォルトでは、DIL.getSearchReferrer は以下の検索エンジン(各国語版を含む)からの検索を認識します。

  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!

説明

サポートされている任意の検索エンジンの検索リファラーを取得する方法の例を以下のコードで示します。ここでは、ユーザーが「homes」という語句を Google Canada(www.google.ca)で検索したとしましょう。このコードでは、これらの検索語句をキャプチャして Audience Manager に送信することができます。

基本コード

検索リファラーを(google.com などから)取得する基本コードは、次のようになります。

var search_referrer = DIL.tools.getSearchReferrer();

登録済み検索エンジンのコードサンプル

ここでは、ユーザーが「homes」という語句を Google Canada(www.google.ca)で検索したとしましょう。コードで、検索エンジン(c_se)および検索語句(c_st)に、必須の c_ プレフィックスが付加されていることに注意してください。c_必須のプレフィックスであり、これらが Audience Manager に対する顧客定義変数であることを明示するためのものです。


var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer();

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

未登録検索エンジンのコードサンプル

ここでは、ユーザーが「homes」という語句を dogpile.com から検索したとしましょう。Dogpile はデフォルトではサポートされていないので、この検索エンジンを認識し検索語句を Audience Manager に返すように DIL を設定します。次のようなコードになります。


var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {
    hostPattern:/dogpile\./,
    queryParam:"q"
});

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

キーと値の他のキーへのマッピング map-key-values

キーと値のペアの値を別のキーに関連付けます。

説明

キーと値のペアでは、キーに付加された c_ プレフィックスで、シグナルが顧客定義データとして識別されます。顧客定義データは、イベント呼び出し時のデータで渡された特定のサイト上のターゲティングに使用されます。ただし、この情報を Audience Manager アカウントのすべてのプロパティで使用可能にしたい場合があります。これをおこなうには、c_ キーと値のペアの値をプラットフォームレベルのキーにマッピングします。プラットフォームレベルのキーには d_ プレフィックスが付加されており、そのシグナルがアカウントのすべてのプロパティでターゲティングに使用できるようになります。

例として、特定のサイトから郵便番号データを収集し、それをすべての Audience Manager プロパティに対してターゲット設定するとします。郵便番号をプラットフォームレベルで使用できるようにするには、以下に示すように、顧客定義郵便番号キー(例:c_zip)をプラットフォーム定義キーにマッピングします。

コードサンプル

次のようなコードになります。

var adobe_dil = DIL.create({
    partner : "adobe",
    mappings : {
        c_zip : 'd_zip',
        d_key2 : 'h_dil_key2'
    }
});
adobe_dil.api.signals({c_zip : '10010'}).submit();
// Request will look like /event?c_zip=10010&d_zip=10010

Google Tag Manager(GTM)での DIL とのやり取り traffic-dil-gtm

GTM タグを使用して DIL を設定および提供します。

この手順は、Google Tag Manager マネージャーのアカウントと操作に関する知識があり、Audience Manager の dil.js ファイルを持っていることを前提としています。

GTM で dil.js ファイルを配信するには:

  1. 新しいコンテナを作成するか、既存のコンテナを開きます。

  2. 新しいタグをコンテナに追加します。

  3. タグを開いて編集し、次の作業をおこないます。

    • タグの名前を設定します。
    • Custom HTML Tag ドロップダウンリストから「Tag Type」を選択します。
    • HTML フィールドで、DIL コード(ライブラリとカスタムコード)をスクリプトタグ <script>DIL code</script> の内側に配置します。
    • Save」をクリックします。
  4. コンテナを公開します。

  5. コンテナタグコードを生成し、自分のインベントリに配置します。

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