Show Menu
トピック×

Analytics for Target の実装

Adobe Analytics を Target のレポートソースとして実装する場合(A4T)には、いくつかの手順が必要になります。

実装手順

次の表は、サイト内でこの統合を実現するために必要な手順を説明しています。

手順1: Analytics と Target のプロビジョニングを依頼します。

Analytics を Target のレポートソースとして実装した後、Analytics および Target のプロビジョニングをおこなう必要があります。 このフォームを使用して、プロビジョニングをリクエストします

手順 2: ユーザー権限を設定します。

Adobe Target で Adobe Analytics ベースのアクティビティを作成するには、ユーザーアカウントの要件が満たされている必要があります。詳しくは、「 ユーザー権限の要件 を参照してください。

手順 3: Experience Cloud 訪問者 ID サービスを導入します。

訪問者 ID サービスによって、Experience Cloud ソリューション全体でユーザーを特定することができます。Experience Cloud 訪問者 ID の必要なバージョンを実装するか、そのバージョンに移行する必要があります。詳しくは、 実装する前に の「導入に必要な条件」を参照してください。
Experience Cloud ID サービスの Target への実装 (Experience Cloud 訪問者 ID サービスのドキュメント)を参照してください。

手順 4: AppMeasurement for JavaScript または s_code を更新します。

appMeasurement.js の必要なバージョンを実装するか、そのバージョンに移行する必要があります。詳しくは、 実装する前に の「導入に必要な条件」を参照してください。
新規導入の場合は、 Analytics導入ガイドの JavaScript導入の概要 を参照してください
移行については、 Analytics導入ガイドのJavaScript版AppMeasurementへの移行 を参照 してください

手順 5:at.js または mbox.js をダウンロードして更新します。

実稼動アカウントで使用する at.js または mbox.js の必要なバージョンを実装するか、そのバージョンに移行する必要があります。コードの修正は必要ありません。
詳しくは、 実装する前に の「導入に必要な条件」を参照してください。

手順 6: at.js または mbox.js をホストします。

at.js または mbox.js を事前にデプロイしている場合、既存のファイルを最新版に置き換えられます。詳しくは、 実装する前に の「導入に必要な条件」を参照してください。
配置していない場合は、最新のファイルを Visitor ID サービスおよび AppMeasurement for JavaScript のファイルとともにホストします。これらのファイルは、サイトのすべてのページからアクセス可能な Web サーバーでホストする必要があります。これらのファイルへのパスを、次の手順で使用します。

手順 7: サイトのすべてのページから at.js または mbox.js を参照します。

各ページのタグ内に以下のコードを追加して、VisitorAPI.js の下に at.js または mbox.js を含めます。
at.js の場合:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

mbox.js の場合:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/mbox.js"></script>

VisitorAPI.js は、at.js や mbox.js より先に読み込まれている必要があります。既存の at.js や mbox.js ファイルを更新中の場合、読み込む順序を必ず確認してください。
あらかじめ用意されている設定で、実装の観点から Target および Analytics の統合用に設定された方法は、ページから渡された SDID を使用して、Target および Analytics リクエストを共にバックエンドで自動的にスティッチします。
ただし、レポート目的で Target に関連する分析データを Analytics に送信する方法およびタイミングをより制御したい場合で、Target および Analytics で分析データを SDID で自動的にスティッチさせるデフォルト設定をオプトインしたくない場合、 window.targetGlobalSettings analyticsLogging = client_side を設定できます。注意:2.1 未満のバージョンでは、この方法をサポートしていません。
次に例を示します。
window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

この設定は全体的に影響します。つまり、at.js によっておこなわれた各呼び出しには、Target リクエストと共に送信された analyticsLogging: "client_side" があり、各リクエストに対して分析ペイロードが返されます。これが設定された場合、返されるペイロードの形式は、以下のようになります。
"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

グローバル設定は望まず、よりオンデマンドな方法が好ましい場合は、at.js 関数 getOffers() を使用して、 analyticsLogging: "client_side" に渡すことでこれを実現します。分析ペイロードはこの呼び出しに対してのみ返され、Target バックエンドは、ペイロードを Analytics に転送しません。この方法を続けることで、各 at.js Target リクエストはデフォルトではペイロードを返しませんが、代わりに、必要に応じて指定した場合に返します。
次に例を示します。
adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

この呼び出しは、分析ペイロードを抽出できる応答を呼び出します。
応答は以下のようになります。
{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

手順 8:実装を検証します。

JavaScript ライブラリを更新した後でページをロードして、Target 呼び出しの mboxMCSDID パラメーター値が Analytics ページビュー呼び出しの sdid パラメーター値と一致していることを確認します。
これは、呼び出しの命令が常に予測可能なわけではないシングルページアプリケーション(SPA)で確認することが特に重要です。
注意: A4T が正常に機能するために、これらの値が一致している必要があります。

手順 9: (オプション)以前の統合コードを削除します。

実装を簡単にし、異なるシステム間の不一致を解消する手間を省くために、以前の統合を削除することをお勧めします。以前の SC から T&T への統合のために設定したコードを、 mboxLoadSCPlugin を含めてすべて削除します。

手順 10: Analytics を Target のレポートソースとして使用するためのオプションを有効にします。

Target で、セットアップ/環境設定をクリックし、「アクティビティごとに選択」または「Adobe Analytics」を選択して、オプションを有効にします。
  • 「アクティビティごとに選択」を選択すると、各アクティビティの作成時に Target か Analytics かを選択できます。
  • 「Adobe Analytics」を選択すると、作成したすべてのアクティビティのレポートソースが Analytics に設定されます。