Adobe Target と Platform Web SDK の使用

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

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

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

Platform Web SDK システム図

次の図は、Target と Platform Web SDK エッジ判定のワークフローを理解するのに役立ちます。

Adobe Target を有効にしています

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

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

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

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

Adobe Target VEC の使用

Platform Web SDK 実装で VEC を使用するには、Firefox または Chrome VEC ヘルパー拡張機能をインストールして有効にします。

詳しくは、『Adobe Target』の「Visual Experience Composer ヘルパー拡張機能 」を参照してください。

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

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

XDM のオーディエンス

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

カスタムパラメーターまたはユーザープロファイルを使用する事前定義済みのオーディエンスを持つ Target アクティビティがある場合、SDK を介して正しく配信されません。 カスタムパラメーターやユーザープロファイルを使用する代わりに、XDM を使用する必要があります。 ただし、Platform Web SDK 経由でサポートされる標準のオーディエンスターゲティングフィールドは、XDM は不要です。 これらのフィールドは、XDM を必要としない Target UI で使用できます。

• ターゲットライブラリ
• 地域
• ネットワーク
• Operating System
• サイトのページ
• Browser
• トラフィックソース
• 時間枠

詳しくは、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"
      }
    }
  ]
}

レスポンストークンを収集するには、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);
  });
  

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

ページ読み込み時：

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

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

• renderAttempted フラグが true に設定されたシングルページアプリケーションビューの Visual Experience Composer ベースの提案

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

ページ読み込み時：

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

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

• renderAttempted フラグが false に設定されたシングルページアプリケーションビューの Visual Experience Composer ベースの提案

単一プロファイルの更新

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 デバッグ を使用します。

用語

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

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

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

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