ניתוח של 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"
      }
    }
  }
}

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

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

השלבים הבאים