監控離線資料診斷

使用 Google Ads API 擷取離線資料診斷，其中包含轉換上傳和調整程序整體健康狀態的相關資訊。

如要擷取帳戶的最新離線資料診斷資訊，請使用 GoogleAdsService 針對 offline_conversion_upload_client_summary 資源傳送下列查詢：

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.resource_name,
  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 值的個別項目。

每個 OfflineConversionUploadClientSummary 都有 status 欄位，反映 client 上傳作業的整體健康狀態。這個專區還包含收到的事件總數、成功處理的事件數，以及提供錯誤摘要的 alerts 欄位 (按 OfflineConversionError 分組)。這些欄位皆包含最近一個完整日曆日期的上傳資訊。你可以利用這項資訊評估上傳內容的「目前」狀態。

此外，每個 OfflineConversionUploadClientSummary 都包含兩種不同類型的報表：

daily_summaries
過去 7 天內的上傳要求的 successful_count 和 failed_count，按照上傳 date 分組。
job_summaries

最近 7 個上傳要求的 successful_count 和 failed_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，判斷是否有特定的上傳日期，或有傳送大量事件未成功處理的工作。

限制

擷取上傳摘要時，請注意下列事項：

  • 如果 searchStream 或 search 要求的 customer_id 是您最近上傳轉換資料的顧客，Google Ads API 只會傳回離線資料診斷結果。

    舉例來說，使用跨帳戶轉換追蹤的客戶帳戶可能不含任何診斷資料。不過，您可以傳送要求，讓 customer_id 與上傳時使用的管理員帳戶 customer_id 相符，藉此擷取診斷資料。

  • Google Ads 會將待開發客戶強化轉換上傳的 CLICK_NOT_FOUND 錯誤視為警告。因此，如果 alerts 包含這個錯誤的項目，則對應的作業仍會視為成功，並納入 successful_event_count。

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