監控離線資料診斷

使用 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_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，並依匯入 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 會包含每個要求的個別項目，這可能會增加分析整體工作健康狀態的難度。

如何使用摘要

為確保匯入程序能如預期記錄轉換和強化功能，請定期擷取每個帳戶的摘要。如果任何摘要的 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 小時才能完成。

如要進一步瞭解如何改善離線資料診斷，請前往說明中心。

限制

擷取匯入摘要時，請注意下列事項：

只有在 customer_id 的 searchStream 或 search 要求與您最近用來匯入轉換的顧客相同時，Google Ads API 才會傳回離線資料診斷結果。

舉例來說，使用跨帳戶轉換追蹤的客戶帳戶可能不會包含任何診斷資訊。不過，您可以傳送要求，其中 customer_id 與您在匯入作業中使用的管理員帳戶 customer_id 相符，藉此擷取診斷資訊。
Google Ads 會將待開發客戶強化轉換匯入作業的 CLICK_NOT_FOUND 錯誤視為警告。因此，如果 alerts 包含這項錯誤的項目，對應的作業仍會視為成功，並納入 successful_event_count。

自訂轉換變數

報表