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