בניית 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",
    }
  ]
}