使用 Adobe Target と Platform Web SDK

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

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

• A/B テスト
• A4T インプレッションとコンバージョンのレポート
• Automated Personalizationアクティビティ
• エクスペリエンスのターゲット設定アクティビティ
• 多変量分析テスト (MVT)
• Recommendationsアクティビティ
• ネイティブ Target のインプレッションおよびコンバージョンレポート
• VEC サポート

Platform Web SDK システム図

次の図は、 Target および Platform Web SDK エッジ判定。

有効化 Adobe Target

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

1. 有効にする Target の datastream を適切なクライアントコードに置き換えます。
2. 次を追加： renderDecisions オプションをイベントに追加できます。

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

• decisionScopes：イベントにこのオプションを追加して、特定のアクティビティ（フォームベースのコンポーザーで作成されたアクティビティで役立つ）を取得します。
• スニペットを事前に非表示にする：ページの特定の部分のみを非表示にします。

Adobe Target VEC の使用

VEC を Platform Web SDK 実装、インストール、アクティブ化 Firefox または クロム VEC ヘルパー拡張機能。

詳しくは、 Visual Experience Composer ヘルパー拡張機能 （内） Adobe Targetガイド.

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

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

XDM のオーディエンス

のオーディエンスを定義する際 Target 経由で配信されるアクティビティ Platform Web SDK, XDM を定義して使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、 Target ターゲティング用に XDM データで定義されるオーディエンスルール。 Within Targetに値を指定しない場合、XDM データは Audience Builder をカスタムパラメーターとして設定します。 XDM は、ドット表記 ( 例えば、 web.webPageDetails.name) をクリックします。

次の条件を満たしている場合： Target アクティビティが事前に定義されたオーディエンスでカスタムパラメーターまたはユーザープロファイルを使用する場合、SDK を介して正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、 Platform 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 約束、反復する 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);
  });

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

ページ読み込み時：

• フォームベースのコンポーザーベース propositions 次を使用 renderAttempted フラグをに設定 false
• を使用した Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 true
• を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 true

表示時 — 変更時（キャッシュされた表示の場合）:

• を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 true

自動レンダリングが無効になっている場合、提案配列には次の情報が含まれます。

ページ読み込み時：

• フォームベースのコンポーザーベース propositions 次を使用 renderAttempted フラグをに設定 false
• を使用した Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 false
• を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 false

表示時 — 変更時（キャッシュされた表示の場合）:

• を使用したシングルページアプリケーションビューに対する Visual Experience Composer ベースの提案 renderAttempted フラグをに設定 false

単一プロファイルの更新

The Platform Web SDK を使用すると、プロファイルを Target プロファイルと Platform Web SDK エクスペリエンスイベントとして。

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

• 「"data {"
• 「"__adobe.target"
• プレフィックス "profile." 例：以下

標準 Platform Web SDK このコマンドを使用するコードは、次のようになります。

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 属性と、それぞれが Platform Web SDK:

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

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

デバッグ

mboxTrace と mboxDebug は非推奨（廃止予定）となりました。 用途 Platform Web SDK デバッグ.

用語

提案： In Targetの提案は、アクティビティから選択されたエクスペリエンスと相関関係を持ちます。

スキーマ： 決定のスキーマは、 Target.

範囲： 決定の範囲。 In Targetの場合、範囲は mBox です。 グローバル mBox は、 __view__ 範囲。

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