監控離線資料診斷

使用 Google Ads API 擷取離線資料診斷資訊，其中包含轉換上傳和調整程序的整體運作情況。

如要擷取帳戶的最新離線資料診斷資訊，請使用下列任一資源：

帳戶層級診斷

如要擷取帳戶層級轉換上傳診斷資訊，請使用下列 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_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 的近期上傳內容。如果這不是預期的結果，請檢查使用該用戶端執行上傳作業的程序。

    舉例來說，如果 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。

上一頁
轉換價值規則
下一頁
報表