報表總覽

Campaign Manager 360 API 提供多種方式，可擷取透過 Campaign Manager 360 投放的廣告資料。

報表服務

使用 Reports 服務產生報表時，需要經過多個步驟的工作流程，才能設定、產生及擷取報表檔案 (例如 CSV 或 Excel 格式)。這是 Campaign Manager 360 API 的標準報表路徑，適用於大型資料集、自動排程指令碼，或會耗用檔案的下游應用程式。

工作流程通常包含下列步驟：

1. 定義或找出 Report 資源 (指定維度、指標、日期範圍和篩選器)，並以專屬報表 ID 儲存。請參閱「建立及更新報表」。
2. 呼叫 reports.run 方法，執行報表產生作業。這會將報表執行作業加入佇列，並傳回預留位置 File 資源。請參閱「找出並執行報表」。
3. 定期檢查 File 資源的狀態。由於這項程序是以非同步方式執行，檔案狀態會先顯示為 PROCESSING，完成後則會轉為 REPORT_AVAILABLE。請參閱「找出並執行報表」。
4. 報表產生完畢後，即可擷取檔案內容 (CSV 或 Excel)。請參閱「下載報表」。

同步執行報表

如要為少量資料產生報表檔案 (CSV 或 Excel)，可以呼叫 reports.run 方法並將 synchronous 參數設為 true，以同步執行報表。API 會嘗試在短暫的逾時期間內生成報表。如果執行時間較長，系統會自動將報告執行作業移回非同步佇列。

詳情請參閱「同步報表」。

查詢報表資料

使用 reportData.query 方法直接查詢報表資料，不必產生報表檔案。

• 您不必建立及儲存 Report 資源，而是直接在要求中指定維度、指標和其他篩選或排序條件。
• 回應會包含結構化報表資料，因此您不必輪詢及下載產生的檔案。
• 要求會同步執行，時間限制為 60 秒。

詳情請參閱「查詢 JSON 報表資料」。