Theo dõi chuyển đổi

Hình 1: Tổng quan về tính năng Theo dõi lượt chuyển đổi

Tóm tắt

Tính năng Theo dõi lượt chuyển đổi dùng để theo dõi các lượt chuyển đổi do Google khởi tạo thông qua một trong các tiện ích tích hợp của Trung tâm hành động. Điều này rất quan trọng để duy trì hoạt động tích hợp và có thể ảnh hưởng đến thứ hạng trên một số trang nhất định. Mỗi khi Google hiển thị một action_link, URL đó sẽ được sửa đổi để bao gồm một tham số truy vấn duy nhất: rwg_token. Bạn có thể lưu trữ mã thông báo đó và trả về các giá trị thích hợp khi người dùng hoàn tất việc đặt phòng.

Để hoàn tất quá trình tích hợp, bạn cần hoàn thành những việc sau:

1. Thu thập và lưu trữ rwg_token.
2. Thu thập và lưu trữ người bán.
3. Trả về các giá trị rwg_token và merchant_change.
4. Thử nghiệm và xác minh tính năng Theo dõi lượt chuyển đổi.

Thu thập và lưu trữ rwg_token.

Để hoàn tất quá trình tích hợp này, bạn phải thu thập và lưu trữ rwg_token trong tối đa 30 ngày kể từ lượt giới thiệu ban đầu của Google. Giá trị rwg_token là một chuỗi được mã hoá chứa một số siêu dữ liệu về đường liên kết và người bán đã tạo đường liên kết hành động đó. Điều quan trọng cần lưu ý là không có dữ liệu người dùng nào được lưu trữ hoặc mã hoá trong mã thông báo.

Bộ sưu tập mã thông báo

Khi người dùng được chuyển đến trang đặt phòng, một tham số truy vấn mới, rwg_token, sẽ được thêm vào URL được cung cấp. Trong trang đặt phòng, bạn phải phân tích cú pháp giá trị. Chúng tôi cũng cung cấp 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.

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;
  }
}

Tham số truy vấn được thêm vào URL của bạn sẽ là một mã thông báo đã mã hoá, hãy xem ví dụ sau về rwg_token. Sử dụng mã thông báo mẫu này để đảm bảo bạn phân tích cú pháp mã thông báo chính xác, bao gồm mọi ký tự đặc biệt như "=". Sau đây là mẫu mã thông báo thông thường.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Bộ nhớ mã thông báo

Khi lưu trữ rwg_token, bạn có thể triển khai tính năng theo dõi lượt chuyển đổi ở hai cấp độ khác nhau, đó là cấp thiết bị và cấp người dùng. Bạn có thể quyết định nơi lưu trữ mã thông báo, nhưng bạn phải lưu trữ mã thông báo trong 30 ngày kể từ lượt giới thiệu ban đầu.

Ví dụ tiếp theo là 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 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ụ về Bộ nhớ mã thông báo. Hãy nhớ cập nhật rootdomain.com bằng miền của bạn.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Hãy cân nhắc những điều sau khi quyết định nơi lưu trữ rwg_token.

Bộ nhớ cấp thiết bị

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ị đang sử dụng, xoá bộ nhớ cục bộ hoặc 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).

Bộ nhớ cấp người dùng

Cấp người dùng bao gồm việc lưu trữ dữ liệu 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 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ộ hoặc 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 đượ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 của 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ợ.

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 nhưng không có dữ liệu người dùng. Bạn nên lưu trữ mã thông báo này và chuyển mã thông báo đó trở lại trong sự kiện chuyển đổi.

Làm mới mã thông báo

Khi người dùng được Google giới thiệu đến cùng một người bán, nếu mã thông báo hiện có được lưu trữ, thì mã thông báo đó sẽ được thay thế bằng mã thông báo mới từ lượt giới thiệu gần đây nhất. Khi mã thông báo được thay thế, khoảng thời gian 30 ngày của bộ nhớ mã thông báo sẽ được đặt lại và mọi lượt chuyển đổi mới cho người bán này sẽ được phân bổ cho mã thông báo mới nhất.

Hãy tham khảo Yêu cầu về mô hình phân bổ lượt chuyển đổi để biết thêm thông tin chi tiết.

Thu thập và lưu trữ người bán.

Khi người dùng được chuyển hướng đến trang đặt phòng, bạn phải triển khai logic để tìm và thu thập người bán. Thông thường, đối tác sẽ thêm siêu dữ liệu của người bán hoặc merchant_id vào đường liên kết hành động của họ và sử dụng siêu dữ liệu đó để xác định và lưu trữ người bán. Bạn nên lưu trữ merchant_id (hoặc giá trị nhận dạng đã chọn) cùng với rwg_token để khi người dùng xác nhận đặt phòng, bạn có thể tham khảo người bán trước khi gửi yêu cầu chuyển đổi đã hoàn tất. Tương tự như khoảng thời gian lưu trữ mã thông báo, người bán phải được lưu cùng với mã thông báo trong 30 ngày kể từ lượt giới thiệu ban đầu.

Các ví dụ tiếp theo sẽ điều chỉnh rwg_token đã lưu trước đó. Điều này giả định rằng bạn đang phân tích cú pháp người bán từ siêu dữ liệu trong URL được cung cấp và lưu người bán đó dưới dạng merchant_id hoặc so khớp người bán đó với một merchant_id hiện có.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Trả về các giá trị rwg_token và merchant_change.

Khi người dùng hoàn tất một lượt đặt phòng bắt đầu từ một lượt giới thiệu Đường liên kết hành động, bạn phải gửi một yêu cầu POST qua 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 sản xuất và một điểm cuối cho môi trường hộp cát.

• Bản chính thức: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Khi gửi một sự kiện chuyển đổi, bạn phải thêm rwg_token đã lưu trữ và giá trị merchant_change là 1 hoặc 2. Để biết thêm thông tin chi tiết về merchant_change, hãy xem phần Trả về giá trị thay đổi của người bán.

Nội dung POST phải là một đối tượng được mã hoá JSON ở định dạng:

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

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

Ví dụ tiếp theo bao gồm tính năng theo dõi lượt chuyển đổi ở cấp thiết bị bằng cách sử dụng cookie trên thiết bị của người dùng, được viết bằng Javascript:

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
    })
  });
}

Thận trọng: Loại nội dung MIME duy nhất được chấp nhận là text/plain. Đừng đặt bất kỳ Content-Type nào khác trong tiêu đề. Nếu làm vậy, bạn sẽ gặp lỗi CORS.

Cảnh báo: Đảm bảo rằng trong dữ liệu lượt chuyển đổi, bạn không gửi Thông tin nhận dạng cá nhân (PII) của người dùng.

Lưu ý: Trong phiên bản chính thức, bạn không nên gửi các sự kiện chuyển đổi không được phân bổ cho chế độ tích hợp này. Bạn nên kiểm tra giá trị rwg_token hợp lệ và chưa hết hạn trước khi gửi sự kiện.

Trả về Giá trị thay đổi của người bán

Giá trị merchant_changed được dùng để xác định xem người bán có được thay đổi từ người bán chuyển hướng ban đầu hay không. Việc thay đổi người bán là điều thường thấy nếu trang đích của bạn nằm trong một nền tảng có cả những người bán khác. Trong trường hợp này, nếu người dùng được Google giới thiệu đến nền tảng của bạn và quyết định chuyển đến một người bán khác để hoàn tất việc đặt phòng, thì chúng ta muốn biết rằng một lượt chuyển đổi đã xảy ra nhưng với một người bán riêng biệt, chúng ta không cần biết người bán đó là ai, chỉ cần biết rằng một sự kiện chuyển đổi đã xảy ra và người bán đó là người bán khác, chúng ta sẽ sử dụng một giá trị Boolean để xác định xem người bán có thay đổi hay không.

Khi quyết định giá trị nào sẽ được chỉ định cho merchant_change, bạn cần lấy người bán ban đầu đã lưu trong phần Thu thập và lưu trữ người bán rồi kiểm tra xem người bán có thay đổi hay không, sau đó tham khảo bảng sau khi chỉ định giá trị.

Nếu trang đặt phòng của bạn không nằm trong một nền tảng hoặc người dùng không thể chuyển đến một người bán khác, thì bạn có thể mã hoá cứng giá trị của các yêu cầu này thành 2. Điều này thường xảy ra với những đối tác tích hợp trang đặt phòng vào trang web của người bán hoặc có trang đích tuỳ chỉnh để xử lý yêu cầu đặt phòng.

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 thông qua nền tảng của bạn với một người bán khác
2	Bạn nên sử dụng giá trị này 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).

Thử nghiệm và xác minh tính năng Theo dõi lượt chuyển đổi.

Để đảm bảo rằng bạn triển khai tính năng theo dõi lượt chuyển đổi đúng cách, bạn cần chạy kiểm thử sau. Hãy nhớ sử dụng Đường liên kết hành động liên kết với người bán và các yêu cầu được thực hiện trong cửa sổ riêng tư hoặc ẩn danh để đảm bảo mọi mã thông báo trước đó liên kết với người dùng đó đều bị xoá.

1. Hoàn tất việc đặt phòng chỉ bằng một Đường liên kết hành động
   • Các lượt đặt phòng trực tiếp không có lượt giới thiệu hoặc mã thông báo đã lưu trước đó sẽ không dẫn đến việc gửi yêu cầu nào đến Google.
2. Hoàn tất việc đặt phòng bằng một đường liên kết có rwg_token đính kèm.
   • Đảm bảo yêu cầu thành công và được gửi với giá trị rwg_token và merchant_change là 2
   • Đảm bảo bạn lưu trữ rwg_token trong 30 ngày
3. Hoàn tất một yêu cầu đặt phòng mới với cùng một người bán bằng cách sử dụng rwg_token mới.
   • Đảm bảo yêu cầu thành công và được gửi với giá trị rwg_token và merchant_change mới là 2
   • Đảm bảo làm mới khoảng thời gian lưu trữ mô hình phân bổ của mã thông báo trong 30 ngày
4. Chuyển thẳng đến trang đặt phòng của người bán mà bạn đang thử nghiệm và đặt phòng mới mà không cần thêm rwg_token.
   • Đảm bảo rằng yêu cầu được gửi bằng rwg_token đã lưu trước đó và giá trị merchant_change là 2

Nếu bạn là một nền tảng cho phép người dùng thanh toán bằng một người bán khác, hãy thử nghiệm những nội dung sau.

1. Chuyển đến trang đặt phòng của người bán bằng một đường liên kết có rwg_token đính kèm, sau đó chuyển đến một người bán khác và đặt phòng.
   • Đảm bảo rằng yêu cầu được gửi với giá trị rwg_token và merchant_change là 1

Khi kiểm thử, hãy gửi yêu cầu POST qua 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.

• Bản chính thức: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Bạn cần thêm mã thông báo sau vào đường liên kết hành động hoặc URL:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Sử dụng mã thông báo sau đây cho các kiểm thử yêu cầu mã thông báo bổ sung.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Khi đã gửi các sự kiện chuyển đổi thành công, bạn có thể xem các sự kiện đó được tổng hợp trong Trung tâm hành động trong trang tổng quan Theo dõi lượt chuyển đổi. Xin lưu ý rằng lượt chuyển đổi có thể mất tới một giờ thì mới xuất hiện trong trang tổng quan.

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 đối với 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à Google 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 dẫn đến hành động tại địa điểm và đặt hàng cho cùng một người bán trong cùng một phiên. (Merchant Change Value = 2 )
• Người dùng nhấp vào đường liên kết dẫn đến 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 hàng cho cùng một người bán. (Merchant Change Value = 2 )
• 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. ( Merchant Change Value = 1 )

Ngoài ra, Google 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 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 sẽ 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.

Lưu ý: Khung phân bổ này có thể khác với cách hệ thống phân tích của bạn phân bổ lượt chuyển đổi. Hệ thống này được thiết kế để hoạt động độc lập với mọi tính năng theo dõi lượt chuyển đổi mà bạn đang thực hiện trong hệ thống của mình và không ảnh hưởng đến số liệu phân tích nội bộ.