改善轉換調整項上傳功能

2024 年 8 月 12 日，星期一

自 2024 年 9 月 9 日起，Google Ads API 使用者不必再等候 24 小時，就能上傳轉換調整項。只要原始轉換已上傳或由 Google 代碼記錄，即可立即上傳。

也就是說，您不必再追蹤 24 小時的時間範圍，就能上傳轉換調整項，也不必再檢查特定錯誤代碼，並重試這些上傳要求。

具體來說，下列異動將會生效：

1. UploadConversionAdjustments 方法的回應不會再傳回下列錯誤代碼，診斷報告也不會再顯示這些代碼：

   • ConversionAdjustmentUploadError.TOO_RECENT_CONVERSION_ACTION
   • ConversionAdjustmentUploadError.TOO_RECENT_CONVERSION
2. 先前因這些錯誤代碼而遭拒的轉換調整項，在處理前會計入診斷中的 pending_count，處理後則會計入 successful_count 或 failed_count 欄位。這項作業最多可能需要 24 小時。

以下說明這些異動對舊版 Google Ads API (v15 和 v16) 的影響：

1. UploadConversionAdjustments 方法的回應不會再傳回下列錯誤代碼，診斷報告也不會再顯示這些代碼：
   • ConversionAdjustmentUploadError.TOO_RECENT_CONVERSION_ACTION
   • ConversionAdjustmentUploadError.TOO_RECENT_CONVERSION
2. 在診斷報告中，凡是會觸發這些程式碼的轉換，在處理期間都會計入total_event_count指標。處理完成後，系統會將這些資料計入 successful_count 或 failed_count。這項作業最多可能需要 24 小時。

我需要做什麼？

1. 請從應用程式中移除任何等待上傳調整項的邏輯，並在原始轉換上傳後，隨時開始上傳轉換調整項。
2. 修改應用程式邏輯和業務流程，避免追蹤即將移除的兩項轉換調整項錯誤。
3. 如果您仰賴成功或失敗的事件計數指標，請重新檢視應用程式邏輯，並瞭解使用第 17 版時，部分上傳的事件有時可能會顯示為待處理。

如有任何疑問或需要協助，請參閱 Google Ads API 支援頁面，瞭解可用的支援選項。

- Ben Karl，Google Ads API 團隊代表

標籤： conversions、 google-ads、 google-ads-api、 offline-conversions