Adobe Target と Platform Web SDK の使用

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

重要

Adobe Targetのドキュメント には、Target の機能に関連する、Platform Web SDK に固有の情報を含むトピックが含まれています。

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

Platform Web SDK システム図

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

Platform Web SDK を使用したAdobe Target Edge Decisioning の図

を呼び出します 詳細
1 デバイスが Platform Web SDK を読み込みます。 Platform Web SDK は、XDM データ、データストリーム環境 ID、渡されたパラメーターおよび顧客 ID(オプション)を使用して、エッジネットワークにリクエストを送信します。 ページ(またはコンテナ)は事前に非表示になっています。
2 エッジネットワークは、エッジサービスにリクエストを送信し、訪問者 ID、同意、その他の訪問者のコンテキスト情報(位置情報やデバイスのわかりやすい名前など)を含めてエンリッチメントをおこないます。
3 エッジネットワークは、訪問者 ID と渡されたパラメーターを使用して、エンリッチメントされたパーソナライゼーションリクエストを Target エッジに送信します。
4 プロファイルスクリプトが実行され、Target プロファイルストレージにフィードされます。 プロファイルストレージは、オーディエンスライブラリ からセグメントを取得します(例えば、Adobe Analytics、Adobe Audience Manager、Adobe Experience Platform から共有されたセグメント)。
5 Target は、URL リクエストパラメーターとプロファイルデータに基づいて、現在のページビューと今後のプリフェッチされたビューで、訪問者に表示するアクティビティとエクスペリエンスを決定します。 Target 次に、これを edge ネットワークに送り返します。
6 a.Edge ネットワークは、パーソナライゼーション応答を(オプションで、追加のパーソナライゼーションに関するプロファイル値を含めて)ページに返します。 デフォルトコンテンツがちらつくことなく、可能な限り迅速に現在のページにパーソナライズされたコンテンツが表示されます。
b.シングルページアプリケーション (SPA) のユーザーアクションの結果として表示されるビュー用にパーソナライズされたコンテンツはキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しを必要とせず、即座に適用できます。
c.エッジネットワークが、同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど、訪問者 ID とその他の値を Cookie で送信します。
7 エッジネットワークは、Analytics for Target (A4T) の詳細(アクティビティ、エクスペリエンス、コンバージョンのメタデータ)を Analytics エッジに転送します。

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.” 例:
キー タイプ 説明
renderDecisions Boolean パーソナライゼーションコンポーネントに DOM アクションを解釈するかどうかを指定します
decisionScopes 配列 <String> 決定を取得するスコープのリスト
xdm オブジェクト XDM で形式設定されたデータで、エクスペリエンスイベントとして Platform Web SDK に読み込まれる
data オブジェクト ターゲットクラスの Target ソリューションに送信された任意のキーと値のペア。

このコマンドを使用する一般的な 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 — デフォルトのエンティティ属性 entity.id サポートあり
entity.name サポートあり
entity.categoryId サポートあり
entity.pageUrl サポートあり
entity.thumbnailUrl サポートあり
entity.message サポートあり
entity.value サポートあり
entity.inventory サポートあり
entity.brand サポートあり
entity.margin サポートあり
entity.event.detailsOnly サポートあり
Recommendations — カスタムエンティティの属性 entity.yourCustomAttributeName サポートあり
Recommendations — 予約された mbox/ページパラメーター excludedIds サポートあり
cartIds サポートあり
productPurchasedId サポートあり
カテゴリ親和性のページまたは品目カテゴリ user.categoryId サポートあり

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 としてに配置されます。

このページ