導入作業
摘要
導入轉換追蹤的程序分為三個部分:
- 從到達網頁 / 應用程式進入點收集
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==
如要在沙箱中測試,您需要手動將以下網址參數附加到沙箱連結:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
以下為如何提出貼文要求的 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 中),就不太可能提供跨裝置歸因。在這種情況下,如果使用者依序在該裝置上追蹤動作連結,每部裝置都會保留個別的權杖,且每部裝置都會分別遵循歸因規則。