שגיאות ואזהרות

בדף הזה מתוארים הסוגים השונים של שגיאות ואזהרות שייתכן בזמן השימוש בתצוגה Video 360 API

שגיאות API

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

תגובת שגיאה לוקחת את הפורמט הבא וכוללת קוד תגובת HTTP: הודעת שגיאה והסטטוס של קוד RPC של Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

בהמשך מופיעה רשימה של שגיאות נפוצות ב-API, יחד עם הפעולה שמומלץ לבצע. אם הם מוחזרים:

שגיאות SDF

רשת המדיה ב-Video 360 API נעשה שימוש בשיטה אסינכרונית לצורך יצירה והורדה של קובצי נתונים מובְנים (SDF). בשביל זה הסיבה לכך, שגיאות שנזרקות במהלך יצירת SDF מוחזרות בקובץ ה-SDF המוכן של ההורדה. משימת הורדה של SDF שמסתיימת ב-error היא מסומן כ'בוצע', אבל מכיל שדה שגיאה מאוכלס במקום שם של משאב מדיה בשדה response, כמו בדוגמה החתוכה הבאה:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

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

• מוודאים שלמשתמש יש את ההרשאות המתאימות של ההורה משאבים של שותפים או של מפרסמים.
• מוודאים שהמזהים שסופקו במסנן מדויקים. שתואמים לסוג המשאב המיועד, ונמצאים בהקשר של ניתן מזהה root.
• יש לוודא שאינכם חורגים מהמגבלה של עשרים הורדות SDF בו-זמנית משימות לכל משתמש.

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

אזהרות ללא חסימה

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

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

מניעה

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

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

אם משכפלים הגדרות מפריט קיים, צריך לוודא הפריט הקיים לא מייצר אזהרות לא צפויות.

מעקב

בעיות שגורמות לאזהרות שאינן חוסמות עשויות להופיע בזמן שפריט מסוים נמצא בטיסה. כדי להבטיח שהפריטים מוצגים כמו שצריך, מומלץ לעקוב אחר את הפריטים הפעילים עבור אזהרות שנוצרו לאחרונה. ניתן לאחזר פריטים בכמות גדולה באמצעות הפונקציה advertisers.lineItems.list. אם המיקום פריט כלשהו מציג אזהרה לא צפויה, עליך לטפל בבעיה באופן מיידי, כדי לצמצם את ההשפעה על הצגת המודעות.

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