使用 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 上傳,結果會包含 client
和 GOOGLE_ADS_API
和 GOOGLE_ADS_WEB_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
。