轉換追蹤

圖 1：轉換追蹤總覽

摘要

轉換追蹤功能可追蹤 Google 透過行動中心整合其中一個功能啟動的轉換。這項設定對於維持整合功能的健康運作至關重要，也可能影響特定網頁的排名。每次 Google 顯示 action_link 時，該網址都會修改為包含專屬查詢參數：rwg_token。您可以自行儲存該權杖，並在使用者完成預訂時傳回適當的值。

如要完成整合，請完成下列事項：

1. 收集並儲存 rwg_token。
2. 收集並儲存商家。
3. 傳回 rwg_token 和 merchant_change 值。
4. 測試並驗證轉換追蹤。

收集並儲存 rwg_token。

如要完成這項整合，您必須在首次 Google 轉介後的 30 天內收集並儲存 rwg_token。rwg_token 值是經過編碼的字串，其中包含關於連結和產生該動作連結的銷售方的一些中繼資料。請注意，權杖中不會儲存或加密任何使用者資料。

符記集合

使用者前往預訂頁面時，系統會在提供的網址中附加新的查詢參數 rwg_token。您必須在訂房頁面中剖析值。我們也提供範例，說明如何剖析這個權杖，以便透過瀏覽器進行裝置層級追蹤。

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

附加到網址的查詢參數會是加密權杖，請參閱以下 rwg_token 範例。請使用這個範例權杖，確保您正確剖析權杖，包括任何特殊字元，例如「="」。以下是典型權杖的範例。

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

符記儲存空間

儲存 rwg_token 時，您可以採用兩種層級導入轉換追蹤功能：裝置層級和使用者層級。您可以自行決定要將權杖儲存在何處，但您必須在首次參照後 30 天內儲存權杖。

下一個範例是裝置層級轉換追蹤，使用第一方 Cookie 將這些值儲存在網路瀏覽器中。本例假設您已將權杖值剖析為變數，如「權杖儲存」範例所示。請務必使用您的網域更新 rootdomain.com。

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

決定儲存 rwg_token 的位置時，請考量下列事項。

裝置層級儲存空間

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可在 30 天歸因期間保留權杖的方法。由於權杖會儲存在使用者的裝置本機，因此如果使用者變更所使用的裝置、清除本機儲存空間或 Cookie，或是使用私密瀏覽或無痕模式，轉換事件可能就無法正確歸因。使用裝置層級轉換追蹤時，您必須在所有支援的介面 (包括行動版) 中重新實作這項功能。

使用者層級儲存空間

使用者層級包括透過伺服器端分析系統或其他伺服器端系統，將資料儲存在應用程式資料庫中。由於權杖會儲存在伺服器端，因此如果使用者變更所用裝置、清除本機儲存空間或 Cookie，或是使用私密瀏覽或無痕模式，轉換事件仍會在使用者重新登入時歸因。使用使用者層級轉換追蹤時，視系統架構而定，您可以在伺服器端實作一次，並在所有支援的途徑中重複使用。

每當 Google 透過動態饋給顯示您提供的 action_link 時，該網址都會修改為包含專屬的查詢參數：rwg_token。rwg_token 值是經過編碼的字串，其中包含使用者點選的連結相關中繼資料，但不含使用者資料。您應儲存此權杖，並將其傳回做為轉換事件的一部分。

更新權杖

當使用者由 Google 導向至同一家商家時，如果已儲存現有憑證，系統會將該憑證替換為最新導向的全新憑證。憑證取代後，憑證儲存的 30 天回溯期會重設，而這位商家的任何新轉換都應歸因於最新的憑證。

詳情請參閱轉換歸因規定。

收集並儲存商家。

當使用者前往預訂網頁時，您必須實作邏輯，找出並擷取商家。合作夥伴通常會在動作連結中加入商家中繼資料或 merchant_id，並用於識別及儲存商家。建議您將 merchant_id (或所選 ID) 與 rwg_token 一併儲存，這樣當使用者確認預訂時，您就能在傳送完成的轉換要求前，先參照商家。與符記儲存期限相似，商家必須在初始轉介後的 30 天內，透過符記儲存。

以下範例會調整先前儲存的 rwg_token。這項操作假設您會從提供的網址中繼資料中剖析商家，並將其儲存為 merchant_id，或與現有的 merchant_id 比對。

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

傳回 rwg_token 和 merchant_change 值。

如果使用者透過 Action Link 推薦完成預訂，您必須將 HTTP POST 要求傳送至轉換端點。有兩個端點，一個用於正式環境，另一個用於沙箱環境。

• 正式版：https://www.google.com/maps/conversion/collect
• Sandbox：https://www.google.com/maps/conversion/debug/collect

傳送轉換事件時，您必須加入已儲存的 rwg_token，以及 1 或 2 的 merchant_change 值。如要進一步瞭解 merchant_change，請參閱「傳回商家變更值」。

POST 主體應為 JSON 編碼物件，格式如下：

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

以下範例包含使用使用者裝置上 Cookie 的裝置層級轉換追蹤，並以 JavaScript 編寫：

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

注意： 系統僅接受 text/plain MIME Content-Type。請勿在標頭中設定任何其他 Content-Type。否則會收到 CORS 錯誤。

警告：請確認轉換資料中沒有傳送使用者的個人識別資訊 (PII)。

注意：在實際環境中，請勿傳送與此整合無關的轉換事件。最佳做法是在傳送事件前，先檢查是否有有效且未過期的 rwg_token 值。

傳回商家變更值

merchant_changed 值可用於判斷商家是否已從初始重新導向商家變更。如果到達網頁位於包含其他商家的平台中，變更商家是很常見的情況。在這種情況下，如果使用者是透過 Google 連至您的平台，並決定前往其他商家完成預訂，我們會想知道轉換發生，但由不同的商家完成，我們不需要知道商家，只需要知道轉換事件發生，且商家不同，我們會使用布林值來判斷商家是否已變更。

決定要為 merchant_change 指派哪個值時，您需要取用在「收集及儲存商家資訊」中儲存的原始商家，並檢查商家是否已變更，然後在指派值時參考下表。

如果您的預訂頁面不在平台中，或使用者無法前往其他商家，您可以將這些要求的值硬式編碼為 2。如果合作夥伴將預訂頁面整合至商家的網站，或有用於處理預訂的自訂到達網頁，就會發生這種情況。

商家變更值	需求
1	使用者離開原始商家網站，並透過您的平台向其他商家完成購物時，應使用這個值
2	當消費者透過原始實體 (商家) 完成交易時，應使用這個值。

測試並驗證轉換追蹤。

為確保轉換追蹤導入正確，您需要執行下列測試。請務必使用與商家綁定的動作連結，並在私人或無痕式視窗中提出要求，確保已清除與該使用者相關的任何先前權杖。

1. 只需使用動作連結即可完成預訂
   • 沒有推薦或先前儲存的權杖的直接預訂，不應導致任何要求傳送至 Google。
2. 使用附加 rwg_token 的連結完成預訂。
   • 確認要求成功，並傳送 2 的 rwg_token 和 merchant_change 值
   • 請務必將 rwg_token 儲存 30 天
3. 使用新的 rwg_token，向相同商家完成新的預訂。
   • 確認要求成功，並附上 2 的新 rwg_token 和 merchant_change 值
   • 確保權杖的歸因儲存期限為 30 天
4. 直接前往您要測試的商家預訂頁面，並在不附加 rwg_token 的情況下進行新預訂。
   • 請確認要求是使用先前儲存的 rwg_token 傳送，且 merchant_change 值為 2

如果您是平台，且使用者可以透過其他商家結帳，請測試以下項目。

1. 使用附加 rwg_token 的連結前往商家的預訂頁面，然後繼續前往其他商家並進行預訂。
   • 請確認要求傳送時，1 的 rwg_token 和 merchant_change 值

測試時，請將 HTTP POST 要求傳送至轉換端點。有兩個端點，一個用於正式環境，另一個用於沙箱環境。

• 正式版：https://www.google.com/maps/conversion/collect
• Sandbox：https://www.google.com/maps/conversion/debug/collect

您必須在動作連結或網址中加上下列符記：

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

針對需要額外符記的測試，請使用下列符記。

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

傳送成功的轉換事件後，您可以在「轉換追蹤」資訊主頁下方的「行動中心」中，查看匯總的轉換事件。請注意，轉換最多可能需要一小時才會顯示在資訊主頁中。

轉換歸因規定

Google 的轉換歸因標準規定，任何商店的任何地點連結互動，都會設為 30 天的歸因回溯期。

這個歸因回溯期表示 Google 會在下列任一情況下傳送轉換事件：

• 使用者點選商店動作連結，並在同一工作階段向同一間商家下單。(商家變更值 = 2)
• 使用者點選商店動作連結，然後在 30 天內透過其他管道返回，為同一家商家下單。(Merchant Change Value = 2 )
• 使用者點選地點動作連結，然後在 30 天內，在同一個工作階段或其他工作階段中向其他商店下單。( Merchant Change Value = 1 )

此外，Google 預期轉換事件會從使用者透過地點動作連結進入的所有途徑傳送。包括：

• 電腦版或行動版網頁應用程式
• 行動應用程式，透過應用程式深層連結或網域註冊的應用程式意圖

如果符記儲存在使用者層級 (請參閱「持續使用符記」)，則您應提供跨裝置歸因資訊。也就是說，如果使用者在電腦上點選動作連結，然後在行動裝置上 (使用相同的使用者帳戶) 完成交易，就會觸發轉換事件。

如果權杖僅儲存在裝置層級 (例如瀏覽器 Cookie)，則不應提供跨裝置歸因。在這種情況下，如果使用者在裝置上點選動作連結，每部裝置都會保留專屬的權杖，且每部裝置都會個別遵循歸因規則。

注意： 這個歸因架構可能與您的數據分析系統歸因轉換的方式不同。這個系統會獨立於您在系統中進行的任何轉換追蹤運作，且不應影響內部分析。