使用 Google Ads API 擷取離線資料診斷資訊，其中包含轉換匯入和調整程序的整體健康狀況資訊。
如要擷取帳戶的最新離線資料診斷資訊，請使用下列任一資源：
offline_conversion_upload_client_summary會在帳戶層級匯總匯入診斷資訊。offline_conversion_upload_conversion_action_summary(僅適用於 v17 以上版本) 會在轉換動作層級匯總匯入診斷資訊。
帳戶層級診斷
如要擷取帳戶層級轉換上傳診斷資訊，請使用下列 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 UI 匯入資料，結果就會包含 GOOGLE_ADS_API 和 GOOGLE_ADS_WEB_CLIENT 的 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 UI 匯入資料，結果就會包含 GOOGLE_ADS_API 和 GOOGLE_ADS_WEB_CLIENT 的 client 值的個別項目。
如何解讀這些摘要
每個 OfflineConversionUploadClientSummary 或 OfflineConversionUploadConversionActionSummary 都有一個 status 欄位，可反映 client 整體健康狀態。並包含下列資訊：
- 收到的事件總數。
- 已成功處理的事件數量。
- 待處理事件 (仍在處理中的事件) 數量。
alerts欄位，提供錯誤摘要，並按OfflineConversionError分組。
所有這些欄位都包含最近一次完整日曆日的匯入資訊。您可以參考這項資訊，評估匯入作業的目前健康狀態。
此外，每個 OfflineConversionUploadClientSummary 或 OfflineConversionUploadConversionActionSummary 都包含兩種不同類型的報表：
daily_summaries- 過去 7 天內的
successful_count、failed_count和pending_count匯入要求，依匯入date分組。 job_summaries7 筆最新匯入要求的
successful_count、failed_count和pending_count，按job_id分組。job_id是UploadClickConversionsRequest和UploadConversionAdjustmentsRequest的選用欄位。您可以將job_id設為小於2^31的非負數字，或是讓 Google Ads API 為要求指派系統產生的工作 ID。無論您選擇哪個選項，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的匯入資料。如果這不是預期的結果，請檢查使用該用戶端執行匯入作業的程序。舉例來說，如果
GOOGLE_ADS_API的status為NO_RECENT_UPLOADS，可能表示最近已停止使用 Google Ads API 的匯入程序。如要判斷是否有特定匯入日期或工作傳送大量無法處理的事件，請檢查
daily_summaries和job_summaries的successful_count、failed_count和pending_count。處於待處理狀態的事件最慢可能需要 24 小時才能完成。
如要進一步瞭解如何改善離線資料診斷，請前往說明中心。
限制
擷取匯入摘要時，請注意下列事項：
只有在
searchStream或search要求的customer_id與您最近用於匯入轉換的客戶相同，Google Ads API 才會傳回離線資料診斷資訊。舉例來說，使用跨帳戶轉換追蹤的客戶帳戶可能不會包含任何診斷資訊。不過，您可以傳送要求來擷取診斷資訊，其中
customer_id必須與您在匯入作業中使用的管理員帳戶的customer_id相符。Google Ads 會將 待開發客戶的強化轉換匯入作業中的
CLICK_NOT_FOUND錯誤視為警告。因此，如果alerts包含此錯誤的項目，系統仍會將對應的作業視為成功，並納入successful_event_count。