パーソナライゼーションへの 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 でのオーディエンス

Target を介して配信される Web SDK アクティビティのオーディエンスを定義する場合は、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 などのサードパーティにメタデータを送信するために使用されます。 レスポンストークンが返されます
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"
      }
    }
  ]
}

応答トークンを収集するには、promise を購読し、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);
  });

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

ページ読み込み時：

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

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

ページ読み込み時：

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

単一プロファイルの更新

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 属性を Target に送信する方法：

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

mbox コンバージョン指標の表示 display-mbox-conversion-metrics

以下のサンプルに、コンテンツやアクティビティの資格を必要とせずに、表示 mbox コンバージョンを追跡し、プロファイルパラメーターを Target に送信する方法を示します。

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

デバッグ

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

用語

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

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

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

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