אפשר להשתמש ב-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_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.