用途 Adobe Target および Web SDK パーソナライゼーションの

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

IMPORTANT
を使用して Target 実装を Platform Web SDK に移行する方法について説明します。 at.js 2.x から Platform Web SDK への Target の移行 チュートリアル
Target を初めて実装する際に、 Web SDK を使用したAdobe Experience Cloudの実装 チュートリアル Target に固有の情報については、「 」というタイトルのチュートリアルの節を参照してください。 Platform Web SDK での Target の設定.

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

Web SDK システム図

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

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

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

有効化 Adobe Target

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

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

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

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

Adobe Target VEC の使用

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

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

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

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

XDM のオーディエンス

のオーディエンスを定義する際 Target 経由で配信されるアクティビティ Web SDK, XDM を定義して使用する必要があります。 XDM スキーマ、クラス、スキーマフィールドグループを定義したら、 Target ターゲティング用に XDM データで定義されるオーディエンスルール。 Within 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 約束、反復する 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

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

ページ読み込み時:

  • Form-based Composer — ベース propositions 次を使用 renderAttempted フラグをに設定 false
  • Visual Experience Composerに基づく提案 renderAttempted フラグをに設定 false
  • Visual Experience Composerを使用したシングルページアプリビューのベースの提案 renderAttempted フラグをに設定 false

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

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

単一プロファイルの更新

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

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

  • の下 "data {"
  • の下 "__adobe.target"
  • プレフィックス "profile."
キー
タイプ
説明
renderDecisions
ブール値
パーソナライゼーションコンポーネントに DOM アクションを解釈するかどうかを指定します
decisionScopes
配列 <String>
決定を取得するスコープのリスト
xdm
オブジェクト
エクスペリエンスイベントとして Web SDK に格納される XDM で形式設定されたデータ
data
オブジェクト
に送信される任意のキーと値のペア Target target クラスのソリューション。

標準 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 属性と、それぞれが 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 は非推奨(廃止予定)となりました。 用途 Web SDK デバッグ.

用語

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

スキーマ: 決定のスキーマは、 Adobe Target.

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

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

recommendation-more-help
def05a9c-d048-422c-a3a1-88b2de863f4f