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