Bước 3: Theo dõi lượt chuyển đổi

Triển khai

Tóm tắt

Quy trình triển khai tính năng theo dõi lượt chuyển đổi gồm 3 phần:

1. Thu thập rwg_token từ trang đích / điểm truy cập ứng dụng.
2. Giữ nguyên rwg_token cho khoảng thời gian phân bổ thích hợp
3. Gửi sự kiện chuyển đổi tại bước thanh toán

Khi triển khai tính năng theo dõi lượt chuyển đổi này, bạn không cần phải sử dụng Google Analytics hoặc bất kỳ javascript nào khác của bên thứ ba.

Trước khi bắt đầu triển khai tính năng theo dõi lượt chuyển đổi, bạn nên quyết định xem mình sẽ theo dõi lượt chuyển đổi ở cấp thiết bị hay cấp người dùng:

• Cấp thiết bị bao gồm việc sử dụng cookie 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 trong khoảng thời gian phân bổ 30 ngày. 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ên nếu người dùng thay đổi thiết bị họ đang sử dụng, xoá bộ nhớ cục bộ/cookie hoặc đang sử dụng chế độ duyệt web riêng tư hoặc ẩn danh, thì sự kiện chuyển đổi có thể không được phân bổ đúng cách. Khi sử dụng tính năng theo dõi lượt chuyển đổi ở cấp thiết bị, bạn phải triển khai lại tính năng 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 việc lưu trữ trạng thái này trong cơ sở dữ liệu ứng dụng 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ủ khác. Vì mã thông báo sẽ được lưu trữ ở phía máy chủ, nên nếu người dùng thay đổi thiết bị đang sử dụng, xoá bộ nhớ cục bộ/cookie hoặc đang sử dụng chế độ duyệt web riêng tư hoặc chế độ ẩn danh, thì sự kiện chuyển đổi vẫn sẽ được phân bổ sau khi 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, tuỳ thuộc vào cấu trúc hệ thống, bạn có thể triển khai tính năng này một lần ở phía máy chủ và sử dụng lại trên tất cả các nền tảng được hỗ trợ.

Thu thập rwg_token

Mỗi khi Google hiển thị một action_link mà bạn đã cung cấp thông qua nguồn cấp dữ liệu, URL đó sẽ được sửa đổi để thêm một tham số truy vấn duy nhất: rwg_token. Giá trị rwg_token là một chuỗi đã mã hoá chứa một số siêu dữ liệu về đường liên kết 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 mã thông báo đó trở lại như một phần 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 giá trị được đặt cho tham số truy vấn rwg_token và lưu trữ giá trị đó. Các yêu cầu để lưu trữ thông số này được mô tả trong bước Giữ nguyên rwg_token.

Dưới đây là 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. Ngoài ra, bạn có thể thu thập mã thông báo này ở 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. Tham số này sẽ được thêm vào tất cả các đường liên kết hành động do bạn cung cấp, trong tổng thời gian là 30 ngày. Giá trị của rwg_token phải được lưu trữ và trả về mà không có bất kỳ nội dung chỉnh sửa nào. Nếu có mã thông báo hiện có được lưu giữ từ một lượt truy cập trước đó, thì mã thông báo cũ sẽ được thay thế và khoảng thời gian lưu trữ 30 ngày sẽ được đặt lại.

Khi lưu trữ mã thông báo, bạn có thể lưu trữ mã thông báo ở 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 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 trong khoảng thời gian phân bổ 30 ngày.
• Cấp người dùng bao gồm việc lưu trữ thông tin này trong cơ sở dữ liệu ứng dụng, 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ủ khác.

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ứ nhất. Ví dụ này giả định rằng 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 cần cập nhật "rootdomain" thành 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 phải được lưu trữ trên máy chủ và liên kết với người dùng.

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ó thể phân bổ cho một liên kết Hành động tại địa điểm của Google, bạn phải gửi một yêu cầu POST HTTP đến điểm cuối chuyển đổi. Có hai điểm cuối, một điểm cuối cho môi trường phát hành chính thức và một điểm cuối cho môi trường hộp cát.

• Phát hành chính thức: 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à một đối tượng được mã hoá bằng JSON ở đị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 sẽ phải cung cấp rwg_token hợp lệ khi gửi sự kiện chuyển đổi. Để kiểm thử trong môi trường hộp cát, bạn có thể sử dụng mã thông báo kiểm thử sau.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Dưới đây là ví dụ đầy đủ về cách 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:

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ể họ đang ở nền tảng nào) từ cơ chế lưu trữ phía máy chủ và gửi mã thông báo đó bằng cùng một điểm cuối trong môi trường thực tế 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 về mô hình phân bổ lượt chuyển đổi là khoảng thời gian phân bổ 30 ngày cho mọi lượt tương tác với đường liên kết đến địa điểm tại bất kỳ cửa hàng nào.

Khoảng thời gian phân bổ này có nghĩa là chúng tôi dự kiến sẽ gửi một sự kiện chuyển đổ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 tại địa điểm và đặt hàng trong cùng một phiên
• Người dùng nhấp vào đường liên kết của hành động đặt phòng, sau đó quay lại từ một kênh khác trong khoảng thời gian 30 ngày để đặt phòng.
• Người dùng nhấp vào đường liên kết hành động tại địa điểm, sau đó đặt hàng tại một cửa hàng khác, trong cùng một phiên hoặc một phiên khác trong khoảng thời gian 30 ngày.

Ngoài ra, chúng tôi dự kiến sự kiện chuyển đổi sẽ được gửi từ tất cả các nền tảng mà người dùng có thể truy cập từ đường liên kết đến 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 di động, thông qua đường liên kết sâu trong ứng dụng hoặc ý định ứng dụng đã đăng ký 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 trữ mã thông báo), thì bạn phải cung cấp tính năng phân bổ trên nhiều thiết bị. Tức là một người dùng truy cập vào đường liên kết dẫn đến hành động trên máy tính, sau đó hoàn tất giao dịch trên thiết bị di động (bằng cùng một tài khoản người dùng) sẽ kích hoạt mộ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 trình duyệt, thì bạn không nên cung cấp tính năng phân bổ trên nhiều thiết bị. Trong trường hợp này, mỗi thiết bị sẽ có một mã thông báo riêng biệt được duy trì nếu người dùng đã nhấp vào một đườ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.