ניתוח של SegmentRequest

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

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

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

בחירת תוכן באמצעות נקודות קצה של אותות לפי הקשר או אותות לזיהוי קהלים

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

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

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

  • ‫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"
      }
  }
}

נקודת קצה של אותות לזיהוי קהלים בזמן אמת

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

השלבים הבאים