Theo dõi chuyển đổi

Tổng quan

Tính năng theo dõi lượt chuyển đổi sẽ theo dõi những lượt chuyển đổi do Google khởi tạo thông qua một trong các lựa chọn tích hợp với Trung tâm hành động. Việc này giúp hoạt động tích hợp của bạn diễn ra suôn sẻ và hiệu quả, vì nó có thể ảnh hưởng đến thứ hạng trên một số trang. Mỗi khi Google tạo một action_link, URL cụ thể sẽ được sửa đổi để thêm một tham số truy vấn riêng biệ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, hãy làm theo các bước sau:

Phân tích cú pháp và lưu trữ rwg_token.
Phân tích cú pháp và lưu trữ thông tin về người bán.
Trả về giá trị rwg_token và merchant_changed.
Kiểm thử và xác minh tính năng theo dõi lượt chuyển đổi.

Phân tích cú pháp và lưu trữ `rwg_token`

Để hoàn tất quy trình tích hợp, bạn cần 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 siêu dữ liệu về đường liên kết và thông tin người bán đã tạo ra action_link đó.

Phân tích cú pháp mã thông báo

Khi người dùng được chuyển đến trang đặt lịch hẹn của bạn, một rwg_token mới sẽ được thêm vào URL được cung cấp. Trong trang đặt lịch hẹn, bạn cần phân tích cú pháp giá trị mã thông báo.

Ví dụ sau đây cho thấy cách phân tích cú pháp rwg_token để theo dõi ở cấp thiết bị thông qua một trình duyệt.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Lưu trữ 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 ở 2 cấp độ khác nhau:

Cấp thiết bị
Cấp người dùng

Bạn có thể lưu trữ mã thông báo ở bất kỳ cấp độ nào, nhưng bạn phải lưu trữ mã thông báo trong 30 ngày sau lượt giới thiệu ban đầu.

Ví dụ sau đây minh hoạ tính năng theo dõi lượt chuyển đổi ở cấp thiết bị. Bạn có thể lưu trữ các giá trị mã thông báo trong trình duyệt bằ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 giá trị mã thông báo thành một biến. Nhớ cập nhật rootdomain.com bằng miền của bạn.

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

Mỗi lần Google tạo 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 riêng biệt: rwg_token. Bạn phải lưu trữ mã thông báo này và truyền lại mã thông báo đó trong sự kiện chuyển đổi.

Lưu trữ ở 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 lượng phân bổ là 30 ngày. Mã thông báo được lưu trữ cục bộ trên thiết bị của người dùng. Do đó, sự kiện chuyển đổi không thể phân bổ đúng cách nếu người dùng:

Thay đổi thiết bị mà trẻ sử dụng.
Xoá bộ nhớ cục bộ hoặc cookie.
Sử dụng trình duyệt ở chế độ riêng tư hoặc ẩn danh.

Khi sử dụng tính năng theo dõi lượt chuyển đổi ở cấp thiết bị, bạn cần triển khai lại sự kiện chuyển đổi trên mọi thiết bị được hỗ trợ, bao gồm cả thiết bị di động.

Lưu trữ ở cấp người dùng

Cấp người dùng duy trì mã thông báo 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. Mã thông báo được lưu trữ ở phía máy chủ. Vì vậy, sự kiện chuyển đổi vẫn được phân bổ đúng cách 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 dựa trên cấu trúc hệ thống, bạn có thể triển khai sự kiện chuyển đổi một lần ở phía máy chủ và sử dụng lại sự kiện đó trên tất cả các thiết bị được hỗ trợ.

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

Khi Google giới thiệu một người dùng đến cùng một người bán, mã thông báo hiện có đã được lưu trữ sẽ được thay thế bằng mã thông báo mới nhất từ lượt giới thiệu gần đây nhất. Sau khi thay thế mã thông báo, thời lượng phân bổ 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 bài viết Yêu cầu về mô hình phân bổ lượt chuyển đổi để biết thêm thông tin.

Phân tích cú pháp và lưu trữ thông tin người bán

Khi người dùng được chuyển hướng đến trang đặt phòng của bạn, bạn cần triển khai logic có thể tìm và thu thập thông tin chi tiết về người bán. Thông thường, các đối tác sẽ thêm siêu dữ liệu người bán hoặc merchant_id vào đường liên kết đến hành động và sử dụng siêu dữ liệu đó để xác định và lưu trữ thông tin người bán.

Bạn nên lưu trữ merchant_id hoặc mã nhận dạng đã chọn cùng với rwg_token. Khi người dùng xác nhận một lượt đặ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 chỉnh. Tương tự như việc lưu trữ mã thông báo, bạn phải lưu thông tin chi tiết về người bán cùng với mã thông báo trong 30 ngày sau lần giới thiệu ban đầu.

Ví dụ sau đây sửa đổi rwg_token đã lưu trữ trước đó. Thao tác này giả định rằng bạn đã phân tích thông tin người bán từ siêu dữ liệu trong URL được cung cấp và đã lưu thông tin đó dưới dạng merchant_id hoặc so khớp thông tin đó với một merchant_id hiện có.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

Trả về giá trị `rwg_token` và `merchant_changed`

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 action_link, bạn cần gửi yêu cầu HTTP POST đến điểm cuối lượt chuyển đổi. Có 2 điểm cuối:

Môi trường sản xuất: https://www.google.com/maps/conversion/collect
Môi trường hộp cát: 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 và giá trị merchant_changed là 1 hoặc 2. Để biết thêm thông tin về merchant_changed, 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á bằng JSON theo đị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ụ sau đây bao gồm tính năng theo dõi lượt chuyển đổi ở cấp thiết bị bằ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`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

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ó thay đổi so với 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 xảy ra nếu trang đích của bạn nằm trong một nền tảng 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 sang một người bán khác để hoàn tất việc đặt phòng, thì bạn cần biết rằng lượt chuyển đổi đã xảy ra với một người bán riêng biệt. Bạn có thể dùng một giá trị Boolean để xác định thay đổi của người bán, nhưng không thể xác định thông tin chi tiết của người bán.

Khi quyết định giá trị cần chỉ định cho merchant_changed, bạn cần lấy người bán ban đầu đã lưu trong Phân tích cú pháp và lưu trữ thông tin người bán. Kiểm tra xem người bán đã thay đổi hay chưa và chỉ định giá trị theo yêu cầu của bạn.

Yêu cầu: 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.
- Giá trị thay đổi của người bán: 1
Yêu cầu: khi người dùng hoàn tất giao dịch thông qua người bán ban đầu.
- Giá trị thay đổi của người bán: 2

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

Các trường hợp kiểm thử sau đây sử dụng mã thông báo kiểm thử được cung cấp trong phần Mã thông báo kiểm thử và nhằm mục đích hướng dẫn bạn thực hiện tất cả các tình huống có thể dẫn đến một sự kiện chuyển đổi. Điều này đảm bảo rằng mã thông báo được lưu trữ đúng cách, giá trị merchant_changed được đặt chính xác và sự kiện chuyển đổi được gửi khi thích hợp.

Sử dụng URL của đường liên kết hành động hoặc trang đặt lịch hẹn có trong nguồn cấp dữ liệu của bạn và chạy từng trường hợp kiểm thử bằng cách thêm Mã thông báo kiểm thử vào cuối URL. Nhớ sử dụng cửa sổ trình duyệt riêng tư hoặc ẩn danh. Thao tác này sẽ xoá mọi mã thông báo hiện có được liên kết với người dùng hiện tại và giúp bạn có một nền tảng mới để làm việc.

Trường hợp kiểm thử	Nội dung mô tả về kiểm thử	User Flow	Kết quả dự kiến
1	Người dùng hoàn tất một lượt đặt phòng không bắt nguồn từ Google.	Người dùng chuyển thẳng đến trang đặt phòng mà không được Google giới thiệu hoặc không có lượt giới thiệu hiện tại. Thao tác này sẽ không dẫn đến bất kỳ sự kiện chuyển đổi nào.	Không có sự kiện chuyển đổi vì trước đó người dùng không truy cập vào trang đặt lịch hẹn hoặc không được Google giới thiệu.
2	Người dùng hoàn tất một lượt đặt phòng bắt nguồn từ Google.	Người dùng tìm thấy người bán của bạn thông qua Google, được giới thiệu đến trang đặt lịch hẹn của bạn và hoàn tất việc đặt lịch hẹn.	Một sự kiện chuyển đổi sẽ được gửi với Mã thông báo A và giá trị merchant changed là 2 vì người dùng được Google giới thiệu đến trang đặt phòng.
3	Người dùng (bắt nguồn từ Google) bắt đầu quy trình đặt phòng nhưng bỏ ngang phiên trước khi hoàn tất việc đặt phòng. Lưu ý: Giữ phiên này mở cho Bài kiểm thử 4 và 5.	Người dùng được chuyển đến trang đặt lịch hẹn của bạn nhưng phiên hoạt động kết thúc và họ không hoàn tất việc đặt phòng.	Không có lượt chuyển đổi vì người dùng không hoàn tất quy trình đặt phòng nhưng Mã thông báo B phải được lưu trữ trong 30 ngày.
4	Người dùng quay lại trang đặt lịch hẹn mà không phải từ Google và hoàn tất việc đặt lịch hẹn. Lưu ý: URL của quy trình đặt phòng không được chứa rwg_token.	Người dùng quay lại trang đặt lịch hẹn sau Thử nghiệm 4. Mã thông báo B phải được lưu trữ trong 30 ngày và mọi lượt chuyển đổi trong 30 ngày đó phải trả về một sự kiện chuyển đổi.	Một sự kiện chuyển đổi sẽ được gửi với Mã thông báo B và giá trị người bán đã thay đổi là 2 vì người dùng đang quay lại trang đặt lịch hẹn sau lượt giới thiệu trước đó từ Google.
5	Người dùng hoàn tất một lượt đặt phòng mới bắt nguồn từ Google sau Bài kiểm thử số 4.	Nếu người dùng quay lại trang đặt lịch hẹn của bạn bằng một lượt giới thiệu từ Google sau một lượt giới thiệu trước đó từ Google, thì khoảng thời gian lưu trữ 30 ngày của họ sẽ được đặt lại và một mã thông báo mới Mã thông báo C sẽ thay thế mã thông báo cũ Mã thông báo B. Sau đó, tất cả lượt chuyển đổi trong tương lai sẽ được phân bổ cho Mã thông báo C.	Một sự kiện chuyển đổi sẽ được gửi cùng với Mã thông báo C và giá trị đã thay đổi người bán là 2 vì người dùng đã hoàn tất việc đặt phòng và mã thông báo mới đã thay thế mã thông báo được lưu trữ trước đó.

Nếu bạn có một nền tảng cho phép người dùng thanh toán với một người bán khác, hãy kiểm thử những trường hợp sau.

Trường hợp kiểm thử	Nội dung mô tả về kiểm thử	User Flow	Kết quả dự kiến
6	Người dùng được Google giới thiệu đến trang đặt lịch hẹn của bạn và hoàn tất việc đặt phòng với một người bán khác.	Google giới thiệu một người dùng đến trang đặt phòng của bạn, Token A được sử dụng, nhưng trước khi hoàn tất việc đặt phòng, người dùng chuyển đến một trang khác và hoàn tất việc đặt phòng với một người bán khác với người bán giới thiệu ban đầu.	Sự kiện chuyển đổi sẽ được gửi vì người dùng đã hoàn tất một lượt đặt phòng bắt nguồn từ một lượt giới thiệu trên Google với Mã thông báo A và giá trị người bán đã thay đổi là 1 vì người dùng đã hoàn tất lượt đặt phòng ở một người bán khác với người bán được giới thiệu.

Trong khi kiểm thử, hãy gửi yêu cầu HTTP POST đến điểm cuối chuyển đổi. Có 2 điểm cuối:

Môi trường sản xuất: https://www.google.com/maps/conversion/collect
Môi trường hộp cát: https://www.google.com/maps/conversion/debug/collect

Mã thông báo kiểm thử

Để kiểm tra tính năng theo dõi lượt chuyển đổi, hãy thêm một trong các mã thông báo kiểm thử sau vào cuối URL của đường liên kết đến hành động hoặc trang đặt phòng mà bạn cung cấp trong nguồn cấp dữ liệu.

Mã thông báo A:

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

Mã thông báo B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Mã thông báo C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Khi gửi các sự kiện chuyển đổi thành công, bạn có thể thấy các sự kiện đó được tổng hợp trong Trung tâm hành động trong trang tổng quan về tính năng theo dõi lượt chuyển đổi.

conversion-tracking-dashboard

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ề việc 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 hành động liên quan đến địa điểm, tại bất kỳ cửa hàng nào.

Khoảng thời lượng phân bổ này có nghĩa là Google có thể dự kiến một sự kiện chuyển đổi sẽ đượ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 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 đường liên kết hành động liên quan đến địa điểm rồi quay lại thông qua một kênh khác trong vòng 30 ngày của thời lượng phân bổ để đặ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 nhấ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 một cửa hàng khác, trong cùng một phiên hoặc một phiên khác trong vòng 30 ngày của thời lượng phân bổ. Giá trị thay đổi của người bán = 1.

Ngoài ra, Google dự kiến sẽ gửi sự kiện chuyển đổi từ mọi thiết bị mà người dùng có thể truy cập thông qua đường liên kết hành động liên quan đến địa điểm. Các thiết bị này 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 đến ứng dụng hoặc ý định đã đăng ký của ứ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, thì bạn nên cung cấp thông tin phân bổ trên nhiều thiết bị. Để biết thêm thông tin, hãy xem phần Lưu trữ ở cấp người dùng. Trong trường hợp này, người dùng theo một đường liên kết đến hành động trên máy tính rồi 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, thì phải kích hoạt mộ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 cần phải cung cấp thông tin phân bổ trên nhiều thiết bị. Trong trường hợp này, mỗi thiết bị có thể duy trì một mã thông báo riêng biệt, 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ị có thể tuân theo các quy tắc phân bổ riêng biệt.