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

בדף הזה מפורטים הסוגים השונים של שגיאות ואזהרות שעשויות להופיע כשמשתמשים ב-Display & Video 360 API.

שגיאות API

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

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

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

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

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

קוד	הכנסה לקליק	מה מומלץ לעשות?
400	INVALID_ARGUMENT	יש בעיה בבקשה שלך. בודקים את שדה ההודעה בתגובה לשגיאה ומשנים את הבקשה בהתאם.
401	UNAUTHENTICATED	לא ניתן היה לאמת את הבקשה כראוי. מוודאים שכללתם בבקשה פרטי כניסה תקינים ל-OAuth. מידע נוסף זמין במדריך למתחילים.
403	PERMISSION_DENIED	אין לכם את ההרשאות הדרושות כדי להשלים את הבקשה. מוודאים שלחשבון המשתמש יש את ההרשאות המתאימות לשותף או למפרסם הרלוונטיים.
404	NOT_FOUND	לא ניתן לאתר את המשאב שאתם מנסים לאחזר. מוודאים שהמזהה שבו אתם משתמשים נכון ומתאים לסוג המשאב שאתם מאתרים.
409	ABORTED	המשאב שאתם מנסים לשנות משתנה במקום אחר. ממתינים כמה שניות ואז מנסים לשלוח שוב את הבקשה.
429	RESOURCE_EXHAUSTED	חרגתם ממגבלת הקצב או ממכסת הבקשות היומית. בודקים את השימוש ב-API באמצעות מסוף Google API ומשנים את תהליך העבודה כך שיתאים למגבלות המכסה הקיימות. מידע נוסף זמין בדף אופטימיזציה של מכסות.
500	INTERNAL	ב-API הייתה שגיאה פנימית. ממתינים כמה שניות ואז מנסים שוב לשלוח את הבקשה. אם השגיאה נמשכת, פנו לתמיכה.
504	DEADLINE_EXCEEDED	ה-API לקח יותר מדי זמן כדי להשלים את הבקשה. ממתינים כמה שניות ואז מנסים לשלוח שוב את הבקשה. אם השגיאה נמשכת, פנו לתמיכה.

שגיאות SDF

ב-Display & 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, צריך לפעול לפי ההוראות. אם לא ברור מה צריך לעשות כדי לפתור את הבעיה שמופיעה בהודעת השגיאה, מומלץ לבצע את הפעולות הבאות:

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

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

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

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

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

מניעה

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

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

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

מעקב

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

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