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

ה-API של Display & Video 360 יכול להגיב עם מספר שגיאות ואזהרות. פתרון תקין של API צריך לטפל בשגיאות האלה.

שגיאות API

בקשות ל-API שלא מצליחות לבצע את הפעולה המיועדת מחזירות שגיאה. צריך לזהות ולטפל בתשובות עם שגיאה [0x0A].

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

{
  "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` חרגת ממגבלת הקצב או ממכסת הבקשות היומית. אפשר להשתמש ב-מסוף Google Cloud כדי לבדוק את השימוש ב-API. מעדכנים את תהליך העבודה כך שיפעל במסגרת מגבלות המכסה הקיימות. מידע נוסף זמין במדריך בנושא אופטימיזציה של השימוש.
`500`	`INTERNAL` אירעה שגיאה פנימית ב-API. מחכים כמה שניות ואז מנסים לשלוח שוב את הבקשה. אם השגיאה נמשכת, פנו לתמיכה.
`504`	`DEADLINE_EXCEEDED` ל-API לקח יותר מדי זמן להשלים את הבקשה. מחכים כמה שניות ואז מנסים לשלוח שוב את הבקשה. אם השגיאה נמשכת, פנו לתמיכה.

שגיאות ב-SDF

ממשק Display & Video 360 API משתמש במשימות ארוכות טווח כדי ליצור קובצי נתונים מובנים (SDF). שגיאות ביצירה של קובצי ה-SDF מוחזרות בקובץ operation שנוצר. הפרטים יופיעו בשדה error. דוגמה להמחשה:

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

אם הודעת השגיאה לא ברורה, מומלץ:

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

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

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

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

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

מניעה

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

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

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

מעקב

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

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

הזמנת הקמפיין מושהית או שתוקפה פג.
רשימת משתמשים או אפשרות טירגוט הוצאו משימוש.