Analytics forTargetの実装

導入時には、いくつかの手順が必要です。 Adobe Analytics レポートソースとして Adobe Target (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: ユーザー権限を設定します。

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

手順 3:Edge 設定の作成

を使用して Edge 設定を作成する Adobe Experience Platform エッジ設定ツールを使用します。 の設定 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: ユーザー権限を設定します。

ユーザーアカウントの要件を満たしてから、 Analyticsのベースとなるアクティビティ Target. 詳しくは、 ユーザー権限の要件.

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

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

詳しくは、 Experience CloudID サービスの Target への実装Experience Cloud訪問者 ID サービス ドキュメント。

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

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

新規導入の場合は、 JavaScript 実装の概要Analytics 実装ガイド.

移行の場合は、 JavaScript 版 AppMeasurement への移行Analytics 実装ガイド.

手順 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 から Analytics レポート目的で使用します。 デフォルト設定 ( Target および Analytics は、SDID を使用して分析データを自動的にステッチし、 analyticsLogging = client_side 経由 window.targetGlobalSettings. 注意:2.1 未満のバージョンでは、この方法をサポートしていません。

次に例を示します。

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

この設定は全体的に影響します。つまり、at.js によっておこなわれるすべての呼び出しには次のようなものがあります。 analyticsLogging:"client_side" 送信される Target リクエストと analytics ペイロードは、リクエストごとに返されます。 このオプションを設定すると、返されるペイロードの形式は次のようになります。

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

ペイロードは、その後、 Data Insertion API. 自動配分と自動ターゲットアクティビティの場合は、sessionId も転送する必要があります。 詳しくは、 Analytics for Target(A4T) レポート Adobe Target SDK ガイド。

グローバル設定は望ましくなく、よりオンデマンドな方法が望ましい場合は、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"
        }
      }
    }]
  }
}

ペイロードは次の場所に転送できます: Analytics 経由 Data Insertion API.

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

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

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

メモ

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

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

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

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

In Targetをクリックし、 管理/レポート を選択し、 アクティビティごとに選択 または Adobe Analytics をクリックしてオプションを有効にします。

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

このページ