Platform Web SDKを使用したTarget コンバージョンイベントの追跡

Targetのコンバージョンイベントは、at.jsと同様にPlatform Web SDKで追跡できます。 コンバージョンイベントは、通常、次のカテゴリに分類されます。

  • 設定を必要としないイベントを自動的に追跡
  • Platform Web SDKのベストプラクティスの実装に合わせて調整する必要があるコンバージョンイベントを購入する
  • コード更新が必要な購入以外のコンバージョンイベント

目標トラッキングの比較

次の表に、at.jsとPlatform Web SDKでのコンバージョンイベントのトラッキング方法を示します

アクティビティの目標
Target at.js 2.x
Platform Web SDK
コンバージョン/ページを表示
自動的に追跡: at.js リクエストペイロードのcontext.address.urlの値に基づきます。
自動的に追跡: sendEvent ペイロードのxdm.web.webPageDetails.URLの値に基づく
コンバージョン > mboxを表示
trackEvent()またはsendNotifications()を使用した表示mboxの場所または通知のリクエストでトラッキングされ、値はtypeでdisplayです。
decisioning.propositionDisplay件中eventType件のPlatform Web SDK sendEvent呼び出しでトラッキングされました。
コンバージョン/要素をクリック
VEC ベースのアクティビティに対して自動的にトラッキングされます。 in リクエストペイロードにnotifications オブジェクトがあり、type値がclickのat.js ネットワーク呼び出しとして表示されます。
VEC ベースのアクティビティに対して自動的にトラッキングされます。 decisioning.propositionInteractのeventTypeを含むPlatform Web SDK sendEvent呼び出しとして表示されます。
エンゲージメント / ページビュー
自動的に追跡
自動的に追跡
エンゲージメント > サイト滞在時間
自動的に追跡
自動的に追跡

自動的に追跡されるイベント

次のコンバージョン目標は、導入に伴う特定の調整を必要としません。

  • コンバージョン/ページを表示
  • コンバージョン/エレメントをクリック
  • エンゲージメント / ページビュー
  • エンゲージメント > サイト滞在時間
NOTE
Platform Web SDKでは、リクエストペイロードで渡される値をより詳細に制御できます。 QA URLや「ページを表示した」コンバージョン目標などのTarget機能が適切に動作することを確認するには、xdm.web.webPageDetails.URL値に適切な文字ケースを含むページ URL全体が含まれていることを確認します。

カスタム追跡イベント

Targetの実装では、一般的に、フォームベースのアクティビティのクリックを追跡したり、フローのコンバージョンを示したり、新しいコンテンツをリクエストすることなくパラメーターを渡したりするために、カスタムのコンバージョンイベントを使用します。

次の表は、at.js アプローチと、いくつかの一般的なコンバージョントラッキングのユースケースに対応するPlatform Web SDKの概要を示しています。

ユースケース
Target at.js 2.x
Platform Web SDK
mboxの場所(スコープ)のクリック変換イベントの追跡
特定のmboxの場所に対してtype値clickでtrackEvent()またはsendNotifications()を実行します
イベントタイプがdecisioning.propositionInteractのsendEvent コマンドを実行します
Target プロファイルパラメーターなどの追加データも含まれるカスタム変換イベントを追跡します
特定のmboxの場所に対してtype値displayでtrackEvent()またはsendNotifications()を実行します
イベントタイプがdecisioning.propositionDisplayのsendEvent コマンドを実行します
NOTE
decisioning.propositionDisplayは、特定のスコープのインプレッションを増分するために最もよく使用されますが、通常はat.js trackEvent()の直接置き換えとしても使用する必要があります。 trackEvent()関数は、指定されていない場合、デフォルトでdisplayの型になります。 定義済みのカスタムコンバージョンに対して、適切なイベントタイプを使用していることを確認してください。

Target イベントのトラッキングにtrackEvent()とsendNotifications()を使用する方法について詳しくは、専用のat.js ドキュメントを参照してください。

at.jsの例:trackEvent()を使用してmboxの場所をクリックした場合:

adobe.target.trackEvent({
  "type": "click",
  "mbox": "homepage_hero"
});

Platform Web SDKの実装では、sendEvent コマンドを呼び出し、_experience.decisioning.propositions XDM フィールドグループを入力し、eventTypeを2つの値のいずれかに設定することで、イベントとユーザーアクションを追跡できます。

  • decisioning.propositionDisplay: Target アクティビティのレンダリングを通知します。
  • decisioning.propositionInteract: マウスのクリックなど、アクティビティに対するユーザーの操作を示します。

_experience.decisioning.propositions XDM フィールドグループはオブジェクトの配列です。 各オブジェクトのプロパティは、sendEvent コマンドで返されるresult.propositionsから派生します:{ id, scope, scopeDetails }

alloy("sendEvent", {
  xdm: { ...},
  decisionScopes: ["hero-banner"]
}).then(function (result) {
  var propositions = result.propositions;

  if (propositions) {
    // Find the discount proposition, if it exists.
    for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      for (var j = 0; j < proposition.items; j++) {
        var item = proposition.items[j];

        if (item.schema === "https://ns.adobe.com/personalization/measurement") {
          // add metric to the DOM element
          const button = document.getElementById("form-based-click-metric");

          button.addEventListener("click", event => {
            const executedPropositions = [
              {
                id: proposition.id,
                scope: proposition.scope,
                scopeDetails: proposition.scopeDetails
              }
            ];
            // send the click track event
            alloy("sendEvent", {
              "xdm": {
                "eventType": "decisioning.propositionInteract",
                "_experience": {
                  "decisioning": {
                    "propositions": executedPropositions
                  }
                }
              }
            });
          });
        }
      }
    }
  }
});

次に、一貫した訪問者プロファイルのために​ クロスドメイン ID共有を有効にする方法を説明します。

NOTE
at.jsからWeb SDKへのTargetの移行を成功させるためのサポートを提供します。 移行で障害が発生した場合、またはこのガイドに重要な情報が欠けていると感じた場合は、このコミュニティのディスカッション ​に投稿してお知らせください。
recommendation-more-help
platform-learn-help-tutorial-migrate-target-websdk