Analytics for AdvertisingのJavaScript コード

Advertising DSPのみの広告主

Advertising DSPの場合、Analytics for Advertising統合は、ビュースルーとクリックスルーのサイトインタラクションを追跡します。 クリックスルー訪問は、web ページ上の標準のAdobe Analytics コードによって追跡されます。Analytics コードは、ランディングページ URLのAMO IDおよびEF ID パラメーターをキャプチャし、それぞれの予約eVarsで追跡します。 JavaScriptスニペットをweb ページにデプロイすることで、ビュースルー訪問を追跡できます。

Adobe Advertising JavaScriptのコードにより、サイトへの訪問の最初のページビューで、訪問者が以前に広告を見たりクリックしたりしたことがあるかどうかを確認します。 ユーザーがクリックスルーでサイトにアクセスしたことがある、広告が表示されていない場合、訪問者は無視されます。 Adobe Advertising内で設定された​ クリックルックバックウィンドウ ​の間に、訪問者が広告を見てクリックスルーでサイトに入っていない場合、Adobe Advertising JavaScript コードは、a)がExperience Cloud ID サービス ​を使用して追加ID (SDID)を生成するか、b)がAdobe Experience Platform Web SDK generateRandomID メソッドを使用してStitchIDを生成します。 どちらのIDも、Adobe Advertisingから訪問者のAdobe Analytics ヒットにデータを合成するために使用されます。 次に、Adobe AnalyticsはAdobe Advertisingに対して、広告露出に関連付けられたAMO IDとEF IDを問い合わせます。 次に、AMO IDとEF IDがそれぞれのeVarsに入力されます。 これらの値は、指定した期間(デフォルトでは60日)保持されます。

Analyticsは、EF IDをキーとして使用して、サイトトラフィック指標(ページビュー、訪問数、滞在時間など)とAnalytics個のカスタムイベントまたは標準イベントをAdobe Advertisingに毎時送信します。 これらのAnalytics指標は、Adobe Advertisingアトリビューションシステムを通じて実行され、コンバージョンをクリック履歴や露出の履歴に結び付けます。

NOTE
Adobe Advertising JavaScriptのトラッキングロジックはAdobe側で実行されるため、ページの読み込み時間にほとんど影響しません。
対照的に、Advertising DSPのDCM データコネクタのAnalyticsへのロジック(Google Campaign Manager 360を使用)は、クライアント側で実行されます。 クライアント側でステッチングをおこなうと、ページの読み込みが遅くなり、データが失われるリスクが高まります。 これは、Analytics JavaScriptがDoubleClickにpingを送信し、DoubleClickが最後のクリック/インプレッションデータをAnalyticsに返すのを待つ必要があるために発生します。 DSP チームがDCM データコネクタを設定する際は、ページを遅延させる期間を指定する必要があります。

JavaScript コードのデプロイ

JavaScript ライブラリは、AnalyticsとAdobe Advertisingが互いに通信できる2行で構成されています。 Adobe Advertisingの実装中にAnalytics for Advertising統合が完了した場合は、このコードを既に受け取っている必要があります。このコードには、デプロイ方法に関する説明が記載されています。

コード

Experience Cloud Identity Service visitorAPI.js コードを使用する実装

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          AdCloudEvent('IMS ORG Id','rsid');
</script>

Experience Platform Web SDK alloy.js コードを使用する実装

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          stitchId = AdCloudEvent('IMS ORG Id','rsid').generateRandomId();
</script>

コードを配置する場所

Analytics for Advertising JavaScript関数は、Experience Cloud ID サービスの後で、Analytics アプリ測定コードの前に指定する必要があります。 これにより、補足ID (SDID)またはStitchIDがAnalytics呼び出しに含まれるようになります。

​ コード プレースメント ​

コード展開の検証

任意のパケットスニファの種類のツール(Charles、Fiddler、Chrome Developer Toolsなど)を使用して検証を実行するには、次に示すように、Adobe Advertisingに送信するリクエストとAnalyticsに送信するリクエストの4つのIDの値を比較します。

Chrome Developer Toolsでコードを確認する方法 validate-js-chrome

  1. Chrome Developer Toolsを開き、「ネットワーク」タブをクリックします。

  2. Analytics for Advertising JavaScriptを含むweb サイト ページを読み込みます。

  3. Network タブをlastでフィルタリングし、2行を確認します。

    最後のにフィルターを実行しています

    • 最初の行はJavaScript ライブラリへの呼び出しであり、タイトルはlast-event-tag-latest.min.jsです。

    • 2行目は、Adobe Advertisingにリクエストを送信する呼び出しです。 次のように始まります:_les_imsOrgId=[your_imsOrgId_here]&_les_url=[your_encoded_url]

      Adobe Advertisingへの呼び出しが表示されない場合は、訪問の最初のページビューではない可能性があります。 テストの目的で、次の呼び出しが対応する訪問の最初のページビューになるように、Cookieを削除できます。

    1. 「アプリケーション」タブで、adcloud Cookieを見つけ、Cookieに_les_v (前回の訪問)の値yと30分で有効期限が切れるUTC エポックタイムスタンプが含まれていることを確認します。
      1. adcloud Cookieを削除してページを更新します。
  4. /b/ssのExperience Cloud ID サービス visitorAPI.js コードを使用する実装)フィルターを使用して、Analytics ヒットを確認します。

    ​ フィルター:/b/ss

  5. (Edge NetworkへのリクエストペイロードにadvertisingStitchIDが含まれていることを確認するために、/interactでExperience Platform Web SDK alloy.js コード)フィルターを使用する実装。

    ​ フィルター:/interact

  6. 2つのヒット間のID値を比較します。 すべての値は、Analytics ヒットのレポートスイート ID (/b/ss/の直後のURL パス)を除いて、クエリ文字列パラメーターにする必要があります。

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
    ID Analytics パラメーター Edge Network Adobe Advertising パラメーター
    Experience Cloud IMS組織 mcorgid _les_imsOrgid
    補足データ ID sdid _les_sdid
    ステッチ ID stitchId _adcloud プロパティのadvertisingStitchID
    Analytics レポートスイート /b/ss/の後の値 _les_rsid
    Experience Cloud訪問者ID _les_mid

    ID値が一致する場合は、JavaScriptの実装が確定されます。 Adobe Advertisingは、クリックスルーまたはビュースルーのトラッキングの詳細が存在する場合、その詳細をAnalytics サーバーに送信します。

Adobe Experience Platform Debuggerでコードを確認する方法

  1. ホームページでthe Adobe Experience Platform Debuggerを開きます。

  2. 「Network」タブに移動します。

  3. Solutions Filter ツールバーで、Adobe AdvertisingとAnalyticsをクリックします。

  4. Request URL - Hostname パラメーター行で、lasteventf-tm.everesttech.netを見つけます。

  5. ​ コードを Chrome Developer Toolsで確認する方法」のステップ 3と同様に、Request - Parameters行で、生成されたシグナルを監査します。

    • (Implementations that use the Experience Cloud Identity Service visitorAPI.js code) Make sure the Sdid parameter matches the Supplemental Data ID in the Adobe Analytics filter.
    • (Implementations that use the Experience Platform Web SDK alloy.jscode) Make sure the value of the advertisingStitchID parameter matches the Sdid sent to the Experience Platform Edge Network.
    • If the code isn’t generating, then check to make sure the Adobe Advertising cookie has been removed in the Application tab. Once it’s removed, refresh the page and repeat the process.

    Auditing Analytics for Advertising JavaScript code in Platform Cloud Debugger

recommendation-more-help
advertising-help-integrations