用途 Adobe Target および Web SDK パーソナライゼーションの
Adobe Experience Platform Web SDK では、で管理されるパーソナライズされたエクスペリエンスを配信およびレンダリングできます Adobe Target を web チャネルに追加します。 WYSIWYG エディタを使用できます。このエディタは、 Visual Experience Composer (VEC)、または非ビジュアルインターフェイス フォームベースの Experience Composerを使用して、アクティビティとパーソナライゼーションエクスペリエンスを作成、アクティブ化および配信します。
次の機能はテスト済みで、現在はでサポートされています。 Target:
Web SDK システム図
次の図は、 Target および Web SDK エッジ判定。
b.シングルページアプリケーション (SPA) のユーザーアクションの結果として表示されるビュー用にパーソナライズされたコンテンツはキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しなしで即座に適用できます。
。Edge ネットワークは、訪問者 ID とその他の値を Cookie で送信します(同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど)。
有効化 Adobe Target
有効にするには Target、次の操作を実行します。
- 有効にする Target の datastream を適切なクライアントコードに置き換えます。
- 次を追加:
renderDecisionsオプションをイベントに追加できます。
その後、オプションで、次のオプションも追加できます。
decisionScopes:イベントにこのオプションを追加して、特定のアクティビティ(フォームベースのコンポーザーで作成されたアクティビティで役立つ)を取得します。- スニペットを事前に非表示にする:ページの特定の部分のみを非表示にします。
Adobe Target VEC の使用
VEC を Web SDK 実装、インストール、アクティブ化 Firefox または クロム VEC ヘルパー拡張機能。
詳しくは、 Visual Experience Composer ヘルパー拡張機能 (内) Adobe Targetガイド.
パーソナライズされたコンテンツのレンダリング
詳しくは、 パーソナライゼーションコンテンツのレンダリング を参照してください。
XDM のオーディエンス
のオーディエンスを定義する際 Target 経由で配信されるアクティビティ Web SDK, XDM を定義して使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、 Target ターゲティング用に XDM データで定義されるオーディエンスルール。 Within Targetに値を指定しない場合、XDM データは Audience Builder をカスタムパラメーターとして設定します。 XDM は、ドット表記 ( 例えば、 web.webPageDetails.name) をクリックします。
次の条件を満たしている場合: Target アクティビティが事前に定義されたオーディエンスでカスタムパラメーターまたはユーザープロファイルを使用する場合、SDK を介して正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、 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 - を使用した Visual Experience Composer ベースの提案
renderAttemptedフラグをに設定true - を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案
renderAttemptedフラグをに設定true
表示時 — 変更時(キャッシュされた表示の場合):
- を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案
renderAttemptedフラグをに設定true
自動レンダリングが無効になっている場合、提案配列には次の情報が含まれます。
ページ読み込み時:
- Form-based Composer — ベース
propositions次を使用renderAttemptedフラグをに設定false - Visual Experience Composerに基づく提案
renderAttemptedフラグをに設定false - Visual Experience Composerを使用したシングルページアプリビューのベースの提案
renderAttemptedフラグをに設定false
表示時 — 変更時(キャッシュされた表示の場合):
- を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案
renderAttemptedフラグをに設定false
単一プロファイルの更新
The Web SDK を使用すると、プロファイルを Target プロファイルと Web SDK エクスペリエンスイベントとして。
を更新するには Target プロファイルで、プロファイルデータが次の情報と共に渡されていることを確認します。
- の下
"data {" - の下
"__adobe.target" - プレフィックス
"profile."
renderDecisionsdecisionScopes<String>xdmdata標準 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 属性と、それぞれが Web SDK:
Recommendations属性をAdobe Targetに送信する方法:
alloy("sendEvent", {
renderDecisions: true,
data: {
__adobe: {
target: {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
デバッグ
mboxTrace と mboxDebug は非推奨(廃止予定)となりました。 用途 Web SDK デバッグ.
用語
提案: In Adobe Targetの提案は、アクティビティから選択されたエクスペリエンスと相関関係を持ちます。
スキーマ: 決定のスキーマは、 Adobe Target.
範囲: 決定の範囲。 In Adobe Targetの場合、範囲は mBox です。 グローバル mBox は、 __view__ 範囲。
XDM: XDM はドット表記にシリアル化され、次に Adobe Target を mbox パラメーターとして設定します。