פתרון בעיות

אם נתקלתם בבעיות במהלך השימוש ב-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. בשלב הבא, לוחצים על ממשקי API. ברשימת ממשקי ה-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 אינו חוקי. צריך להעלות מחדש את ההמרות אחרי ש:

  • וידאנו שמזהה הקליק נוצר 4 שעות לפני העלאת ההמרות.

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

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

  • אושר כי הקליק הגיע ממקור חוקי כפי שמצוין על ידי הפרמטר 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 הוגדר כמאפיין (לא מדד) למפרסם שמשויך להמרה, ל- criterionId או ל-productGroupId שבחרת לשייך להמרה.

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

חשוב לוודא שהמשתנה המותאם אישית שציינת ב-Floodlight הוגדר כמדד (לא מאפיין) למפרסם שמשויך להמרה, ל- 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 שסיפקת לא תואמים לסוג ההמרה שציינת.

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

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

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

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