Phân tích cú pháp SegmentRequest

Trong tính năng Sắp xếp theo thời gian thực, Google sẽ gửi một JSON SegmentRequest đến điểm cuối sắp xếp của bạn để cung cấp các tín hiệu mô tả một hoặc nhiều lượt hiển thị, cho phép bạn xác định các phân khúc dữ liệu áp dụng cho từng lượt hiển thị. Hướng dẫn này trình bày cách phát triển logic tuyển chọn để xử lý SegmentRequest.

Sử dụng phương thức mã hoá gzip

Google sử dụng phương thức mã hoá gzip khi gửi SegmentRequest đến điểm cuối của bạn. Điểm cuối của bạn phải có khả năng nhận và phản hồi bằng phương thức mã hoá gzip.

Tuyển chọn bằng các điểm cuối tín hiệu theo bối cảnh hoặc tín hiệu an toàn

Khi tạo một điểm cuối Sắp xếp theo thời gian thực, bạn phải chọn nhận tín hiệu theo bối cảnh hoặc tín hiệu an toàn. Những tín hiệu bạn chọn sẽ ảnh hưởng đến cách điền các yêu cầu về phân đoạn được gửi đến điểm cuối của bạn, số lượng khoảng không quảng cáo tạo ra các yêu cầu về phân đoạn được gửi đến điểm cuối của bạn và logic tuyển chọn được dùng trong quá trình tích hợp.

Sử dụng tín hiệu bối cảnh

Tín hiệu theo bối cảnh bao gồm thông tin về nhà xuất bản, thiết bị và người dùng mô tả nguồn gốc của lượt hiển thị. Danh sách sau đây mô tả các tín hiệu có sẵn:

  • SegmentRequest.site: Mô tả trang web hiển thị lượt hiển thị, chẳng hạn như URL của trang web. Chỉ một trong số SegmentRequest.site và SegmentRequest.app có thể được điền trong SegmentRequest.
  • SegmentRequest.app: Mô tả ứng dụng hiển thị lượt hiển thị, chẳng hạn như giá trị nhận dạng ứng dụng dành riêng cho nền tảng của ứng dụng. Chỉ một trong số SegmentRequest.site và SegmentRequest.app có thể được điền vào SegmentRequest.
  • SegmentRequest.pub: Mô tả nhà xuất bản của phương tiện hiển thị lượt hiển thị; ví dụ: mã nhận dạng của nhà xuất bản.
  • SegmentRequest.user: Mô tả lựa chọn của người dùng về cách xử lý dữ liệu cá nhân của họ; ví dụ: bằng chuỗi đồng ý TCF.
  • SegmentRequest.device: Mô tả thông tin về thiết bị, chẳng hạn như vị trí địa lý của thiết bị ở độ chính xác cấp thành phố.

Bạn có thể sử dụng tín hiệu theo bối cảnh để triển khai logic tuyển chọn có thể xác định các phân đoạn dữ liệu áp dụng để trả về trong SegmentResponse.

Sử dụng tín hiệu an toàn

Tín hiệu an toàn là dữ liệu do nhà xuất bản tạo ra và họ đã chọn chia sẻ dữ liệu đó với một hoặc nhiều đối tác. Các giá trị này sẽ được làm rối mã nguồn trước khi được chia sẻ với Google trong yêu cầu quảng cáo và trong tính năng Sắp xếp theo thời gian thực, các giá trị này sẽ xuất hiện ở dạng làm rối mã nguồn trong SegmentRequest.user.eids.uids.id.

Nếu được định cấu hình để sử dụng tín hiệu an toàn, thì điểm cuối của bạn sẽ chỉ nhận được các yêu cầu phân khúc cho khoảng không quảng cáo của những nhà xuất bản đã chọn chia sẻ tín hiệu an toàn với tài khoản tuyển chọn của bạn. Do đó, tổng số lượt hiển thị đủ điều kiện được gửi đến các điểm cuối tín hiệu an toàn sẽ ít hơn so với các điểm cuối tín hiệu theo bối cảnh.

Logic tuyển chọn của điểm cuối phải diễn giải tín hiệu an toàn và sử dụng tín hiệu an toàn để xác định các phân khúc dữ liệu áp dụng để trả về trong SegmentResponse.

Ví dụ về SegmentRequest

Điểm cuối Tuyển chọn theo thời gian thực của tín hiệu theo bối cảnh

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Điểm cuối tuyển chọn theo thời gian thực của tín hiệu an toàn

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Các bước tiếp theo