Analytics forTarget の実装

Adobe AnalyticsをAdobe Target (A4T)のレポートソースとして実装する場合は、いくつかの手順が必要です。 プロセスは、A4TをAdobe Experience Platform Web SDKで実装するか、at.jsで実装するかによって異なります。

Adobe Experience Platform Web SDKバッ ジAdobe Experience Platform Web SDK実装の実装手順

以下の節では、Platform Web SDKを使用する予定の場合に、この統合をサイトにデプロイするために必要な手順を説明します。

手順1:AnalyticsとTargetのプロビジョニングをリクエストします

A4Tを実装する前に、AnalyticsとTargetのプロビジョニングをおこなう必要があります。 プロビジョニングの依頼にはこのフォームを使用します

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

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

手順3:Edge設定の作成

エッジ設定ツールを使用して、Adobe Experience Platform Launchを使用してEdge設定を作成します。 Analytics and Target エッジ設定を設定します。

手順4:Platform Web SDKのインストールと設定

Targetエクスペリエンスの配信を開始し、追跡や分析のためにAnalyticsを適用するには、サイトページに🔗Platform Web SDKを設定します。

手順5:A4T使用のオプションの有効化

Target UIで、管理 / Visual Experience Composer​をクリックし、「アクティビティごとに選択」または「Adobe Analytics」を選択します。

  • **「アクティビティごとに選択」を選択すると、各アクティビティの作成時に か かを選択できます。**TargetAnalytics
  • **「Adobe 」を選択すると、作成したすべてのアクティビティのレポートソースが Analytics に設定されます。**Analytics

at.jsバッ ジat.js実装の実装手順

次の節では、at.jsを使用する予定の場合に、この統合をサイトにデプロイするために必要な手順を説明します。

手順1:AnalyticsとTargetのプロビジョニングをリクエストする

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

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

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

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

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

Experience Cloud訪問者IDサービス​のドキュメントのTarget用Experience CloudIDサービスの実装を参照してください。

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

必要なバージョンのappMeasurement.jsを実装するか、そのバージョンに移行します。 詳しくは、実装する前にの「導入に必要な条件」を参照してください。

新しい実装については、『Analytics実装ガイド』の「JavaScript実装の概要」を参照してください。**

移行の場合は、『Analytics導入ガイド』のJavaScript版AppMeasurementへの移行​を参照してください。

手順5:at.jsのダウンロードと更新

実稼動アカウントを使用して、必要なバージョンのat.jsを実装するか、そのバージョンに移行します。 コードの修正は必要ありません。

詳しくは、実装する前にの「導入に必要な条件」を参照してください。

手順6:at.jsのホスト

以前にat.jsをデプロイしている場合は、既存のファイルを最新バージョンに置き換えます。 詳しくは、実装する前にの「導入に必要な条件」を参照してください。

配置していない場合は、最新のファイルを Visitor ID サービスおよび AppMeasurement for JavaScript のファイルとともにホストします。これらのファイルは、サイトのすべてのページからアクセス可能な Web サーバーでホストする必要があります。これらのファイルへのパスを、次の手順で使用します。

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

各ページのタグ内に次のコードを追加して、VisitorAPI.jsの下にat.jsを含めます。

at.js の場合:

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

VisitorAPI.jsは、at.jsの前に読み込む必要があります。 既存のat.jsファイルを更新する場合は、必ず読み込み順序を確認してください。

実装の観点から見ると、TargetとAnalytics統合のデフォルト設定は、ページから渡されたSDIDを使用して、TargetリクエストとAnalyticsリクエストをバックエンドで自動的にステッチすることです。

Targetに関連する分析データをレポート目的でいつどのように送信するかを制御できます。 AnalyticsSDIDを使用してTargetとAnalyticsで分析データを自動的にステッチするデフォルト設定をオプトインしない場合は、window.targetGlobalSettings​を使用して​analyticsLogging = client_side​を設定します。 注意:2.1 未満のバージョンでは、この方法をサポートしていません。

次に例を示します。

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

この設定は全体的に影響します。つまり、at.jsによるすべての呼び出しに​analyticsLogging:Targetリクエスト内で送信された「client_side」​と、各リクエストに対して分析ペイロードが返されます。 このオプションを設定すると、返されるペイロードの形式は次のようになります。

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

ペイロードは、その後、Data Insertion APIを使用してAnalyticsに転送できます。 自動配分および自動ターゲットアクティビティの場合は、 sessionIdも転送する必要があります。 詳しくは、『Adobe Target SDK』ガイドのAnalytics for Target(A4T)レポートを参照してください。

グローバル設定は望ましくなく、よりオンデマンドな方法が望ましい場合は、analyticsLoggingを渡すことで、at.js関数getOffers()を使用します。"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"
        }
      }
    }]
  }
}

ペイロードは、その後、Data Insertion APIを使用してAnalyticsに転送できます。

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

JavaScript ライブラリを更新した後でページをロードして、 呼び出しの mboxMCSDIDTarget パラメーター値が ページビュー呼び出しの sdidAnalytics パラメーター値と一致していることを確認します。

呼び出しの順序が常に予測可能とは限らないシングルページアプリケーション(SPA)で、これらの値が一致することを確認することが特に重要です。

メモ

A4Tが正しく機能するには、これらの値の一致が必要です。

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

Adobeでは、実装を簡略化し、システム間の不一致を解消する手間を省くために、以前の統合を削除することをお勧めします。 以前のSCからT&Tへの統合用にデプロイしたコードを、mboxLoadSCPluginを含めてすべて削除できます。

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

Targetで、管理/Visual Experience Composer​をクリックし、「アクティビティごとに選択」または「Adobe Analytics」を選択してオプションを有効にします。

  • **「アクティビティごとに選択」を選択すると、各アクティビティの作成時に か かを選択できます。**TargetAnalytics
  • **「Adobe 」を選択すると、作成したすべてのアクティビティのレポートソースが Analytics に設定されます。**Analytics

このページ