פתרון בעיות

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

קריאת מדדים בממשק המשתמש של Google Ads

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

בעיות בתכונה "המרות משופרות לצורך שיוך ללידים"

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

שגיאות נפוצות

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

שגיאה
NO_CONVERSION_ACTION_FOUND

פעולת ההמרה שצוינה לא מופעלת, או שאין לחשבון בשדה customer_id של הבקשה גישה אליה. מוודאים שפעולת ההמרה בקובץ שהועלה מופעלת, ושהבעלים שלה הוא הלקוח של ההמרה ב-Google Ads שמשויך לקליק, או חשבון בהיררכיית מעקב ההמרות של החשבון שמעלה את הקובץ.

השגיאה הזו יכולה להופיע גם אם ה-GCLID בבקשה שייך לחשבון לקוח שאין לו גישה לפעולת ההמרה שצוינה בבקשה. כדי לבדוק אם GCLID שייך לחשבון לקוח, אפשר להשתמש במשאב click_view ולשלוח שאילתה שמסננת לפי click_view.gclid ו-segments.date, כשהתאריך הוא התאריך שבו התרחש הקליק.

INVALID_CONVERSION_ACTION_TYPE The specified conversion action has a type that is not valid for enhanced conversions for leads. צריך לוודא שה-ConversionAction שצוין בבקשת ההעלאה הוא מסוג UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS מוודאים שהפעלתם את התכונה "המרות משופרות לצורך שיוך ללידים" בהגדרות ההמרה. הוראות לביצוע הפעולה הזו מופיעות במדריך דרישות מוקדמות.
DUPLICATE_ORDER_ID האירועים שיובאו כוללים מספר המרות עם אותו מזהה הזמנה, ולא עובדו. צריך לוודא שמזהי ההזמנות ייחודיים ולנסות שוב.
CLICK_NOT_FOUND לא נמצא קליק שתואם למזהי המשתמשים שסופקו.

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

השגיאה הזו צפויה אם הקליק לא הגיע מקמפיין Google Ads. לדוגמה, הוא יכול להגיע מ-SA360 או מ-DV360. סיבות אפשריות אחרות:

במקרים נדירים שבהם הלקוח שמעלה את הנתונים שונה מהלקוח שמוגדר בחשבון Google Ads שבו מתבצע מעקב ההמרות, יכול להיות שהשגיאה הזו מציינת שהלקוח שמעלה את הנתונים אישר את התנאים בנוגע לנתוני לקוחות, אבל הלקוח שמוגדר בחשבון שבו מתבצע מעקב ההמרות לא אישר אותם.

כדי לבדוק אם בחשבון מסוים אושרו התנאים לאיסוף נתוני לקוחות ושימוש בהם, שולחים שאילתה למשאב customer ובודקים את השדה customer.conversion_tracking_setting.accepted_customer_data_terms.

פערים במדדים

חשוב לזכור את הבעיות הנפוצות הבאות:

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

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

  • אם אתם משתמשים בהמרות משופרות לצורך שיוך ללידים בלי Google Tag בדף האינטרנט, אתם חייבים לכלול את ה-GCLID בייבוא ההמרות על ידי הגדרת השדה ClickConversion.gclid בכל המרה.

  • מוודאים שציינתם את ההסכמה בצורה נכונה בהעלאות. כדי לעשות את זה, אתם יכולים לקבוע את הגדרות ברירת המחדל בנוגע להסכמה בחשבון (בממשק המשתמש של Google Ads, לוחצים על כלים > המרכז לניהול נתונים > הגדרות הסכמה) או להגדיר את השדה ClickConversion.consent בכל המרה שאתם מעלים.

בעיות בביצועים ברמת הקמפיין

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

בעיות בתיעוד המרות משופר באתרים

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

שגיאות נפוצות

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

שגיאה
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS התנאים וההגבלות בנוגע לנתוני לקוחות לא אושרו עבור customer_id של הבקשה. הוראות לכך מופיעות במדריך דרישות מוקדמות.
CONVERSION_ALREADY_ENHANCED ההמרה הזו כבר קיבלה התאמה מסוג ENHANCEMENT עם השדות order_id ו-conversion_action שצוינו. חשוב לציין ערך order_id ייחודי לכל המרה.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT ה-conversion_action שצוין לא כשירה לשימוש בהמרות משופרות באתרים. בממשק המשתמש של Google Ads, מסמנים את התיבה הפעלת המרות משופרות בפעולת ההמרה שצוינה בבקשה. הוראות בנושא זמינות במרכז העזרה.
INVALID_USER_IDENTIFIER שדה של מזהה משתמש שעבר גיבוב (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name או hashed_street_address) הוא לא תמצית SHA-256 תקינה של 64 תווים הקסדצימליים. לנרמל ולגבב את הפרטים שהמשתמשים סיפקו לפני הייבוא. הוראות מפורטות זמינות במאמר נרמול וגיבוב (hash) של פרטים שהמשתמשים סיפקו.
CONVERSION_NOT_FOUND

מערכת Google Ads לא הצליחה למצוא המרה שתואמת לשדה conversion_action ולמזהה ההמרה (order_id או gclid_date_time_pair) שצוינו. השגיאה הזו רלוונטית רק לשינויים מסוג RESTATEMENT ו-RETRACTION. פרטים נוספים זמינים במאמר דרישות לייבוא של שינויים בערכי המרות.

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

התראות על בעיות בתגים בממשק המשתמש אחרי העלאה תקינה של API

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

אם מופיעות התראות על בעיות בתגים בממשק המשתמש אחרי העלאות מוצלחות דרך ה-API, כדאי לבדוק את הגורמים הבאים:

  • שדות חובה חסרים בכתובת: אובייקט OfflineUserAddressInfo בשדה address_info דורש ארבעה שדות באותה רשומה: hashed_first_name,‏ hashed_last_name,‏ country_code ו-postal_code. השדות hashed_street_address,‏ city ו-state הם אופציונליים (אם ממלאים את השדה hashed_street_address, הוא עדיין צריך להיות ערך גיבוב תקין של 64 תווים הקסדצימליים מסוג SHA-256). ה-API מקבל אובייקטים חלקיים של address_info שאינם ריקים (כמו שם פרטי ושם משפחה בלבד) בלי להחזיר שגיאה בשדה partial_failure_error. עם זאת, בתהליך ההתאמה במורד הזרם, המערכת מתעלמת מכתובות חלקיות ומפעילה התראה על שדות כתובת חסרים. אם אחד מארבעת שדות החובה לא זמין, צריך להשמיט את האובייקט UserIdentifier בשדה address_info.

  • מזהי עסקאות חסרים באירועים של תג האתר: אם משמיטים את השדה order_id מהתאמה של ENHANCEMENT ב-API, מוחזרת שגיאת FieldError.REQUIRED סינכרונית. אם בקשות ה-API שלכם כוללות את השדה order_id, התראה בממשק המשתמש על מזהה עסקה חסר באירוע ההמרה מתייחסת לתג באתר. ההתראה הזו מופיעה כשפחות מ-90% מהאירועים של תג ההמרה באתר כוללים מזהה עסקה תקין (או כשהתג שולח מחרוזות של פלייסהולדרים כמו "undefined" או "null"). צריך להגדיר את תג ההמרה באתר כך שישלח מזהה עסקה ייחודי לכל אירוע המרה.

  • חוסר התאמה בין מזהה ההזמנה בתג לבין מזהה ההזמנה ב-API או העלאות מאוחרות: כשמבצעים התאמות של ENHANCEMENT, ה-API לא מחזיר שגיאה מסוג CONVERSION_NOT_FOUND או CONVERSION_EXPIRED בזמן ההעלאה. במקום זאת, ערכי order_id שלא תואמים מפעילים התראה על אי-התאמה של מזהה ההזמנה בממשק המשתמש, ושיפורים שהועלו יותר מ-24 שעות אחרי ההמרה מפעילים התראה על העלאה מאוחרת. מתאימים את השדה order_id ב-API למחרוזת המדויקת של מזהה העסקה שנשלחה על ידי תג ההמרה באתר, ומעלים את השיפור תוך 24 שעות מאירוע ההמרה.

  • נתוני משתמשים לא מנורמלים שעברו גיבוב לפני ההעלאה: גיבוב של ערכים לא מנורמלים – כמו אותיות רישיות, רווחים בתחילת או בסוף המחרוזת או מספרי טלפון שלא בפורמט E.164 – עדיין מפיק תקציר הקסדצימלי תקין של SHA-256 באורך 64 תווים. ה-API מקבל את ההעלאה בלי להחזיר שגיאת INVALID_USER_IDENTIFIER, אבל ההתאמה בהמשך נכשלת ומופיעות התראות על פורמט שגוי או על אחוז נמוך של לקוחות לטירגוט. פועלים לפי כללי הנרמול שמפורטים במאמר נרמול וגיבוב של פרטים שהמשתמשים סיפקו.

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

    • הגדרת סטטוס הסכמה: כשסטטוס ההסכמה ב-Google Tag מאותת על ההגדרה ad_storage='denied', כלי האבחון בממשק המשתמש מחריגים מההשוואה אירועים של תגי אתר ללא הסכמה לשימוש בקובצי Cookie. לכן, השמטת האירועים האלה מההעלאות של ה-API לא מפעילה התראה על נפח נמוך. עם זאת, חוסר התאמה בין הטיפול בהסכמה בתג של האתר לבין הטריגרים בקצה העורפי מפעיל התראות:

      • בתג חסר הפרמטר ad_storage='denied', הקצה העורפי מדלג על ההעלאה: כלי האבחון בממשק המשתמש סופרים את אירועי התג כאירועים שהתקבלה לגביהם הסכמה, ומדווחים על התראה לגבי כיסוי נמוך.
      • אותות תגים ad_storage='denied', שיפור העלאות בקצה העורפי: בשיפורים שהועלו חסר אירוע תג תואם שהמשתמשים הסכימו לו, והם תורמים להתראות על אי-התאמה של מזהה ההזמנה.

      צריך להחיל את אותו מצב הסכמה גם על תג האתר וגם על העלאות השיפורים ב-API.

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

בעיות כלליות בניהול ההמרות

חשוב לזכור את הבעיות הנפוצות הבאות:

  • ניסיון להגדיר שדה enum כלשהו לערך UNKNOWN יגרום לשגיאה RequestError.INVALID_ENUM_VALUE. זו בעיה נפוצה כשמציינים את הערך consent, כי יכול להיות שהמפרסם לא יודע אם ניתנה הסכמה. אם הסטטוס של consent לא ידוע, צריך להגדיר אותו כ-DENIED.

  • כשיוצרים פעולת המרה להמרות באפליקציה או לFirebase ולניתוח נתונים של אפליקציות של צד שלישי, אפשר לשנות את השדה app_id רק בזמן היצירה. אחרי שיוצרים את פעולת ההמרה, אי אפשר לשנות את השדה הזה.

  • כשיוצרים פעולת המרה, אפשר להגדיר את השדה ConversionAction.attribution_model_settings.attribution_model רק לערך GOOGLE_ADS_LAST_CLICK או לערך GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. כל אפשרות אחרת תגרום לשגיאה CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים על הוצאה משימוש של מודלים אחרים של שיוך (Attribution).

  • הטווח המותר בשדה click_through_lookback_window_days הוא 1 עד 60 ימים לפעולות המרה מסוג AD_CALL ו-WEBSITE_CALL. ברוב פעולות ההמרה האחרות, הטווח המותר הוא בין 1 ל-90 ימים.

  • הטווח המותר בשדה view_through_lookback_window_days הוא 1 עד 30 ימים ברוב פעולות ההמרה. השדה הזה צריך להיות לא מוגדר בפעולות המרה מהסוגים AD_CALL ו-WEBSITE_CALL.

  • הגדרה או עדכון של השדה include_in_conversions_metric בפעולת המרה יובילו לשגיאה FieldError.IMMUTABLE_FIELD. במקום זאת, צריך להגדיר את השדה primary_for_goal, כפי שמתואר במדריך ליעדי המרות.

  • כשיוצרים פעולת המרה מסוג WEBSITE_CALL או AD_CALL, צריך להגדיר את השדה value_settings.always_use_default_value לערך true. אם תציינו את הערך false, תופיע השגיאה INVALID_VALUE.

שגיאות נפוצות

ההנחיות הבאות יעזרו לכם לאבחן ולתקן שגיאות נפוצות בייבוא של נתוני המרות אופליין (OCI), כולל שגיאות גישה שקשורות למעקב המרות ברמת חשבון ניהול.

שגיאה
INVALID_CONVERSION_ACTION_TYPE הסוג של פעולת ההמרה שצוינה לא מתאים להעלאת המרות מסוג קליקים. צריך לוודא שהערך של ConversionAction שצוין בבקשת ההעלאה הוא מסוג UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND פעולת ההמרה שצוינה לא מופעלת, או שאין לחשבון גישה אליה בשדה customer_id של הבקשה. אחזור מידע על הגדרת מעקב ההמרות כדי לוודא שפעולת ההמרה מופעלת. הבעלים של פעולת ההמרה צריך להיות הלקוח של המרה ממודעה ב-Google Ads שמשויך לקליק, או חשבון בהיררכיית מעקב ההמרות של החשבון שמעלה את ההמרות. לדוגמה, השגיאה הזו מתרחשת אם פעולת ההמרה שייכת לחשבון ניהול קודם שהקישור אליו בוטל אחרי הקליק.
TOO_RECENT_CONVERSION_ACTION פעולת ההמרה נוצרה לאחרונה. צריך להמתין לפחות 6 שעות אחרי שיוצרים את הפעולה, ורק אז לנסות שוב להעלות את ההמרות שנכשלו.
INVALID_CUSTOMER_FOR_CLICK השדה customer_id בבקשה לא תואם ללקוח המרת המודעה ב-Google Ads בזמן הקליק. השגיאה הזו מתרחשת כשבחשבון שמעלה את ההמרות אין גם גישה לחשבונות אחרים לפעולת ההמרה. מעדכנים את השדה customer_id של הבקשה לחשבון בהיררכיה של הבעלים של פעולת ההמרה.
EVENT_NOT_FOUND מערכת Google Ads לא מוצאת את השילוב של מזהה הקליק ו-customer_id. בודקים את הדרישות של customer_id ומוודאים שמעלים את הנתונים באמצעות חשבון Google Ads הנכון.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST לכמה המרות בבקשה יש אותו שילוב של מזהה קליק, conversion_date_time ו-conversion_action. צריך להסיר המרות כפולות מהבקשה.
CLICK_CONVERSION_ALREADY_EXISTS כבר העלית המרה עם אותו שילוב של מזהה קליק, conversion_date_time ו-conversion_action. אפשר להתעלם מהשגיאה הזו אם ניסיתם להעלות שוב את ההמרה הזו והיא כבר הועלתה בהצלחה בעבר. אם רוצים להוסיף עוד המרה בנוסף להמרה שהועלתה קודם, צריך לשנות את הערך של conversion_date_time ב-ClickConversion כדי למנוע כפילות של ההמרה שהועלתה קודם.
EXPIRED_EVENT הקליק המיובא התרחש לפני מסגרת הזמן שצוינה בשדה click_through_lookback_window_days. שינוי בclick_through_lookback_window_days משפיע רק על קליקים שתועדו אחרי השינוי, ולכן שינוי של חלון המבט לאחור לא יפתור את השגיאה הזו בקליק הספציפי. אם צריך, משנים את conversion_action לפעולה אחרת עם חלון מבט לאחור ארוך יותר.
CONVERSION_PRECEDES_EVENT הערך של conversion_date_time הוא לפני התאריך והשעה של הקליק. צריך לעדכן את הערך של conversion_date_time לערך מאוחר יותר.
VALUE_MUST_BE_UNSET

ל-ClickConversion יש ערך שמוגדר ל-gbraid או ל-wbraid (בלי gclid) ויש לו ערך ל-custom_variables או ל-cart_data, ש-Google Ads לא תומכת בהם עם gbraid או wbraid. מבטלים את ההגדרה של השדה המתנגש.