導入作業
摘要
轉換追蹤導入作業分為以下三部分:
-
從到達網頁 / 應用程式進入點收集
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
網址參數,這個參數會附加至您提供的所有動作連結,總時間長度為 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==
以下提供裝置層級轉換追蹤 (在使用者裝置上使用 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 }) }); }
使用使用者層級的轉換追蹤時,您應從伺服器端儲存機制擷取與使用者相關聯的權杖 (無論使用者所在的介面為何),並使用相同的正式版或沙箱端點傳送權杖。
轉換歸因規定
凡是與地點連結的互動,Google 規定轉換的歸屬期都是 30 天。
這個歸因期代表系統預期在以下任一情況下會傳送轉換事件:
- 使用者點選地點動作連結,並在同一個工作階段中下單
- 使用者點選地點動作連結,然後在 30 天內從其他管道返回訂購商品。
- 使用者點選地點動作連結,然後在同一個工作階段或 30 天內不同的工作階段內訂購其他商店。
此外,我們預期轉換事件會從使用者可以透過地點動作連結前往的所有介面傳送。包括:
- 桌面或行動網頁應用程式
- 行動應用程式 (透過應用程式深層連結,或是您網域中已註冊的應用程式意圖)
如果權杖儲存在使用者層級 (請參閱「保留權杖」一節),則應提供跨裝置歸因。也就是說,如果使用者是在電腦上前往某個動作連結,然後在行動裝置上 (使用相同使用者帳戶) 完成交易,就應觸發轉換事件。
如果權杖只儲存在裝置層級 (例如瀏覽器 Cookie),就不應提供跨裝置歸因功能。在這種情況下,如果使用者在裝置上點選動作連結,每部裝置都會有獨立的權杖,且每部裝置都會分別遵循歸因規則。