使用 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
。