Triển khai
Tóm tắt
Có ba phần trong việc triển khai tính năng theo dõi lượt chuyển đổi:
-
Thu thập
rwg_tokentừ trang đích / điểm truy cập ứng dụng. -
Duy trì
rwg_tokencho thời lượng phân bổ thích hợp - Gửi một sự kiện chuyển đổi khi thanh toán
Việc triển khai tính năng theo dõi lượt chuyển đổi này không yêu cầu bạn sử dụng Google Analytics hoặc bất kỳ javascript nào của bên thứ ba khác.
Trước khi bắt đầu triển khai tính năng theo dõi chuyển đổi, bạn nên quyết định nếu bạn định theo dõi lượt chuyển đổi ở cấp thiết bị hoặc cấp người dùng:
- Cấp thiết bị bao gồm việc sử dụng cookie của trình duyệt, cục bộ bộ nhớ cục bộ, bộ nhớ cục bộ của ứng dụng hoặc bất kỳ phương thức nào khác có thể duy trì mã thông báo cho thời lượng phân bổ 30 ngày. Bởi vì mã thông báo sẽ được lưu trữ cục bộ trên thiết bị của người dùng nếu người dùng thay đổi thiết bị mà họ đang sử dụng, xoá bộ nhớ cục bộ/cookie của họ hoặc đang sử dụng duyệt web ở chế độ riêng tư hoặc chế độ ẩn danh, sự kiện chuyển đổi có thể không được phân bổ đúng. Khi sử dụng cấp độ thiết bị theo dõi chuyển đổi, bạn phải triển khai lại điều này trên mỗi nền tảng được hỗ trợ (bao gồm cả thiết bị di động).
- Cấp người dùng bao gồm cả việc duy trì ứng dụng trong ứng dụng của bạn thông qua hệ thống phân tích phía máy chủ hoặc các hệ thống phía máy chủ. Bởi vì mã thông báo sẽ được lưu trữ trên phía máy chủ, nếu người dùng thay đổi thiết bị họ đang sử dụng, sẽ xoá bộ nhớ cục bộ/cookie của họ hoặc đang sử dụng duyệt web ở chế độ riêng tư hoặc ở chế độ ẩn danh, sự kiện chuyển đổi sẽ vẫn được phân bổ một lần người dùng đăng nhập lại. Khi sử dụng tính năng theo dõi lượt chuyển đổi cấp người dùng, tùy thuộc vào cấu trúc của hệ thống, bạn có thể hãy triển khai lệnh này một lần trên máy chủ của bạn và sử dụng lại nó trên tất cả nền tảng được hỗ trợ.
Đang thu thập rwg_token
Mỗi khi Google hiển thị một action_link mà bạn đã cung cấp
Nguồn cấp dữ liệu, url đó sẽ được sửa đổi để bao gồm một truy vấn duy nhất
tham số: rwg_token. rwg_token
là một chuỗi được mã hoá chứa một số siêu dữ liệu về
mà người dùng đã nhấp vào. Bạn sẽ lưu trữ mã thông báo này và chuyển lại dưới dạng
của sự kiện chuyển đổi.
Trên mỗi trang đích / điểm truy cập ứng dụng, bạn phải phân tích cú pháp tập hợp giá trị
cho tham số truy vấn rwg_token và lưu trữ tham số đó. Yêu cầu đối với
việc lưu trữ thông số này được mô tả trong bước, Duy trì
rwg_token.
Ví dụ về cách phân tích cú pháp mã thông báo này để theo dõi ở cấp thiết bị thông qua trình duyệt được liệt kê bên dưới. Ngoài ra, bạn có thể thu thập mã thông báo này trên phía máy chủ khi phản hồi yêu cầu:
<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>
Duy trì rwg_token
Bạn sẽ phải duy trì tham số URL rwg_token.
sẽ được nối vào tất cả các đường liên kết hành động do bạn cung cấp, để tính tổng
kéo dài 30 ngày. Giá trị của rwg_token phải là
được lưu trữ và trả lại mà không có bất kỳ chỉnh sửa nào.
Nếu vẫn còn mã thông báo sau lần truy cập trước, thì
mã thông báo cũ phải được thay thế và thời hạn 30 ngày để lưu trữ
phải được đặt lại.
Khi duy trì mã thông báo, bạn có thể lưu trữ mã này tại ở cấp thiết bị hoặc ở cấp người dùng:
- Cấp thiết bị bao gồm việc sử dụng cookie của trình duyệt, bộ nhớ cục bộ, bộ nhớ cục bộ của ứng dụng hoặc bất kỳ phương thức nào khác có thể duy trì mã thông báo cho thời lượng phân bổ 30 ngày.
- Cấp người dùng bao gồm việc duy trì API này trong cơ sở dữ liệu ứng dụng của bạn, thông qua hệ thống phân tích phía máy chủ hoặc các hệ thống khác phía máy chủ.
Dưới đây là ví dụ về tính năng theo dõi lượt chuyển đổi ở cấp thiết bị, lưu trữ mã thông báo này trong trình duyệt web thông qua cookie của bên thứ ba. Ví dụ này giả định bạn đã phân tích cú pháp giá trị mã thông báo thành một biến như trong ví dụ trên. Để sử dụng ví dụ này, bạn sẽ cần cập nhật "rootdomain" (miền gốc) cho miền của mình.
<script>
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}
</script>
Khi sử dụng tính năng theo dõi lượt chuyển đổi ở cấp người dùng, rwg_token nên
được lưu trữ trên máy chủ và được liên kết với người dùng.
Đang gửi dữ liệu lượt chuyển đổi
Khi người dùng hoàn tất một giao dịch được cho là do liên kết Hành động với địa điểm của Google, bạn phải gửi yêu cầu POST qua HTTP tới điểm cuối chuyển đổi. Có hai điểm cuối, một điểm cuối dành cho quá trình sản xuất và một dành cho môi trường hộp cát.
- Phát hành công khai:
https://www.google.com/maps/conversion/collect - Hộp cát:
https://www.google.com/maps/conversion/debug/collect
Nội dung bài đăng phải là đối tượng mã hoá json theo định dạng:
{
'conversion_partner_id': partnerId,
'rwg_token': <rwg_token_val>
}
Trong cả môi trường hộp cát và môi trường phát hành công khai, bạn đều bắt buộc phải
cung cấp rwg_token hợp lệ khi gửi sự kiện chuyển đổi.
Đối với mục đích thử nghiệm trong môi trường hộp cát, bạn có thể sử dụng các
mã thông báo thử nghiệm.
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
Ví dụ đầy đủ về tính năng theo dõi lượt chuyển đổi ở cấp thiết bị (sử dụng cookie trên thiết bị của người dùng) trong javascript về cách tạo yêu cầu đăng này là bao gồm bên dưới:
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
})
});
}
Khi sử dụng tính năng theo dõi lượt chuyển đổi cấp người dùng, bạn nên truy xuất mã thông báo được liên kết với người dùng (bất kể nền tảng bật) từ cơ chế lưu trữ phía máy chủ của bạn rồi gửi bằng cách sử dụng cùng một điểm cuối chính thức hoặc hộp cát.
Yêu cầu về mô hình phân bổ lượt chuyển đổi
Tiêu chuẩn bắt buộc của Google để phân bổ lượt chuyển đổi là thời lượng 30 ngày thời lượng phân bổ cho bất kỳ lượt tương tác nào với một đường liên kết đến địa điểm, tại bất kỳ thời điểm nào của bạn.
Khoảng thời gian phân bổ này có nghĩa là chúng tôi mong đợi một chuyển đổi sự kiện được gửi trong bất kỳ trường hợp nào sau đây:
- Người dùng nhấp vào đường liên kết đến hành động liên quan đến địa điểm và đặt hàng trong cùng phiên
- Người dùng nhấp vào đường liên kết đến hành động liên quan đến địa điểm, sau đó quay lại từ kênh khác nhau trong thời hạn 30 ngày để đặt hàng.
- Người dùng truy cập vào đường liên kết đến hành động liên quan đến địa điểm, sau đó đặt hàng tại cửa hàng khác nhau, trong cùng một phiên hoạt động hoặc trong khoảng thời gian 30 ngày.
Ngoài ra, chúng tôi dự kiến sẽ gửi các sự kiện chuyển đổi từ tất cả hiển thị mà người dùng có thể truy cập từ một đường liên kết hành động liên quan đến địa điểm. Bao gồm:
- Ứng dụng web dành cho máy tính hoặc thiết bị di động
- Ứng dụng dành cho thiết bị di động, thông qua đường liên kết sâu của ứng dụng hoặc ý định trong ứng dụng cho miền của bạn
Nếu mã thông báo được lưu trữ ở cấp người dùng (xem phần lưu giữ mã thông báo), có thể dự kiến mà bạn cung cấp mô hình phân bổ trên nhiều thiết bị. Tức là một người dùng truy cập một liên kết hành động từ máy tính để bàn rồi hoàn tất giao dịch trên thiết bị di động (sử dụng cùng một tài khoản người dùng), sẽ kích hoạt sự kiện chuyển đổi.
Nếu mã thông báo được lưu trữ riêng ở cấp thiết bị, chẳng hạn như trong cookie của trình duyệt, bạn sẽ không thể cung cấp dữ liệu trên nhiều thiết bị phân bổ giá trị đóng góp. Trong trường hợp này, mỗi thiết bị sẽ có một mã thông báo riêng vẫn tồn tại nếu người dùng đã nhấp vào đường liên kết hành động trên thiết bị đó, và mỗi thiết bị sẽ tuân theo các quy tắc phân bổ riêng biệt.