ניתוח של SegmentRequest

בשיטה 'בחירת תוכן בזמן אמת', Google שולחת קובץ JSON SegmentRequest לנקודת הקצה של בחירת התוכן כדי לספק אותות שמתארים חשיפה אחת או יותר, וכך מאפשרת לכם לקבוע אילו פלחי נתונים רלוונטיים לכל חשיפה. במדריך הזה מוסבר איך לפתח לוגיקה של אוצרות שמטפלת ב-SegmentRequest.

שימוש בקידוד gzip

‫Google משתמשת בקידוד gzip כשהיא שולחת SegmentRequest לנקודת הקצה שלכם. נקודת הקצה צריכה להיות מסוגלת לקבל תגובות עם קידוד gzip ולהגיב להן.

אוסף עם נקודות קצה של אותות בהקשר או אותות מאובטחים

כשיוצרים נקודת קצה של אוסף בזמן אמת, צריך לבחור אם לקבל אותות הקשריים או אותות מאובטחים. האותות שאתם בוחרים משפיעים על האופן שבו מתבצעת אוכלוסייה של בקשות לפלחים שנשלחות לנקודת הקצה שלכם, על כמות מלאי שטחי הפרסום שמייצר בקשות לפלחים שנשלחות לנקודת הקצה שלכם ועל לוגיקת האוצרות שמשמשת בשילוב.

שימוש באותות לפי הקשר

אותות הקשריים כוללים מידע על בעל האתר, המכשיר והמשתמש, שמתאר את המקור של החשיפה. ברשימה הבאה מתוארים האותות הזמינים:

  • ‫SegmentRequest.site: תיאור של האתר שבו מוצגת החשיפה, כמו כתובת ה-URL של האתר. אפשר לאכלס רק אחד מהערכים SegmentRequest.site ו-SegmentRequest.app ב-SegmentRequest.
  • ‫SegmentRequest.app: תיאור של האפליקציה שבה מוצגת החשיפה, כמו מזהה האפליקציה הספציפי לפלטפורמה. אפשר לאכלס רק אחד מהערכים SegmentRequest.site ו-SegmentRequest.app ב-SegmentRequest.
  • ‫SegmentRequest.pub: מתאר את בעל התוכן הדיגיטלי של המדיה שבה מוצגת החשיפה, לדוגמה, המזהה של בעל התוכן הדיגיטלי.
  • ‫SegmentRequest.user: מתאר את הבחירות של המשתמשים לגבי האופן שבו אפשר לעבד את המידע האישי שלהם. לדוגמה, באמצעות מחרוזת ההסכמה של TCF.
  • ‫SegmentRequest.device: תיאור מידע על המכשיר, כמו המיקום הגיאוגרפי של המכשיר ברמת דיוק של אזור מטרופוליטני.

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

שימוש באותות מאובטחים

אותות מאובטחים הם נתונים שנוצרו על ידי בעל התוכן הדיגיטלי והוא בחר לשתף אותם עם שותף אחד או יותר. הם עוברים טשטוש לפני שהם משותפים עם Google בבקשה להצגת מודעה, ובזמן אמת הם מופיעים בצורה המטושטשת שלהם בSegmentRequest.user.eids.uids.id.

אם נקודת הקצה שלכם מוגדרת לשימוש באותות מאובטחים, היא תקבל רק בקשות לפלחים לגבי מלאי שטחי הפרסום של בעלי אתרים שבחרו לשתף אותות מאובטחים עם חשבון ניהול מלאי שטחי הפרסום שלכם. לכן, יש פחות חשיפות כוללות שעומדות בדרישות לשליחה לנקודות קצה של אותות מאובטחים בהשוואה לנקודות קצה של אותות קונטקסטואליים.

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

דוגמאות ל-SegmentRequest

נקודת הקצה של אוסף אותות בהקשר בזמן אמת

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

נקודת קצה (endpoint) של אוסף אותות מאובטח בזמן אמת

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

השלבים הבאים