ドキュメントTargetTarget ガイド

Analytics for Target の実装

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Analytics を Adobe Target のレポートソースとして実装する場合（A4T）は、いくつかの手順が必要です。 プロセスは、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： ユーザー権限を設定します。

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

手順 3:Edge設定の作成

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

手順 4:Platform Web SDK をインストールして設定する

Target エクスペリエンスの配信を開始し、トラッキングと分析の目的で Analytics を適用するには、サイトページに Platform Web SDK を インストールおよび 設定します。

手順 5:A4T を使用するためのオプションを有効にする

Target の UI で、Administration/Visual Experience Composer をクリックし、Select per activity または Adobe Analytics を選択します。

  • Select per activity 各アクティビティの作成時に、Target から Analytics のいずれかを選択できます。
  • Adobe Analytics は、作成するすべてのアクティビティのレポートソースとして Analytics を設定します。

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

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

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

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

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

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

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

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

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

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

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

新規実装については、{Analytics 実装ガイド 🔗 の 0}JavaScript実装の概要 を参照してください。

移行については、Analytics 実装ガイドの JavaScriptのAppMeasurementへの移行 を参照してください。

手順 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 を使用するデフォルト設定のオプトインを希望せず、SDID を介して Analytics が自動的に分析データをステッチする場合は、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"
   }
}

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

グローバル設定を使用しない場合でよりオンデマンドのアプローチを使用したい場合は、at.js 関数 getOffers （）を使用して analyticsLogging: "client_side" を渡します。 Analytics のペイロードはこの呼び出しにのみ返され、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： 実装を検証します。 step8

JavaScript ライブラリを更新した後にページを読み込み、Target 呼び出しの mboxMCSDID パラメーター値が Analytics のページビュー呼び出しの sdid パラメーター値と一致することを確認します。

呼び出しの順序が常に予測可能とは限らない場合は、Single Page Applications （SPA）でこれらの値が一致することを確認することが特に重要です。

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

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

Adobeでは、以前の統合を削除して実装を簡素化し、システム間の不一致を整理する必要をなくすことをお勧めします。 mboxLoadSCPlugin など、以前の SC から T&T への統合にデプロイしたコードはすべて削除できます。

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

Target で、「Administration > Reporting」をクリックし、Select per activity または Adobe Analytics を選択してオプションを有効にします。

  • Select per activity 各アクティビティの作成時に、Target から Analytics のいずれかを選択できます。
  • Adobe Analytics は、作成するすべてのアクティビティのレポートソースとして Analytics を設定します。
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654