So khớp cookie

So khớp cookie là một tính năng cho phép bạn so khớp cookie của mình (ví dụ: mã nhận dạng của người dùng đã duyệt xem 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 và tạo danh sách người dùng có thể giúp bạn đưa ra các 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 được dùng trong hoạt độ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ể mà các quy trình này có thể có đối với 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 của cookie cho những người dùng duyệt xem trang web của họ. Cookie này được dùng để xác định 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 trình duyệt Internet vẫn hạn chế một chủ sở hữu đọc cookie do một 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 bằng cookie thuộc miền doubleclick.net và những bên đặt giá thầu tham gia Đặt giá thầu theo thời gian thực có thể có miền riêng để xác định một số 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 một lượt hiển thị được gửi trong yêu cầu giá thầu có được liên kết với một trong những người dùng đang được nhắm đến hay không. Họ sẽ nhận được dữ liệu cookie của riêng mình hoặc một Mã nhận dạng người dùng Google dành riêng cho bên đặt giá thầu. Đây là một 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 giúp 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 của Google, đồng thời cho phép điền sẵn thông tin vào danh sách người dùng.

Bảng đối sánh

Bạn có thể sử dụng bảng so khớp để ánh xạ mộ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 sẵn vào bảng so khớp của riêng họ bằng cách liên kết cookie của họ cho một người dùng nhất định với Mã nhận dạng người dùng của Google hoặc để điền sẵn vào bảng so khớp do Google lưu trữ. Các bảng so khớp là cần thiết để ứng dụng đặt giá thầu của bên đặt giá thầu truy cập vào dữ liệu cookie của người dùng đang được hiển thị lượt hiển thị.

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

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

  • Danh sách người dùng: Bạn có thể điền sẵn thông tin vào danh sách người dùng bằng Mã nhận dạng người dùng của 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ể định cấu hình chế độ nhắm mục tiêu trước để chỉ nhận được những yêu cầu giá thầu có chứa dữ liệu so khớp được lưu trữ. Bạn có thể sử dụng thông tin này để loại bỏ những lượt hiển thị ít liên quan 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 sau đây hoặc thông qua Dịch vụ 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. Người này có thể bật các quy trình cụ thể và giúp bạn định cấu hình những mục sau:

  • Mã mạng so khớp cookie (NID): Một mã nhận dạng duy nhất ở dạng chuỗi để xác định một tài khoản người đặt giá thầu cho quy trình So khớp cookie và các hoạt động liên quan khác.
  • URL so khớp cookie: URL cơ sở dành cho điểm cuối sẽ chấp nhận và xử lý các yêu cầu 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 truyền đến URL đó trong quy trình So khớp cookie.
  • Thẻ so khớp: Thẻ mà bạn phải đặt trong trình duyệt của người dùng cho quy trình So khớp cookie do bên đặt giá thầu khởi tạo. Bạn có thể phân phát thành phần này 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 đơn hướng, đây là URL không bắt buộc mà bạn có thể cung cấp để chỉ định một điểm cuối sẽ nhận 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, các phản hồi sẽ chỉ được gửi đến URL này nếu có lỗi xảy ra với thao tác 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 những nền tảng triển khai quy trình hỗ trợ so khớp cookie, đây là URL cơ sở của điểm cuối nhằm 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 những 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. Điều này nhằm mục đích ngăn các yêu cầu CMA làm quá tải máy chủ của sàn giao dịch.

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 tham số được thêm vào theo thứ tự không đảm bảo. Những bên đặt giá thầu có các hoạt động tích hợp yêu cầu sắp xếp nhất quán các tham số có thể đặt macro trong URL So khớp cookie để cho biết vị trí của các tham số.

Macro được hỗ trợ

Người đặt giá thầu có thể tuỳ ý định cấu hình URL So khớp cookie để thêm một hoặc nhiều macro ở dạng %%GOOGLE_<PARAM_NAME>%% hoặc %%GOOGLE_<PARAM_NAME>_PAIR%%. Sau đây là các macro được hỗ trợ và giá trị mở rộng tương ứng:

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 &cver=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

Một đơn vị đặt giá thầu có chế độ tích hợp so khớp cookie với một điểm cuối được lưu trữ tại https://user.bidder.com/cookies và việc triển khai của họ yêu cầu các thông số do đơn vị đặt giá thầu xác định trước ngoài các thông số So khớp pixel theo thứ tự sau: google_push, google_gid, google_cver và google_error. Bên đặ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 một yêu cầu so khớp đến người đặt giá thầu này, yêu cầu đó sẽ được mở rộng thành một yêu cầu 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 hỗ trợ 3 quy trình sau.

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

Bước 1: Đặt thẻ so 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. Thẻ so khớp chỉ trả về Mã nhận dạng người dùng của Google cho đơn vị đặt giá thầu có thể được cấu trúc như sau:

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

Bạn có thể thêm các thông số khác vào thẻ so khớp để đáp ứng nhiều trường hợp sử dụng. Để tìm hiểu thêm về các tham số này, hãy xem bài viết So khớp các 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 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ẽ phát hành một lệnh chuyển hướng HTTP 302 đến URL so khớp cookie của đơn vị đặt giá thầu. Lệnh chuyển hướng sẽ bao gồm các tham số truy vấn chỉ định Mã người dùng 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 họ có trong tiêu đề yêu cầu. Trong thực tế, đối với URL so khớp cookie được chỉ định là https://ad.network.com/pixel, URL chuyển hướng cho thẻ so khớp trước đó 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 an toàn cho web, không có khoảng đệm. Đối với những người đặ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.user.id.

Phiên bản được chỉ định trong google_cver cho biết số phiên bản dạng số cho Mã nhận dạng người dùng của Google. Mã nhận dạng người dùng Google cho một người dùng nhất định sẽ hiếm khi thay đổi, sau đó mã 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ì một tham số google_error sẽ được chỉ định.

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

Giá thầu nhận được một lệnh chuyển hướng đến URL so khớp cookie của họ, bao gồm cả các thông số mà họ đã chỉ định ở bước đầu tiên và những thông số mà Google cung cấp ở bước thứ hai. Ngoài ra, họ cũng sẽ nhận được cookie trong tiêu đề HTTP. Nếu thao tác thành công, một đơn vị đặt giá thầu lưu trữ bảng so khớp của riêng họ có thể so khớp cookie của họ với Mã nhận dạng người dùng của Google có trong phản hồi. Người đặt giá thầu nên lưu trữ chuỗi chính xác 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 một tham số google_error trong lệnh chuyển hướng. Đây là một giá trị số tương ứng với các trạng thái lỗi khác nhau, 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 trong phần mô tả của tham số URL google_error. Nếu gặp lỗi, bạn có thể thử so khớp lại cho người dùng đó bằng cách đặt mộ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 một hình ảnh pixel 1x1 không nhìn thấy được hoặc trả về phản hồi HTTP 204 Không có nội dung.

Quy trình này được minh hoạ bằng sơ đồ sau đâ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 liệt kê trong dấu ngoặc đơn.

Tham số URL của thẻ khớp

Thông số Mô tả
google_nid Mã mạng (NID) cho tài khoản đơn vị đặt giá thầu. Bạn có thể truy xuất mã nhận dạng này thông qua tài nguyên Người đặt giá thầu.
google_cm Cho biết Dịch vụ so khớp cookie của Google nên thực hiện quy trình so khớp cookie. Giá trị của tham số này sẽ bị bỏ qua và có thể bị bỏ sót.
google_sc Thông 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 nào. Giá trị của tham số này sẽ bị bỏ qua và có thể bị bỏ sót. Việc bỏ qua tham số sẽ dẫn đến lỗi nếu không có cookie.
google_no_sc Thông số này không được dùng nữa. Điều này cho biết Dịch vụ so khớp cookie của Google không nên đặt cookie cho người dùng nếu không có cookie. Giá trị của tham số này sẽ bị bỏ qua và có thể bị bỏ sót.
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ó tối đa 40 byte. Ví dụ: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.
google_redir Một chuỗi được mã hoá URL mà bên đặt giá thầu có thể chỉ định nếu họ muốn hướng dẫn Google gửi lệnh chuyển hướng HTTP 302 đến URL được mã hoá cho thẻ so khớp này. Điều này cho phép Google được đặt ở vị trí đầu tiên 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 dự kiến của giá trị là userlistid[,timestamp]:
  • userlistid: một mã nhận dạng danh sách người dùng bằng số duy nhất.
  • timestamp: 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 thông 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 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 chi tiết, hãy xem Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc Mức độ ảnh hưởng đến điều kiện phù hợp để so khớp cookie trong Tài liệu về Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.0 của Cục Quảng cáo tương tác (IAB) trên Authorized Buyers.

Ví dụ: gdpr=1
gdpr_consent Một 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 chi tiết, hãy xem Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc Chuỗi về sự minh bạch và sự đồng ý sẽ được truyền như thế nào? trong Tài liệu về Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.0 của Cục Quảng cáo tương tác (IAB) cho Authorized Buyers.
process_consent Cho biết rằng bên đặt giá thầu đã nhận được sự đồng ý của người dùng cuối đối với các mục đích sử dụng dữ liệu được chỉ định trong Chính sách của Google về sự đồng ý của người dùng ở Liên minh Châu Âu.

Nếu yêu cầu không 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ố khác về sự đồng ý 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 tham số trước đó, bên đặt giá thầu có thể chỉ định tham số của riêng họ. Các tham số này sẽ được thêm dưới dạng tham số vào URL chuyển hướng. Xin lưu ý rằng các thông số do người đặt giá thầu xác định có tên bằng tiền tố google_ sẽ bị bỏ qua vì Google dành riêng các thông số đó cho việc phát triển trong tương lai và không đảm bảo việc giữ nguyên thứ tự của các thông số. Thẻ so khớp bao gồm các thông số do bên đặt giá thầu xác định có thể trô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 cơ sở của hoạt động So khớp cookie được định cấu hình cho tài khoản của một đơn vị đặt giá thầu, bao gồm cả google_ và các tham số do đơn vị đặt giá thầu xác định, tuỳ thuộc vào những tham 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ố Mô tả
google_gid Mã nhận dạng người dùng Google. Đặt 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. Đặt nếu google_cm được chỉ định trong yêu cầu và yêu cầu thành công.
google_error

Một giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Khi nhận được, thông báo này cho biết rằng không có thao tác nào được thực hiện và không có tham số phản hồi google_ nào khác được đặt. Các giá trị lỗi được hỗ trợ bao gồm:

  • 1: Người dùng có cookie của Google nhưng đã chọn không tham gia bất kỳ hoạt động theo dõi nào bằng cookie này.
  • 2: Không có thao tác hợp lệ nào được chỉ định. Ví dụ: yêu cầu không có thao tác đã nhận được.
  • 3: Người dùng không 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 tham số google_push không hợp lệ đã được truyền trong một lệnh chuyển hướng đến máy chủ của Google trong 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 truyền cho bạn trong yêu cầu pixel ban đầu.
  • 6: Bạn đã cung cấp một NID không hợp lệ 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, hệ thống đã cố gắng đặt một cookie kiểm thử.
  • 10: Tham số google_redir được dùng mà không chỉ định google_hm hoặc được dùng ngoài google_cm.
  • 15: Yêu cầu đến từ một khu vực mà Google yêu cầu Google lưu trữ bảng so khớp. Do đó, phản hồi này không chứa Mã người dùng Google.
google_hm

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

  • 1 – Bị cấm: Khách hàng không có quyền 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ị tham số.
  • 3 – Tải trọng quá dài: Giá trị tham số được giải mã thành hơn 40 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 – Bị điều tiết: Thao tác ghi này không được xử lý do bị điều tiết.
google_ula

Trạng thái của thao tác thêm danh sách người dùng, được 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

Thao tác 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 này đã đượ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 đã cho.
  • 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 đã đó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.

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

Tình huống 1: Người dùng xoá cookie và duyệt xem một trang web

Jane xoá bộ nhớ đệm của tất cả 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 này đủ điều kiện sử dụng tính năng phân bổ động, nên Google sẽ gửi yêu cầu đặt giá thầu đến FinestDSP và những 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 đặt giá thầu của FinestDSP nhận và xử lý yêu cầu giá thầu, đồng thời gửi giá thầu phản hồi.
  4. Google nhận được phản hồi về giá thầu từ những người đặt giá thầu, bao gồm cả phản hồi của FinestDSP, trong đó 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 thông số google_nid và google_cm.
  7. Cookie Match Service đọc cookie của 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 với các tham số google_gid và google_cver được đặt.
  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 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 họ cho Jane trong tiêu đề HTTP. Giờ đây, FinestDSP có thể lưu trữ mối liên kết giữa cookie của họ với google_gid 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 nhìn thấy được.
Trường hợp 2: Người dùng có mối liên kết hiện có

Một tuần sau Tình huống 1, Jane truy cập lại vào ExampleNews.com. Giờ đây, Jane đã có cả cookie của bên đặt giá thầu và cookie của Ad Manager trên máy của mình, sau đây là cách hoạt động của quy trình so khớp.

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

So khớp cookie một chiều tương tự như quy trình hai chiều, ngoại trừ việc quy trình này được sửa đổi để chỉ Google lưu trữ và điền sẵn bảng so khớp. Bạn có thể sử dụng thông tin này trong 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 của Google trong bảng so khớp của riêng họ. Để sử dụng quy trình này, các đơn vị đặt giá thầu phải cho phép Google lưu trữ bảng so khớp, không thể chỉ định google_cm trong các yêu cầu gửi đến Dịch vụ so khớp cookie của Google và do đó sẽ không nhận được google_gid để điền vào bảng so khớp của riêng họ. Sau khi Google xác định được một người dùng khớp, bên đặt giá thầu có thể thêm người dùng đó vào danh sách người dùng bằng cách sử dụng dữ liệu cookie của riêng họ. Tương tự, các 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ữ. Ví dụ về quy trình công việc đã sửa đổi được tóm tắt trong các bước sau.

Bước 1: Đặt thẻ so khớp được chuyển hướng đến URL so khớp cookie của đơn vị đặt giá thầu

Để bắt đầu quy trình này, một đơn vị đặ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. Không giống như quy trình dành cho người dùng không ở tiểu bang tại Hoa Kỳ có các quy định hạn chế về quyền riêng tư, thẻ so khớp phải chuyển hướng trình duyệt của người dùng đến URL So khớp cookie của bạn. Ví dụ: nếu bạn định cấu hình URL so khớp cookie là https://ad.network.com/pixel, thì 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, yêu cầu này sẽ yêu cầu một pixel từ URL so khớp cookie của đơn vị đặt giá thầu. Yêu cầu này sẽ chứa cookie của họ trong tiêu đề HTTP. Bạn cần trích xuất cookie này 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ả tham số google_hm được điền sẵn bằng dữ liệu cookie được mã hoá base64 an toàn cho web của họ. 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 sẽ nhận được một lệnh chuyển hướng chứa các tham số mà bạn đã chỉ định, ngoài cookie của Google trong tiêu đề HTTP.

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

Nếu thao tác so khớp cookie thành công hoặc nếu không có URL Báo cáo so khớp cookie nào được chỉ định cho tài khoản của bên đặt giá thầu, thì theo mặc định, Google sẽ phân phát một pixel trong suốt 1x1 và quy trình sẽ kết thúc tại đây. 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.user.buyeruid. Người đặt giá thầu cũng có thể điền sẵn danh sách người dùng bằ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 một lệnh chuyển hướng đến URL Báo cáo so khớp cookie của bên đặt giá thầu, trong đó nêu rõ nguyên nhân gây ra lỗi trong tham 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 xảy ra lỗi (nếu có) do Google chỉ định trong tham 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ả tham 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 một pixel trong suốt 1x1 cho trình duyệt của người dùng.

Quy trình mặc định cho người dùng ở những tiểu bang tại Hoa Kỳ có các quy định hạn chế về quyền riêng tư được minh hoạ bằng sơ đồ sau, 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 liệt kê trong dấu ngoặc đơn.

Thông số Mô tả
google_nid Mã mạng (NID) cho tài khoản đơn vị đặt giá thầu. Bạn có thể truy xuất mã nhận dạng này thông qua tài nguyên Người đặt giá thầu.
google_sc Thông 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 nào. Giá trị của tham số này sẽ bị bỏ qua và có thể bị bỏ sót. Việc bỏ qua tham số sẽ dẫn đến lỗi nếu không có cookie.
google_no_sc Thông số này không được dùng nữa. Điều này cho biết Dịch vụ so khớp cookie của Google không nên đặt cookie cho người dùng nếu không có cookie. Giá trị của tham số này sẽ bị bỏ qua và có thể bị bỏ sót.
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 Một 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à các 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 dự kiến của giá trị là userlistid[,timestamp]:
  • userlistid: một mã nhận dạng danh sách người dùng bằng số duy nhất.
  • timestamp: 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 thông 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 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 chi tiết, hãy xem Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc Mức độ ảnh hưởng đến điều kiện phù hợp để so khớp cookie trong Tài liệu về Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.0 của Cục Quảng cáo tương tác (IAB) trên Authorized Buyers.

Ví dụ: gdpr=1
gdpr_consent Một 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 chi tiết, hãy xem Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu hoặc Chuỗi về sự minh bạch và sự đồng ý sẽ được truyền như thế nào? trong Tài liệu về Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.0 của Cục Quảng cáo tương tác (IAB) cho Authorized Buyers.
process_consent Cho biết rằng bên đặt giá thầu đã nhận được sự đồng ý của người dùng cuối đối với các mục đích sử dụng dữ liệu được chỉ định trong Chính sách của Google về sự đồng ý của người dùng ở Liên minh Châu Âu.

Nếu yêu cầu không 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ố khác về sự đồng ý 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ố Mô tả
google_error

Một giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Khi nhận được, thông báo này cho biết rằng không có thao tác nào được thực hiện và không có tham số phản hồi google_ nào khác được đặt. Các giá trị lỗi được hỗ trợ bao gồm:

  • 1: Người dùng có cookie của Google nhưng đã chọn không tham gia bất kỳ hoạt động theo dõi nào bằng cookie này.
  • 2: Không có thao tác hợp lệ nào được chỉ định. Ví dụ: yêu cầu không có thao tác đã nhận được.
  • 3: Người dùng không 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 tham số google_push không hợp lệ đã được truyền trong một lệnh chuyển hướng đến máy chủ của Google trong 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 truyền cho bạn trong yêu cầu pixel ban đầu.
  • 6: Bạn đã cung cấp một NID không hợp lệ 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, hệ thống đã cố gắng đặt một cookie kiểm thử.
  • 10: Tham số google_redir được dùng mà không chỉ định google_hm hoặc được dùng ngoài google_cm.
  • 15: Yêu cầu đến từ một khu vực mà Google yêu cầu Google lưu trữ bảng so khớp. Do đó, phản hồi này không chứa Mã người dùng Google.

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 trong Dịch vụ so khớp cookie của Google, trong đó Google cố gắng so khớp một Mã nhận dạng người dùng Google với một giá thầu được chọn theo thuật toán, không phải là người chiến thắng trong phiên đấu giá Đặt giá thầu theo thời gian thực. Khi một quảng cáo được đặt, Google sẽ đặt một thẻ so khớp hướng 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. Thao tác này sẽ cho phép cả Google và bên đặt giá thầu điền thông tin vào bảng so khớp cho một người dùng cụ thể. Sau đây là một ví dụ về quy trình này.

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

Khi trang của một nhà xuất bản tham gia tải trong trình duyệt của người dùng và một vị trí quảng cáo trên trang đó được Google điền sẵn, một thẻ so khớp có thể được đặt để yêu cầu một pixel từ một đơn vị đặ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 đơn vị đặt giá thầu với các tham số bổ sung mà đơn vị đặt giá thầu có thể dùng để điền thông tin vào bảng so khớp của họ. Đối với URL so khớp cookie được chỉ định là https://ad.network.com/pixel, URL này đượ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" />

Những 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 một 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 bên đặ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ị do Google cung cấp trong yêu cầu. Tương tự như quy trình do bên đặt giá thầu khởi tạo, bạn có thể chỉ định các tham số bổ sung để đáp ứng các trường hợp sử dụng bổ sung.

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

Google ghi nhật ký rằng một lượt so 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 phản hồi bằng một pixel trong suốt 1x1.

Sơ đồ quy trình công việc So khớp pixel

Quy trình này được minh hoạ bằng sơ đồ sau đâ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 liệt kê trong dấu ngoặc đơn.

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

Thông số Mô tả
google_gid Mã nhận dạng người dùng Google. Đối với người dùng không ở những tiểu bang tại Hoa Kỳ có các hạn chế về quyền riêng tư, thông số này sẽ luôn được chỉ định trong thẻ so khớp của Google.
google_cver Phiên bản cookie. Thông số này sẽ luôn được chỉ định trong thẻ match của Google.
google_push Cho biết rằng yêu cầu này đang bắt đầu quy trình Khớp pixel. Giá trị phải được trả về thông qua tham số tương ứng trong phản hồi chuyển hướng của bên đặt giá thầu.
gdpr_consent Một 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 chi tiết, hãy xem [Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) hoặc **Chuỗi TC sẽ được truyền như thế nào?** trong [Tài liệu về TCF phiên bản 2.0 của IAB cho Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378).

Các thông số chuyển hướng So khớp pixel của đơn vị đặt giá thầu

Thông số Mô tả
google_nid Mã mạng (NID) cho tài khoản đơn vị đặt giá thầu. Bạn có thể truy xuất mã nhận dạng này thông qua tài nguyên Người đặ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 Khớp pixel. Bạn phải chỉ định giá trị từ thẻ khớp của Google tương ứng 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 dự kiến của giá trị là userlistid[,timestamp]:
  • userlistid: một mã nhận dạng danh sách người dùng bằng số duy nhất.
  • timestamp: 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 thông số URL này để thêm người dùng vào nhiều danh sách.
gdpr_consent Một 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 chi tiết, hãy xem [Yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) hoặc **Chuỗi TC sẽ được truyền như thế nào?** trong [Tài liệu về TCF phiên bản 2.0 của IAB trên Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378).

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 hai chiều ở chỗ thẻ so khớp của Google không bao gồm một tham số chỉ định mã nhận dạng người dùng Google, nhưng sẽ tiếp tục điền thông tin vào bảng so khớp do Google lưu trữ. Bạn có thể sử dụng tính năng này trong trường hợp người đặ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ọ. Ví dụ về quy trình làm việc đã sửa đổi được tóm tắt trong các bước sau.

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

Google đặt một thẻ so khớp cho một đơn vị đặt giá thầu được chọn theo thuật toán. Thẻ khớp bao gồm tham 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 so khớp cookie của đơn vị đặt giá thầu

Trình duyệt của người dùng yêu cầu một pixel từ URL so khớp cookie của bên đặt giá thầu, bao gồm cả 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ả tham số google_hm được điền sẵn bằng dữ liệu cookie được mã hoá base64 an toàn cho web của họ. 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

Google sẽ nhận được một lệnh chuyển hướng chứa các tham số mà bạn đã chỉ định, ngoài cookie của Google trong tiêu đề HTTP. Nếu thao tác thành công, thì số lượt hiển thị cho người dùng này trong các yêu cầu đặt 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.user.buyeruid. Bên đặt giá thầu cũng có thể điền sẵn danh sách người dùng bằ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 1x1 trong suốt 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 nền tảng trao đổi sử dụng quy trình so khớp cookie do bên đặt giá thầu khởi tạo và do Google khởi tạo để so khớp Mã nhận dạng người dùng Google với cookie của họ. Cookie Match Assist (CMA) là một tính năng bổ sung dành cho các sàn giao dịch, cho phép họ tạo bảng khớp với những người đặt giá thầu của riêng mình.

  1. Khi đặt quảng cáo, thuật toán của Google sẽ chọn một sàn giao dịch tham gia và đặt thẻ Cookie Match Assist 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 sàn giao dịch nhận được yêu cầu về pixel.

  3. Điểm cuối So khớp cookie của sàn giao dịch sẽ nhận được yêu cầu, trong đó dịch vụ so khớp cookie của riêng sàn giao dịch chịu trách nhiệm so khớp mã nhận dạng người dùng với một trong các đơn vị đặt giá thầu của sàn giao dịch. Trong sơ đồ sau, dịch vụ so khớp cookie của sàn giao dịch sẽ phản hồi trình duyệt của người dùng bằng một 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 nhận được yêu cầu này, cùng với mọi thông số do sàn giao dịch 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 về kết quả trùng khớp mới

Bên đặt giá thầu chịu trách nhiệm giới hạn số lượng lệnh gọi đến dịch vụ Cookie Matching cho 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 trong bảng trận đấu đượ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 đó.

Trả lời tất cả các yêu cầu so khớp pixel

Những bên đặt giá thầu sử dụng quy trình Pixel Matching dự kiến sẽ phản hồi tất cả các yêu cầu Pixel Match đến bằng một phản hồi bao gồm tham số google_push. Điều này cho phép Google 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 một bên đặt giá thầu thấp hơn 90%, Google sẽ điều tiết số lượng yêu cầu So khớp pixel được gửi đến tài khoản của bên đó.

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

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

Khi phản hồi một yêu cầu So khớp pixel được gửi cho bạn qua HTTPS, bạn phải chuyển hướng đến Dịch vụ so khớp cookie qua HTTPS. Tương tự, điểm cuối Cookie Match Assist chuyển hướng đến các đơn vị đặt giá thầu cũng phải sử dụng HTTPS. Nếu bạn gửi yêu cầu đến Google qua HTTP thường xuyên hơn 1 lần mỗi 2 phút, thì 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.

Các yêu cầu So khớp cookie phải tuân thủ Chính sách của Google về sự đồng ý của người dùng ở Liên minh Châu Âu và phải cho biết sự đồng ý của người dùng cuối. Những yêu cầu như vậy phải 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ụ sau đâ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, giả định là người dùng bị ảnh hưởng không phải đến từ một tiểu bang ở Hoa Kỳ có các hạn chế về quyền riêng tư.

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

Bên đặt giá thầu có thể sử dụng quy trình So khớp cookie để điền sẵn bảng so khớp của riêng họ bằng cách chỉ cung cấp các tham số google_nid và google_cm trong thẻ so khớp. Ví dụ:

<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à thao tác so khớp cookie thành công, thì lệnh chuyển hướng mà Google gửi để phản hồi thẻ so khớp của bên đặt giá thầu có thể trông như sau:

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

Nếu thao tác 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 các tham số URL chuyển hướng.

Thêm vào danh sách người dùng riêng lẻ

Bạn có thể chỉ định thông số google_ula trong thẻ so khớp của đơn vị đặ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 đủ. Hãy xem các hạn chế khi gọi Dịch vụ so khớp cookie để biết thêm thông tin chi tiết. 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 một phản hồi thành công, trong đó 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 tổng thể (ví dụ: người dùng không có cookie của Google), 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ẻ 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 mức độ thành công của thao tác. 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 được 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 người dùng sẽ được thêm vào nhiều danh sách người dùng bằng cách thêm nhiều tham số google_ula vào thẻ so khớp. Trong thực tế, điều này có thể như sau:

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

Tương tự, trạng thái của thao tác đối với từng danh sách người dùng được báo cáo thông qua các thông 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ước đó, chúng ta có thể thấy rằng thao tác đã thành công đối với danh sách người dùng có mã nhận dạng 45678, nhưng không thành công đối với mã nhận dạng 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 danh sách đó.

Để thực hiện 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 đơn vị đặ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. Thông tin này có thể như sau:

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

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

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

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

Đối với một phản hồi thành công, trong đó 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ẻ khớp không bao gồm google_cm và google_hm không có trong các phản hồi thành công. Trong các yêu cầu giá thầu trong tương lai cho các lượt hiển thị của 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ữ của họ trong BidRequest.user.buyeruid.

Nếu giá thầu thay vào đó 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ể trông như sau:

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

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

Bảng khớp do Google lưu trữ và đơn vị đặt giá thầu có danh sách người dùng

Nếu một đơn vị đặt giá thầu lưu trữ danh sách người dùng của riêng mình ngoài danh sách người dùng do Google lưu trữ và muốn một thẻ so khớp duy nhất so khớp cả hai bảng và 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 đơn vị đó phải có các thông 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==, 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" />

Đối với một phản hồi thành công, trong đó 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ã người dùng Google được chỉ định trong google_gid với dữ liệu cookie trong bảng so khớp của họ. Ngoài ra, họ 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 hoạt động nhắm mục tiêu trước mà bên đặt giá thầu đã định cấu hình để nhắm đến 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.user.buyeruid.