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

步驟 3：轉換追蹤

導入作業

摘要

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

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

導入轉換追蹤時，您不必使用 Google Analytics (分析) 或任何其他第三方 JavaScript。

開始導入轉換追蹤前，您需要先決定要追蹤裝置層級還是使用者層級的轉換：

裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可在 30 天歸屬期內保留權杖的方法。由於權杖會儲存在使用者的裝置本機上，因此，如果使用者變更目前使用的裝置、清除本機儲存空間/Cookie，或者使用私密瀏覽或無痕模式，轉換事件可能就無法正確歸因。使用裝置層級轉換追蹤時，您必須在所有支援的平台 (包括行動裝置) 中重新導入這項功能。
使用者層級包括透過伺服器端分析系統或其他伺服器端系統，將憑證保存在應用程式資料庫中。由於權杖會儲存在伺服器端，因此，如果使用者變更目前使用的裝置、清除本機儲存空間/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。為了在沙箱環境中進行測試，您可以使用下列測試權杖。

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

注意：在實際工作環境中，請勿傳送未歸因於此整合作業的轉換事件。傳送事件前，請務必檢查 rwg_token 值是否有效且未過期。

以下提供裝置層級轉換追蹤 (在使用者裝置上使用 Cookie) 的完整範例，以如何提出此發布要求為例：

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)，則預期不會提供跨裝置歸因。在此情況下，如果使用者在該裝置上點選動作連結，且每部裝置會分別遵循歸因規則，則每部裝置都會保有不同的權杖，

步驟 2：動態饋給

步驟 4：前測和推出