personalization

personalization オブジェクトは、要求されるパーソナライズ決定（オファーまたは提案）と、要求と応答でそれらの処理方法を設定します。 Adobe TargetやAdobe Journey Optimizerの導入では、ユーザーごとに表示コンテンツをカスタマイズできる原動力となるため、特に価値があります。

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

personalization オブジェクトには、次のプロパティが含まれています。

personalization.decisionScopes

decisionScopes プロパティは、パーソナライズに関する決定を取得および返すようにWeb SDKに指示する文字列の配列です。 配列内の各項目は、パーソナライズされたコンテンツが必要な場所、コンテキスト、または論理的な配置を特定します。

このプロパティは、ページの特定の領域またはコンポーネントに対してパーソナライズされたコンテンツを明示的に取得する場合に便利です。 特に、シングルページアプリケーションでは、ユーザーのナビゲーションやビューの変更に応じて異なるオファーセットが必要になる場合があります。 このプロパティを使用して、ユーザーに関連するUI要素のオファーのみを取得することで、パフォーマンスを最適化することもできます。

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

Adobe Targetでは、各意思決定範囲がmboxまたはアクティビティにマッピングされます。 Adobe Journey Optimizerでは、各意思決定範囲を、意思決定に基づくweb コンテンツの配置や施策にマッピングしています。 Offer Decisioningでは、意思決定範囲は、訪問者が受け取るべきオファーや提案にマッピングされます。

personalization.surfaces

surfaces プロパティは、​ サーフェス URI文字列の配列で、パーソナライゼーションを要求するチャネル、デバイス、またはコンテキストを手動で定義します。 クロスチャネルエコシステム内で、ドメイン、アプリ、デバイスプラットフォームなど、異なるデジタルエクスペリエンスを区別できます。 デフォルトでは、ライブラリは現在のページからデフォルトサーフェスを推測します。 このプロパティを使用すると、現在のページの自動推測サーフェスを上書きできます。

このプロパティは、クロスチャネルパーソナライゼーションを使用する場合に役立ち、パーソナライゼーションの仕組みを別々のチャネルで区別する必要があります。 これにより、同じAdobe Experience Platform組織の下で、異なるサイトに対して個別のオファーを作成できます。

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

このプロパティは、Adobe Journey Optimizerのキャンペーンやサーフェス管理で設定されたサーフェスと一致するため、Journey Optimizerでは基本的に使用されます。

personalization.schemas

schemas プロパティは、Edge Networkから要求されたパーソナライゼーションコンテンツの種類をフィルタリングするスキーマ URI文字列の配列です。 このプロパティを設定すると、Adobeから受け取る応答が、指定したコンテンツタイプ定義に一致するオファーのみを含むように制限されます。 省略した場合、ライブラリは、一致したスコープまたはサーフェスに対して、利用可能なすべてのスキーマのオファーをリクエストします。

このプロパティは、応答サイズを最適化するのに役立ち、web サイトまたはアプリケーションが処理できるオファータイプのみを受け取るようにします。 また、特定の方法でパーソナライズされたコンテンツをレンダリングするシングルページアプリケーション（DOM アクションのみを使用する、JSON オブジェクトのみを使用するなど）で使用する場合にも役立ちます。

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

次のスキーマ URIがサポートされています。

personalization.sendDisplayEvent

sendDisplayEvent プロパティは、パーソナライズされたコンテンツがページにレンダリングされた直後に、表示通知イベントがEdge Networkに自動的に送信されるかどうかを判断するブール値です。 省略した場合、デフォルト値はtrueです。 パーソナライズされたコンテンツがインプレッションのトラッキング用にレンダリングされたことを示さない場合は、この変数をfalseに設定します。

この変数をfalseに設定する最も一般的な使用例は、実装内の別の場所に別のコマンドを送信し、表示イベントにフラグを付ける場合です。 一部の実装には、インプレッションとAnalytics イベントの両方が含まれています。このプロパティを使用すると、インプレッションを増分するsendEvent コマンドを完全に制御できます。

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

includePendingDisplayNotifications プロパティは、保留中の表示通知が現在のsendEvent呼び出しにバンドルされているかどうかを制御するブール値です。 保留中の表示通知は、表示イベントとしてEdge Networkにレンダリングされたが、まだ報告されていないパーソナライズされたコンテンツのインプレッションです。 このプロパティは、パーソナライズされたコンテンツとsendEvent呼び出しのレンダリングが非同期になる可能性があるため、シングルページアプリケーションを使用する場合に役立ちます。

このプロパティの既定値はfalseです。 保留中の表示通知をバッチ処理してフラッシュし、インプレッションを正確に記録する場合は、このプロパティをtrueに設定します。 従来のweb サイトなどの同期実装では、通常、このプロパティを設定する必要はありません。

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

defaultPersonalizationEnabled プロパティは、Web SDKがこのsendEvent コマンドに対してデフォルトのページ全体のパーソナライゼーションスコープ （__view__）とサーフェスをリクエストする方法を明示的に制御できるブール値です。 デフォルトでは、ページ読み込み後の最初のsendEvent コマンドで、Web SDKはデフォルトのページ全体のパーソナライゼーションスコープと関連するサーフェスのオファーをリクエストします。 後続のsendEvent コマンドは、デフォルトのパーソナライゼーションを要求しません。 このプロパティを使用して、その動作を上書きできます。 シングルページアプリケーションの実装では、ユーザーがサイトを移動する際に、デフォルトのパーソナライゼーションを再度要求する場合に役立ちます。 このプロパティは、オファー取得を重複せずに表示イベントを​ のみ ​送信する場合にも使用できます。

personalization: {
  defaultPersonalizationEnabled: false
}

このプロパティは、設定方法に応じて次のロジックを使用します。

Web SDK タグ拡張機能を使用したPersonalization コンポーネント

このプロパティに相当するWeb SDK タグ拡張機能は、‘Send event’ アクションを設定する際のPersonalization セクションです。