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

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