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