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

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

אין לך מפתחים? כדאי לעיין בסקירה הכללית על 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.

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

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 כולל גם פרטים על התמיכה בתכונות והאילוצים.