SegmentResponse را بسازید

پس از اینکه نقطه پایانی گزینش شما سیگنال‌های ارسالی در درخواست بخش‌بندی را پردازش کرد، نقطه پایانی گزینش شما باید ظرف ۵۰ میلی‌ثانیه یک شیء SegmentResponse ایجاد کند و به گوگل پاسخ دهد که بخش‌های داده‌ای را که برای هر نمایش قابل استفاده هستند، شناسایی می‌کند. گوگل پاسخ‌های دریافتی پس از ۵۰ میلی‌ثانیه را نادیده می‌گیرد.

شما می‌توانید شناسه‌های بخش مربوط به یک فرصت تبلیغاتی را با فیلد SegmentResponse.segment.segment_id شناسایی کنید. می‌توانید شناسه‌های بخش‌های داده‌ای را که با استفاده از منبع dataSegments در Marketplace API ایجاد کرده‌اید، پیدا کنید. برای جزئیات بیشتر، به بخش «نحوه شناسایی بخش‌های داده در API در مقابل Real-time Curation» مراجعه کنید.

اگر هیچ بخش داده‌ای قابل اجرا نیست، پاسخ دهید

اگر متوجه شدید که هیچ یک از بخش‌های داده شما برای یک درخواست بخش مشخص قابل استفاده نیست، از ساخت یک شیء SegmentResponse صرف نظر کنید و با یک وضعیت HTTP 204 خالی پاسخ دهید.

مثال SegmentResponse

اگر محتویات شیء SegmentRequest نشان دهد که این نمایش مربوط به بخش‌های داده test-data-segment-1 و test-data-segment-2 است، شناسه‌های آنها را در یک شیء SegmentResponse برگردانید:

{
  "segment": [
    {
      "segment_id": "test-data-segment-1",
    },
    {
      "segment_id": "test-data-segment-2",
    }
  ]
}