פתרון בעיות

אם נתקלתם בבעיות בזמן השימוש ב-Search Ads 360 API, תוכלו לעיין בקטע הזה בנושא פתרון בעיות.

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

  • מזהה הסוכנות ומזהה המפרסם ב-Search Ads 360 שאתם מנסים לגשת אליהם

  • מספר הפרויקט מ-Google API Console

  • שם המשתמש של חשבון Google שבו אתם משתמשים כדי לגשת ל-API.
    זהו החשבון שקיבל הרשאה לגשת ל-Search Ads 360, וזה גם החשבון שבו משתמשים כדי להגדיר את ההרשאה.

  • קטע קוד של הבקשה

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

שגיאות הקשורות להרשאות

ריכזנו כאן כמה מהשגיאות הנפוצות שקשורות להרשאה:

הודעה תיאור

Access Not Configured. Please use Google API Console to activate the API for your project.

השגיאה הזו מתרחשת אם לא הפעלתם את Search Ads 360 API בחשבון. חשוב לוודא ש:

  1. נכנסים למסוף Google API.

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

  3. בסרגל הצד שמימין, מרחיבים את האפשרות APIs & auth. לאחר מכן, לוחצים על APIs. ברשימת ממשקי ה-API, מוודאים שהסטטוס של Search Ads 360 API הוא מופעל.

Invalid grant

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

sa360Api.py --login

מידע נוסף על תהליך העבודה המומלץ להרשאה

Invalid client
no application name

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

סוגים אחרים של שגיאות הרשאה

חשוב להשתמש בחשבון Google שקיבל גישה ל-Search Ads 360 כשנכנסים למסוף Google API כדי לאחזר את מזהה הלקוח ואת הסוד של הלקוח, וכשלוקחים אסימון רענון.

שגיאות בהעלאת המרות

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

קוד שגיאה הודעה תיאור
0x00000101

Click ID '{ID}' is not found

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

  • מוודאים שמספר הקליק נוצר 6 שעות לפני העלאת ההמרות.

  • הפעלת שירות API ההמרות.

  • אם אתם משייכים המרות לביקורים ספציפיים, עליכם להמתין לפחות 6 שעות אחרי הביקור לפני שאתם מעלים את ההמרה. יכול להיות שמערכת Search Ads 360 לא תזהה את מזהה הקליק של הביקור אם תעלו את הנתונים לפני 6 שעות ממועד הביקור. במקרים נדירים, יכול להיות שיעברו עד 24 שעות עד שמערכת Search Ads 360 תזהה את clickId.

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

  • וידאתי שציינת את המפרסם הנכון בעמודה advertiserId.

  • מוודאים שמספר הקליק נוצר ב-90 הימים האחרונים.
0x0000010E Floodlight activity name '{name}' is not found

השם של הפעילות ב-Floodlight שצוין בעמודה segmentationName שגוי או שהוא עדיין לא זמין. אם השגיאה הזו מופיעה, כדאי לבדוק את הבעיות הנפוצות הבאות:

  • השמות תלויי אותיות רישיות, לכן חשוב לוודא שהבקשה תואמת בדיוק לאותיות הרישיות.
  • חשוב לוודא שלא כללתם תווים של Unicode שלא ניתן להדפיס או רווחים כפולים בשם הפעילות ב-Floodlight.
  • חשוב לוודא שציינתם את השם של פעילות ב-Floodlight, ולא של עמודה ב-Floodlight.
  • מוודאים שהפעילות ב-Floodlight קיימת עבור המפרסם שציינתם בעמודה advertiserId. (יכול להיות שציינתם את המפרסם הלא נכון).
  • אחרי שיוצרים או עורכים פעילות ב-Floodlight, צריך להמתין כמה שעות לפני שמעלים המרות עבור הפעילות.
0x00000115 Custom dimension '{name}' is not found

צריך לוודא שהמשתנה המותאם אישית של Floodlight שציינתם מוגדר כמאפיין (לא מדד) של המפרסם שמשויך למזהה clickId,‏ criterionId או productGroupId שמשמש לצורך השיוך של ההמרה.

0x00000116 Custom metric '{name}' is not found

חשוב לוודא שהמשתנה המותאם אישית של Floodlight שציינתם הוגדר כמדד (ולא כמאפיין) עבור המפרסם שמשויך למשתנה clickId,‏ criterionId או productGroupId שמשמש לשיוך ההמרה.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

משתמש כלשהו כבר העלאה המרה באותו היקף ובאותו מזהה המרה של המפרסם שצוינו בעמודה conversionId.

'מזהה ההמרה של המפרסם' הוא מזהה שאתם יוצרים. מערכת Search Ads 360 דורשת שהמזהה הזה יהיה ייחודי להיקף נתון. מזהה ההמרה ב-Search Ads 360 נוצר על ידי Search Ads 360 והוא ייחודי.
0x0000011B Advertiser conversion ID '{ID}' is not found

בבקשה update ניסו לעדכן מזהה המרה של מפרסם שלא קיים. חשוב לוודא שציינתם את המזהה הנכון.
0x0000011D User does not have permission to view advertiser {advertiser ID}

לחשבון Google שבו הלקוח משתמש אין הרשאה להציג את המפרסם שצוין בבקשה.

כשנכנסים למסוף Google API כדי לאחזר את מזהה הלקוח ואת הסוד של הלקוח, וכשמקבלים אסימון רענון, חשוב להשתמש בחשבון Google שקיבל גישה למפרסם שציינתם.
0x0000011F Advertiser conversion ID is already specified in this request

שתי המרות או יותר בבקשה מציינות את אותו היקף ומזהה המרה של המפרסם.

מזהה ההמרה של המפרסם הוא מזהה שאתם יוצרים ומציינים בעמודה conversionId. מערכת Search Ads 360 דורשת שהמזהה הזה יהיה ייחודי להיקף נתון.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

השם או המזהה של הפעילות ב-Floodlight שציינתם לא תואמים לסוג ההמרה שציינתם.

דיווח על קודי תגובה והודעות שגיאה

אם מבקשים דוח והתגובה היא הודעת שגיאה, אפשר לקרוא את המאמרים קודי תגובה ב-Search Ads 360 API ותגובות סטנדרטיות לשגיאות כדי לקבל מידע נוסף על השגיאה.

הנתונים בממשק המשתמש של Search Ads 360 לא תואמים לדוח שהוחזר על ידי ה-API

כברירת מחדל, הנתונים בממשק המשתמש של Search Ads 360 אמורים להתאים לנתונים שמוחזרים על ידי ה-API. אם מגדירים את הערך של includeRemovedEntities ל-true בבקשת דוח, צריך לוודא שהתיבה Show removed מסומנת גם בממשק המשתמש.