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