בניית SegmentResponse

אחרי שנקודת הקצה של תהליך האוצרות מעבדת את האותות שנשלחים בבקשה לפלח, נקודת הקצה של תהליך האוצרות צריכה ליצור אובייקט SegmentResponse ולהשיב ל-Google תוך 50 אלפיות השנייה עם אובייקט שמזהה פלחי נתונים שרלוונטיים לכל חשיפה. ‫Google מתעלמת מתשובות שמתקבלות אחרי 50 אלפיות השנייה.

אפשר לזהות את מזהי הפלחים שרלוונטיים להזדמנות להצגת מודעה באמצעות השדה SegmentResponse.segment.segment_id. אפשר למצוא את המזהים של פלחי הנתונים שיצרתם באמצעות משאב dataSegments ב-Marketplace API. לפרטים נוספים, ראו איך מזהים פלחים של נתונים ב-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",
    }
  ]
}