回應 Token

回應Token可讓您自動將Adobe Target的特定資訊輸出至您品牌的網頁。 此資訊可包含有關活動、選件、體驗、使用者設定檔、地理資訊等詳細資訊。 這些詳細資料提供額外的回應資料,可與內部或第三方工具共用,或用於偵錯。

回應Token可讓您選擇要使用的變數(在索引鍵值配對中),然後啟用這些變數作為Target回應的一部分傳送。 您使用交換器啟用變數,變數會與Target個回應一併傳送,這可以在網路呼叫中驗證。 回應Token也可在Preview模式下運作。

外掛程式和回應Token的主要差異在於,外掛程式會將JavaScript傳送至傳送時執行的頁面。 然而,回應Token會傳送物件,然後可以使用事件接聽程式讀取該物件並據以採取行動。 回應Token方法比較安全,而且在開發和維護第三方整合時較輕鬆。

NOTE
回應Token附隨於at.js 1.1版或更新版本提供。
Target SDK
建議的動作
Adobe Experience Platform Web SDK
確保您使用Platform Web SDK 2.6.0版或更新版本。 如需有關下載最新版Platform Web SDK的資訊,請參閱​ Platform Web SDK總覽 ​指南中的安裝SDK。 如需每個Platform Web SDK版本中新功能的相關資訊,請參閱​ Platform Web SDK總覽 ​指南中的發行說明
at.js
確保您使用 at.js 版本 1.1 或更新版本。如需有關下載最新版at.js的資訊,請參閱下載at.js。 如需每個at.js版本中新功能的相關資訊,請參閱at.js版本詳細資料
對於使用 at.js 的客戶,建議採用回應 Token,而不要使用外掛程式。mbox.js (現已棄用)中有部分外掛程式所依賴的內部方法,但at.js中卻沒有,雖然可以傳送這些外掛程式,但卻會失敗。

使用回應Token section_A9E141DDCBA84308926E68D05FD2AC62

  1. 確保您使用Platform Web SDK 2.6.0版(或更新版本)或at.js版本1.1 (或更新版本)。

    如需詳細資訊:

    • Platform Web SDK:請參閱​ Platform Web SDK總覽 ​指南中的安裝SDK
    • at.js:請參閱下載at.js
  2. 在Target中,按一下​ Administration > Response Tokens

    response_tokens — 新影像

  3. 啟用所需的回應Token,例如activity.idoffer.id

    依預設有下列參數可用:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3
    類型 參數 附註
    內建的設定檔 profile.activeActivities 傳回訪客合格可使用的 activityIds 陣列。這會隨著使用者合格而增加。例如,在包含兩個Target請求(傳送兩個不同的活動)的頁面上,第二個請求會包含兩個活動。
    profile.isFirstSession 傳回 "true" 或 "false"。
    profile.isNewSession 傳回 "true" 或 "false"。
    profile.daysSinceLastVisit 傳回訪客上次造訪後所經過的天數。
    profile.tntId 傳回訪客的 tntID
    profile.marketingCloudVisitorId 傳回訪客的 Experience Cloud 訪客 ID。
    profile.thirdPartyId 傳回訪客的第三方 ID。
    profile.categoryAffinity 傳回訪客最喜愛的類別。
    profile.categoryAffinities 以字串形式傳回訪客前 5 名類別的陣列。
    活動 activity.name
    activity.id
    experience.name
    experience.id
    offer.name
    offer.id
    目前活動的詳細資料。
    請注意,優惠引數的值是在體驗層級上評估的。
    地理 geo.country
    geo.state
    geo.city
    geo.zip
    geo.dma
    geo.domainName
    geo.ispName
    geo.connectionSpeed
    geo.mobileCarrier
    請參閱地理,以取得在活動中使用地理鎖定目標的詳細資訊。
    流量分配方法
    (僅適用於Auto-Target和Automated Personalization活動。)
    experience.trafficAllocationId 如果訪客從「控制」流量中收到體驗,則傳回0;如果訪客從「已鎖定目標」流量分佈中收到體驗,則傳回1。
    experience.trafficAllocationType 傳回「控制」或「已鎖定目標」。

    使用者設定檔屬性和客戶屬性也顯示在清單中。

    note note
    NOTE
    含特殊字元的參數不會顯示在清單中。僅支援英數字元和底線。
  4. (條件式)若要使用設定檔引數做為回應Token,但引數尚未透過Target要求傳遞,因此,尚未載入Target UI,您可以使用Add Response Token按鈕將設定檔新增至UI。

    按一下​ Add Response Token,提供權杖名稱,然後按一下​ Activate

    response_token_create image

  5. 建立活動。

接聽回應並讀取回應Token

您用來接聽Target回應和讀取回應Token的處理程式會因您是Platform Web SDK或at.js實作而異。

使用Handle物件類別的 Adobe Experience Platform Web SDK徽章 Platform Web SDK platform-web-sdk

使用Handle物件類別(具有中繼資料物件與資料物件)來接聽Target回應並讀取回應Token。

下列回應範例直接將Platform Web SDK自訂事件處理常式新增至HTML頁面(表格說明程式碼中使用的物件):

物件
資訊
型別 — Personalization.decision
決定是由Target或Offer decisioning提供者所做。
DecisionProvider - TGT
TGT-Target。 Target提供回應Token中繼資料和值給頁面。
中繼
傳遞至頁面的中繼資料。
資料
傳遞給頁面的中繼資料值。
<html>

<head>
 ...
 <script src="alloy.js"></script>
 <script>
  {
   "requestId": "4d0a7cfd-952c-408c-b3b8-438edc38250a",
   "handle": [{
    "type": "personalization:decisions",
    "payload": [{
     "id": "....",
     "scope": "__view__",
     "scopeDetails": {
      "decisionProvider": "TGT",
      "activity": {
       "id": "..."
      },
      "experience": {
       "id": "...."
      }
     },
     "items": [{
      "id": "123",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
       "activity.id": "...",
       "activity.name": "...",
       "profile.foo": "...",
       "profile.bar": "..."
      },
      "data": {
       "id": "123",
       "type": "setHtml",
       "selector": "#foo",
       "prehidingSelector": "#foo",
       "content": "<div>Hello world</div>"
      }
     }]
    }]
   }]
  }
  });
 </script>
</head>

<body>
 ...
</body>

</html>

使用自訂事件的 at.js badge at.js

使用at.js自訂事件接聽Target回應並讀取回應Token。

下列程式碼範例直接將 at.js 自訂事件處理常式新增至 HTML 頁面:

<html>
  <head>
    ....
    <script src="at.js"></script>
    <script>
      document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
        console.log("Request succeeded", e.detail);
      });
    </script>
  <head>
  <body>
  ...
  </body>
</html>

回應Token FAQ section_3DD5F32C668246289CDF9B4CDE1F536D

需要什麼角色才能啟動或停用回應 Token?

回應權杖只能由具有Target Administrator角色的使用者啟用或停用。

如果我執行Platform Web SDK 2.6.0 (或更早版本)會發生什麼事?

您無權存取回應Token。

如果我執行at.js 1.0 (或更早版本)會發生什麼事?

您會看到回應Token,但at.js無法使用。

我可以同時啟用Target Classic外掛程式和回應Token嗎?

外掛程式和回應Token可並行使用;不過,外掛程式未來將停止使用。

回應Token是透過所有Target回應傳遞,還是僅透過傳遞活動的Target回應傳遞?

回應Token僅能透過傳遞活動的Target個回應來傳遞。

我的Target Classic外掛程式包含JavaScript。 如何使用回應 Token 來複寫其功能?

移轉至回應Token時,此型別的JavaScript必須保留在程式碼基底或標籤管理解決方案中。 您可以使用Platform Web SDK或at.js自訂事件來觸發此程式碼,並將回應Token值傳遞至JavaScript函式。

我的設定檔/客戶屬性參數為何沒有顯示在回應 Token 清單中?

Target通常會每15分鐘重新整理一次引數。 此重新整理取決於使用者動作,而且只有在您檢視回應Token頁面時,才會重新整理資料。 如果您的引數未顯示在回應權杖清單中,Target尚未重新整理資料。

此外,如果您的引數包含非英數字元或底線以外的任何符號,則引數不會出現在清單中。 目前僅支援英數和底線字元。

如果回應Token使用已刪除的設定檔指令碼或設定檔引數,仍會傳送內容嗎?

回應 Token 會從使用者設定檔中擷取資訊,然後傳送該資訊。如果您刪除設定檔指令碼或參數,這不代表該資訊已從使用者設定檔中移除。使用者設定檔仍然具有與設定檔指令碼對應的資料。 回應Token會繼續傳遞內容。 對於沒有將該資訊儲存在其設定檔中的使用者,或新訪客,該Token不會傳遞,因為資料不存在於其設定檔中。

Target不會自動關閉權杖。 如果您刪除設定檔指令碼,且不想再傳送 Token,則必須自行關閉 Token。

我已重新命名設定檔指令碼,但為何使用該指令碼的 Token 仍以舊名稱處於使用中狀態?

如上所述,回應 Token 會處理使用者已儲存的設定檔資訊。即使您重新命名了個人資料指令碼,造訪過您網站的使用者仍會將舊的個人資料指令碼值儲存在其個人資料中。 代號會繼續挑選已儲存在使用者設定檔中的舊值。 如果您現在想要以新名稱來傳送內容,則必須關閉先前的 Token,並開啟新的 Token。

如果我的屬性已變更,何時會從清單中移除這些屬性?

Target會定期執行屬性重新整理。 任何未切換的屬性都會在下次重新整理時移除。 不過,如果您有已切換且已移除的屬性,該指令碼不會從屬性清單中移除,直到您將其切換為關閉為止。 例如,您移除用來做為Token的設定檔指令碼。 刪除或重新命名時,Target只會從清單中移除已切換的屬性。

傳送資料給Google Analytics

以下各節說明如何將Target資料傳送至Google Analytics4。 回應Token傳送的資料也可傳送至其他第三方整合。

AEP徽章 透過Platform Web SDK傳送資料給Google Analytics

若要傳送Google Analytics,可透過Platform Web SDK 2.6.0版(或更新版本)在HTML頁面中新增下列程式碼。

NOTE
請確定回應Token金鑰值組位於alloy("sendEvent"物件下。
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
    alloy("sendEvent", {


    })
    .then(({ renderedPropositions, nonRenderedPropositions }) => {
        // concatenate all the propositions
        const propositions = [...renderedPropositions, ...nonRenderedPropositions];
        // extractResponseTokens() extract the meta from item -> meta
        const tokens = extractResponseTokens(propositions);
        const activityNames = [];
        const experienceNames = [];
        const uniqueTokens = distinct(tokens);


        uniqueTokens.forEach(token => {
            activityNames.push(token["activity.name"]);
            experienceNames.push(token["experience.name"]);
        });

        gtag('config', 'TAG_ID');
        gtag('event', 'action_name', {'eventCategory': 'target',
            'eventAction': experienceNames, 'eventLabel': activityNames
        });
    });
</script>

at.js badge 透過at.js傳送資料給Google Analytics section_04AA830826D94D4EBEC741B7C4F86156

在 HTML 頁面中新增下列程式碼,即可透過 at.js 將資料傳送至 Google Analytics:

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>

<script type="text/javascript">
    document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
        var tokens = e.detail.responseTokens;

        if (isEmpty(tokens)) {
            return;
        }

        var activityNames = [];
        var experienceNames = [];
        var uniqueTokens = distinct(tokens);

        uniqueTokens.forEach(function(token) {
            activityNames.push(token["activity.name"]);
            experienceNames.push(token["experience.name"]);
        });

        gtag('config', 'TAG_ID');
        gtag('event', 'action_name', {'eventCategory': 'target',
            'eventAction': experienceNames, 'eventLabel': activityNames
        });
    });

    function isEmpty(val) {
        return (val === undefined || val == null || val.length <= 0) ? true : false;
    }

    function key(obj) {
        return Object.keys(obj)
        .map(function(k) { return k + "" + obj[k]; })
        .join("");
    }

    function distinct(arr) {
        var result = arr.reduce(function(acc, e) {
            acc[key(e)] = e;
            return acc;
        }, {});

        return Object.keys(result)
        .map(function(k) { return result[k]; });
    }
</script>

除錯

以下小節提供除錯回應Token的相關資訊:

at.js badge 個Google Analytics和偵錯

以下程式碼可讓您使用Google Analytics進行偵錯:

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>

<script type="text/javascript">
    document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
      var tokens = e.detail.responseTokens;

      if (isEmpty(tokens)) {
        return;
      }

      var activityNames = [];
      var experienceNames = [];
      var uniqueTokens = distinct(tokens);

      uniqueTokens.forEach(function(token) {
        activityNames.push(token["activity.name"]);
        experienceNames.push(token["experience.name"]);
      });

      gtag('config', 'TAG_ID');
      gtag('event', 'action_name', {'eventCategory': 'target',
          'eventAction': experienceNames, 'eventLabel': activityNames
      });
    });

    function isEmpty(val) {
      return (val === undefined || val == null || val.length <= 0) ? true : false;
    }

    function key(obj) {
       return Object.keys(obj)
      .map(function(k) { return k + "" + obj[k]; })
      .join("");
    }

    function distinct(arr) {
      var result = arr.reduce(function(acc, e) {
        acc[key(e)] = e;
        return acc;
      }, {});

      return Object.keys(result)
      .map(function(k) { return result[k]; });
    }
</script>

使用等同於ttMeta外掛程式進行偵錯

將下列程式碼新增至 HTML 頁面,即可建立等同於 ttMeta 的外掛程式作為偵錯用途:

<script type="text/javascript" >
  document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function (e) {
    window.ttMETA= typeof(window.ttMETA)!="undefined" ? window.ttMETA : [];

    var tokens=e.detail.responseTokens;

    if (isEmpty(tokens)) {
      return;
    }

    var uniqueTokens = distinct(tokens);

    uniqueTokens.forEach(function(token) {
      window.ttMETA.push({
        'CampaignName': token["activity.name"],
        'CampaignId' : token["activity.id"],
        'RecipeName': token["experience.name"],
        'RecipeId': token["experience.id"],
        'OfferId': token["offer.id"],
        'OfferName': token["offer.name"],
        'MboxName': e.detail.mbox});
      console.log(ttMETA);
    });
  });

  function isEmpty(val){
    return (val === undefined || val == null || val.length <= 0) ? true : false;
  }

  function key(obj) {
     return Object.keys(obj)
    .map(function(k) { return k + "" + obj[k]; })
    .join("");
  }

  function distinct(arr) {
    var result = arr.reduce(function(acc, e) {
      acc[key(e)] = e;
      return acc;
    }, {});

    return Object.keys(result)
    .map(function(k) { return result[k]; });
  }
</script>

at.js 訓練影片:回應Token和at.js自訂事件 section_3AA0A6C8DBD94A528337A2525E3E05D5

以下影片說明如何使用回應Token和at.js自訂事件,共用從Target到協力廠商系統的設定檔資訊。

NOTE
Target Administration功能表UI (先前稱為Setup)已經過重新設計,可提供改良的效能、縮短發布新功能所需的維護時間,並改善整個產品的使用者體驗。 下列影片中的資訊是正確的;不過,選項的位置稍有不同。
影片中提到option.nameoption.id,已分別以offer.nameoffer.id取代。
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654