Adobe TargetとPlatform Web SDKの使用

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

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

Adobe Targetを有効にする

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

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

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

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

Adobe Target VECの使用

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

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

VECアクティビティの自動レンダリング

Adobe Experience Platform Web SDKは、ユーザーに対して、Web上のAdobe TargetのVECを介して定義されたエクスペリエンスを自動的にレンダリングする機能を備えています。 VECアクティビティを自動レンダリングするようにExperience Platform Web SDKに指示するには、renderDecisions = trueを含むイベントを送信します。

alloy
("sendEvent", 
  { 
  "renderDecisions": true, 
  "xdm": {
    "commerce": { 
      "order": {
        "purchaseID": "a8g784hjq1mnp3", 
         "purchaseOrderNumber": "VAU3123", 
         "currencyCode": "USD", 
         "priceTotal": 999.98 
         } 
      } 
    }
  }
);

フォームベースのコンポーザーの使用

フォームベースのExperience Composerは、JSONなどの応答タイプの異なるA/Bテスト、エクスペリエンスターゲット設定、Automated Personalization、Recommendationsアクティビティの設定に役立つ非視覚的なインターフェイスですHTML、画像など Targetから返される応答のタイプや決定に応じて、コアビジネスロジックを実行できます。 フォームベースのComposerアクティビティの決定を取得するには、決定を取得するすべての「decisionScopes」を含むイベントを送信します。

alloy
  ("sendEvent", { 
    decisionScopes: [
      "foo", "bar"], 
      "xdm": {
        "commerce": { 
          "order": { 
            "purchaseID": "a8g784hjq1mnp3", 
            "purchaseOrderNumber": "VAU3123", 
            "currencyCode": "USD", 
            "priceTotal": 999.98 
          } 
        } 
      } 
    }
  );

判定範囲

decisionScopes パーソナライズされたエクスペリエンスをレンダリングするページのセクション、場所または部分を定義します。これらのdecisionScopesはカスタマイズ可能で、ユーザー定義です。 現在の[!DNL Target]のお客様の場合、decisionScopesは「mbox」とも呼ばれます。 [!DNL Target] UIでは、decisionScopesが「場所」として表示されます。

__view__スコープ

Experience Platform Web SDKは、VECアクションをレンダリングするSDKに依存せずにVECアクションを取得する機能を提供します。 __view__decisionScopesとして定義したイベントを送信します。

alloy("sendEvent", {
      "decisionScopes": ["__view__", "foo", "bar"], 
      "xdm": { 
        "web": { 
          "webPageDetails": { 
            "name": "Home Page"
          }
        } 
      }
    }
  ).then(function(results) {
    for (decision of results.decisions) {
      if (decision.decisionScope === "__view__") {
        console.log(decision.content)
      }
    }
  });

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ガイド』のオーディエンスのカテゴリを参照してください。

単一プロファイルの更新

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

このページ