ドキュメントTargetTarget ガイド

の分析 Target 実装

Last update: Thu Mar 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

導入時には、いくつかの手順が必要です。 Adobe Analytics レポートソースとして Adobe Target (A4T)。 プロセスは、 Adobe Experience Platform Web SDK または at.js を使用します。

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

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

手順 1：用のプロビジョニングをリクエストする Analytics および Target

A4T を実装する前に、 Analytics および Target. プロビジョニングの依頼にこのフォームを使用します.

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

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

手順 3:Edge 設定の作成

を使用して Edge 設定を作成する Adobe Experience Platform エッジ設定ツールを使用します。 を設定します。 データストリームの作成と設定.

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

配信を開始するには Target エクスペリエンスと適用 Analytics 追跡や分析のために インストール および 設定 サイトページ上の Platform Web SDK。

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

Adobe Analytics の Target UI、クリック Administration > Visual Experience Composer ​次に、次のいずれかを選択します。 Select per activity または Adobe Analytics.

  • Select per activity 次の中から選択できます。 Target および Analytics 各アクティビティを作成する際に使用します。
  • Adobe Analytics sets Analytics を作成するすべてのアクティビティのレポートソースとして使用する。

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

次の節では、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 を参照します。 step7

各ページのタグ内に次のコードを追加して、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： 実装を検証します。 step8

JavaScript ライブラリを更新した後にページを読み込み、 mboxMCSDID パラメータ値 Target 呼び出しが sdid パラメーター値 Analytics ページビュー呼び出し。

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

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

手順 9： （オプション）以前の統合コードを削除します。

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

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

In Targetをクリックし、 Administration > Reporting を選択し、次のいずれかを選択します。 Select per activity または Adobe Analytics をクリックしてオプションを有効にします。

  • Select per activity 次の中から選択できます。 Target および Analytics 各アクティビティを作成する際に使用します。
  • Adobe Analytics sets Analytics を作成するすべてのアクティビティのレポートソースとして使用する。
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654