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

שימוש ב-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
A 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.