פתרון בעיות

אם תיתקלו בבעיות במהלך השימוש ב-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. כדי לתקן את השגיאה הזו, מזינים את שם המוצר במסך ההסכמה ב-Google API Console.

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

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

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

מזהה ההמרה של המפרסם הוא מזהה שיוצרים ומציינים בעמודה 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 מסומנת גם בממשק המשתמש.