בדף הזה נפרט את הסוגים השונים של השגיאות והאזהרות שאתם עשויים להיתקל בהן במהלך השימוש ב-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 Console ומשנים את תהליך העבודה כך שיפעל במסגרת המגבלות הקיימות. למידע נוסף, קראו את המאמר אופטימיזציה של מכסות. אם אי אפשר להשלים את הפעולות במכסה היומית, תוכלו לבקש מכסה נוספת. |
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: אם הערך של הטיסה של פריט מסוים לא תקין, או אם פג התוקף של הטיסה של הזמנת ההורה, הפריט יצור אזהרה ולא יוצג. כדי למנוע את הבעיה הזו, חשוב לוודא שהטיסה של פריט מסוים לא מסתיימת אחרי פרק הזמן של הפרסום הפעיל של סדר ההכנסה שלו.
- נכסי קריאייטיב שהוקצו: אם אין קריאייטיב חוקי שהוקצה לפריט, הפריט ייצור אזהרה והוא לא יוצג.
- Targeting (טירגוט): אם הטירגוט של הפריט לא מוקצה בצורה נכונה, הפריט עלול ליצור אזהרה וייתכן שתהיה לכך השפעה על הצגת המודעות או למנוע את הצגת המודעות.
אם אתם יוצרים רפליקה של הגדרות מפריט קיים, חשוב לוודא שהפריט הקיים לא מייצר אזהרות בלתי צפויות.
מעקב
יכול להיות שיופיעו בעיות שגורמות לאזהרות בלי חסימה בזמן שפריט מסוים פועל. כדי להבטיח שהפריטים יוצגו כראוי, צריך לעקוב אחר הפריטים הפעילים כדי לראות אם יש אזהרות חדשות. אפשר לאחזר פריטים בכמות גדולה באמצעות הפונקציה advertisers.lineItems.list
. אם פריט כלשהו מציג אזהרה בלתי צפויה, צריך לטפל בבעיה מיד כדי לצמצם את ההשפעה על הצגת המודעות.
בעיות יכולות להתעורר גם אם ההגדרות או הטירגוט של הפריט לא השתנו. לדוגמה, השהיה או תפוגה של הזמנת קמפיין ברמה העליונה, והוצאה משימוש של רשימות משתמשים או הגדרות טירגוט אחרות.