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 — cho ví dụ: ID cho người dùng đã duyệt trang web của bạn—với ID tương ứng Mã nhận dạng người dùng Google dành riêng cho bên đặt giá thầu và tạo danh sách người dùng có thể giúp bạn thực hiện cách đặt giá thầu hiệu quả hơn. Hướng dẫn này mô tả các khái niệm được sử dụng trong Cookie So khớp cũng như các quy trình So khớp cookie khác nhau và mọi biến thể 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 của cookie cho những người dùng duyệt trang web của họ, được sử dụng để xác định người dùng trong miền đó. Ngay cả khi hai chủ sở hữu miền sẽ đồng ý trao đổi dữ liệu này, mô hình bảo mật trình duyệt internet hạn chế một trình duyệt đọc cookie do một trình duyệt khác đặt miền.

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à các bên đặt giá thầu tham gia Đặt giá thầu thời gian thực có thể có miền riêng của mình 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. So khớp cookie cho phép bên đặt giá thầu khớp cookie của họ với cookie của Google để họ có thể xác định xem 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 người dùng được nhắm mục tiêu, họ sẽ nhận được dữ liệu cookie riêng của mình hoặc Mã nhận dạng người dùng Google của riêng bên đặt giá thầu, là dạng đã mã hoá của doubleclick.net cookie 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, đồng thời cho phép điền sẵ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ừ một miền đến khác. Bên đặt giá thầu có thể sử dụng Dịch vụ so khớp cookie để tự điền thông tin so khớp các bảng bằng cách liên kết cookie của họ dành cho một người dùng nhất định với cookie của người dùng đó Mã nhận dạng người dùng hoặc để điền vào một bảng so khớp do Google lưu trữ. Bảng so khớp đang cần thiết để ứng dụng của bên đặt giá thầu của bên đặt giá thầu truy cập vào dữ liệu cookie cho người dùng được 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. Thao tác này cho phép bạn chỉ định một chuỗi được mã hoá base64 an toàn cho web — được gọi là dữ liệu so khớp được lưu trữ—sẽ được ánh xạ đến Mã nhận dạng người dùng Google cho một người dùng cụ thể. Sau khi thiết lập một kết quả trùng khớp, được sử dụng 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 lượt hiển thị được liên kết với người dùng đó, thì Google sẽ gửi cho bạn dữ liệu so khớp được lưu trữ mà bạn khớp với ID người dùng Google của họ. Nếu bạn đã thiết lập giới hạn đặt giá thầu để sử dụng giao thức RTB của Google, bạn sẽ nhận được mã này dưới dạng byte được giải mã thông qua trường BidRequest.hosted_match_data. Trong OpenRTB của Google khi triển khai, BidRequest.user.buyeruid sẽ trả về giá trị 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: Có thể điền danh sách người dùng với 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 tiêu chí nhắm mục tiêu trước để chỉ nhận yêu cầu giá thầu có chứa dữ liệu so khớp được lưu trữ. Bạn có thể dùng công cụ này để loại bỏ những thông tin không 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 xong, bạn có thể điền sẵn các danh sách này bằng quy trình So khớp cookie được mô tả bên dưới hoặc thông qua Dịch vụ Người tải lên hàng loạt.

Bắt đầu

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

  • Mã mạng so khớp cookie (NID): Mã chuỗi được xác định riêng biệt tài khoản bên đặt giá thầu cho tính năng So khớp cookie và các hoạt động khác có liên quan.
  • 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 đến trong quy trình So khớp cookie. Bên đặt giá thầu có thể nhúng macro trong URL này để kiểm soát thứ tự của các tham số được truyền đến trong quy trình So khớp cookie.
  • Thẻ so khớp: Thẻ mà bạn phải đặt vào 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. Loại quảng cáo này có thể được phân phát cùng với quảng cáo. hoặc được đặt trên 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): Theo một chiều Quy trình so khớp cookie, đây là URL không bắt buộc có thể được cung cấp cho chỉ định điểm cuối sẽ nhận thông tin chi tiết về lỗi trong trường hợp cookie đó so khớp không thành công thông qua lệnh chuyển hướng HTTP 302. Theo mặc định, câu trả lời sẽ chỉ gửi tới URL này nếu có lỗi 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 các sàn giao dịch triển khai quy trình của Trợ lý 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 được gửi đến.
  • Hạn mức hỗ trợ so khớp cookie: Đối với các sàn giao dịch triển khai quy trình của Trợ lý 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 ngăn các yêu cầu CMA làm quá tải máy chủ của Exchange với yêu cầu.

Trong bất kỳ quy trình công việc 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 trong phần tử thứ tự không bảo đảm. Bên đặt giá thầu có tính năng tích hợp yêu cầu tính nhất quán thứ tự của các thông số có thể đặt macro trong URL So khớp cookie của chúng để đảm bảo vị trí của họ.

Macro được hỗ trợ

Bên đặt giá thầu có thể định cấu hình URL So khớp cookie (không bắt buộc) để bao gồm một hoặc thêm macro ở dạng %%GOOGLE_<PARAM_NAME>%% hoặc %%GOOGLE_<PARAM_NAME>_PAIR%% Các macro được hỗ trợ và giá trị mở rộng là:

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

Ví dụ về macro

Bên đặt giá thầu có 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, kèm theo đó là việc triển khai tính năng này cần có các thông số do bên đặt giá thầu xác định đặt trước ngoài tính năng So khớp pixel các thông số theo thứ tự sau: google_push, google_gid, google_cvergoogle_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 để:

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 bên đặt giá thầu này, yêu cầu đó sẽ được mở rộng thành một nội dung tương tự 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ợ ba quy trình làm việc cho các trường hợp sử dụng khác nhau được mô tả dưới đây.

Tính năng So khớp cookie hai chiều đề cập đến quy trình làm việc do bên đặt giá thầu khởi tạo, trong đó họ sẽ đặt một thẻ so khớp trong trình duyệt của người dùng để chuyển hướng thẻ đó đến Google. Chiến dịch này quy trình công việc cho phép cả Google và bên đặt giá thầu điền 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: Đặ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 của họ như hiển thị trong trình duyệt của người dùng. 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 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ể đưa các thông số bổ sung vào thẻ so khớp để đáp ứng các trường hợp sử dụng khác nhau. Để tìm hiểu thêm về các thông số này, hãy xem So khớp các tham số URL của thẻ.

Bước 2: Google sẽ phản hồi bằng lệnh chuyển hướng, trong đó có dữ liệu trùng khớp

Thẻ so khớp sẽ khiến cho Dịch vụ so khớp cookie của Google nhận được từ trình duyệt của người dùng, việc này sẽ tạo ra một HTTP 302 chuyển hướng đến URL so khớp cookie của bên đặt giá thầu. Chuyển hướng sẽ bao gồm truy vấn các tham số chỉ định Mã nhận dạng người dùng Google và số phiên bản của mã đó trong URL, và bên đặt giá thầu cũng sẽ nhận được cookie có trong tiêu đề của yêu cầu. Trong đố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 đơn giản như đã thấy ở trên có thể có dạng như sau: 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 thông số google_gid là một tệp được mã hoá base64 an toàn trên web không được đệm . Đố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ữ chuỗi chính xác do Dịch vụ so khớp cookie trả về. Trong số yêu cầu giá thầu, thì 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 giao thức Triển khai OpenRTB.

Phiên bản được chỉ định trong google_cver cho biết giá trị số số phiên bản của ID người dùng Google. Mã nhận dạng người dùng Google cho một người dùng cụ thể sẽ không thường xuyên thay đổi, sau đó giá trị này sẽ được 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, Tham số google_error sẽ được chỉ định thay thế.

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

Bên đặt giá thầu nhận được 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 ở bước đầu tiên và những thông số mà Google đã cung cấp trong bước thứ hai. Ngoài ra, họ cũng sẽ nhận được cookie trong HTTP . Nếu thao tác thành công, bên đặt giá thầu sẽ 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 Google có trong phản hồi. Đó là nên đặt giá thầu nên lưu trữ chuỗi chính xác mà tính năng So khớp cookie trả về Dịch vụ.

Nếu thao tác không thành công, bên đặt giá thầu sẽ nhận được 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 xác định lỗi cụ thể đã xảy ra. Bạn có thể tìm hiểu 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ể thử so khớp lại cho người dùng đó bằng cách hãy đặ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 hình ảnh pixel vô hình 1x1 hoặc hoặc trả về phản hồi HTTP 204 No Content (Không có nội dung).

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

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

Thông số Mô tả
google_nid Mã mạng (NID) cho tài khoản bên đặt giá thầu. Có thể truy xuất mã nhận dạng này thông qua Bên đặt giá thầu nguồn.
google_cm Cho Dịch vụ so khớp cookie của Google biết rằng dịch vụ sẽ hoạt động so khớp cookie. Giá trị của thông số này bị bỏ qua và có thể bị bỏ qua đã bỏ qua.
google_sc Tham số này không còn được dùng nữa. Đặt cookie của Google cho người dùng nếu không có mã số. Giá trị của thông số này bị bỏ qua và có thể bị bỏ qua. Việc bỏ qua thông số này sẽ dẫn đến lỗi nếu không có cookie đã tồn tại.
google_no_sc Tham số này không còn được dùng nữa. Điều này cho biết Dịch vụ so khớp cookie không được đặt cookie cho người dùng nếu không có giá trị nào. Giá trị của thông số này bị bỏ qua và có thể bị bỏ qua đã 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ị là một chuỗi được mã hoá base64 an toàn trên web (không bắt buộc khoảng đệm). Dữ liệu thô phải là 40 byte trở xuống. Ví dụ: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Chuỗi được mã hóa URL mà bên đặt giá thầu có thể chỉ định nếu họ muốn chuyển hướng Google để gửi lệnh chuyển hướng HTTP 302 đến URL được mã hoá cho thẻ so khớp này. Việc này cho phép Google đặt Google ở vị trí đầu tiên trong chuỗi cuộc gọi cho đối tác. Điều này sẽ dẫn đến lỗi nếu được chỉ định mà không có google_hm hoặc bằng google_cm.
google_ula Chuỗi được dùng để thêm người dùng vào danh sách người dùng hiện có. Giá trị định dạng đúng là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • 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 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 phải tuân theo các quy định hạn chế của GDPR về dữ liệu mức sử dụng. Để biết thêm chi tiết, hãy xem Các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu dưới đây hoặc Tác động đối với việc so khớp cookie đủ điều kiện trong Tài liệu TCF phiên bản 2.0 của IAB cho Authorized Buyers.

Ví dụ: gdpr=1

gdpr_consent Chuỗi về sự minh bạch và sự đồng ý thể hiện sự đồng ý của người dùng cuối. Để biết thêm chi tiết, 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 TCF phiên bản 2.0 của IAB cho 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 cho việc 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ác thông số đồng ý khác trong yêu cầu không (gdpr_consent), thì tham 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 các thông số riêng của họ, sẽ được thêm vào dưới dạng thông số vào URL chuyển hướng. Lưu ý rằng bên đặt giá thầu do bên đặt giá thầu xác định các thông số được đặt tên bằng tiền tố google_ sẽ bị bỏ qua vì những thông tin đó được Google dành riêng cho việc phát triển trong tương lai và duy trì thông số' không đảm bảo việc đặt hàng. Thẻ so khớp bao gồm cả do bên đặt giá thầu xác định các thông số 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 cơ sở So khớp cookie đã đị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 những giá trị được chỉ định trong thẻ so khớp. google_ sau đây các thông số phản hồi đượ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

Giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Thời gian nhận được, nó cho biết rằng không có hoạt động nào được thực hiện và không có google_ thông số phản hồi sẽ được đặt. Lỗi được hỗ trợ bao gồm các giá trị sau:

  • 1: Người dùng có cookie của Google nhưng đã chọn không tham gia theo dõi bằng cookie này.
  • 2: Chưa chỉ định hoạt động hợp lệ nào. ví dụ: không hoạt động đã nhận được yêu cầu.
  • 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 hoạt động xung đột được chỉ định. Bạn không được phép chỉ định cả google_pushgoogle_cm cờ cho cùng một yêu cầu vì chúng có mục đích xung đột.
  • 5: Tham số google_push không hợp lệ là được truyền trong lệnh chuyển hướng đến máy chủ của Google theo quy trình hai chiều Yêu cầu So khớp pixel. Lệnh chuyển hướng của bạn phải đặt google_push thành cùng giá trị được chuyển cho bạn trong yêu cầu pixel ban đầu.
  • 6: Mã NID không hợp lệ đã được cung cấp trong thẻ so khớp.
  • 7: Đã phát hiện thấy cookie không hợp lệ.
  • 8: Không dùng nữa. Không tìm thấy cookie.
  • 9: Không tìm thấy cookie nào, hệ thống đã cố gắng đặt một cookie thử nghiệm.
  • 10: Tham số google_redir đã được sử dụng không có google_hm được chỉ định hoặc đã được dùng kèm theo đến google_cm.
  • 15: Yêu cầu đến từ một khu vực nơi Google yêu cầu Google lưu trữ bảng so khớp. Do đó, phản hồi không chứa Mã nhận dạng người dùng Google. Tính năng này hiện được bật cho chỉ một tỷ lệ nhỏ lưu lượng truy cập, nhưng được lên kế hoạch để được kích hoạt hoàn toàn trong Tháng 6 năm 2020.
google_hm

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

  • 1 - Bị cấm: Khách hàng chưa được liệt kê trong danh sách cho phép ghi mục nhập bảng so khớp được lưu trữ.
  • 2 – Lỗi giải mã: Không thể nhập giá trị thông số đã giải mã.
  • 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 – Bị điều tiết: Hoạt động ghi này không được xử lý do đ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 có nhiều google_ula đã được chỉ định 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 – ID danh sách người dùng không hợp lệ. ID danh sách người dùng đã 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 phải lỗi nội bộ; bạn có thể thử khớp lại người dùng.

Các trường hợp sau mô tả cách so khớp cookie cho một người dùng thông thường khi họ duyệt xem một trang web.

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

Jane xoá tất cả cookie trong bộ nhớ đệm. 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 giá thầu các yêu cầu đến FinestDSP và những người đặ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 nhận và xử lý yêu cầu giá thầu, và gửi giá thầu phản hồi.
  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 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 của FinestDSP và so khớp thẻ với Jane.
  6. Thẻ so khớp gọi Dịch vụ so khớp cookie của Google, chỉ định Tham số google_nidgoogle_cm.
  7. Cookie Match Service đọc cookie của Google của Jane và gửi cookie của Jane trình duyệt chuyển hướng đến URL so khớp cookie của FinestDSP với Đã đặt tham số google_user_idgoogle_cver.
  8. Trình duyệt của Jane tải lệnh chuyển hướng đến URL Match Cookie Match 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 thông số URL do Google đặt và cookie của họ cho Jane trong Tiêu đề HTTP. FinestDSP hiện có thể lưu trữ tệp ánh xạ cookie của họ đến google_user_id trong bảng so khớp của họ.
  10. FinestDSP phản hồi lệnh chuyển hướng bằng pixel 1x1 vô hình.
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 ExampleNews.com. Bây giờ khi Jane có cả cookie của bên đặt giá thầu và Ad Manager trên máy của họ, sau đây là cách so khớp hoạt động.

  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 đến các bên đặ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 tín hiệu như google_user_id.
  4. FinestDSP tra cứu google_user_id trong bảng so khớp của nó, và tìm 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 quan đến cookie, chiến lược đặt giá thầu của FinestDSP logic đặt giá thầu cho hiển thị và thắng 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 họ, dựa trên thông tin mà FinestDSP sở hữu.

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 thay đổi để chỉ Google lưu trữ và điền kết quả trùng khớp bảng. Có thể dùng thuộc tính 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 của Google trong bảng so khớp riêng. Để 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 thể chỉ định google_cm trong các yêu cầu tới Dịch vụ so khớp cookie của Google và do đó, sẽ không nhận được google_gid để điền bảng so khớp. Sau khi Google thiết lập chế độ so khớp cho người dùng, bên đặt giá thầu có thể thêm chú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ự, 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 cả dữ liệu so khớp được lưu trữ. Đáp ví dụ đơn giản về quy trình làm việc đã sửa đổi được tóm tắt trong các bước dưới đây.

Để 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 nó 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 dành cho người dùng không ở tiểu bang của Hoa Kỳ có các 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 Cookie của bạn URL trùng khớp. Ví dụ: với một URL So khớp cookie được định cấu hình là https://ad.network.com/pixel, mã 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 của người dùng sẽ yêu cầu một pixel từ URL so khớp cookie. Yêu cầu này sẽ chứa cookie trong tiêu đề HTTP, cần đượ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 Cookie của Google Dịch vụ trùng khớp, 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ể trông giố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 những tham số mà bạn đã chỉ định, trong vào 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 lỗi nếu URL báo cáo được chỉ định

Nếu hoạt động so khớp cookie thành công hoặc không có Cookie URL báo cáo so khớp đã được chỉ định cho tài khoản của người đặt giá thầu—Google sẽ phân phát pixel trong suốt 1x1 theo mặc định và quy trình làm việc sẽ kết thúc tại đây. 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 lượt hiển thị của bên đặt giá thầu dữ liệu so khớp được lưu trữ trong BidRequest.hosted_match_data cho cụm từ tìm kiếm của Google Giao thức, hoặc BidRequest.user.buyeruid cho OpenRTB của Google trong quá trình triển khai. 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 một lệnh chuyển hướng đến URL báo cáo so khớp cookie với nguyên nhân gây ra lỗi được chỉ định 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ư:

<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 Tham số google_error. Để tìm hiểu thêm về cách diễn giải lỗi hãy xem 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 1x1 trong suốt cho trình duyệt.

Quy trình làm việc mặc định cho người dùng ở các tiểu bang tại Hoa Kỳ có hạn chế về quyền riêng tư được minh hoạ bằng biểu đồ bên dưới, nơi các yêu cầu và phản hồi được biểu thị bằng một mũi tên và dữ liệu các mục đ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 bên đặt giá thầu. Có thể truy xuất mã nhận dạng này thông qua Bên đặt giá thầu nguồn.
google_sc Tham số này không còn được dùng nữa. Đặt cookie của Google cho người dùng nếu không có mã số. Giá trị của thông số này bị bỏ qua và có thể bị bỏ qua. Việc bỏ qua thông số này sẽ dẫn đến lỗi nếu không có cookie đã tồn tại.
google_no_sc Tham số này không còn được dùng nữa. Điều này cho biết Dịch vụ so khớp cookie không được đặt cookie cho người dùng nếu không có giá trị nào. Giá trị của thông số này bị bỏ qua và có thể bị bỏ qua đã bỏ qua.
google_hm

Chứa dữ liệu mà bên đặt giá thầu muốn lưu trữ trong một kết quả trùng khớp do Google lưu trữ bảng.

google_redir URL đã mã hoá mà bạn muốn Google gửi lệnh chuyển hướng HTTP 302. Chiến lược phát hành đĩa đơn URL đã chỉ định sẽ nhận được lệnh chuyển hướng có google_error tham số cho cả lỗi và thao tác thành công.
google_ula Chuỗi được dùng để thêm người dùng vào danh sách người dùng hiện có. Giá trị định dạng đúng là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • 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 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 phải tuân theo các quy định hạn chế của GDPR về dữ liệu mức sử dụng. Để biết thêm chi tiết, hãy xem Các yêu cầu về sự đồng ý của người dùng ở Liên minh Châu Âu dưới đây hoặc Tác động đối với việc so khớp cookie đủ điều kiện trong Tài liệu TCF phiên bản 2.0 của IAB cho Authorized Buyers.

Ví dụ: gdpr=1

gdpr_consent Chuỗi về sự minh bạch và sự đồng ý thể hiện sự đồng ý của người dùng cuối. Để biết thêm chi tiết, 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 TCF phiên bản 2.0 của IAB cho 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 cho việc 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ác thông số đồng ý khác trong yêu cầu không (gdpr_consent), thì tham số này sẽ bị bỏ qua.

Ví dụ: process_consent=T

Thông số Mô tả
google_error

Giá trị số nguyên cho biết lỗi yêu cầu tổng thể. Thời gian nhận được, nó cho biết rằng không có hoạt động nào được thực hiện và không có google_ thông số phản hồi sẽ được đặt. Lỗi được hỗ trợ bao gồm các giá trị sau:

  • 1: Người dùng có cookie của Google nhưng đã chọn không tham gia theo dõi bằng cookie này.
  • 2: Chưa chỉ định hoạt động hợp lệ nào. ví dụ: không hoạt động đã nhận được yêu cầu.
  • 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 hoạt động xung đột được chỉ định. Bạn không được phép chỉ định cả google_pushgoogle_cm cờ cho cùng một yêu cầu vì chúng có mục đích xung đột.
  • 5: Tham số google_push không hợp lệ là được truyền trong lệnh chuyển hướng đến máy chủ của Google theo quy trình hai chiều Yêu cầu So khớp pixel. Lệnh chuyển hướng của bạn phải đặt google_push thành cùng giá trị được chuyển cho bạn trong yêu cầu pixel ban đầu.
  • 6: Mã NID không hợp lệ đã được cung cấp trong thẻ so khớp.
  • 7: Đã phát hiện thấy cookie không hợp lệ.
  • 8: Không dùng nữa. Không tìm thấy cookie.
  • 9: Không tìm thấy cookie nào, hệ thống đã cố gắng đặt một cookie thử nghiệm.
  • 10: Tham số google_redir đã được sử dụng không có google_hm được chỉ định hoặc đã được dùng kèm theo đến google_cm.
  • 15: Yêu cầu đến từ một khu vực nơi Google yêu cầu Google lưu trữ bảng so khớp. Do đó, phản hồi không chứa Mã nhận dạng người dùng Google. Tính năng này hiện được bật cho chỉ một tỷ lệ nhỏ lưu lượng truy cập, nhưng được lên kế hoạch để được kích hoạt hoàn toàn trong 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 cho tính năng So khớp cookie của Google Dịch vụ trong đó Google cố gắng khớp Mã nhận dạng người dùng Google với bên đặt giá thầu được chọn khác với bên 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 thì 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 khỏi URL so khớp cookie của bên đặt giá thầu được chọn. Thao tác này sẽ cho phép cả Google và bên đặt giá thầu để điền vào bảng so khớp với một người dùng nhất định. Bên dưới 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à vùng quảng cáo trên trang đó do Google lấp đầy, nên bạn có thể đặt thẻ so khớp yêu cầu một pixel từ bên đặt giá thầu được chọn bằng thuật toán. Pixel Matching thẻ 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 của họ. Đối với URL so khớp cookie được chỉ định là https://ad.network.com/pixel, thì mã 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" />

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

Lưu ý rằng URL chuyển hướng ở trên tương tự với URL của URL được sử dụng trong 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ố tham số google_push và giá trị của tham số này phải bằng giá trị do Google cung cấp trong yêu cầu. Cũng tương tự như do bên đặt giá thầu đưa ra quy trình công việc, các thông số bổ sung có thể được chỉ định để đáp ứng các trường hợp sử dụng khác.

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

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

Sơ đồ quy trình làm việc của tính năng Pixel Matching

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

Các thông 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 ở một tiểu bang của Hoa Kỳ có các hạn chế về quyền riêng tư, lựa chọn này sẽ luôn là được chỉ định trong thẻ so khớp của Google.
google_cver Phiên bản cookie. Điều này sẽ luôn được chỉ định trong kết quả phù hợp của Google .
google_push Cho biết rằng yêu cầu này đang bắt đầu 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.

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

Thông số Mô tả
google_nid Mã mạng (NID) cho tài khoản bên đặt giá thầu. Có thể truy xuất mã nhận dạng này thông qua Bên đặt giá thầu nguồn.
google_push Cho biết rằng lệnh chuyển hướng này đang hoàn thành quá trình So khớp pixel quy trình làm việc. Giá trị từ thẻ so khớp tương ứng của Google phải là xác định tại đây.
google_hm

Chứa dữ liệu mà bên đặt giá thầu muốn lưu trữ trong một kết quả trùng khớp do Google lưu trữ bảng.

google_ula Chuỗi được dùng để thêm người dùng vào danh sách người dùng hiện có. Giá trị định dạng đúng là userlistid[,timestamp]:
  • userlistid: một mã danh sách người dùng dạng số.
  • 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 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

So khớp pixel một chiều khác với quy trình làm việc Hai chiều trong thẻ so khớp của Google không bao gồm thông số chỉ định Người dùng Google Mã nhận dạng, nhưng sẽ tiếp tục điền vào bảng so khớp do Google lưu trữ. Bạn có thể dùng công cụ 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 riêng. Một ví dụ đơn giản về quy trình sửa đổi được tóm tắt trong các bước dưới đây.

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

Google đặt một thẻ so khớp cho bên đặt giá thầu được chọn bằng thuật toán. Thẻ so 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 Cooking Matching của bên đặ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 Cookie của Google Dịch vụ trùng khớp, 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ể trông giố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 những tham số mà bạn đã chỉ định, trong vào 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 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 Google hoặc BidRequest.user.buyeruid cho Triển khai OpenRTB. 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 khớp với dữ liệu 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 sàn giao dịch sử dụng bên đặt giá thầu đã khởi tạoGoogle đã bắt đầu quy trình so khớp cookie để so khớp Mã nhận dạng người dùng Google với cookie của họ. Bánh quy Hỗ trợ so khớp (CMA) là một tính năng bổ sung dành cho các sàn giao dịch, giúp họ tạo bảng so khớp với bên đặt giá thầu riêng.

  1. Khi đặt quảng cáo, Google sử dụng thuật toán để chọn Exchange và đặt thẻ Hỗ trợ so khớp cookie có các đặc điểm sau: cấu trúc:

    <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 sẽ nhận được yêu cầu pixel.

  3. Điểm cuối So khớp cookie của đối tác trao đổi sẽ nhận được yêu cầu, trong đó dịch vụ so khớp cookie của riêng mình 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 của mình. Trong biểu đồ dưới đây, quy trình so khớp cookie của sàn giao dịch dịch vụ phản hồi trình duyệt của người dùng bằng chuyển hướng đến một trong những bên đặt giá thầu điểm cuối.
  4. Bên đặt giá thầu nhận được yêu cầu, cùng với bất kỳ thông số nào được chỉ định bởi trao đổi để 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 kết quả khớp mới

Bên đặt giá thầu có trách nhiệm giới hạn số lệnh gọi đối với Cookie Dịch vụ so khớp dành cho người dùng có mục nhập mới trong trận đấu do Google lưu trữ bảng. 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ã.

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

Những bên đặt giá thầu sử dụng quy trình So khớp pixel cần phải phản hồi tất cả các yêu cầu Pixel Match gửi đến kèm theo một phản hồi, trong đó có google_push . Việc này giú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 một tỷ lệ phản hồi của bên đặt giá thầu giảm xuống dưới 90%, Google sẽ điều tiết số lượng Đã gửi yêu cầu Pixel Match đến tài khoản của họ.

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

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

Khi phản hồi một yêu cầu Pixel Match gửi cho bạn qua HTTPS, bạn để chuyển hướng đến Dịch vụ so khớp cookie qua HTTPS. Tương tự, điểm cuối Hỗ trợ so khớp cookie chuyển hướng đến người đặ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 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.

Các yêu cầu So khớp cookie phải tuân theo Người dùng Liên minh Châu Âu của Google Chính sách về sự đồng ý phải thể hiện 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 đã thu thập sự đồng ý bằng một trong những cách sau:

Ví dụ

Các ví dụ bên dưới 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 rằng người dùng đang được thực hiện không phải từ Tiểu bang tại Hoa Kỳ có các quy định hạn chế về quyền riêng tư.

Điền bảng so khớp do người đặ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 thông tin so khớp của riêng họ bảng bằng cách chỉ cung cấp google_nidgoogle_cm trong thẻ so khớp của chúng. 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, lệnh chuyển hướng mà Google sẽ gửi nội dung phản hồi cho thẻ so khớp của người đặt giá thầu có thể trông giố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 do người dùng không có cookie của Google, 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 để biết thêm thông tin về các mã lỗi có thể xảy ra cho quy trình So khớp cookie, hãy xem tham số URL chuyển hướng.

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

Bạn có thể chỉ định thông số google_ula trong kết quả 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 với ID đã cho. Nếu Google hoặc bảng so khớp do bên đặt giá thầu lưu trữ có mục nhập mới cho người dùng, bên đặt giá thầu có thể đặt một thẻ so khớp bao gồm google_nidgoogle_ula các tham số để thêm người dùng vào danh sách được chỉ định mà không cần bắt đầu điền đầy đủ Quy trình So khớp cookie. Xem quy định hạn chế khi gọi Dịch vụ so khớp cookie để có thêm trường hợp gián đoạn. Thuộc tính tương ứng thẻ so khớp có thể có dạng như sau:

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

Để có 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 xảy ra lỗi tổng thể (ví dụ: không có cookie của Google) cho người dùng— 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 quá trình chuyển hướng. Không giống như thông số thẻ so khớp tương ứng, điều này sẽ thay thế dấu thời gian bằng một trạng thái để cho biết thành công của thao tác. Ví dụ: nếu yêu cầu không thành công bởi 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, 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 một người dùng vào nhiều danh sách người dùng bằng cách bao gồm nhiều thông số google_ula trong thẻ so khớp. Trong thực tế, ví dụ này có thể hiển thị 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 đối với từng danh sách người dùng được báo cáo tương tự 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 rằng thao tác đã thành công đối với người dùng danh sách có mã 45678, nhưng không thành công đối với danh sách người dùng có mã 12345 bởi vì bên đặt giá thầu không có quyền truy cập vào báo cáo đó.

Để thực hiện quá trình so khớp cookie và thêm người dùng vào danh sách người dùng trong một thì thẻ so khớp của bên đặt giá thầu phải bao gồm google_cmgoogle_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_cvergoogle_ula. URL này có thể giống như sau:

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

Lưu trữ video trùng khớp 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 của họ trong bảng so khớp do Google lưu trữ, và không có ý định lưu trữ kết quả trùng khớp với User ID Google trong kết quả trùng khớp của riêng họ thì thẻ so khớp của các thẻ này phải bao gồm thông số google_hm, trong đó giá trị của giá trị này 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!, mã này được mã hoá sẽ là Q29va2llIG51bWJlciAxIQ==. Giá trị này sẽ được dùng trong một khớp thẻ như sau:

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

Để có 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_cmgoogle_hm là không được đưa vào phản hồi thành công. Yêu cầu giá thầu cho lượt hiển thị trong tương lai 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ữ của họ trong BidRequest.hosted_match_data cho giao thức RTB của Google hoặc BidRequest.user.buyeruid để triển khai OpenRTB của Google.

Nếu bên đặt giá thầu sử dụng một thẻ so khớp thay vào đó, trong đó giá trị của google_hm không được mã hoá base64, chẳng hạn như chocolate_chunk!—URL chuyển hướng có thể trông giố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 của 2, đề xuất rằng thao tác không thành công vì giá trị có thể không thể giải mã.

Bảng so khớp do Google lưu trữ và bên đặt giá thầu có 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 người dùng do Google lưu trữ và muốn có một thẻ so khớp khớp với cả hai bảng và thêm người dùng vào một danh sách người dùng cụ thể, thì thẻ so khớp của họ phải bao gồm google_cm, Tham số google_hmgoogle_ula. Nếu bên đặt giá thầu dữ liệu cookie là Cookie number 1!, thì giá trị được mã hoá sẽ là Q29va2llIG51bWJlciAxIQ== sẽ 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" />

Để có 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ẽ 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ể khớp với Mã nhận dạng người dùng Google đã chỉ định trong google_gid với dữ liệu cookie trong bảng so khớp. Trong Ngoài ra, chúng có thể xác định rằng bảng so khớp và danh sách người dùng do Google lưu trữ đã thực hiện thành công thao tác. Do đó, bất kỳ tiêu chí nhắm mục tiêu trước nào bên đặt giá thầu được định cấu hình để nhắm mục tiêu ID danh sách người dùng được chỉ định giờ đây sẽ khiến bên đặt giá thầu nhận 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 giá thầu này thì 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.hosted_match_data cho giao thức RTB của Google hoặc BidRequest.user.buyeruid để triển khai OpenRTB của Google.