Target実装用Analytics
Adobe Target (A4T)のレポートソースとしてAdobe Analyticsを実装する場合は、いくつかの手順が必要です。 プロセスは、Adobe Experience Platform Web SDKでA4Tを実装するか、at.jsで実装するかによって異なります。
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をクリックし、アクティビティごとに選択または Adobe Analytics のいずれかを選択します。
- アクティビティごとに選択すると、各アクティビティの作成時にTargetからAnalyticsを選択できます。
- Adobe Analyticsは、作成するすべてのアクティビティのレポートソースとしてAnalyticsを設定します。
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の必要なバージョンを実装または移行します。 詳しくは、実装する前にの「導入に必要な条件」を参照してください。
Experience Cloud Visitor ID Service ドキュメントの「Target用Experience Cloud ID サービスの実装」を参照してください。
手順 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を参照する 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を介して分析データを自動的に合成するというデフォルト設定をオプトインしない場合は、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: "client_side"を渡してat.js関数getOffers () を使用します。 この呼び出しにのみ分析ペイロードが返され、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 パラメーター値と一致することを確認します。
特に、呼び出しの順序が必ずしも予測可能ではないシングルページアプリケーション(SPA)でこれらの値が一致することを確認することが重要です。
手順 9: (オプション)以前の統合コードを削除します。
Adobeでは、導入を簡素化し、システム間の不一致を整理する必要がないように、以前の統合を削除することをお勧めします。 以前のSCからT&Tへの統合にデプロイしたコード(mboxLoadSCPluginを含む)を削除できます。
手順 10: Analytics を Target のレポートソースとして使用するためのオプションを有効にします。
Targetで、管理/ レポートをクリックし、アクティビティごとに選択または Adobe Analytics のいずれかを選択して、オプションを有効にします。
- アクティビティごとに選択すると、各アクティビティの作成時にTargetからAnalyticsを選択できます。
- Adobe Analyticsは、作成するすべてのアクティビティのレポートソースとしてAnalyticsを設定します。