使用方法 Adobe Target および Web SDK パーソナライゼーションの場合

Adobe Experience Platform Web SDK では、で管理されたパーソナライズされたエクスペリエンスを配信およびレンダリングできます。 Adobe Target を web チャネルに追加します。 という WYSIWYG エディターを使用できます Visual Experience Composer （VEC）、または非ビジュアルインターフェイス、 フォームベースの Experience Composerを作成し、アクティブ化して、アクティビティとパーソナライゼーションエクスペリエンスを配信します。

次の機能はテスト済みで、現在でサポートされています Target:

Web SDK システム図

次の図は、のワークフローを理解するのに役立ちます Target および Web SDK edge decisioning.

有効化 Adobe Target

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

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

Adobe Target VEC の使用

で VEC を使用するには Web SDK の実装、インストールおよびアクティベーション Firefox または Chrome VEC Helper 拡張機能。

詳しくは、を参照してください Visual Experience Composer ヘルパー拡張機能 が含まれる Adobe Target ガイド.

パーソナライズされたコンテンツのレンダリング

参照： パーソナライゼーションコンテンツのレンダリング を参照してください。

XDM でのオーディエンス

のオーディエンスを定義する場合 Target を介して配信されるアクティビティ Web SDK, XDM 定義し、使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、 Target ターゲティング用に XDM データで定義されたオーディエンスルール。 内 Target、XDM データはに表示されます Audience Builder をカスタムパラメーターとして使用します。 XDM は、ドット表記（など）を使用してシリアル化されます。 web.webPageDetails.name）に設定します。

以下がある場合： Target カスタムパラメーターまたはユーザープロファイルを使用する定義済みオーディエンスを持つアクティビティの場合、SDK 経由で正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、を介してサポートされている標準のオーディエンスターゲティングフィールドは次のとおりです Web SDK XDM は必要ありません。 これらのフィールドは、 Target XDM を必要としない 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"
      }
    }
  ]
}

応答トークンを収集するには、を購読する必要があります。 alloy.sendEvent promise、反復処理 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,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;

sendEventプロファイルデータを使用

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

プロファイル属性をAdobe Targetに送信する方法：

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

お勧めをリクエスト

以下の表にリストを示します Recommendations 属性とそれぞれが Web SDK:

Recommendations属性をAdobe Targetに送信する方法：

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

デバッグ

mboxTrace と mboxDebug は非推奨（廃止予定）になりました。 ～の方法を用いる Web SDK のデバッグ その代わり。

用語

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

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

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

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