אתם יכולים להשתמש ב-Google Ads API כדי לאחזר אבחון של נתוני אופליין, שמכיל מידע על התקינות הכוללת של תהליכי ההעלאה וההתאמה של ההמרות.
כדי לאחזר את נתוני האבחון האחרונים של נתונים אופליין בחשבון, תוכלו להשתמש באחד מהמקורות הבאים:
offline_conversion_upload_client_summary
הוא צבירת נתונים מצטברים של ניתוחים ברמת החשבון.offline_conversion_upload_conversion_action_summary
(זמין רק בגרסה 17 ואילך) מצטבר אבחון ההעלאה ברמת פעולת ההמרה.
אבחון ברמת החשבון
כדי לאחזר את האבחון של העלאת ההמרות ברמת החשבון, משתמשים בשאילתת GAQL הבאה:
SELECT
customer.id,
offline_conversion_upload_client_summary.alerts,
offline_conversion_upload_client_summary.client,
offline_conversion_upload_client_summary.daily_summaries,
offline_conversion_upload_client_summary.job_summaries,
offline_conversion_upload_client_summary.last_upload_date_time,
offline_conversion_upload_client_summary.pending_event_count,
offline_conversion_upload_client_summary.pending_rate,
offline_conversion_upload_client_summary.status,
offline_conversion_upload_client_summary.success_rate,
offline_conversion_upload_client_summary.successful_event_count,
offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary
השאילתה הזו מחזירה שורות נפרדות של OfflineConversionUploadClientSummary
לכל סוג של לקוח שנעשה בו שימוש בהעלאות האחרונות. לדוגמה, אם לאחרונה העליתם את הנתונים באמצעות Google Ads API וגם באמצעות ממשק המשתמש של Google Ads, התוצאות יכללו רשומות נפרדות של ערכי client
של GOOGLE_ADS_API
ושל GOOGLE_ADS_WEB_CLIENT
.
אבחון ברמה של פעולת ההמרה
כדי לאחזר אבחון של העלאות המרות ברמת פעולת ההמרה, משתמשים בשאילתת GAQL הבאה:
SELECT
offline_conversion_upload_conversion_action_summary.conversion_action_name,
offline_conversion_upload_conversion_action_summary.alerts,
offline_conversion_upload_conversion_action_summary.client,
offline_conversion_upload_conversion_action_summary.daily_summaries,
offline_conversion_upload_conversion_action_summary.job_summaries,
offline_conversion_upload_conversion_action_summary.last_upload_date_time,
offline_conversion_upload_conversion_action_summary.pending_event_count,
offline_conversion_upload_conversion_action_summary.status,
offline_conversion_upload_conversion_action_summary.successful_event_count,
offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >
בדומה לאבחון ברמת החשבון, השאילתה הזו מחזירה שורות OfflineConversionUploadConversionActionSummary
נפרדות לכל סוג של לקוח בהעלאות האחרונות. לדוגמה, אם העליתם לאחרונה נתונים גם באמצעות Google Ads API וגם באמצעות ממשק המשתמש של Google Ads, התוצאות יכילו רשומות נפרדות לערכים של client
עבור GOOGLE_ADS_API
ו-GOOGLE_ADS_WEB_CLIENT
.
איך לפרש את הסיכומים האלה
לכל OfflineConversionUploadClientSummary
או OfflineConversionUploadConversionActionSummary
יש שדה status
שמשקף את המצב הכללי של ההעלאות ב-client
. הוא מכיל גם את הפרטים הבאים:
- המספר הכולל של האירועים שהתקבלו.
- מספר האירועים שעברו עיבוד בהצלחה.
- מספר האירועים בהמתנה (אירועים שעדיין נמצאים בעיבוד).
- שדה
alerts
, שמספק סיכום של השגיאות, שמקובצות לפיOfflineConversionError
.
כל השדות האלה מכילים מידע מהיום הקלנדרי המלא האחרון שבו בוצעו העלאות. אפשר להשתמש במידע הזה כדי להעריך את המצב הנוכחי של ההעלאות שלכם.
בנוסף, כל OfflineConversionUploadClientSummary
או OfflineConversionUploadConversionActionSummary
מכילים שני סוגי דוחות:
daily_summaries
successful_count
,failed_count
ו-pending_count
של בקשות ההעלאה מ-7 הימים האחרונים, שמקובצות לפיdate
ההעלאה.job_summaries
השדות
successful_count
,failed_count
ו-pending_count
של 7 בקשות ההעלאה האחרונות, שמקובצות לפיjob_id
. השדהjob_id
הוא שדה אופציונלי שלUploadClickConversionsRequest
ושלUploadConversionAdjustmentsRequest
. אפשר להגדיר אתjob_id
למספר לא שלילי שקטן מ-2^31
, או לאפשר ל-Google Ads API להקצות לבקשה מזהה משימה שהמערכת יצרה. בלי קשר לאפשרות שנבחרה,UploadClickConversionsResponse
אוUploadConversionAdjustmentsResponse
יחזירו אתjob_id
.במקרים רבים, הקצאת
job_id
משלכם היא שימושית כשיש משימה או תהליך אחד שמעלים מספר גדול של המרות באמצעות מספר בקשות. אם מגדירים אתjob_id
בכל אחת מהבקשות לאותו ערך, אפשר לאחזר רשומה אחת למשימה מ-job_summaries
. אם במקום זאת תאפשרו ל-Google Ads API להקצות ערך שנוצר על ידי המערכת ל-job_id
של כל בקשה, השדהjob_summaries
יכיל רשומה נפרדת לכל בקשה, וכך יהיה קשה יותר לנתח את המצב הכללי של המשימה.
איך משתמשים בסיכומים
כדי לוודא שתהליכי ההעלאה מתעדים המרות ושיפורים כצפוי, כדאי לאחזר מדי פעם את הסיכומים של כל אחד מהחשבונות. אם הערך של status
בסיכום כלשהו הוא לא EXCELLENT
, תוכלו להיעזר ברשימת השגיאות בקטע alerts
כדי לשנות את תהליך ההעלאה ולצמצם או למנוע את השגיאות האלה.
לדוגמה:
אם הסטטוס הוא
NEEDS_ATTENTION
, סימן שחלק משמעותי מפעולות ההעלאה שלכם נכשל. בודקים את השגיאות ב-alerts
ומשנים את תהליך ההעלאה כדי לצמצם או לתקן את השגיאות האלה.אם הסטטוס הוא
NO_RECENT_UPLOADS
, המשמעות היא שלא התקבלו לאחרונה העלאות שלclient
ב-Google Ads. אם מדובר בנתון לא צפוי, כדאי לבדוק את התהליכים שמבצעים העלאות באמצעות הלקוח הזה.לדוגמה, אם הערך של
status
עבורGOOGLE_ADS_API
הואNO_RECENT_UPLOADS
, יכול להיות שתהליך ההעלאה שמשתמש ב-Google Ads API הפסיק לפעול לאחרונה.כדי לבדוק אם היה תאריך העלאה ספציפי או משימה ספציפית ששלחו מספר גדול של אירועים שלא ניתן היה לעבד, בודקים את השדות
successful_count
,failed_count
ו-pending_count
שלdaily_summaries
ו-job_summaries
. אירועים שנמצאים במצב המתנה עשויים להימשך עד 24 שעות.
הגבלות
כשמאחזרים את סיכומי ההעלאות, חשוב לזכור את הדברים הבאים:
Google Ads API מחזיר אבחון של נתוני אופליין רק אם הערך של
customer_id
בבקשהsearchStream
אוsearch
הוא אותו לקוח שבו השתמשתם לאחרונה כדי להעלות המרות.לדוגמה, חשבון לקוח שמוגדר בו מעקב המרות ברמת חשבון הניהול עשוי לא לכלול אבחון כלשהו. עם זאת, אפשר לאחזר את האבחון על ידי שליחת בקשה שבה ה-
customer_id
תואם ל-customer_id
של חשבון הניהול שבו אתם משתמשים בהעלאות.מערכת Google Ads מתייחסת לשגיאות מסוג
CLICK_NOT_FOUND
מהעלאות של המרות משופרות לצורך יצירת לידים כאזהרות. כתוצאה מכך, אםalerts
מכיל רשומה של השגיאה הזו, הפעולות התואמות עדיין נחשבות כפעולות מוצלחות ונכללות ב-successful_event_count
.