Nhận thông báo về lượt hiển thị

Bạn có thể nhận được thông báo về lượt hiển thị bất cứ khi nào Google phát hiện thấy các phân khúc dữ liệu của bạn được dùng trong một giá thầu thắng trong phiên đấu giá Đặt giá thầu theo thời gian thực và dẫn đến một lượt hiển thị. Bạn nên tích hợp với thông báo về lượt hiển thị để tìm hiểu thêm về cách các phân khúc dữ liệu của bạn đang được sử dụng. Hãy liên hệ với người quản lý tài khoản để bật thông báo về lượt hiển thị.

Định cấu hình điểm cuối thông báo về lượt hiển thị

Bạn phải tạo một điểm cuối HTTP và chia sẻ URL của điểm cuối đó với Google để nhận thông báo về lượt hiển thị. Bạn có thể đặt URL mà thông báo về lượt hiển thị được gửi đến bằng một trong các lựa chọn sau:

  1. Đặt URL điểm cuối thông báo về lượt hiển thị cho từng chú thích Tuyển chọn theo thời gian thực.
    • Bạn có thể đặt động URL dùng cho thông báo về lượt hiển thị cho từng chú thích Tuyển chọn theo thời gian thực mà bạn nhận được bằng cách điền vào trường SegmentResponse.burl.
    • Đối với một chú thích Tuyển chọn theo thời gian thực nhất định, bạn phải đặt trường SegmentResponse.burl để nhận thông báo về lượt hiển thị cho chú thích đó. Nếu trường SegmentResponse.burl không được điền, thì sẽ không có thông báo nào được gửi cho chú thích đó, ngay cả khi trường SegmentResponse.burl đã được đặt trong các chú thích trước đó.
  2. Đặt URL điểm cuối thông báo về lượt hiển thị ở cấp tài khoản.
    • Bạn có thể đặt URL điểm cuối thông báo về lượt hiển thị ở cấp tài khoản cho tài khoản của mình bằng cách liên hệ với người quản lý tài khoản. Đây là lựa chọn lý tưởng nếu URL điểm cuối của bạn ít thay đổi.
    • Tất cả chú thích Tuyển chọn theo thời gian thực sẽ sử dụng URL thông báo về lượt hiển thị ở cấp tài khoản mà bạn định cấu hình cho tài khoản của mình, trừ phi bạn ghi đè URL ở cấp tài khoản bằng cách đặt trường SegmentResponse.burl cho một chú thích Tuyển chọn theo thời gian thực riêng lẻ.

Phân tích cú pháp thông báo về lượt hiển thị

Thông tin được gửi trong thông báo về lượt hiển thị phụ thuộc vào cấu hình của URL điểm cuối thông báo về lượt hiển thị. URL điểm cuối có thể bao gồm các tham số truy vấn và sử dụng macro để đưa thêm thông tin về bối cảnh liên quan đến cách các phân khúc dữ liệu của bạn được giá thầu thắng sử dụng, dẫn đến một lượt hiển thị.

Tìm hiểu cách macro được mở rộng

Nếu bạn định cấu hình URL điểm cuối để chứa một hoặc nhiều tham số truy vấn được đặt thành macro, thì thông báo về lượt hiển thị được gửi đến điểm cuối của bạn sẽ mở rộng các macro đó, thay thế macro bằng các giá trị tương ứng.

Ví dụ: bạn có thể định cấu hình URL điểm cuối thông báo về lượt hiển thị có dạng như sau:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Khi nhận được thông báo về lượt hiển thị, các macro sẽ được thay thế, khiến URL có dạng như sau:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Tìm hiểu về các macro được hỗ trợ

Sau đây là các macro mà bạn có thể đưa vào tham số truy vấn của URL điểm cuối thông báo về lượt hiển thị. Các macro này được thay thế bằng các giá trị liên quan đến giá thầu thắng mà một hoặc nhiều phân khúc dữ liệu của bạn đã đóng góp.

Macro Mô tả
${SR_ID} Mã nhận dạng chuỗi duy nhất tương đương với trường SegmentRequest.segment_request_id cho chú thích Tuyển chọn theo thời gian thực tương ứng. Đây là yêu cầu phân khúc mà bạn đã phản hồi bằng một hoặc nhiều mã phân khúc dữ liệu đã đóng góp vào giá thầu thắng.
${SEGMENT_IDS} Danh sách mã phân khúc dữ liệu chuỗi đã đóng góp vào giá thầu thắng. Mỗi mục trong danh sách được phân tách bằng ký tự "|". Ví dụ: danh sách này có thể được mở rộng thành một danh sách các giá trị như: "segmentId1|segmentId2|segmentId3" Mỗi mã phân khúc dữ liệu điền vào danh sách này đều đề cập đến mã tài nguyên của tài nguyên curators.dataSegments tương ứng trong Marketplace API.
${AUCTION_PRICE} Một chuỗi đại diện cho giá thắng của phiên đấu giá. Giá này là chi phí của một lượt hiển thị (CPI) được biểu thị bằng đơn vị một phần triệu USD. Ví dụ: giá thầu Đặt giá thầu theo thời gian thực là 5 USD CPM sẽ dẫn đến việc macro ${AUCTION_PRICE} mở rộng thành 5000 CPI đơn vị một phần triệu USD trong thông báo về lượt hiển thị Tuyển chọn theo thời gian thực.
${DEAL_ID} Mã của giao dịch hoặc gói đã thắng phiên đấu giá. Đây là giao dịch hoặc gói nhắm mục tiêu đến một hoặc nhiều mã phân khúc dữ liệu của bạn, có thể được xác định bằng macro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} Mã của tài khoản con bên mua đã giành được lượt hiển thị, theo chỉ định của bên đặt giá thầu trong giá thầu thắng. Ví dụ: tài khoản con bên mua có thể là đại lý hoặc nhà quảng cáo.

Các bước tiếp theo