עדכון נתוני הקהל ורענון המודעות

כאן מוסבר איך מעדכנים נתוני קהל על ידי הגדרת כתובת URL לעדכון של קבוצת תחומי עניין ב-Protected Audience API. כדי לקבל מידע על מחזור החיים המלא של Protected Audience API, אפשר לעיין במדריך למפתחים. כדי לקבל הסבר מפורט על האופן שבו דפדפנים מתעדים קבוצות של תחומי עניין, אפשר לעיין במאמר Protected Audience API explainer.

אתם לא מפתחים? מידע נוסף מופיע בסקירה הכללית על Protected Audience API.

קבוצות אינטרס של Protected Audience API

קבוצת אינטרס של Protected Audience API מייצגת קבוצה של אנשים עם עניין משותף, שתואמת לרשימת רימרקטינג. לכל קבוצת אינטרס ב-Protected Audience API יש בעלים.

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

פונקציות API

דוגמה לשימוש

הנה דוגמה מתוך המדריך בנושא הגדרת נתוני קהל שמראה איך ליצור קבוצת אינטרס ולבקש מהדפדפן להצטרף לקבוצה.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

המאפיין updateUrl מספק כתובת URL שמחזירה JSON כדי לעדכן מאפיינים של קבוצות נושאים. המקור של owner חייב להיות זהה למקור של owner.

עדכון מאפיינים

‫updateUrl מציין שרת אינטרנט שמחזיר JSON שמגדיר את המאפיינים של קבוצת נושאים, בהתאם לאובייקט של קבוצת הנושאים שמועבר אל joinAdInterestGroup().

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

biddingLogicUrl
biddingWasmHelperUrl
trustedBiddingSignalsUrl
trustedBiddingSignalsKeys
ads
priority

שדות שלא צוינו ב-JSON לא ייכתבו מחדש – רק שדות שצוינו ב-JSON יעודכנו – בעוד שקריאה ל-navigator.joinAdInterestGroup() כותבת מחדש כל קבוצת בעלי עניין קיימת.

העדכונים מתבצעים כמיטב היכולת, ויכולים להיכשל בתנאים הבאים:

הזמן הקצוב לתפוגה של בקשת רשת (כרגע 30 שניות).
תקלה אחרת ברשת.
שגיאה בניתוח JSON.

העדכונים מוגבלים לשיעור של עד אחד ביום.

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

עדכונים ידניים

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

הגבלת קצב הבקשות מונעת עדכונים בתדירות גבוהה מדי: קריאות חוזרות ל-navigator.updateAdInterestGroups() לא עושות כלום עד שתקופת הגבלת קצב הבקשות (כרגע יום אחד) מסתיימת.

מגבלת הקצב מתאפסת אם מתבצעת קריאה חוזרת ל-navigator.joinAdInterestGroup() עבור אותה קבוצת נושא owner ו-name.

עדכונים אוטומטיים

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

לכל בעלים עם קבוצת עניין אחת לפחות שמשתתפת במכרז, הפונקציה navigator.updateAdInterestGroups() נקראת מתוך iframe שהמקור שלו תואם לבעלים.

כל חומרי העזר בנושא Protected Audience API

תוכלו להיעזר במדריכים הבאים עם ה-API:

מדריך למפתחים של Protected Audience API.
המדריך לקונים של מודעות בנושא קבוצות תחומי עניין ויצירת הצעות מחיר של Protected Audience.
המדריך למוכר מודעות למכרזי מודעות של Protected Audience.
מדריך לדיווח על תוצאות מכרזים
שיטות מומלצות לזמן אחזור של מכרז מודעות עם Protected Audience
פתרון בעיות ב'קהל מוגן'

הסבר על Protected Audience API כולל גם פרטים על התמיכה בתכונות והאילוצים.

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