使用 Adobe Target と Platform Web SDK

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

重要

この 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 データ、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) でのユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツはキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しを必要とせずに、即座に適用できます。
c.エッジネットワークは、同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど、訪問者 ID とその他の値を Cookie で送信します。
7 エッジネットワークが転送されます Analytics for Target (A4T) Analytics エッジです。

有効化 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);
  });

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

ページ読み込み時:

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

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

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

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

ページ読み込み時:

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

用語

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

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

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

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

このページ