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

personalization: {
  defaultPersonalizationEnabled: false
}

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

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

このプロパティに相当する Web SDK タグ拡張機能は、'Personalization' アクションを構成する場合の Send event セクションです。