פתרון בעיות

אם נתקלתם בבעיות במהלך השימוש ב-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 Console.

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

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

Invalid grant

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

sa360Api.py --login

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

Invalid client
no application name

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

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

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

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

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

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

Click ID '{ID}' is not found

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

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

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

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

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

  • מוודאים שמספר הקליק נוצר ב-90 הימים האחרונים.

0x00000106 Either a click ID or keyword ID is required

ההמרה לא מציינת למה היא משויכת. צריך לציין את העמודה clickId או את העמודות customerId,‏ campaignId,‏ adGroupId ו-criterionId שמזהות מילת מפתח.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

מציינים את הערך segmentationType: "FLOODLIGHT" ואת הפעילות ב-Floodlight בעמודה segmentationName או בעמודה segmentationId.

כשעורכים המרה שמערכת Search Ads 360 תיעדה באמצעות תג Floodlight, צריך להשתמש בפעילות ב-Floodlight כדי לזהות את ההמרה.

0x0000010E Floodlight activity name '{name}' is not found

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

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

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

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

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

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

בבקשה update לא צוינה העמודה conversionId. ‫conversionId נדרש כדי לזהות את ההמרה שרוצים לערוך. מידע נוסף זמין במאמר הוצאה משימוש של dsConversionId.

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

  • מוודאים שציינתם את המזהה הנכון בעמודה conversionId . בהמרות שהועלו דרך ה-API, זהו ה-conversionId שציינת כשהוספת את ההמרה. בהמרות שתועדו באמצעות תגי Floodlight, זהו מזהה ההזמנה ב-Floodlight.
  • חשוב לוודא שהערך של conversionTimestamp הוא חותמת הזמן של ההמרה הקיימת, במילישניות של זמן Unix ב-UTC. חותמת זמן שהומרה מאזור זמן מקומי, או שצוינה בשניות במקום באלפיות השנייה, לא תואמת להמרה הקיימת.
  • אם ההמרות מתועדות באמצעות תגי Floodlight, צריך לוודא שציינתם את הפעילות ב-Floodlight שקשורה להמרה בעמודה segmentationName או segmentationId, ושההמרה התרחשה ב-28 הימים האחרונים.
0x0000011D User does not have permission to view advertiser {advertiser ID}

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

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

0x00000124 Conversion timestamp is before click timestamp

הערך בעמודה conversionTimestamp מוקדם יותר מהשעה של הקליק שציינתם בעמודה clickId. חשוב לוודא שחותמת הזמן מצוינת במילישניות לפי ראשית זמן יוניקס (Unix epoch) ב-UTC, ולא בשניות או באזור זמן מקומי.

0x00000125 Conversion age is older than the max supported age

בבקשה מסוג update ניסית לערוך המרה ישנה מדי. אפשר לערוך המרות ש-Search Ads 360 תיעד באמצעות תגי Floodlight רק בתוך 28 ימים מ-conversionTimestamp.

0x00000126 Service internal error

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

0x00000129 Invalid customer ID: {ID}

מערכת Search Ads 360 לא מוצאת את מספר הלקוח שציינתם בעמודה customerId . מציינים את מספר הלקוח בממשק החדש של Search Ads 360 של חשבון הלקוח שמכיל את מילת המפתח, לדוגמה 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

מערכת Search Ads 360 לא מצליחה למצוא את מילת המפתח שמזוהה לפי העמודות customerId, campaignId, adGroupId ו- criterionId. מוודאים שכל ארבעת המזהים הם מזהים של הממשק החדש של Search Ads 360, ושמילת המפתח שייכת לקבוצת המודעות, לקמפיין ולחשבון הלקוח שציינתם.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

בהמרה שמשויכת למילת מפתח צריך לציין את השדות customerId,‏ campaignId,‏ adGroupId ו- criterionId. בהודעה מצוין המזהה שחסר. איך משייכים המרה למילת מפתח בלבד

0x0000012F Editing a click ID older than 60 days is not supported.

בבקשה update צוין clickId שנוצר לפני יותר מ-60 יום. אפשר לערוך המרות רק תוך 60 ימים מהקליק.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

בבקשה update צוינה העמודה dsConversionId שהוצאה משימוש, או שהועבר מזהה המרה של מעקב המרות ב-Search Ads 360 בעמודה conversionId. במקום זאת, צריך לזהות את ההמרה לפי מזהה ההמרה של המפרסם. מידע נוסף זמין במאמר הוצאה משימוש של dsConversionId.

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

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

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

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