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

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

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

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

• offline_conversion_upload_client_summary מקבץ את אבחון הייבוא ברמת החשבון.
• offline_conversion_upload_conversion_action_summary מקבץ את אבחון הייבוא ברמת פעולת ההמרה.

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

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