إنشاء SegmentResponse

بعد أن تعالج نقطة نهاية التنظيم الإشارات المُرسَلة في طلب شريحة الجمهور، يجب أن تنشئ نقطة نهاية التنظيم ردًا على Google يتضمّن الكائن SegmentResponse في غضون 50 ملي ثانية، ويحدّد شرائح البيانات التي تنطبق على كل مرّة ظهور. تتجاهل Google الردود التي يتم تلقّيها بعد 50 ملي ثانية.

يمكنك تحديد أرقام تعريف الأقسام ذات الصلة بفرصة عرض الإعلان باستخدام الحقل SegmentResponse.segment.segment_id. يمكنك العثور على أرقام تعريف شرائح البيانات التي أنشأتها باستخدام مورد dataSegments في Marketplace API. لمزيد من التفاصيل، يُرجى الاطّلاع على كيفية تحديد شرائح البيانات في واجهة برمجة التطبيقات مقارنةً بميزة "التنظيم في الوقت الفعلي".

الردّ في حال عدم انطباق أي شرائح جمهور مستندة إلى البيانات

إذا تبيّن لك أنّ أيًا من شرائح الجمهور المستندة إلى بياناتك لا ينطبق على طلب شريحة جمهور معيّن، عليك حذف إنشاء عنصر 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",
    }
  ]
}