מעקב אחרי ניתוחים של נתונים אופליין

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

כדי לאחזר את נתוני האבחון האחרונים של נתונים אופליין בחשבון, תוכלו להשתמש באחד מהמקורות הבאים:

אבחון ברמת החשבון

כדי לאחזר את האבחון של העלאת ההמרות ברמת החשבון, משתמשים בשאילתת 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.