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

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