使用 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 データで定義されるオーディエンスルール。 内 Targetに値を指定しない場合、XDM データは Audience Builder をカスタムパラメーターとして設定します。 XDM は、ドット表記を使用してシリアル化されます ( 例： web.webPageDetails.name) をクリックします。

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

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

詳しくは、 オーディエンスのカテゴリ 内 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

単一プロファイルの更新

この 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 パラメーターとして設定します。