轉換追蹤

導入作業

摘要

導入轉換追蹤時，需要完成下列三項工作：

從到達網頁 / 應用程式進入點收集 rwg_token。
在適當的歸因期內保留 rwg_token
在結帳時傳送轉換事件

導入這項轉換追蹤功能時，您不需要使用 Google Analytics 或任何其他第三方 JavaScript。

開始導入轉換追蹤功能前，請先決定要追蹤裝置層級或使用者層級的轉換：

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可在 30 天歸因期間內保留權杖的方法。由於權杖會儲存在使用者裝置的本機，如果使用者變更使用的裝置、清除本機儲存空間/Cookie，或是使用私密瀏覽或無痕模式，轉換事件可能就無法正確歸因。使用裝置層級轉換追蹤時，您必須在每個支援的介面 (包括行動裝置) 重新導入這項功能。
使用者層級包括透過伺服器端分析系統或其他伺服器端系統，將 ID 保存在應用程式資料庫中。由於權杖會儲存在伺服器端，因此即使使用者變更裝置、清除本機儲存空間/Cookie，或使用私密瀏覽/無痕模式，只要使用者重新登入，系統仍會歸因轉換事件。使用使用者層級轉換追蹤時，視系統架構而定，您或許可以在伺服器端實作一次，並在所有支援的平台重複使用。

收集 `rwg_token`

每當 Google 透過動態消息顯示你提供的 action_link 時，系統就會修改該網址，加入專屬查詢參數：rwg_token。rwg_token 值是經過編碼的字串，內含使用者點選連結的部分中繼資料。您會儲存這個權杖，並在轉換事件中傳回。

您必須在每個到達網頁 / 應用程式進入點剖析為 rwg_token 查詢參數設定的值，並儲存該值。如要瞭解儲存這項參數的相關規定，請參閱「保留 rwg_token」步驟。

以下範例說明如何透過瀏覽器剖析這個權杖，以追蹤裝置層級。或者，您可以在回應要求時，在伺服器端收集這個權杖：

<script>
  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;
    }
  }
</script>

保存 `rwg_token`

注意：持續保留 rwg_token 是正確導入必要歸因期間的關鍵。如要進一步瞭解歸因規定，請參閱下方的「轉換歸因規定」一節。

您必須保留 rwg_token 網址參數，並將其附加至您提供的所有動作連結，保留時間總共 30 天。rwg_token 的值應儲存並傳回，不得經過任何編輯。如果先前造訪時已儲存權杖，則應替換舊權杖，並重設 30 天的儲存期限。

保存權杖時，您可以將權杖儲存在裝置層級或使用者層級：

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可在 30 天歸因期間內保留權杖的方法。
使用者層級包括在應用程式資料庫中保存該值，方法是透過伺服器端分析系統或其他伺服器端系統。

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

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

使用使用者層級轉換追蹤時，rwg_token 應儲存在伺服器上，並與使用者建立關聯。

傳送轉換資料

如果使用者完成的交易歸因於 Google 地點動作連結，您必須向轉換端點傳送 HTTP POST 要求。有兩個端點，分別用於正式環境和沙箱環境。

正式版：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>
}

無論是在沙箱或正式版環境中，傳送轉換事件時都必須提供有效的 rwg_token。如要在沙箱環境中進行測試，可以使用下列測試權杖。

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

注意：在正式環境中，您不應傳送未歸因於這項整合的轉換事件。請務必先檢查 rwg_token 值是否有效且未過期，再傳送事件。

以下是 JavaScript 中裝置層級轉換追蹤 (使用使用者裝置上的 Cookie) 的完整範例，說明如何發出這項 POST 要求：

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
    })
  });
}

使用使用者層級轉換追蹤時，您應從伺服器端儲存機制擷取與使用者相關聯的權杖 (無論使用者位於哪個平台)，並使用相同的正式版或沙箱端點傳送權杖。

注意：轉換事件可從網站或應用程式用戶端傳送，也可從伺服器傳送。您可以根據需求和權杖的儲存位置做出這項決定，但請務必確保每個轉換只傳送一次轉換事件，且包含有效的 rwg_token 值。

轉換歸因規定

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

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

使用者點選地點動作連結，並在同一個工作階段中下單
使用者點選地點動作連結，然後在 30 天內透過其他管道返回並下單。
使用者點選地點動作連結，然後在 30 天內於不同商店下單，無論是在同一個工作階段或不同工作階段。

此外，我們也希望使用者從地點動作連結進入的所有介面，都能傳送轉換事件。包括：

電腦或行動裝置網頁應用程式
行動應用程式 (透過應用程式深層連結或網域的已註冊應用程式意圖)

如果權杖儲存在使用者層級 (請參閱保留權杖)，您應提供跨裝置歸因。也就是說，使用者在電腦上點選動作連結，然後在行動裝置上完成交易 (使用相同的使用者帳戶)，就應該觸發轉換事件。

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