Adobe Experience Platform Web SDK では、で管理されるパーソナライズされたエクスペリエンスを配信およびレンダリングできます Adobe Target を web チャネルに追加します。 WYSIWYG エディタを使用できます。このエディタは、 Visual Experience Composer (VEC)、または非ビジュアルインターフェイス フォームベースの Experience Composerを使用して、アクティビティとパーソナライゼーションエクスペリエンスを作成、アクティブ化および配信します。
を使用して Target 実装を Platform Web SDK に移行する方法について説明します。 at.js 2.x から Platform Web SDK への Target の移行 チュートリアル
Target を初めて実装する際に、 Web SDK を使用したAdobe Experience Cloudの実装 チュートリアル Target に固有の情報については、「 」というタイトルのチュートリアルの節を参照してください。 Platform Web SDK での Target の設定.
次の機能はテスト済みで、現在はでサポートされています。 Target:
次の図は、 Target および Platform Web SDK エッジ判定。
を呼び出します | 詳細 |
---|---|
1 | デバイスが Platform Web SDK. この Platform Web SDK は、XDM データ、Datastreams 環境 ID、渡されたパラメーターおよび顧客 ID(オプション)を使用して、エッジネットワークにリクエストを送信します。 ページ(またはコンテナ)は事前に非表示になっています。 |
2 | エッジネットワークは、エッジサービスにリクエストを送信し、訪問者 ID、同意、その他の訪問者のコンテキスト情報(位置情報やデバイスにわかりやすい名前など)でエンリッチメントします。 |
3 | エッジネットワークは、エンリッチメントされたパーソナライゼーションリクエストを Target エッジに貼り付け、訪問者 ID および渡されたパラメーターを含める必要があります。 |
4 | プロファイルスクリプトが実行されてから、 Target プロファイルストレージ。 プロファイルストレージは、 オーディエンスライブラリ ( 例: Adobe Analytics, Adobe Audience Manager、 Adobe Experience Platform) をクリックします。 |
5 | URL リクエストパラメーターとプロファイルデータに基づき、 Target は、現在のページビューと今後のプリフェッチされたビューに対して、訪問者に対して表示するアクティビティとエクスペリエンスを決定します。 Target 次に、これを edge ネットワークに送り返します。 |
6 | a.Edge ネットワークは、パーソナライゼーション応答を(オプションで、追加のパーソナライゼーションに関するプロファイル値を含めて)ページに送り返します。 デフォルトコンテンツがちらつくことなく、可能な限り迅速に現在のページ上のパーソナライズされたコンテンツが表示されます。 b.シングルページアプリケーション (SPA) でのユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツはキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しを必要とせずに、即座に適用できます。 c.エッジネットワークは、同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど、訪問者 ID とその他の値を Cookie で送信します。 |
7 | エッジネットワークが転送されます Analytics for Target (A4T) Analytics エッジです。 |
有効にするには Target、次の操作を実行します。
renderDecisions
オプションをイベントに追加できます。その後、オプションで、次のオプションも追加できます。
decisionScopes
:イベントにこのオプションを追加して、特定のアクティビティ(フォームベースのコンポーザーで作成されたアクティビティで役立つ)を取得します。VEC を Platform Web SDK 実装、インストール、アクティブ化 Firefox または クロム VEC ヘルパー拡張機能。
詳しくは、 Visual Experience Composer ヘルパー拡張機能 内 Adobe Targetガイド.
詳しくは、 パーソナライゼーションコンテンツのレンダリング を参照してください。
のオーディエンスを定義する際 Target 経由で配信されるアクティビティ Platform Web SDK, XDM を定義して使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、 Target ターゲティング用に XDM データで定義されるオーディエンスルール。 内 Targetに値を指定しない場合、XDM データは Audience Builder をカスタムパラメーターとして設定します。 XDM は、ドット表記を使用してシリアル化されます ( 例: web.webPageDetails.name
) をクリックします。
次の場合: Target アクティビティが事前に定義されたオーディエンスでカスタムパラメーターまたはユーザープロファイルを使用する場合、SDK を介して正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、 Platform Web SDK XDM を必要としない これらのフィールドは、 Target XDM を必要としない UI:
詳しくは、 オーディエンスのカテゴリ 内 Adobe Targetガイド.
レスポンストークンは主に、Google、Facebookなどのサードパーティにメタデータを送信するために使用されます。 レスポンストークンは meta
~の中のフィールド propositions
-> items
. 次に例を示します。
{
"id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
"scope": "__view__",
"scopeDetails": ...,
"renderAttempted": true,
"items": [
{
"id": "0",
"schema": "https://ns.adobe.com/personalization/dom-action",
"meta": {
"experience.id": "0",
"activity.id": "126736",
"offer.name": "Default Content",
"offer.id": "0"
}
}
]
}
レスポンストークンを収集するには、サブスクライブする必要があります。 alloy.sendEvent
約束、反復する propositions
詳細を抽出する items
-> meta
. 毎 proposition
には、 renderAttempted
ブール型フィールドで、 proposition
がレンダリングされたかどうか。 以下のサンプルを参照してください。
alloy("sendEvent",
{
renderDecisions: true,
decisionScopes: [
"hero-container"
]
}).then(result => {
const { propositions } = result;
// filter rendered propositions
const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);
// collect the item metadata that represents the response tokens
const collectMetaData = (items) => {
return items.filter(item => item.meta !== undefined).map(item => item.meta);
}
const pageLoadResponseTokens = renderedPropositions
.map(proposition => collectMetaData(proposition.items))
.filter(e => e.length > 0)
.flatMap(e => e);
});
自動レンダリングが有効な場合、提案配列には次の情報が含まれます。
propositions
と renderAttempted
フラグを false
renderAttempted
フラグを true
renderAttempted
フラグを true
renderAttempted
フラグを true
自動レンダリングが無効になっている場合、提案配列には次の情報が含まれます。
propositions
と renderAttempted
フラグを false
renderAttempted
フラグを false
renderAttempted
フラグを false
renderAttempted
フラグを false
この Platform Web SDK を使用すると、プロファイルを Target プロファイルと Platform Web SDK エクスペリエンスイベントとして。
を更新するには Target プロファイルで、プロファイルデータが次の情報と共に渡されていることを確認します。
"data {"
"__adobe.target"
"profile."
例:以下キー | タイプ | 説明 |
---|---|---|
renderDecisions |
ブール値 | パーソナライゼーションコンポーネントに DOM アクションを解釈するかどうかを指定します |
decisionScopes |
配列 <String> |
決定を取得するスコープのリスト |
xdm |
オブジェクト | XDM で形式設定されたデータで、Platform Web SDK にエクスペリエンスイベントとして読み込まれます |
data |
オブジェクト | に送信される任意のキーと値のペア Target target クラスのソリューション。 |
標準 Platform Web SDK このコマンドを使用するコードは、次のようになります。
sendEvent
プロファイルデータを使用
alloy("sendEvent", {
renderDecisions: true|false,
xdm: { // Experience Event XDM data },
data: { // Freeform data }
});
プロファイル属性をAdobe Targetに送信する方法:
alloy("sendEvent", {
renderDecisions: true,
data: {
__adobe: {
target: {
"profile.gender": "female",
"profile.age": 30
}
}
}
});
次の表に、 Recommendations 属性と、それぞれが Platform Web SDK:
カテゴリ | 属性 | サポートステータス |
---|---|---|
Recommendations — デフォルトのエンティティ属性 | entity.id | サポートあり |
entity.name | サポートあり | |
entity.categoryId | サポートあり | |
entity.pageUrl | サポートあり | |
entity.thumbnailUrl | サポートあり | |
entity.message | サポートあり | |
entity.value | サポートあり | |
entity.inventory | サポートあり | |
entity.brand | サポートあり | |
entity.margin | サポートあり | |
entity.event.detailsOnly | サポートあり | |
Recommendations — カスタムエンティティの属性 | entity.yourCustomAttributeName | サポートあり |
Recommendations — 予約済みの mbox/ページパラメーター | excludedIds | サポートあり |
cartIds | サポートあり | |
productPurchasedId | サポートあり | |
カテゴリ親和性のページまたは品目カテゴリ | user.categoryId | サポートあり |
Recommendations属性をAdobe Targetに送信する方法:
alloy("sendEvent", {
renderDecisions: true,
data: {
__adobe: {
target: {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
mboxTrace と mboxDebug は非推奨(廃止予定)となりました。 用途 Platform Web SDK デバッグ.
提案: In Targetの提案は、アクティビティから選択されたエクスペリエンスと相関関係を持ちます。
スキーマ: 決定のスキーマは、 Target.
範囲: 決定の範囲。 In Targetの場合、範囲は mBox です。 グローバル mBox は __view__
範囲。
XDM: XDM はドット表記にシリアル化され、次に Target を mbox パラメーターとして設定します。