使用Platform Web SDK追蹤目標轉換事件

可使用Platform Web SDK (類似at.js)追蹤Target的轉換事件。 轉換事件通常分為下列類別:

  • 自動追蹤不需要任何設定的事件
  • 針對最佳實務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」
已使用具有typedisplaytrackEvent()sendNotifications()來追蹤顯示mbox位置或通知的要求。
已使用Platform Web SDK sendEvent呼叫和decisioning.propositionDisplayeventType進行追蹤。
轉換>點選元素
已針對VEC型活動自動追蹤。 顯示為at.js網路呼叫,要求裝載中有notifications物件且type值為click
已針對VEC型活動自動追蹤。 顯示為Platform Web SDK sendEvent呼叫,具有decisioning.propositionInteracteventType
參與度>頁面檢視
已自動追蹤
已自動追蹤
參與度>網站逗留時間
已自動追蹤
已自動追蹤

自動追蹤的事件

下列轉換目標不需要對實作作作作任何特定調整:

  • 轉換>已檢視頁面
  • 轉換>點選元素
  • 參與度>頁面檢視
  • 參與度>網站逗留時間
NOTE
Platform Web SDK允許對請求承載中傳遞的值進行更全面的控制。 若要確保Target功能(例如QA URL和「已檢視頁面」轉換目標)正常運作,請檢查xdm.web.webPageDetails.URL值是否包含具有適當字元大小寫的完整頁面URL。

自訂追蹤事件

Target實施通常會使用自訂轉換事件來追蹤表單式活動的點按、表示流量中的轉換,或傳遞引數而不要求新內容。

下表概述幾個常見轉換追蹤使用案例的at.js方法和Platform Web SDK同等功能。

使用實例
Target at.js 2.x
Platform Web SDK
追蹤mbox位置(範圍)的點選轉換事件
針對特定mbox位置以typeclick執行trackEvent()sendNotifications()
執行事件型別為decisioning.propositionInteractsendEvent命令
追蹤可能也會包含其他資料(例如Target設定檔引數)的自訂轉換事件
針對特定mbox位置以typedisplay執行trackEvent()sendNotifications()
執行事件型別為decisioning.propositionDisplaysendEvent命令
NOTE
雖然decisioning.propositionDisplay最常用於增加特定範圍的曝光數,但通常也應該用來直接取代at.js trackEvent()。 如果未指定,trackEvent()函式預設為display型別。 請檢查您的實作,確保您可能已定義的任何自訂轉換使用正確的事件型別。

請參閱專屬的at.js檔案,以取得有關如何使用trackEvent()sendNotifications()來追蹤Target事件的詳細資訊。

at.js範例使用trackEvent()追蹤mbox位置上的點選:

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

透過Platform Web SDK實作,您可以呼叫sendEvent命令、填入_experience.decisioning.propositions XDM欄位群組,並將eventType設定為下列兩個值之一,以追蹤事件和使用者動作:

  • 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
我們致力協助您成功將Target從at.js移轉至Web SDK。 如果您在移轉時遇到問題,或覺得本指南中缺少重要資訊,請在此社群討論中張貼以告知我們。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110