Trang này được dịch bởi Cloud Translation API.

Theo dõi lượt chuyển đổi

Triển khai

Tóm tắt

Có 3 phần trong quá trình triển khai tính năng theo dõi lượt chuyển đổi:

Thu thập rwg_token từ trang đích / điểm truy cập của ứng dụng.
Duy trì rwg_token trong 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 của bên thứ ba nào khác.

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 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 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 trong thời lượng 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ị đang dùng, xoá bộ nhớ cục bộ hay cookie, hoặc đang sử dụng chế độ duyệt web riêng tư hay chế độ ẩ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 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 duy trì dữ liệu đó 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 phía máy chủ khác. Vì mã thông báo sẽ được lưu trữ ở phía máy chủ, nếu người dùng thay đổi thiết bị đang sử dụng, xoá bộ nhớ cục bộ hoặc cookie hay đang sử dụng chế độ duyệt web riêng tư hoặc chế độ ẩn danh, sự kiện chuyển đổi vẫn đượ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ả nền tảng được hỗ trợ.

Đang thu thập rwg_token

Mỗi lần 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 để bao gồ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 nên lưu trữ mã thông báo này và chuyển lại mã này dưới dạng một phần của sự kiện chuyển đổi.

Trên mỗi trang đích / điểm truy cập của ứng dụng, bạn phải phân tích cú pháp giá trị đã đặt cho tham số truy vấn rwg_token và lưu trữ thông số đó. Các yêu cầu để lưu trữ tham số này được mô tả trong bước, Duy trì 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 bắt buộc phải duy trì tham số URL rwg_token. Tham số này sẽ được thêm vào tất cả đường liên kết hành động do bạn cung cấp trong tổng thời gian 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ỳ chỉnh sửa nào.

Cùng với rwg_token, bạn cần lưu trữ merchant_id được liên kết với đường liên kết hành động.

Nếu vẫn còn mã thông báo từ lượt truy cập trước, bạn nên thay thế rwg_token và merchant_id trước đó cũng như đặt lại khoảng thời gian lưu trữ 30 ngày.

Khi duy trì cặp trên, bạn có thể lưu trữ các giá trị ở 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 trong thời lượng phân bổ 30 ngày.
Cấp độ người dùng bao gồm việc duy trì dữ liệu đó 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 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ữ các giá trị này trong trình duyệt web bằng cách sử dụng cookie của bên thứ nhất. 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 cần cập nhật "rootdomain" cho miền của mình.

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";_merchant_id="+merchantid +";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, bạn phải lưu trữ rwg_token + merchant_id trên máy chủ và 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ó thể bắt nguồn từ đường liên kết đến Google Place Action, bạn phải gửi yêu cầu POST qua HTTP đến điểm cuối chuyển đổi. Có 2 điểm cuối, một dành cho môi trường 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 được mã hoá JSON ở định dạng:

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>
  "merchant_changed": 1|2
}

Giá trị merchant_change dùng để xác định xem người bán có bị thay đổi từ người bán chuyển hướng ban đầu hay không. Có hai giá trị có thể được chuyển

Giá trị thay đổi của người bán	Yêu cầu
1	Bạn nên sử dụng giá trị này khi người dùng rời khỏi trang web của người bán ban đầu và hoàn tất giao dịch mua hàng qua nền tảng của bạn với một người bán khác
2	Giá trị này nên được dùng khi khách hàng đã hoàn tất một giao dịch thông qua Thực thể ban đầu (Người bán).

Trong cả môi trường hộp cát và môi trường thực tế, bạn 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 kiểm thử, hãy sử dụng mã thông báo kiểm thử sau đây trong cả hai môi trường cho đến khi bạn khởi chạy:

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Dưới đây là 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 bài 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,
      Merchant_changed: merchantChanged
    })
  });
}

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 liên kết với người dùng (bất kể nền tảng mà họ đang dùng) từ cơ chế lưu trữ phía máy chủ và gửi mã thông báo bằng cách sử dụng cùng một điểm cuối của phiên bản chính thức hoặc điểm cuối của hộp cát.

Yêu cầu đối với việc phân bổ lượt chuyển đổi

Tiêu chuẩn bắt buộc của Google về việc phân bổ lượt chuyển đổi là thời lượng phân bổ là 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à Google 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 truy cập vào đường liên kết hành động liên quan đến địa điểm và đặt hàng cho cùng một người bán trong cùng một phiên(Giá trị thay đổi của người bán = 2)
Người dùng nhấp vào một đường liên kết hành động liên quan đến địa điểm, sau đó quay lại từ một kênh khác trong khung thời gian 30 ngày để đặt hàng cho cùng một người bán. ( Giá trị thay đổi của người bán = 2)
Người dùng truy cập một đường liên kết hành động liên quan đến đị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. ( Giá trị thay đổi của người bán = 1 )

Ngoài ra, Google dự kiến sẽ gửi các sự kiện chuyển đổ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 hành động liên quan đến địa điểm. Bao gồm cả:

Ứng dụng web dành cho máy tính hoặc thiết bị di động
Các ứ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 đã đă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 duy trì mã thông báo), thì dự kiến bạn sẽ cung cấp mô hình phân bổ trên nhiều thiết bị. Nghĩa là, người dùng nhấp vào một đường liên kết hành động trên máy tính và sau đó 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 chỉ được lưu trữ ở cấp thiết bị, chẳng hạn như trong cookie của trình duyệt, thì bạn không nên cung cấp mô hình phân bổ trên nhiều thiết bị. Trong trường hợp này, mỗi thiết bị sẽ duy trì một mã thông báo riêng 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.

Nguồn cấp dữ liệu

Tiếp

Xem xét tích hợp