So khớp cookie

So khớp cookie là tính năng cho phép bạn so khớp cookie của mình (ví dụ: mã nhận dạng cho người dùng đã duyệt trang web của bạn) với Mã nhận dạng người dùng Google dành riêng cho người đặt giá thầu tương ứng, đồng thời tạo danh sách người dùng có thể giúp bạn đưa ra lựa chọn đặt giá thầu hiệu quả hơn. Hướng dẫn này mô tả các khái niệm dùng trong tính năng So khớp cookie, cũng như các quy trình so khớp cookie khác nhau và mọi biến thể có thể có cho một số trường hợp sử dụng nhất định.

Khái niệm

Chủ sở hữu miền thường đặt nội dung cookie cho những người dùng duyệt trang web của họ. Nội dung này được dùng để nhận dạng người dùng trong miền đó. Ngay cả khi hai chủ sở hữu miền đồng ý trao đổi dữ liệu này, mô hình bảo mật của các trình duyệt Internet vẫn hạn chế việc một trình duyệt đọc cookie do miền khác đặt.

Trong bối cảnh quảng cáo kỹ thuật số, Google xác định người dùng có cookie thuộc miền doubleclick.net và những bên đặt giá thầu tham gia tính năng Đặt giá thầu theo thời gian thực có thể có miền riêng, nơi họ xác định một số nhóm người dùng mà họ muốn hiển thị quảng cáo. Tính năng So khớp cookie cho phép bên đặt giá thầu so khớp cookie của họ với cookie của Google, nhờ đó, họ có thể xác định xem lượt hiển thị được gửi trong yêu cầu giá thầu có liên kết với một trong những người dùng được nhắm mục tiêu hay không, họ sẽ nhận được dữ liệu cookie của riêng mình hoặc Mã nhận dạng người dùng Google dành riêng cho người đặt giá thầu. Đây là dạng mã hoá của cookie doubleclick.net trong yêu cầu giá thầu.

Dịch vụ so khớp cookie được mô tả trong hướng dẫn này hỗ trợ việc tạo và duy trì mối liên kết giữa cookie của bên đặt giá thầu và Mã nhận dạng người dùng Google, đồng thời cũng cho phép một người điền danh sách người dùng.

Bảng so khớp

Bạn có thể sử dụng bảng so khớp để liên kết mã nhận dạng hoặc dữ liệu khác từ miền này sang miền khác. Bên đặt giá thầu có thể sử dụng Dịch vụ so khớp cookie để điền bảng so khớp riêng bằng cách liên kết cookie của một người dùng nhất định với Mã nhận dạng người dùng Google của người dùng đó hoặc để điền bảng so khớp do Google lưu trữ. Ứng dụng bên đặt giá thầu của bên đặt giá thầu cần có bảng so khớp để truy cập vào dữ liệu cookie cho người dùng đang được hiển thị lượt hiển thị.

Bảng so khớp do Google lưu trữ

Để bảo trì dễ dàng hơn, cải thiện độ trễ và truy cập để so khớp dữ liệu cho người dùng ở một số khu vực nhất định, bạn nên cho phép Google lưu trữ bảng so khớp. Điều này cho phép bạn chỉ định một chuỗi được mã hoá base64 an toàn trên web (sau đây được gọi là dữ liệu so khớp được lưu trữ) sẽ được liên kết với Mã nhận dạng người dùng Google cho một người dùng nhất định. Sau khi thiết lập kết quả trùng khớp, bạn có thể sử dụng kết quả đó theo các cách sau:

  • Đặt giá thầu theo thời gian thực: Trong các yêu cầu giá thầu tiếp theo cho các lượt hiển thị được liên kết với người dùng, Google sẽ gửi cho bạn dữ liệu so khớp được lưu trữ mà bạn khớp với Mã nhận dạng người dùng Google của họ. Nếu điểm cuối đặt giá thầu được định cấu hình để sử dụng giao thức RTB của Google, thì bạn sẽ nhận được giá trị này dưới dạng byte đã giải mã thông qua trường BidRequest.hosted_match_data. Trong quá trình triển khai OpenRTB của Google, BidRequest.user.buyeruid sẽ trả về dữ liệu này dưới dạng chuỗi được mã hoá base64 an toàn trên web.

  • Danh sách người dùng: Danh sách người dùng có thể được điền sẵn bằng Mã nhận dạng người dùng Google hoặc dữ liệu so khớp được lưu trữ.

  • Nhắm mục tiêu trước: Bạn có thể thiết lập tiêu chí nhắm mục tiêu trước để chỉ nhận những yêu cầu giá thầu chứa dữ liệu so khớp được lưu trữ. Bạn có thể dùng tính năng này để loại bỏ các lượt hiển thị ít phù hợp cho người dùng bên ngoài không gian cookie của bạn.

Danh sách người dùng

Bạn có thể tạo và quản lý danh sách người dùng bằng API Đặt giá thầu theo thời gian thực. Sau khi tạo, bạn có thể điền sẵn các danh sách này bằng quy trình So khớp cookie như mô tả bên dưới hoặc thông qua Dịch vụ của người tải lên hàng loạt.

Bắt đầu

Để bắt đầu sử dụng tính năng So khớp cookie, bạn phải liên hệ với Người quản lý tài khoản kỹ thuật của mình, người có thể bật các quy trình làm việc cụ thể và giúp bạn định cấu hình các quy trình sau:

  • Mã mạng so khớp cookie (NID): Mã nhận dạng chuỗi chỉ xác định riêng một tài khoản bên đặt giá thầu cho hoạt động So khớp cookie và các hoạt động liên quan khác.
  • URL so khớp cookie: URL cơ sở cho điểm cuối sẽ chấp nhận và xử lý các yêu cầu được gửi đến trong quy trình So khớp cookie. Bên đặt giá thầu có thể nhúng macro vào URL này để kiểm soát thứ tự của các thông số được chuyển đến URL đó trong quy trình So khớp cookie.
  • Match Tag (Thẻ so khớp): Thẻ mà bạn phải đặt trong trình duyệt của người dùng đối với quy trình So khớp cookie do bên đặt giá thầu khởi tạo. Quảng cáo có thể được phân phát cùng với quảng cáo hoặc đặt trên các tài sản web bên ngoài quảng cáo.
  • URL báo cáo so khớp cookie (không bắt buộc): Trong Quy trình so khớp cookie một chiều, đây là URL không bắt buộc có thể được cung cấp để chỉ định một điểm cuối sẽ nhận được thông tin chi tiết về lỗi trong trường hợp không so khớp cookie được thông qua lệnh chuyển hướng HTTP 302. Theo mặc định, phản hồi sẽ chỉ được gửi đến URL này nếu xảy ra lỗi với hoạt động so khớp cookie, nhưng bên đặt giá thầu có thể yêu cầu luôn gửi lệnh chuyển hướng.
  • URL hỗ trợ so khớp cookie: Đối với các sàn giao dịch triển khai quy trình hỗ trợ so khớp cookie, đây là URL cơ sở của điểm cuối dùng để phản hồi các yêu cầu gửi đến.
  • Hạn mức hỗ trợ so khớp cookie: Đối với các nền tảng trao đổi triển khai quy trình hỗ trợ so khớp cookie, đây là số lượng yêu cầu tối đa mà URL so khớp cookie của họ có thể nhận được mỗi giây. Mục đích của việc này là để ngăn các yêu cầu CMA làm quá tải các máy chủ của nền tảng trao đổi.

Trong bất kỳ quy trình So khớp cookie nào được hỗ trợ, URL so khớp cookie của bên đặt giá thầu thường có các thông số được thêm vào theo thứ tự không đảm bảo. Bên đặt giá thầu có tích hợp yêu cầu thứ tự thông số nhất quán có thể đặt macro trong URL so khớp cookie để đảm bảo vị trí của chúng.

Macro được hỗ trợ

Bên đặt giá thầu có thể tuỳ ý định cấu hình URL so khớp cookie để đưa vào một hoặc nhiều macro dưới dạng %%GOOGLE_<PARAM_NAME>%% hoặc %%GOOGLE_<PARAM_NAME>_PAIR%%. Các macro được hỗ trợ và giá trị mở rộng của các macro đó là:

Macro Giá trị mở rộng
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &scver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID

Ví dụ về macro

Bên đặt giá thầu có chế độ tích hợp so khớp cookie với điểm cuối được lưu trữ tại https://user.bidder.com.cookies. Khi triển khai, bên đặt giá thầu cần có các thông số do bên đặt giá thầu đặt trước xác định cùng với các thông số So khớp pixel theo thứ tự sau: google_push, google_gid, google_cver và google_error. Người đặt giá thầu có thể thực hiện việc này bằng cách đặt URL so khớp cookie thành:

https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%

Sau đó, khi Google gửi yêu cầu so khớp cho bên đặt giá thầu này, yêu cầu đó sẽ được mở rộng như sau:

https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3

Dịch vụ so khớp cookie của Google hiện hỗ trợ 3 quy trình công việc cho nhiều trường hợp sử dụng như mô tả bên dưới.

So khớp cookie hai chiều là quy trình làm việc do bên đặt giá thầu khởi tạo, trong đó họ đặt một thẻ so khớp vào trình duyệt của người dùng để chuyển hướng thẻ đó đến Google. Quy trình làm việc này cho phép cả Google và bên đặt giá thầu điền sẵn bảng so khớp. Dưới đây là một ví dụ đơn giản về quy trình làm việc này.

Bước 1: Đặt thẻ trùng khớp

Để bắt đầu quy trình này, bên đặt giá thầu phải đặt thẻ so khớp sao cho thẻ hiển thị trong trình duyệt của người dùng. Có thể có cấu trúc một thẻ so khớp đơn giản chỉ trả về Mã nhận dạng người dùng Google cho bên đặt giá thầu như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

Bạn có thể đưa vào các tham số bổ sung trong thẻ so khớp để đáp ứng nhiều trường hợp sử dụng. Để tìm hiểu thêm về các thông số này, hãy xem bài viết So khớp tham số URL của thẻ.

Bước 2: Google phản hồi bằng lệnh chuyển hướng, bao gồm cả dữ liệu so khớp

Thẻ so khớp sẽ khiến Dịch vụ so khớp cookie của Google nhận được yêu cầu từ trình duyệt của người dùng. Yêu cầu này sẽ chuyển hướng HTTP 302 đến URL so khớp cookie của bên đặt giá thầu. Hoạt động chuyển hướng sẽ bao gồm các tham số truy vấn chỉ định Mã nhận dạng người dùng của Google và số phiên bản của mã đó trong URL, đồng thời bên đặt giá thầu cũng sẽ nhận được cookie của mình trong tiêu đề của yêu cầu. Trong thực tế, đối với một URL so khớp cookie được chỉ định là https://ad.network.com/pixel, URL chuyển hướng cho thẻ so khớp đơn giản như đã thấy ở trên có thể có dạng như sau:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

Mã nhận dạng người dùng Google được truyền qua tham số google_gid là một chuỗi được mã hoá base64 không được đệm, an toàn cho web. Đối với những bên đặt giá thầu chọn lưu trữ bảng so khớp, họ nên lưu trữ chính xác chuỗi do Dịch vụ so khớp cookie trả về. Trong các yêu cầu giá thầu tiếp theo, giá trị này sẽ tương ứng với các giá trị được chỉ định thông qua BidRequest.google_user_id trong giao thức RTB của Google hoặc BidRequest.user.id trong quá trình triển khai OpenRTB của Google.

Phiên bản được chỉ định trong google_cver cho biết số phiên bản dạng số của Mã nhận dạng người dùng Google. Mã nhận dạng người dùng Google của một người dùng nhất định sẽ không thường xuyên thay đổi, sau đó, mã nhận dạng này sẽ tăng lên.

Nếu Google gặp lỗi trong khi xử lý yêu cầu so khớp của bạn, thì tham số google_error sẽ được chỉ định.

Bước 3: Bên đặt giá thầu xử lý việc chuyển hướng và phản hồi bằng pixel

Bên đặt giá thầu sẽ nhận được lệnh chuyển hướng đến URL so khớp cookie của họ, bao gồm các thông số mà họ đã chỉ định trong bước đầu tiên và các thông số mà Google đã cung cấp trong bước thứ hai. Ngoài ra, các trình xử lý này cũng sẽ nhận được cookie trong tiêu đề HTTP. Nếu thao tác thành công thì bên đặt giá thầu lưu trữ bảng so khớp riêng có thể so khớp cookie của họ với Mã nhận dạng người dùng Google có trong phản hồi. Bên đặt giá thầu nên lưu trữ chính xác chuỗi do Dịch vụ so khớp cookie trả về.

Nếu thao tác không thành công, bên đặt giá thầu sẽ nhận được thông số google_error trong lệnh chuyển hướng. Đây là một giá trị số tương ứng với nhiều trạng thái lỗi giúp xác định lỗi cụ thể đã xảy ra. Bạn có thể tìm hiểu thêm về các giá trị lỗi có thể xảy ra tại đây. Nếu gặp lỗi, bạn có thể cố gắng so khớp lại người dùng đó bằng cách đặt thẻ so khớp mới.

Bên đặt giá thầu phải luôn phản hồi bằng cách phân phát hình ảnh pixel không hiển thị 1x1 hoặc trả về phản hồi HTTP 204 No Content (Không có nội dung).

Quy trình công việc này được minh hoạ bằng sơ đồ dưới đây, trong đó các yêu cầu và phản hồi được biểu thị bằng một mũi tên và các mục dữ liệu đi kèm với các yêu cầu và phản hồi đó được liệt kê trong dấu ngoặc đơn.

Tham số URL của thẻ phù hợp

Thông số Nội dung mô tả
google_nid Mã mạng (NID) của tài khoản bên đặt giá thầu. Bạn có thể truy xuất mã này thông qua tài nguyên Bên đặt giá thầu.
google_cm Cho Dịch vụ so khớp cookie của Google biết rằng dịch vụ này sẽ thực hiện quy trình so khớp cookie. Giá trị của thông số này sẽ bị bỏ qua và có thể bị bỏ qua.
google_sc Tham số này không được dùng nữa. Đặt cookie của Google cho người dùng nếu không có cookie. Giá trị của thông số này sẽ bị bỏ qua và có thể bị bỏ qua. Việc bỏ qua tham số này sẽ dẫn đến lỗi nếu không có cookie nào tồn tại.
google_no_sc Tham số này không được dùng nữa. Điều này cho Dịch vụ so khớp cookie của Google biết rằng dịch vụ này không nên đặt cookie cho người dùng nếu không có cookie. Giá trị của thông số này sẽ bị bỏ qua và có thể bị bỏ qua.
google_hm

Dữ liệu mà bên đặt giá thầu muốn lưu trữ trong bảng so khớp do Google lưu trữ.

Giá trị này là một chuỗi được mã hoá base64 an toàn cho web (không bắt buộc phải có khoảng đệm). Dữ liệu thô phải có kích thước từ 40 byte trở xuống. Ví dụ: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Chuỗi được mã hoá URL mà bên đặt giá thầu có thể chỉ định xem họ có muốn yêu cầu Google gửi lệnh chuyển hướng HTTP 302 đến URL đã mã hoá cho thẻ so khớp này hay không. Điều này cho phép Google xuất hiện ở phía trước trong lệnh gọi theo chuỗi đến các đối tác. Điều này sẽ dẫn đến lỗi nếu bạn chỉ định mà không có google_hm hoặc có google_cm.
google_ula Một chuỗi dùng để thêm người dùng vào danh sách người dùng hiện có. Định dạng hợp lệ của giá trị là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • timestamp: một dấu thời gian không bắt buộc ở định dạng POSIX, cho biết thời điểm người dùng đã được thêm vào danh sách người dùng.

Bạn có thể lặp lại tham số URL này để thêm người dùng vào nhiều danh sách.
gdpr Cho biết rằng yêu cầu này phải tuân theo các quy định hạn chế của GDPR về việc sử dụng dữ liệu. Để biết thêm thông tin, hãy xem các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu bên dưới, hoặc Tác động đến điều kiện sử dụng tính năng so khớp cookie trong tài liệu về TCF phiên bản 2.0 của IAB trong Authorized Buyers.

Ví dụ: gdpr=1
gdpr_consent Chuỗi về sự minh bạch và sự đồng ý đại diện cho sự đồng ý của người dùng cuối. Để biết thêm thông tin, hãy xem Các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu bên dưới, hoặc Chuỗi về sự minh bạch và sự đồng ý sẽ được chuyển như thế nào? trong tài liệu về TCF phiên bản 2.0 của IAB trong Authorized Buyers.
process_consent Cho biết rằng bên đặt giá thầu đã có được sự đồng ý của người dùng cuối đối với việc sử dụng dữ liệu được quy định trong Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google.

Nếu yêu cầu không phải tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc nếu có các thông số về sự đồng ý khác trong yêu cầu (gdpr_consent), thì thông số này sẽ bị bỏ qua.

Ví dụ: process_consent=T

Ngoài các thông số ở trên, bên đặt giá thầu có thể chỉ định thông số riêng của mình và sẽ được thêm vào dưới dạng thông số cho URL chuyển hướng. Xin lưu ý rằng các thông số do bên đặt giá thầu xác định có tên bằng tiền tố google_ sẽ bị bỏ qua vì các thông số đó được Google đặt trước để phát triển trong tương lai và việc giữ nguyên thứ tự của các thông số không được đảm bảo. Một thẻ so khớp bao gồm thông số do bên đặt giá thầu xác định có thể có dạng như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

Tham số URL chuyển hướng

URL chuyển hướng được tạo từ URL so khớp cookie cơ sở được định cấu hình cho tài khoản của bên đặt giá thầu, bao gồm google_ và các thông số do bên đặt giá thầu xác định tuỳ thuộc vào các thông số được chỉ định trong thẻ so khớp. Các tham số phản hồi google_ sau đây được xác định:

Thông số Nội dung mô tả
google_gid Mã nhận dạng người dùng Google. Thiết lập nếu google_cm được chỉ định trong yêu cầu và yêu cầu thành công.
google_cver Phiên bản cookie. Thiết lập nếu google_cm được chỉ định trong yêu cầu và yêu cầu thành công.
google_error

Giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Khi nhận được, thuộc tính này cho biết chưa có hoạt động nào được thực hiện và không có tham số phản hồi google_ nào khác được đặt. Sau đây là các giá trị lỗi được hỗ trợ:

  • 1: Người dùng có cookie của Google nhưng đã chọn không theo dõi bằng cookie này.
  • 2: Không có hoạt động hợp lệ nào được chỉ định. Ví dụ: yêu cầu không hoạt động đã được nhận.
  • 3: Người dùng chưa có cookie của Google. Google sẽ không đặt cookie thông qua Dịch vụ so khớp cookie.
  • 4: Các thao tác xung đột được chỉ định. Bạn không được phép chỉ định cả cờ google_push và google_cm trong cùng một yêu cầu vì chúng có mục đích xung đột.
  • 5: Một thông số google_push không hợp lệ đã được truyền trong lệnh chuyển hướng đến máy chủ của Google theo yêu cầu so khớp pixel hai chiều. Lệnh chuyển hướng của bạn phải đặt google_push thành cùng một giá trị được chuyển cho bạn trong yêu cầu pixel ban đầu.
  • 6: NID không hợp lệ đã được cung cấp trong thẻ so khớp.
  • 7: Đã phát hiện thấy một cookie không hợp lệ.
  • 8: Không dùng nữa. Không tìm thấy cookie nào.
  • 9: Không tìm thấy cookie nào, đã thử đặt cookie kiểm tra.
  • 10: Tham số google_redir đã được sử dụng mà không chỉ định google_hm hoặc không được dùng bổ sung cho google_cm.
  • 15: Yêu cầu đến từ một khu vực mà Google yêu cầu phải do Google lưu trữ bảng so khớp. Do đó, phản hồi này không chứa Mã nhận dạng người dùng Google. Hiện tại, chúng tôi chỉ bật tính năng này cho một tỷ lệ nhỏ lưu lượng truy cập. Tuy nhiên, chúng tôi dự kiến sẽ kích hoạt đầy đủ tính năng này vào tháng 6 năm 2020.
google_hm

Chỉ xuất hiện nếu không ghi được vào bảng so khớp do Google lưu trữ. Khi điều đó xảy ra, giá trị của trạng thái đó là một trong các mã trạng thái sau:

  • 1 – Bị cấm: Khách hàng chưa có trong danh sách cho phép để ghi các mục trong bảng so khớp được lưu trữ.
  • 2 – Lỗi giải mã: Không thể giải mã giá trị thông số.
  • 3 – Tải trọng quá dài: Giá trị thông số được giải mã thành hơn 24 byte dữ liệu.
  • 4 – Lỗi nội bộ: Đã xảy ra lỗi nội bộ khi lưu trữ dữ liệu.
  • 5 – Điều tiết: Hoạt động ghi này không được xử lý do việc điều tiết.
google_ula

Trạng thái của thao tác thêm danh sách người dùng, lặp lại nếu bạn chỉ định nhiều google_ula trong yêu cầu. Định dạng là:
userlistid,status code

Ví dụ: google_ula=1234567890,0

Toán tử google_ula có thể trả về bất kỳ mã trạng thái nào sau đây:

  • 0 – Không có lỗi. Người dùng đã được thêm vào danh sách người dùng.
  • 2 – Quyền bị từ chối. Bạn không có quyền thêm người dùng vào danh sách người dùng được chỉ định.
  • 5 – Mã danh sách người dùng không hợp lệ. Mã danh sách người dùng được cung cấp không hợp lệ.
  • 6 – Mã thuộc tính đã đóng. Mã danh sách người dùng được cung cấp đã bị đóng.
  • 10 – Lỗi nội bộ. Dịch vụ So khớp cookie đã gặp lỗi nội bộ; bạn có thể thử so khớp lại người dùng một lần nữa.

Các trường hợp sau đây mô tả cách so khớp cookie đối với một người dùng thông thường đang duyệt xem trang web.

Trường hợp 1: Người dùng xoá cookie và duyệt qua một trang web

Jane xoá bộ nhớ đệm của mọi cookie. Sau đó, họ truy cập vào trang chủ của ExampleNews.com.

Dưới đây là những gì sẽ xảy ra:

  1. ExampleNews.com hiển thị và gọi quảng cáo từ Google (Ad Manager).
  2. Vì đơn vị quảng cáo đủ điều kiện cho tính năng phân bổ động, nên Google sẽ gửi yêu cầu giá thầu đến FinestDSP và các bên đặt giá thầu khác thông qua dịch vụ Đặt giá thầu theo thời gian thực.
  3. Ứng dụng bên đặt giá thầu của FinestDSP sẽ nhận và xử lý yêu cầu giá thầu, đồng thời gửi phản hồi giá thầu.
  4. Google nhận phản hồi giá thầu từ bên đặt giá thầu, bao gồm cả phản hồi của FinestDSP chỉ định một quảng cáo có thẻ so khớp (pixel).
  5. FinestDSP thắng phiên đấu giá. Google phân phát quảng cáo và thẻ so khớp của FinestDSP cho Jane.
  6. Thẻ so khớp gọi Dịch vụ so khớp cookie của Google, chỉ định các tham số google_nid và google_cm.
  7. Dịch vụ so khớp cookie sẽ đọc cookie Google của Jane và gửi cho trình duyệt của Jane một lệnh chuyển hướng đến URL so khớp cookie của FinestDSP bằng các tham số google_user_id và google_cver.
  8. Trình duyệt của Jane tải lệnh chuyển hướng đến URL So khớp cookie của FinestDSP.
  9. Điểm cuối so khớp cookie của FinestDSP sẽ xử lý yêu cầu chuyển hướng, bao gồm các tham số URL do Google đặt và cookie của Jane trong các tiêu đề HTTP. Giờ đây, FinestDSP có thể lưu trữ liên kết của cookie với google_user_id trong bảng so khớp.
  10. FinestDSP phản hồi lệnh chuyển hướng bằng một pixel 1x1 không hiển thị.
Trường hợp 2: Người dùng đã có mối liên kết

Một tuần sau Kịch bản 1, Jane truy cập lại ExampleNews.com. Bây giờ, Jane có cả cookie bên đặt giá thầu và cookie của Ad Manager trên máy của họ, sau đây là cách hoạt động của tính năng so khớp.

  1. Trang web hiển thị, khiến Google (Ad Manager) yêu cầu quảng cáo sẽ hiển thị trên trang.
  2. Trong phiên đấu giá quảng cáo, Google gửi yêu cầu giá thầu cho những bên đặt giá thầu hiện hành, bao gồm cả FinestDSP.
  3. FinestDSP nhận yêu cầu giá thầu, bao gồm cả các tín hiệu như google_user_id.
  4. FinestDSP tra cứu google_user_id trong bảng so khớp và tìm thấy cookie liên kết với Jane mà Jane đã tạo trước đó một tuần (trong Tình huống 1).
  5. Dựa trên thông tin liên quan đến cookie, logic đặt giá thầu của FinestDSP đặt giá thầu cho một lượt hiển thị và thắng phiên đấu giá.
  6. Jane có thể nhìn thấy một quảng cáo phù hợp với mối quan tâm của họ dựa trên thông tin mà FinestDSP có.

Tính năng So khớp cookie một chiều tương tự như quy trình làm việc Hai chiều, ngoại trừ việc quy trình này được thay đổi để chỉ Google lưu trữ và điền sẵn bảng so khớp. Bạn có thể sử dụng mã này trong các trường hợp bên đặt giá thầu không được phép lưu trữ Mã nhận dạng người dùng Google trong bảng so khớp của riêng họ. Để sử dụng quy trình này, bên đặt giá thầu phải cho phép Google lưu trữ bảng so khớp, không được chỉ định google_cm trong các yêu cầu đến Dịch vụ so khớp cookie của Google nữa, và do đó, bên đặt giá thầu sẽ không nhận được google_gid để điền bảng so khớp của riêng mình. Sau khi Google thiết lập phương thức so khớp cho một người dùng, bên đặt giá thầu có thể thêm những đối tượng đó vào danh sách người dùng bằng dữ liệu cookie của riêng họ. Tương tự, yêu cầu giá thầu cho những người dùng này sẽ loại trừ Mã nhận dạng người dùng Google, nhưng bao gồm dữ liệu so khớp được lưu trữ. Dưới đây là các bước tóm tắt một ví dụ đơn giản về quy trình sửa đổi.

Để bắt đầu quy trình này, bên đặt giá thầu phải đặt một thẻ so khớp sao cho thẻ đó hiển thị trong trình duyệt của người dùng. Không giống như quy trình làm việc cho người dùng không ở một tiểu bang của Hoa Kỳ có hạn chế về quyền riêng tư, thẻ so khớp phải chuyển trình duyệt của người dùng đến URL so khớp cookie của bạn. Ví dụ: với URL so khớp cookie được định cấu hình là https://ad.network.com/pixel, URL đó sẽ có dạng như sau:

<img src="https://ad.network.com/pixel" />

Khi tải trong trình duyệt của người dùng, trình duyệt sẽ yêu cầu một pixel từ URL so khớp cookie của bên đặt giá thầu. Yêu cầu này sẽ chứa cookie của chúng trong tiêu đề HTTP mà sẽ được trích xuất cho bước tiếp theo.

Điểm cuối so khớp cookie của bên đặt giá thầu phải chuyển hướng đến dịch vụ So khớp cookie của Google, bao gồm cả thông số google_hm được điền sẵn dữ liệu cookie được mã hoá base64 an toàn trên web. URL chuyển hướng có thể có dạng như sau:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

Ngoài cookie của Google trong tiêu đề HTTP, Google sẽ nhận được lệnh chuyển hướng có chứa các tham số mà bạn đã chỉ định.

Bước 4: Google phân phát pixel khi thành công hoặc chuyển hướng lỗi nếu đã chỉ định url báo cáo

Nếu hoạt động so khớp cookie thành công (hoặc nếu bạn chưa chỉ định URL báo cáo so khớp cookie nào cho tài khoản của bên đặt giá thầu), thì Google sẽ phân phát pixel trong suốt 1x1 theo mặc định và quy trình công việc sẽ kết thúc tại đây. Các lượt hiển thị cho người dùng này trong các yêu cầu giá thầu tiếp theo sẽ bao gồm dữ liệu so khớp được lưu trữ của bên đặt giá thầu trong BidRequest.hosted_match_data cho Giao thức của Google hoặc BidRequest.user.buyeruid đối với quá trình triển khai OpenRTB của Google. Bên đặt giá thầu cũng có thể điền danh sách người dùng bằng cách sử dụng dữ liệu so khớp được lưu trữ mà họ đã chỉ định.

Nếu không, nếu xảy ra lỗi, Google sẽ gửi lệnh chuyển hướng đến URL Báo cáo so khớp cookie của bên đặt giá thầu với nguyên nhân gây ra lỗi được chỉ định trong thông số google_error. Nếu URL báo cáo so khớp cookie của bên đặt giá thầu là https://ad.network.com/report, thì URL chuyển hướng sẽ có dạng như sau:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

Trình duyệt của người dùng sẽ chuyển hướng đến URL Báo cáo so khớp cookie của bên đặt giá thầu, bao gồm cả lý do lỗi (nếu có) mà Google chỉ định trong thông số google_error. Để tìm hiểu thêm về cách diễn giải mã lỗi, hãy xem phần mô tả thông số.

Bước 6: Bên đặt giá thầu phân phát pixel trong suốt 1x1

Bên đặt giá thầu phải phản hồi bằng cách phân phát pixel trong suốt 1x1 đến trình duyệt của người dùng.

Quy trình làm việc mặc định cho người dùng ở các tiểu bang của Hoa Kỳ có hạn chế về quyền riêng tư được minh hoạ bằng sơ đồ dưới đây, trong đó các yêu cầu và phản hồi được biểu thị bằng một mũi tên, còn các mục dữ liệu đi kèm các mục đó được liệt kê trong ngoặc đơn.

Thông số Nội dung mô tả
google_nid Mã mạng (NID) của tài khoản bên đặt giá thầu. Bạn có thể truy xuất mã này thông qua tài nguyên Bên đặt giá thầu.
google_sc Tham số này không được dùng nữa. Đặt cookie của Google cho người dùng nếu không có cookie. Giá trị của thông số này sẽ bị bỏ qua và có thể bị bỏ qua. Việc bỏ qua tham số này sẽ dẫn đến lỗi nếu không có cookie nào tồn tại.
google_no_sc Tham số này không được dùng nữa. Điều này cho Dịch vụ so khớp cookie của Google biết rằng dịch vụ này không nên đặt cookie cho người dùng nếu không có cookie. Giá trị của thông số này sẽ bị bỏ qua và có thể bị bỏ qua.
google_hm

Chứa dữ liệu mà bên đặt giá thầu muốn lưu trữ trong bảng so khớp do Google lưu trữ.
google_redir URL được mã hoá mà bạn muốn Google gửi lệnh chuyển hướng HTTP 302. URL được chỉ định sẽ nhận được các lệnh chuyển hướng có tham số google_error cho cả lỗi và thao tác thành công.
google_ula Một chuỗi dùng để thêm người dùng vào danh sách người dùng hiện có. Định dạng hợp lệ của giá trị là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • timestamp: một dấu thời gian không bắt buộc ở định dạng POSIX, cho biết thời điểm người dùng đã được thêm vào danh sách người dùng.

Bạn có thể lặp lại tham số URL này để thêm người dùng vào nhiều danh sách.
gdpr Cho biết rằng yêu cầu này phải tuân theo các quy định hạn chế của GDPR về việc sử dụng dữ liệu. Để biết thêm thông tin, hãy xem các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu bên dưới, hoặc Tác động đến điều kiện sử dụng tính năng so khớp cookie trong tài liệu về TCF phiên bản 2.0 của IAB trong Authorized Buyers.

Ví dụ: gdpr=1
gdpr_consent Chuỗi về sự minh bạch và sự đồng ý đại diện cho sự đồng ý của người dùng cuối. Để biết thêm thông tin, hãy xem Các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu bên dưới, hoặc Chuỗi về sự minh bạch và sự đồng ý sẽ được chuyển như thế nào? trong tài liệu về TCF phiên bản 2.0 của IAB trong Authorized Buyers.
process_consent Cho biết rằng bên đặt giá thầu đã có được sự đồng ý của người dùng cuối đối với việc sử dụng dữ liệu được quy định trong Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google.

Nếu yêu cầu không phải tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc nếu có các thông số về sự đồng ý khác trong yêu cầu (gdpr_consent), thì thông số này sẽ bị bỏ qua.

Ví dụ: process_consent=T
Thông số Nội dung mô tả
google_error

Giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Khi nhận được, thuộc tính này cho biết chưa có hoạt động nào được thực hiện và không có tham số phản hồi google_ nào khác được đặt. Sau đây là các giá trị lỗi được hỗ trợ:

  • 1: Người dùng có cookie của Google nhưng đã chọn không theo dõi bằng cookie này.
  • 2: Không có hoạt động hợp lệ nào được chỉ định. Ví dụ: yêu cầu không hoạt động đã được nhận.
  • 3: Người dùng chưa có cookie của Google. Google sẽ không đặt cookie thông qua Dịch vụ so khớp cookie.
  • 4: Các thao tác xung đột được chỉ định. Bạn không được phép chỉ định cả cờ google_push và google_cm trong cùng một yêu cầu vì chúng có mục đích xung đột.
  • 5: Một thông số google_push không hợp lệ đã được truyền trong lệnh chuyển hướng đến máy chủ của Google theo yêu cầu so khớp pixel hai chiều. Lệnh chuyển hướng của bạn phải đặt google_push thành cùng một giá trị được chuyển cho bạn trong yêu cầu pixel ban đầu.
  • 6: NID không hợp lệ đã được cung cấp trong thẻ so khớp.
  • 7: Đã phát hiện thấy một cookie không hợp lệ.
  • 8: Không dùng nữa. Không tìm thấy cookie nào.
  • 9: Không tìm thấy cookie nào, đã thử đặt cookie kiểm tra.
  • 10: Tham số google_redir đã được sử dụng mà không chỉ định google_hm hoặc không được dùng bổ sung cho google_cm.
  • 15: Yêu cầu đến từ một khu vực mà Google yêu cầu phải do Google lưu trữ bảng so khớp. Do đó, phản hồi này không chứa Mã nhận dạng người dùng Google. Hiện tại, chúng tôi chỉ bật tính năng này cho một tỷ lệ nhỏ lưu lượng truy cập. Tuy nhiên, chúng tôi dự kiến sẽ kích hoạt đầy đủ tính năng này vào tháng 6 năm 2020.

Do Google khởi tạo: So khớp pixel hai chiều

So khớp pixel hai chiều là một quy trình dành cho Dịch vụ so khớp cookie của Google, trong đó Google cố gắng so khớp mã nhận dạng người dùng Google với một bên đặt giá thầu được chọn bằng thuật toán chứ không phải bên chiến thắng trong phiên đấu giá Đặt giá thầu theo thời gian thực. Khi đặt quảng cáo, Google sẽ đặt một thẻ so khớp để chỉ dẫn trình duyệt của người dùng tải một pixel trong suốt từ URL so khớp cookie của bên đặt giá thầu đã chọn. Điều này sẽ cho phép cả Google và bên đặt giá thầu điền sẵn một người dùng nhất định vào bảng so khớp. Dưới đây là ví dụ đơn giản về quy trình này.

Bước 1: Google đặt một thẻ so khớp

Khi trang của nhà xuất bản tham gia tải trong trình duyệt của người dùng và một vùng quảng cáo trên trang đó được Google lấp đầy, thì một thẻ so khớp có thể được đặt để yêu cầu pixel từ một bên đặt giá thầu được chọn theo thuật toán. Thẻ So khớp pixel do Google đặt sẽ kết hợp URL so khớp cookie của bên đặt giá thầu với các thông số bổ sung mà bên đặt giá thầu có thể sử dụng để điền vào bảng so khớp. Đối với một URL so khớp cookie được chỉ định là https://ad.network.com/pixel, URL đó có cấu trúc như sau:

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

Bên đặt giá thầu nhận được yêu cầu so khớp pixel phải phản hồi bằng lệnh chuyển hướng đến Dịch vụ so khớp cookie của Google có cấu trúc như sau:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Xin lưu ý rằng URL chuyển hướng ở trên tương tự như URL được dùng trong thẻ so khớp cho Quy trình so khớp cookie do người đặt giá thầu khởi tạo. Trong tính năng So khớp Pixel, tham số google_cm được thay thế bằng tham số google_push và giá trị của tham số này phải bằng với giá trị mà Google cung cấp trong yêu cầu. Cũng tương tự như quy trình công việc do bên đặt giá thầu khởi tạo, bạn có thể chỉ định các thông số bổ sung để đáp ứng các trường hợp sử dụng khác.

Bước 3: Google xử lý chuyển hướng và phản hồi bằng pixel

Google ghi lại rằng một kết quả trùng khớp đã được tạo cho người dùng và xử lý mọi thao tác bổ sung được yêu cầu thông qua các tham số truy vấn. Cuối cùng, Google sẽ phản hồi bằng một pixel trong suốt 1x1.

Biểu đồ quy trình so khớp pixel

Quy trình công việc này được minh hoạ bằng sơ đồ dưới đây, trong đó các yêu cầu và phản hồi được biểu thị bằng một mũi tên và các mục dữ liệu đi kèm với các yêu cầu và phản hồi đó được liệt kê trong dấu ngoặc đơn.

Thông số yêu cầu thẻ so khớp của Google

Thông số Nội dung mô tả
google_gid Mã nhận dạng người dùng Google. Đối với người dùng không ở một tiểu bang của Hoa Kỳ có quy định hạn chế về quyền riêng tư, thông tin này sẽ luôn được chỉ định trong thẻ so khớp của Google.
google_cver Phiên bản cookie. Giá trị này sẽ luôn được chỉ định trong thẻ so khớp của Google.
google_push Cho biết rằng yêu cầu này đang khởi tạo quy trình so khớp Pixel. Giá trị phải được trả về thông qua thông số tương ứng trong phản hồi chuyển hướng của bên đặt giá thầu.

Thông số chuyển hướng So khớp pixel của bên đặt giá thầu

Thông số Nội dung mô tả
google_nid Mã mạng (NID) của tài khoản bên đặt giá thầu. Bạn có thể truy xuất mã này thông qua tài nguyên Bên đặt giá thầu.
google_push Cho biết rằng lệnh chuyển hướng này đang hoàn tất quy trình so khớp Pixel. Bạn phải chỉ định giá trị của thẻ so khớp tương ứng của Google tại đây.
google_hm

Chứa dữ liệu mà bên đặt giá thầu muốn lưu trữ trong bảng so khớp do Google lưu trữ.
google_ula Một chuỗi dùng để thêm người dùng vào danh sách người dùng hiện có. Định dạng hợp lệ của giá trị là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • timestamp: một dấu thời gian không bắt buộc ở định dạng POSIX, cho biết thời điểm người dùng đã được thêm vào danh sách người dùng.

Bạn có thể lặp lại tham số URL này để thêm người dùng vào nhiều danh sách.

Do Google khởi tạo: So khớp pixel một chiều

Tính năng So khớp pixel một chiều khác với quy trình làm việc Hai chiều ở chỗ thẻ so khớp của Google không chứa thông số chỉ định Mã nhận dạng người dùng Google, nhưng sẽ tiếp tục điền sẵn bảng so khớp do Google lưu trữ. Bạn có thể sử dụng mã này trong các trường hợp bên đặt giá thầu không được phép lưu trữ Mã nhận dạng người dùng Google trong bảng so khớp của riêng họ. Dưới đây là các bước tóm tắt ví dụ đơn giản về quy trình đã sửa đổi.

Bước 1: Google đặt một thẻ so khớp

Google đặt một thẻ so khớp cho một bên đặt giá thầu được chọn bằng thuật toán. Thẻ so khớp chứa thông số google_push. Ví dụ:

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

Bước 2: Trình duyệt của người dùng yêu cầu pixel từ URL Cooking Match của bên đặt giá thầu

Trình duyệt của người dùng yêu cầu pixel từ URL so khớp cookie của bên đặt giá thầu, bao gồm cookie của bên đặt giá thầu trong tiêu đề HTTP.

Điểm cuối so khớp cookie của bên đặt giá thầu phải chuyển hướng đến dịch vụ So khớp cookie của Google, bao gồm cả thông số google_hm được điền sẵn dữ liệu cookie được mã hoá base64 an toàn trên web. URL chuyển hướng có thể có dạng như sau:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Ngoài cookie của Google trong tiêu đề HTTP, Google sẽ nhận được lệnh chuyển hướng có chứa các tham số mà bạn đã chỉ định. Nếu thao tác thành công, số lượt hiển thị cho người dùng này trong các yêu cầu giá thầu tiếp theo sẽ bao gồm dữ liệu so khớp được lưu trữ của người đặt giá thầu trong BidRequest.hosted_match_data cho Giao thức Google hoặc BidRequest.user.buyeruid đối với quá trình triển khai OpenRTB của Google. Bên đặt giá thầu cũng có thể điền danh sách người dùng bằng cách sử dụng dữ liệu so khớp được lưu trữ mà họ đã chỉ định.

Cuối cùng, Google trả về một pixel trong suốt 1x1 cho trình duyệt của người dùng.

Tính năng Đặt giá thầu mở cho phép các đối tác trao đổi sử dụng quy trình so khớp cookie do người đặt giá thầu khởi tạo và quy trình so khớp cookie do Google bắt đầu để so khớp Mã nhận dạng người dùng của Google với cookie của họ. Cookie So khớp (CMA) là một tính năng bổ sung cho các sàn giao dịch, cho phép họ tạo bảng so khớp với bên đặt giá thầu của riêng mình.

  1. Khi đặt quảng cáo, Google sẽ chọn một đối tác trao đổi tham gia bằng thuật toán và đặt một thẻ Hỗ trợ so khớp cookie có cấu trúc như sau:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

  2. Thẻ so khớp CMA của Google khiến URL so khớp cookie của đối tác trao đổi nhận được yêu cầu pixel.

  3. Điểm cuối So khớp cookie của bên trao đổi sẽ nhận được yêu cầu, trong đó dịch vụ so khớp cookie riêng sẽ chịu trách nhiệm so khớp mã nhận dạng người dùng với một trong những bên đặt giá thầu. Trong sơ đồ bên dưới, dịch vụ so khớp cookie của bên trao đổi sẽ phản hồi trình duyệt của người dùng bằng lệnh chuyển hướng đến một trong các điểm cuối của bên đặt giá thầu.
  4. Bên đặt giá thầu sẽ nhận được yêu cầu, cùng với mọi thông số do đối tác trao đổi chỉ định để so khớp mã nhận dạng người dùng với cookie của họ.

Quy định hạn chế

Giới hạn tần suất yêu cầu các kết quả trùng khớp mới

Bên đặt giá thầu có trách nhiệm giới hạn số lệnh gọi đến dịch vụ So khớp cookie đối với những người dùng có mục nhập mới trong bảng so khớp do Google lưu trữ. Một mục nhập trong bảng so khớp được lưu trữ có thể được coi là đã hết hạn sau 14 ngày, sau đó bạn có thể làm mới mục đó.

Phản hồi mọi yêu cầu so khớp pixel

Bên đặt giá thầu sử dụng quy trình So khớp pixel dự kiến sẽ phản hồi mọi yêu cầu so khớp Pixel gửi đến bằng phản hồi bao gồm tham số google_push. Nhờ đó, Google có thể thực thi các chính sách bằng cách giám sát việc sử dụng. Nếu tỷ lệ phản hồi của người đặt giá thầu giảm xuống dưới 90%, Google sẽ điều tiết số lượng yêu cầu Pixel Match được gửi đến tài khoản của người đó.

Sử dụng điểm cuối HTTPS

Các điểm cuối được dùng trong tất cả các quy trình So khớp cookie bắt buộc phải sử dụng HTTPS.

Khi phản hồi yêu cầu Pixel Match được gửi cho bạn qua HTTPS, bạn bắt buộc phải chuyển hướng đến Dịch vụ so khớp cookie qua HTTPS. Tương tự như vậy, điểm cuối của Cookie So khớp hỗ trợ chuyển hướng đến bên đặt giá thầu cũng phải sử dụng HTTPS. Nếu bạn gửi yêu cầu tới Google qua HTTP thường xuyên hơn 2 phút một lần, số lượng yêu cầu so khớp được gửi đến tài khoản của bạn sẽ bị điều tiết.

Những yêu cầu So khớp cookie tuân theo Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google phải biểu thị sự đồng ý của người dùng cuối. Những yêu cầu như vậy là bắt buộc để cho biết rằng bạn đã thu thập sự đồng ý bằng một trong những cách sau:

Ví dụ

Các ví dụ dưới đây minh hoạ cách sử dụng dịch vụ So khớp cookie để đạt được các mục tiêu cụ thể. Xin lưu ý rằng trừ phi có quy định khác, hệ thống giả định rằng người dùng bị hành động không phải từ một tiểu bang của Hoa Kỳ có các quy định hạn chế về quyền riêng tư.

Điền bảng so khớp do bên đặt giá thầu lưu trữ

Người đặt giá thầu có thể sử dụng quy trình So khớp cookie để điền bảng so khớp của riêng mình bằng cách chỉ cung cấp các thông số google_nid và google_cm trong thẻ so khớp. Thông tin này có thể có dạng như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

Nếu URL so khớp cookie của bên đặt giá thầu được đặt thành https://ad.network.com/pixel?id=1 và hoạt động so khớp cookie thành công, thì lệnh chuyển hướng mà Google gửi để phản hồi cho thẻ so khớp của bên đặt giá thầu có thể có dạng như sau:

https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

Nếu hoạt động so khớp cookie không thành công vì người dùng không có cookie của Google, thì phản hồi sẽ là:

https://ad.network.com/pixel?id=1&google_error=3

Mã lỗi phụ thuộc vào nguyên nhân cơ bản gây ra lỗi. Để tìm hiểu thêm về các mã lỗi có thể xảy ra cho quy trình So khớp cookie, hãy xem bài viết về tham số URL chuyển hướng.

Thêm vào danh sách người dùng duy nhất

Bạn có thể chỉ định tham số google_ula trong thẻ so khớp của bên đặt giá thầu để thêm người dùng vào danh sách người dùng có mã nhận dạng đã cho. Nếu bảng so khớp do Google hoặc bên đặt giá thầu lưu trữ có một mục mới cho người dùng, thì bên đặt giá thầu có thể đặt một thẻ so khớp bao gồm các thông số google_nid và google_ula để thêm người dùng vào danh sách được chỉ định mà không cần bắt đầu quy trình So khớp cookie đầy đủ. Xem các hạn chế khi gọi Dịch vụ so khớp cookie để biết thêm các bước cụ thể. Thẻ so khớp tương ứng có thể có dạng như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

Đối với phản hồi thành công, khi URL so khớp cookie của bên đặt giá thầu là https://ad.network.com/pixel, URL chuyển hướng của Google sẽ là:

https://ad.network.com/pixel?google_ula=12345,0

Nếu có lỗi chung (ví dụ: không có cookie của Google) cho người dùng, thì URL chuyển hướng sẽ bao gồm tham số google_error:

  • https://ad.network.com/pixel?google_error=3

Nếu có lỗi cụ thể liên quan đến việc thêm người dùng vào danh sách, bạn sẽ nhận được google_ula trong lệnh chuyển hướng. Không giống như tham số thẻ so khớp tương ứng, tham số này sẽ thay thế dấu thời gian bằng mã trạng thái để cho biết hoạt động thành công. Ví dụ: nếu yêu cầu không thành công vì tài khoản bên đặt giá thầu không có quyền truy cập vào danh sách người dùng đã chỉ định, thì URL chuyển hướng sẽ là:

https://ad.network.com/pixel?google_ula=12345,2

Thêm vào nhiều danh sách người dùng

Bên đặt giá thầu có thể chỉ định rằng cần thêm người dùng vào nhiều danh sách người dùng bằng cách đưa nhiều tham số google_ula vào thẻ so khớp. Trong thực tế, mục này có thể có dạng như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />

Trạng thái của hoạt động cho mỗi danh sách người dùng cũng được báo cáo tương tự thông qua các tham số google_ula riêng biệt trong lệnh chuyển hướng:

https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0

Trong lệnh chuyển hướng ở trên, chúng ta có thể thấy thao tác đã thành công đối với danh sách người dùng có mã 45678, nhưng không thực hiện được đối với mã danh sách người dùng 12345 vì bên đặt giá thầu không có quyền truy cập vào.

Để so khớp cookie và thêm người dùng vào danh sách người dùng trong một yêu cầu duy nhất, thẻ so khớp của bên đặt giá thầu phải bao gồm google_cm và google_ula:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

URL chuyển hướng do Google chỉ định sẽ bao gồm google_gid, google_cver và google_ula. Lệnh này có thể có dạng như sau:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

Lưu trữ một trận đấu trong bảng so khớp do Google lưu trữ

Nếu bên đặt giá thầu muốn lưu trữ dữ liệu cookie trong bảng so khớp do Google lưu trữ và không có ý định lưu trữ thông tin so khớp với mã nhận dạng người dùng Google trong bảng so khớp của riêng mình, thì thẻ so khớp đó phải bao gồm tham số google_hm, trong đó giá trị của thẻ phải là một chuỗi được mã hoá base64 an toàn trên web. Đối với người dùng có dữ liệu cookie chưa mã hoá của bên đặt giá thầu là Cookie number 1!, thì giá trị được mã hoá sẽ là Q29va2llIG51bWJlciAxIQ==, sẽ được dùng trong một thẻ so khớp như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

Để phản hồi thành công, khi URL so khớp cookie của bên đặt giá thầu là https://cookie-monster.com/pixel, URL chuyển hướng của Google sẽ là:

https://cookie-monster.com/pixel

Tham số google_gid không có trong lệnh chuyển hướng vì thẻ so khớp không bao gồm google_cm và google_hm không có trong phản hồi thành công. Trong yêu cầu giá thầu trong tương lai cho các lượt hiển thị cho người dùng này, bên đặt giá thầu sẽ nhận được dữ liệu so khớp được lưu trữ trong BidRequest.hosted_match_data đối với giao thức RTB của Google hoặc BidRequest.user.buyeruid để triển khai OpenRTB của Google.

Thay vào đó, nếu bên đặt giá thầu sử dụng một thẻ so khớp mà giá trị của google_hm không được mã hoá base64 (chẳng hạn như chocolate_chunk!), thì URL chuyển hướng có thể có dạng như sau:

https://cookie-monster.com/pixel?google_hm=2

URL chuyển hướng ở trên bao gồm giá trị google_hm là 2, cho thấy thao tác không thành công vì không thể giải mã giá trị đó.

Bên đặt giá thầu và bảng so khớp do Google lưu trữ kèm theo danh sách người dùng

Nếu bên đặt giá thầu lưu trữ danh sách sử dụng của riêng họ ngoài danh sách người dùng do Google lưu trữ, đồng thời muốn có một thẻ so khớp duy nhất để so khớp cả hai bảng, đồng thời thêm người dùng vào một danh sách người dùng nhất định, thì thẻ so khớp của họ phải bao gồm các tham số google_cm, google_hm và google_ula. Nếu dữ liệu cookie của bên đặt giá thầu là Cookie number 1!, thì giá trị được mã hoá sẽ là Q29va2llIG51bWJlciAxIQ==, nhờ đó tạo ra một thẻ so khớp như sau:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />

Để phản hồi thành công, URL so khớp cookie của bên đặt giá thầu là https://cookie-monster.com/pixel, URL chuyển hướng của Google sẽ có dạng như sau:

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

Khi nhận được lệnh chuyển hướng, bên đặt giá thầu có thể so khớp Mã nhận dạng người dùng của Google được chỉ định trong google_gid với dữ liệu cookie trong bảng so khớp. Ngoài ra, chúng có thể xác định rằng các thao tác trên bảng so khớp và danh sách người dùng do Google lưu trữ đã thành công. Do đó, mọi thao tác nhắm mục tiêu trước mà bên đặt giá thầu được định cấu hình để nhắm mục tiêu mã danh sách người dùng được chỉ định sẽ khiến bên đặt giá thầu nhận được yêu cầu giá thầu cho các lượt hiển thị từ người dùng. Tương tự, trong các yêu cầu giá thầu này, bên đặt giá thầu sẽ nhận được dữ liệu so khớp được lưu trữ trong BidRequest.hosted_match_data đối với giao thức RTB của Google hoặc BidRequest.user.buyeruid để triển khai OpenRTB của Google.