本頁面由 Cloud Translation API 翻譯而成。

監控離線資料診斷

使用 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 上傳的結果包含的 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 UI 上傳的結果包含的 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

前 7 名的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 則包含單獨的項目，以便分析 API 的整體健康狀態工作變得更具挑戰性

如何使用摘要

為確保上傳程序能將轉換和強化項目記錄下來，預期會定期擷取每個帳戶的摘要。如果所有摘要的 status 都不是 EXCELLENT，請參考下方的錯誤清單。 alerts，引導您修改上傳程序，以減少或縮減檔案數量並且排除這些錯誤

例如：

如果狀態為 NEEDS_ATTENTION，則上傳作業失敗。查看 alerts 底下的錯誤並修改以減少或排除這些錯誤。
如果狀態為 NO_RECENT_UPLOADS，則 Google Ads 最近並未收到任何「client」的上傳項目。如果這不符合預期，請查看程序以使用該用戶端上傳資料

例如，如果 GOOGLE_ADS_API 的 status 為 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。

轉換價值規則

報表