パーソナライゼーションへの 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 のワークフローを理解するのに役立ちます。

Adobe Target の有効化

Target を有効にするには、次の手順を実行します。

その後、オプションで、次のオプションも追加できます。

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);
  });

自動レンダリングが有効な場合、提案の配列には次が含まれます。

ページ読み込み時：

表示時 – 変更（キャッシュされたビュー用）:

自動レンダリングが無効の場合、提案の配列には次が含まれます。

ページ読み込み時：

表示時 – 変更（キャッシュされたビュー用）:

単一プロファイルの更新

Web SDK を使用すると、プロファイルを Target プロファイルに更新したり、エクスペリエンスイベントとして Web SDK に更新したりできます。

Target プロファイルを更新するには、プロファイルデータに次の情報が渡されていることを確認します。

コンテンツがエンドユーザーに表示されるまで、プロファイルまたはエンティティパラメーターの保存を遅延させる

コンテンツが表示されるまでプロファイルの属性の記録を遅延させるには、リクエストで 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"
            }
        }
    }
})

お勧めをリクエスト

次の表に、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"
    }
});

デバッグ

mboxTrace と mboxDebug は非推奨（廃止予定）になりました。 代わりに、Web SDK デバッグメソッドを使用します。

用語

__提案：__Adobe Target では、提案は、アクティビティから選択されたエクスペリエンスに関連付けられます。

スキーマ： 決定のスキーマは、Adobe Target のオファーのタイプです。

範囲： 決定の範囲。 ま Adobe Target、スコープは mBox です。 グローバル mBox は __view__ スコープです。

XDM: XDM はドット表記にシリアル化され、mBox パラメーターとして Adobe Target に入れられます。