Analytics for Target の実装

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

導入手順

次の節では、この統合をサイトに導入するために必要な手順について説明します。

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

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

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

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

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

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

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

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

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

新しい導入方法については、『Analytics導入ガイド』の「JavaScript導入の概要」を参照してください。

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

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

実稼動アカウントを使用して、必要なバージョンの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>

at.jsの前にVisitorAPI.jsを読み込むことが不可欠です。既存のat.jsまたはmbox.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": {
   "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 TargetSDK​ガイドのターゲット用のAnalytics(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:実装を検証します。

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

これは、呼び出しの命令が常に予測可能なわけではないシングルページアプリケーション(SPA)で確認することが特に重要です。

注意: A4T が正常に機能するために、これらの値が一致している必要があります。

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

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

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

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

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

このページ