導入作業
摘要
導入轉換追蹤的程序分為三個部分：
- 從到達網頁 / 應用程式進入點收集
rwg_token和merchant_id。 - 針對適當的歸因期間保留
rwg_token和merchant_id。 - 比較轉換時的
merchant_id和merchant_id(預訂完成)。 - 在轉換時傳送轉換事件 (預訂完成)。
導入轉換追蹤時，您不需要使用 Google Analytics (分析) 或任何其他第三方 JavaScript。
著手導入轉換追蹤前，請先決定要追蹤裝置層級或使用者層級的轉換：
- 裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可保留權杖達 30 天歸因期的方法。由於權杖會儲存在使用者的裝置本機上，因此如果使用者變更目前使用的裝置，請清除本機儲存空間或 Cookie，或是使用私密瀏覽/無痕模式，否則轉換事件可能無法正確歸因。使用裝置層級轉換追蹤時，請務必在所有支援的介面 (包括行動裝置) 上重新導入此轉換。
- 使用者層級的資料包括透過伺服器端分析系統或其他伺服器端系統，保存在應用程式資料庫中。由於權杖會儲存在伺服器端，如果使用者變更目前使用的裝置、清除本機儲存空間或 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 必須與您在動態饋給中提供給 Google 的 ID 相同。
保留 rwg_token 和 merchant_id
您必須保留 rwg_token 網址參數，該參數會附加至您提供的所有動作連結，總時長為 30 天。rwg_token 的值應儲存及傳回，不得經過任何編輯。
除了 rwg_token 以外，您也必須儲存與動作連結相關聯的 merchant_id。
如果上次造訪時已有保留中的權杖，則應替換先前的 rwg_token 和 merchant_id，並重設 30 天的儲存空間回溯期。
保留上述組合時，您可以將值儲存在裝置層級或使用者層級：
- 裝置層級包括使用瀏覽器 Cookie、本機儲存空間、應用程式本機儲存空間，或任何其他可保留權杖達 30 天歸因期的方法。
- 使用者層級的資料包括透過伺服器端分析系統或其他伺服器端系統，保存在應用程式資料庫中。
以下舉例說明裝置層級轉換追蹤 (如何使用第一方 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 要求。系統會有兩個端點，一個用於正式環境，另一個用於沙箱環境。
- 正式版：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==
以下為如何提出貼文要求的 JavaScript 範例，說明裝置層級轉換追蹤 (使用使用者裝置上的 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,
merchant_changed: merchantChanged
})
});
}
採用使用者層級轉換追蹤時，您應從伺服器端儲存機制擷取與使用者相關聯的權杖 (無論使用者所在的介面為何)，然後使用相同的實際執行環境或沙箱端點傳送權杖。
轉換歸因相關規定
Google 的轉換歸因標準規定，對於任何商店中的地點連結互動，一律採用 30 天的歸因期。
這個歸屬期意味著 Google 預期在下列情況中傳送轉換事件：
- 使用者點選地點動作連結，並在同一個工作階段中向同一商家下訂單。(商家變更價值 = 2)
- 使用者點選地點動作連結，然後於 30 天內從其他管道返迴向同一商家下單。(商家 變更價值 = 2)
- 使用者點選地點動作連結，然後在不同的商店下單 (在同一工作階段或 30 天的不同工作階段內下單)。( 商家變更值 = 1)
此外，Google 預期轉換事件從使用者能透過地點動作連結到達的所有平台傳送。包含：
- 電腦版或行動版網頁應用程式
- 行動應用程式，可透過應用程式深層連結或網域中註冊的應用程式意圖。
如果權杖儲存在使用者層級 (請參閱保留權杖)，則您應提供跨裝置歸因。也就是說，使用者在電腦上點按動作連結後，接著在行動裝置上 (使用同一個使用者帳戶) 完成交易，應會觸發轉換事件。
如果權杖只儲存在裝置層級 (例如儲存在瀏覽器 Cookie 中)，就不太可能提供跨裝置歸因。在這種情況下，如果使用者依序在該裝置上追蹤動作連結，每部裝置都會保留個別的權杖，且每部裝置都會分別遵循歸因規則。