本頁面由 Cloud Translation API 翻譯而成。

轉換追蹤

警告：請確認轉換資料包含使用者個人身分不會將資訊 (PII) 傳送給 Google。

導入作業

摘要

導入轉換追蹤的程序分為三個部分：

從到達網頁 / 應用程式收集rwg_token和merchant_id 進入點。
保留 rwg_token 和 merchant_id，以利適當的歸因視窗。
比較轉換時持續的merchant_id和merchant_id (預訂完成)。
在轉換時傳送轉換事件 (預訂完成)。

您不需要透過 Google Analytics 或任何其他第三方 JavaScript

開始設定轉換追蹤前，決定您要在裝置層級或使用者層級追蹤轉換：

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機或任何其他可保留權杖 30 天歸屬期。權杖會儲存在本機使用者的裝置時，如果使用者變更目前使用的裝置，系統會將其清除儲存空間或 Cookie，或使用私密瀏覽或無痕模式轉換事件可能無法正確歸因。使用裝置層級時轉換追蹤，就必須在所有支援的途徑 (包括行動裝置)。
使用者層級包括將 ID 保留在應用程式資料庫中伺服器端分析系統或其他伺服器端系統。由於權杖會儲存在伺服器端，使用者變更裝置後使用、清除本機儲存或 Cookie，或使用私密存取在瀏覽或無痕模式下，轉換事件仍會歸因於一次使用者重新登入使用使用者層級轉換追蹤時，您或許可以在系統架構中並在所有支援的介面上重複使用

收集`rwg_token`

每次 Google 顯示您透過動態饋給提供的 action_link 時，網址會修改為包含不重複的查詢參數：rwg_token。 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;
  }
}

收集`merchant_id`

如果您是在前端導入轉換追蹤邏輯，則在到達網頁您必須導入自訂指令碼，以找出並擷取 merchant_id。merchant_id 通常已存在於到達網頁或網址，以便從該處擷取。如果不是，您就必須只要找出方法加以公開，就很容易隱瞞後端變更。

在後端導入轉換追蹤邏輯後， merchant_id，以及查詢內部系統所產生之資料前端頁面

這個merchant_id必須與你在動態饋給

保留 `rwg_token` 和 `merchant_id`

您必須保留 rwg_token 網址參數，也就是附加在您提供的所有動作連結中，總時長為 30 天。 rwg_token 的值應儲存及傳回，不得經過任何編輯。

除了 rwg_token 以外，您需要儲存相關聯的 merchant_id 與動作連結聯絡

如果存在自前次造訪以來已有的權杖，應替換 rwg_token 和 merchant_id，且為期 30 天的 Storage 的儲存空間就會需要重新設定儲存空間

保留上述組合時，可將值儲存在裝置中或使用者層級：

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機或任何其他可保留權杖 30 天歸屬期。
使用者層級包括將 ID 保留在應用程式資料庫中伺服器端分析系統或其他伺服器端系統。

以下提供裝置層級轉換追蹤範例，將這些值儲存在由網路瀏覽器使用第一方 Cookie這個範例假設您剖析了將符記值轉換成變數，如上例所示。使用這個範例時您需要將 rootdomain.com 更新為您的網域。

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

使用使用者層級轉換追蹤時，rwg_token + merchant_id 應會儲存在伺服器中，並與使用者的相關聯。

正在傳送轉換資料

使用者完成可歸因於 Google 地點的交易時動作連結，您必須將 HTTP POST 要求傳送至轉換端點。有兩個端點：一個用於 Production 環境，另一個用於沙箱環境。

正式版：https://www.google.com/maps/conversion/collect
沙箱：https://www.google.com/maps/conversion/debug/collect

文章內文應為 JSON 編碼的物件，並採用下列格式：

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

範例 (使用合作夥伴 20123456 且使用測試權杖的未變更商家)：

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

business_changed 值用於判斷商家是否已變更初始重新導向商家的值有兩種值可傳遞

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

在沙箱和實際執行環境中，您都必須提供有效的 rwg_token (也就是傳送轉換事件)。如要進行測試，請使用使用以下測試權杖，直到應用程式啟動為止：

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

如要在沙箱中測試，您需要將以下網址參數手動附加至您的沙箱連結：

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

裝置層級轉換追蹤的完整範例 (在使用者的裝置) 的 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
    })
  });
}

使用使用者層級轉換追蹤時，會關聯到伺服器端儲存機制，並使用相同的實際工作環境或沙箱端點

轉換歸因相關規定

Google 對轉換歸因的要求標準為 30 天歸因這個視窗。

這個歸屬期代表 Google 預期轉換事件會達到可以在以下任一情況傳送：

使用者追蹤地點動作連結，並向同一商家下單同一個工作階段(商家變更價值 = 2)
使用者點選地點動作連結，然後從其他管道回訪則為同一個商家下單的 30 天內。(商家變更值 = 2)
使用者點選地點動作連結，然後向其他位置下單儲存的資料 (在 30 天內於同一工作階段或 30 天內的不同工作階段內) 視窗。( 商家變更值 = 1)

此外，Google 則希望轉換事件從所有平台傳送使用者可以透過地點動作連結到達。包括：

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

如果權杖是儲存在使用者層級 (請參閱保留權杖)，則您需要使用跨裝置歸因分析也就是說，使用者在在電腦上加入動作連結，然後在行動裝置上完成交易 (使用同一個使用者帳戶) 應觸發轉換事件。

如果權杖只儲存在裝置層級 (例如在瀏覽器中) Cookie，這並不預期您需要提供跨裝置歸因。在本系統會保留個別權杖，如果使用者接續使用裝置上的動作連結，每部裝置都會追蹤歸因結果

即時更新