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ó 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_token và merchant_id từ trang đích / ứng dụng điểm truy cập.
Duy trì rwg_token và merchant_id để có mô hình phân bổ phù hợp cửa sổ.
So sánh merchant_id và merchant_id được duy trì tại thời điểm chuyển đổi (đã hoàn tất đặt phòng).
Gửi một sự kiện chuyển đổi tại thời điểm chuyển đổi (đã hoàn tất lượt đặt phòng).

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 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 bạn sẽ theo dõi 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ộ, ứng dụng cục bộ bộ nhớ hoặc bất kỳ phương thức nào khác có thể duy trì mã thông báo trong 30 ngày thời lượng phân bổ. Bởi vì mã thông báo sẽ được lưu trữ cục bộ trên thiết bị của họ, nếu người dùng thay đổi thiết bị họ đang sử dụng, sẽ xoá thiết bị bộ nhớ hoặc cookie hay đ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 cách. 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 (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 khác phía máy chủ. 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ị họ đang sử dụng, xoá bộ nhớ cục bộ hoặc cookie của họ hoặc đang sử dụng duyệt web hoặc chế độ ẩn danh, sự kiện chuyển đổi 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, trên kiến trúc hệ thống của mình, bạn có thể triển khai điều này một lần trên phía máy chủ và sử dụng lại mã đó 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 thông qua Nguồn cấp dữ liệu, URL đó đã được sửa đổi để bao gồm một tham số truy vấn duy nhất: rwg_token. Chiến lược phát hành đĩa đơn Giá trị rwg_token là một chuỗi được mã hoá chứa một số siêu dữ liệu về 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à trả về 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 ứ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ữ tham số đó. Các yêu cầu để lưu trữ dữ liệu 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:

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

Đang thu thập `merchant_id`

Nếu bạn triển khai logic theo dõi chuyển đổi trong giao diện người dùng, trên trang đích bạn phải triển khai một tập lệnh tuỳ chỉnh sẽ tìm và nắm bắt merchant_id. Thông thường, merchant_id có thể đã có mặt trên trang đích hoặc trong URL để bạn có thể thu thập dữ liệu từ đó. Nếu không, bạn phải tìm cách để lộ thông tin ở đâu đó để thông tin đó có thể xác định được, có khả năng ngụ ý rằng các thay đổi phụ trợ.

Nếu triển khai logic theo dõi lượt chuyển đổi trong phần phụ trợ, bạn có thể thấy merchant_id cùng với dữ liệu truy vấn hệ thống nội bộ của bạn để tạo trang giao diện người dùng.

URL này merchant_id phải giống với tài khoản mà bạn đã chia sẻ với Google nguồn cấp dữ liệu của bạn.

Duy trì `rwg_token` và `merchant_id`

Bạn bắt buộc phải duy trì tham số URL rwg_token. Tham số này sẽ thêm vào tất cả đường liên kết hành động do bạn cung cấp, 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 chỉnh sửa bất kỳ nội dung nào.

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

Nếu vẫn còn mã thông báo sau lần truy cập trước, thì Bạn phải thay thế rwg_token và merchant_id, đồng thời đặt thời hạn 30 ngày cho bộ nhớ cần được đặt lại.

Khi duy trì cặp dữ liệu trên, bạn có thể lưu trữ các giá trị tại 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ộ, ứng dụng cục bộ bộ nhớ hoặc bất kỳ phương thức nào khác có thể duy trì mã thông báo trong 30 ngày thời lượng phân bổ.
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 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ữ các giá trị này trong trình duyệt web sử dụng 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 mã thông báo vào 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.com cho miền của bạn.

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

Khi sử dụng tính năng theo dõi lượt chuyển đổi cấp người dùng, rwg_token + merchant_id phải đượ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ó thể quy cho một Địa điểm trên Google Đường liên kết hành động. Bạn phải 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 dành cho môi trường phát hành chính thức và một điểm cuối dành cho môi trường hộp cát.

Sản xuất: 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>,
  "merchant_changed": 1|2
}

Ví dụ (người bán không thay đổi có mã thông báo thử nghiệm cho đối tác 20123456):

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

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

Giá trị thay đổi của người bán	Yêu cầu
1	Giá trị này nên được sử dụng khi người dùng đã rời khỏi trang web của người bán ban đầu và đã hoàn tất mộ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	Giá trị này nên được sử dụng khi khách hàng đã hoàn tất giao dịch thông qua Pháp nhân ban đầu (Người bán).

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 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, hãy sử dụng mã thông báo thử nghiệm sau trong cả hai môi trường cho đến khi bạn khởi chạy:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Để thử nghiệm trong Hộp cát, bạn cần phải tự thêm tham số URL sau vào đường liên kết đến Hộp cát của bạn:

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

Một 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 trang thiết bị) trong javascript về cách tạo yêu cầu đăng này được 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,
      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 được liên kết với người dùng (bất kể họ ở trên 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ách sử dụng cùng một điểm cuối 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à mô hình phân bổ 30 ngày cho bất kỳ tương tác nào với liên kết đị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 có một sự kiện chuyển đổi 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 hành động liên quan đến địa điểm rồi đặ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 đường liên kết đến hành động liên quan đến địa điểm rồi quay lại từ một kênh khác trong thời hạn 30 ngày để đặt hàng cho cùng một người bán. (Người bán Giá trị thay đổi = 2 )
Người dùng truy cập vào đường liên kết hành động liên quan đến địa điểm rồi đặt hàng tại cửa hàng, trong cùng một phiên hoặc một phiên khác nhau trong vòng 30 ngày cửa sổ. ( Giá trị thay đổi của người bán = 1 )

Ngoài ra, Google muốn các sự kiện chuyển đổi sẽ được gửi từ tất cả nền tảng 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 một liên kết sâu của ứng dụng hoặc một ý đị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 cách duy trì mã thông báo), đó là mong muốn rằng 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 theo dõi một đường liên kết hành động trên máy tính, 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 trình duyệt thì bạn sẽ không thể cung cấp mô hình phân bổ trên nhiều thiết bị. Trong phần này trong trường hợp khác, mỗi thiết bị sẽ vẫn có một mã thông báo riêng biệt nếu người dùng đã làm theo 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 mô hình phân bổ riêng biệt.

Nguồn cấp dữ liệu

Tiếp

Xem xét tích hợp