統合モジュールを使用すると、アドビのパートナーは自社のデータ収集作業を組織と統合できます。この統合により、双方向のデータ接続の機会が得られます。通常、統合モジュールの使用はアドビのパートナーが主導します。
実装でパートナーデータをリクエストすると、ページ読み込みとアドビのデータ収集サーバーに送信されるデータの間に遅延が生じる可能性があります。データの送信前に訪問者が新しいページを読み込んだ場合、そのページは記録されません。
get
リクエストを開始するページを読み込みます。get
要求を受け取り、適切な変数を JSON オブジェクトにパッケージ化します。JSON オブジェクトが返されます。setVars
を呼び出して JSON オブジェクトに含まれる情報を Adobe Analytics 変数に割り当てます。アドビのパートナーと連携している組織は、これらの手順を使用して統合モジュールの使用を正常に開始できます。
モジュールコードを取得するには、製品管理者のアクセス権を持つユーザー、またはコードマネージャーへのアクセス権を持つ製品プロファイルに属するユーザーである必要があります。モジュールコードの取得メソッドは、Adobe Experience Platform のタグを含め、すべての実装方法で同じです。
AppMeasurement_Module_Integrate.js
を見つけます。サイトに統合モジュールを実装するには、Adobe Experience Platformデータ収集にアクセスする必要があります。 レガシー JavaScript 実装を使用する場合は、組織の Web サイトソースコードへのアクセスが必要になります。
統合モジュールが実装されたら、これらのメソッドを使用して、目的のアドビパートナーからデータを送受信するよう設定します。
add
メソッドはパートナーシステムと実装の間でデータを共有する際、変数データの中間記憶領域となる、パートナーオブジェクトをインスタンス化します。このメソッドは、すべての統合に必要です。1 件の実装で複数のパートナーを使用する場合は、各個別パートナーに対して個別のパートナーオブジェクトを使用する必要があります。
s.Integrate.add("<partner_name>");
通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。
beacon
メソッドは、イメージリクエストを作成し、設定された URL を指します。これらのイメージリクエストは、標準のイメージリクエストとは異なります。ビーコンメソッドは、通常、アドビのデータ収集サーバーではなく、アドビのパートナーにデータを送信します。
p.beacon("<partner_url>/track?qs1=value1&qs2=value2");
通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。URL に含まれるクエリー文字列はオプションで、パートナーに依存します。ブラウザーのキャッシュを防ぐために、統合モジュールには、乱数を含むクエリー文字列が自動的に含まれます。
アドビは、このメソッドを文書化するよう、社内チームと作業を進めています。
get
メソッドを使用すると、クライアントはパートナー変数を読み込み、パートナーオブジェクトに保存できます。データがパートナーオブジェクトに含まれたら、Analytics 変数に割り当てられ、イメージリクエストで送信されます。このメソッドは、目的のデータを含む JSON オブジェクトを指す URL を呼び出します。
s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");
統合モジュールは、自動的に URL にクエリー文字列を追加します。var クエリー文字列は、モジュールがパートナーから返されるよう想定する JSON オブジェクトの名前を指定します。また、ブラウザーのキャッシュを防ぐために、乱数も追加されます。
アドビは、このメソッドを文書化するよう、社内チームと作業を進めています。
useVars
メソッドを使用すると、クライアントは変数の値をアドビのパートナーと共有できます。
s.Integrate.<partner_name>.useVars = function (s,p) {
p.<partner_var1> = s.eVar1;
p.<partner_var2> = s.eVar2;
}
通常、組織はアドビのパートナーと協力して、パートナー名およびパートナーが使用する変数の値を決定します。
setVars
メソッドを使用すると、クライアントは取得したパートナーデータを使用して Analytics 変数を設定できます。パートナーデータは、get
メソッド、静的割り当て、またはパートナーオブジェクトにデータを入力するその他のメカニズムの結果にすることができます。
s.Integrate.<partner_name>.setVars = function (s,p) {
s.eVar1 = p.<partner_var1>;
s.eVar2 = p.<partner_var2>;
}
通常、組織はアドビのパートナーと協力して、パートナー名およびパートナーが使用する変数の値を決定します。
script
メソッドを使用すれば、特定の条件が満たされた場合(例:campaign 変数が設定されている場合)に、アドビのパートナーがパートナーサイトから追加の JavaScript を呼び出すことができます。
p.script("<partner_url>/script?qs1=value1&qs2=value2");
通常、組織はアドビのパートナーと連携してパートナー名の値を決定します。URL に含まれるクエリー文字列はオプションで、パートナーに依存します。ブラウザーのキャッシュを防ぐために、統合モジュールには、乱数を含むクエリー文字列が自動的に含まれます。