パーソナライゼーションへの Adobe Target と Web SDK の使用
Adobe Experience Platform Web SDK は、web チャネルに Adobe Target して管理され、パーソナライズされたエクスペリエンスを配信およびレンダリングできます。 Visual Experience Composer (VEC)、非ビジュアルベースのインターフェイス フォームベースの Experience Composer と呼ばれる WYSIWYG エディターを使用して、アクティビティとパーソナライゼーションエクスペリエンスを作成、アクティブ化および配信できます。
次の機能はテスト済みで、現在 Target でサポートされています。
Web SDK システム図
次の図は、Target と Web SDK edge decisioning のワークフローを理解するのに役立ちます。
b.シングルページアプリケーション(SPA)でのユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツは、キャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しをおこなわずに即座にコンテンツを適用できます。
c.Edge Networkは、訪問者 ID と Cookie のその他の値(同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど)を送信します。
Adobe Target の有効化
Target を有効にするには、次の手順を実行します。
- 適切なクライアントコードを使用して、 データストリームの Target を有効にします。
- イベントに「
renderDecisions
」オプションを追加します。
その後、オプションで、次のオプションも追加できます。
decisionScopes
:イベントにこのオプションを追加して、特定のアクティビティ(フォームベースのコンポーザーで作成されたアクティビティで役立つ)を取得します。- スニペットを事前非表示:ページの特定の部分のみを非表示にします。
Adobe Target VEC の使用
Web SDK 実装で VEC を使用するには、{Firefox🔗 または 3}Chrome VEC Helper 拡張機能をインストールして有効化します。
詳しくは、Adobe Targetガイドの Visual Experience Composer ヘルパー拡張機能を参照してください。
パーソナライズされたコンテンツのレンダリング
詳しくは、 パーソナライゼーションコンテンツのレンダリングを参照してください。
XDM でのオーディエンス
Web SDK を介して配信される Target アクティビティのオーディエンスを定義する場合は、XDM を定義し、使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、XDM データで定義されたターゲティング用の Target オーディエンスルールを作成できます。 Target 内では、XDM データは Audience Builder にカスタムパラメーターとして表示されます。 XDM は、ドット表記(web.webPageDetails.name
など)を使用してシリアル化されます。
カスタムパラメーターまたはユーザープロファイルを使用する、事前に定義されたオーディエンスを持つ Target アクティビティがある場合、そのアクティビティは SDK 経由で正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、Web SDK を介してサポートされている標準搭載のオーディエンスターゲティングフィールドのうち、XDM を必要としないものがあります。 これらのフィールドは、XDM を必要としない Target UI で使用できます。
- ターゲットライブラリ
- ジオ
- ネットワーク
- オペレーティングシステム
- サイトページ
- ブラウザー
- トラフィックソース
- 時間枠
詳しくは、Adobe Target ガイド オーディエンスのカテゴリを参照してください。
レスポンストークン
レスポンストークンは、GoogleやFacebookなどのサードパーティにメタデータを送信するために使用されます。 レスポンストークンが返されますpropositions
-> items
内の meta
フィールドに移動します。 次に例を示します。
{
"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"
}
}
]
}
応答トークンを収集するには、promise を購読し、propositions
を繰り返し処理 alloy.sendEvent
、items
~ meta
から詳細を抽出する必要があります。
すべての proposition
には、proposition
がレンダリングされたかどうかを示す renderAttempted
しいブール値フィールドがあります。 以下のサンプルを参照してください。
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);
});
自動レンダリングが有効な場合、提案の配列には次が含まれます。
ページ読み込み時:
renderAttempted
フラグをfalse
に設定したフォームベースの Composer ベースのpropositions
renderAttempted
フラグをtrue
に設定した Visual Experience Composer ベースの提案- フラグが
true
に設定されたシングルページアプリケーションビューrenderAttempted
Visual Experience Composer ベースの提案
表示時 – 変更(キャッシュされたビュー用):
- フラグが
true
に設定されたシングルページアプリケーションビューrenderAttempted
Visual Experience Composer ベースの提案
自動レンダリングが無効の場合、提案の配列には次が含まれます。
ページ読み込み時:
renderAttempted
フラグがfalse
に設定された Form-based Composer ベースのpropositions
renderAttempted
フラグがfalse
に設定された Visual Experience Composer ベースの提案- フラグが
false
に設定されたシングルページアプリケーションビューrenderAttempted
対する Visual Experience Composer ベースの提案
表示時 – 変更(キャッシュされたビュー用):
- フラグが
false
に設定されたシングルページアプリケーションビューrenderAttempted
Visual Experience Composer ベースの提案
単一プロファイルの更新
Web SDK を使用すると、プロファイルを Target プロファイルに更新したり、エクスペリエンスイベントとして Web SDK に更新したりできます。
Target プロファイルを更新するには、プロファイルデータに次の情報が渡されていることを確認します。
"data {"
未満"__adobe.target"
未満- プレフィックス
"profile."
renderDecisions
decisionScopes
<String>
xdm
data
コンテンツがエンドユーザーに表示されるまで、プロファイルまたはエンティティパラメーターの保存を遅延させる
コンテンツが表示されるまでプロファイルの属性の記録を遅延させるには、リクエストで data.adobe.target._save=false
を設定します。
例えば、Web サイトには、Web サイト上の 3 つのカテゴリリンク(男性、女性および子供)に対応する 3 つの決定範囲が含まれており、ユーザーが最終的に訪問したカテゴリを追跡したいとします。 コンテンツがリクエストされた時点でカテゴリが持続しないように、__save
フラグを false
に設定してこれらのリクエストを送信します。 コンテンツを視覚化したら、対応する属性が記録されるように、適切なペイロード(eventToken
と stateToken
を含む)を送信します。
次の例では、trackEvent スタイルのメッセージを送信し、プロファイルスクリプトを実行して、属性を保存し、イベントを直ちに記録します。
alloy("sendEvent", {
"renderDecisions": true,
"xdm": { /* Experience Event XDM data */ },
"data": {
"__adobe": {
"target": {
" __save": true|false,
//defaults to true if omitted
"profile.gender": "female",
"profile.age": 30,
"entity.name": "T-shirt",
"entity.id": "1234"
}
}
}
})
__save
ディレクティブが省略された場合、プロファイル属性とエンティティ属性の保存は直ちに行われます。 __save
ディレクティブは、プロファイル属性とエンティティの詳細にのみ関連しています。お勧めをリクエスト
次の表に、Recommendations 属性と、各属性が Web SDK でサポートされているかどうかを示します。
Recommendations属性をAdobe Targetに送信する方法:
alloy("sendEvent", {
"renderDecisions": true,
"data": {
"__adobe": {
"target": {
"entity.id": "123",
"entity.genre": "Drama"
}
}
}
});
mbox コンバージョン指標の表示 display-mbox-conversion-metrics
以下のサンプルに、コンテンツやアクティビティの対象として認定される必要なく、表示 mbox コンバージョンを追跡し、プロファイルパラメーターをAdobe Targetに送信する方法を示します。
alloy("sendEvent", {
"xdm": {
"_experience": {
"decisioning": {
"propositions": [{
"scope": "conversion-step-1" //example scope name
}],
"propositionEventType": {
"display": 1
}
}
},
"eventType": "decisioning.propositionDisplay"
}
});
xdm._experience.decisioning.propositions[x].scope
xdm._experience.decisioning.propositions[x].eventType
"decisioning.propositionDisplay"
に設定します。デバッグ
mboxTrace と mboxDebug は非推奨(廃止予定)になりました。 代わりに、Web SDK デバッグメソッドを使用します。
用語
__提案:__Adobe Target では、提案は、アクティビティから選択されたエクスペリエンスに関連付けられます。
スキーマ: 決定のスキーマは、Adobe Target のオファーのタイプです。
範囲: 決定の範囲。 ま Adobe Target、スコープは mBox です。 グローバル mBox は __view__
スコープです。
XDM: XDM はドット表記にシリアル化され、mBox パラメーターとして Adobe Target に入れられます。