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

אפשר להשתמש ב-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_id,
  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 = <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, סימן שלאחרונה לא בוצעו ייבואים אל Google Ads עבור client. אם זה לא צפוי, כדאי לבדוק את התהליכים שמבצעים ייבוא באמצעות הלקוח הזה.

    לדוגמה, אם הערך של 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.