モジュールの統合

統合モジュールを使用すると、アドビのパートナーは自社のデータ収集作業を組織と統合できます。この統合により、双方向のデータ接続の機会が得られます。通常、統合モジュールの使用はアドビのパートナーが主導します。

統合モジュールのワークフロー

統合モジュールの実装

アドビのパートナーと連携している組織は、これらの手順を使用して統合モジュールの使用を正常に開始できます。

統合モジュールコードの取得

モジュールコードを取得するには、製品管理者のアクセス権を持つユーザー、またはコードマネージャーへのアクセス権を持つ製品プロファイルに属するユーザーである必要があります。モジュールコードの取得メソッドは、Adobe Experience Platform のタグを含め、すべての実装方法で同じです。

実装に統合モジュールを配置する

サイトに Integrate Module を実装するには、Adobe Experience Platform Data Collection へのアクセスが必要です。 レガシー JavaScript 実装を使用する場合は、組織の Web サイトソースコードへのアクセスが必要になります。

統合モジュールのメソッド

統合モジュールが実装されたら、これらのメソッドを使用して、目的のアドビパートナーからデータを送受信するよう設定します。

追加

add メソッドはパートナーシステムと実装の間でデータを共有する際、変数データの中間記憶領域となる、パートナーオブジェクトをインスタンス化します。このメソッドは、すべての統合に必要です。1 件の実装で複数のパートナーを使用する場合は、各個別パートナーに対して個別のパートナーオブジェクトを使用する必要があります。

s.Integrate.add("<partner_name>");

通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。

beacon

beacon メソッドは、イメージリクエストを作成し、設定された URL を指します。これらのイメージリクエストは、標準のイメージリクエストとは異なります。ビーコンメソッドは、通常、アドビのデータ収集サーバーではなく、アドビのパートナーにデータを送信します。

p.beacon("<partner_url>/track?qs1=value1&qs2=value2");

通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。URL に含まれるクエリ文字列はオプションで、パートナーに依存します。ブラウザーのキャッシュを防ぐために、統合モジュールには、乱数を含むクエリ文字列が自動的に含まれます。

delay

アドビは、このメソッドを文書化するよう、社内チームと作業を進めています。

get

get メソッドを使用すると、クライアントはパートナー変数を読み込み、パートナーオブジェクトに保存できます。データがパートナーオブジェクトに含まれたら、Analytics 変数に割り当てられ、イメージリクエストで送信されます。このメソッドは、目的のデータを含む JSON オブジェクトを指す URL を呼び出します。

s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");

統合モジュールは、自動的に URL にクエリ文字列を追加します。var クエリ文字列は、モジュールがパートナーから返されるよう想定する JSON オブジェクトの名前を指定します。また、ブラウザーのキャッシュを防ぐために、乱数も追加されます。

Ready

アドビは、このメソッドを文書化するよう、社内チームと作業を進めています。

useVars

useVars メソッドを使用すると、クライアントは変数の値をアドビのパートナーと共有できます。

s.Integrate.<partner_name>.useVars = function (s,p) {
    p.<partner_var1> = s.eVar1;
    p.<partner_var2> = s.eVar2;
}

通常、組織はアドビのパートナーと協力して、パートナー名およびパートナーが使用する変数の値を決定します。

setVars

setVars メソッドを使用すると、クライアントは取得したパートナーデータを使用して Analytics 変数を設定できます。パートナーデータは、get メソッド、静的割り当て、またはパートナーオブジェクトにデータを入力するその他のメカニズムの結果にすることができます。

s.Integrate.<partner_name>.setVars = function (s,p) {
    s.eVar1 = p.<partner_var1>;
    s.eVar2 = p.<partner_var2>;
}

通常、組織はアドビのパートナーと協力して、パートナー名およびパートナーが使用する変数の値を決定します。

script

script メソッドを使用すれば、特定の条件が満たされた場合（例：campaign 変数が設定されている場合）に、アドビのパートナーがパートナーサイトから追加の JavaScript を呼び出すことができます。

p.script("<partner_url>/script?qs1=value1&qs2=value2");

通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。URL に含まれるクエリ文字列はオプションで、パートナーに依存します。ブラウザーのキャッシュを防ぐために、統合モジュールには、乱数を含むクエリ文字列が自動的に含まれます。