索取報告

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能,協助您建立自訂報表,並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API

按照「我的第一個應用程式」中的說明設定用戶端應用程式後,您可使用 Search Ads 360 API 要求及下載報表。您可以發出下列任一類型的要求:

同步

只需要一個要求,並以 JSON 格式的回應傳回報表。同步要求:

如果您要要求大型的廣告客戶或引擎帳戶報表,建議您採用非同步方法。

非同步

您必須傳送初始要求,指定報表中需要的資料。接著,您傳送其他要求給 Search Ads 360 意見調查。Search Ads 360 產生報表後,您會傳送要求,以一或多個檔案的形式下載報表。非同步要求:

  • 可傳回任何報表類型
  • 將超大型報表分割成多個檔案
  • 將報告格式化為 CSV 或 TSV

資料模型:資料列和資料欄

Search Ads 360 會將報表中的資料整理成列和欄。 傳回的資料列取決於要求的報表類型。例如,如果您要求產生關鍵字報表,則每一列都會包含單一關鍵字的相關資料。如需所有報表類型的清單,請參閱報表類型參考資料。 您可以為報表要求中的每個欄命名,藉此指定報表中的資料欄。如需每種報表類型可傳回的資料欄清單,請參閱報表類型參考資料。

資料欄行為

資料欄的行為視資料欄包含的資料類型而定 (「報表類型」參考資料會顯示各欄的行為):

  • 屬性欄:屬性欄含有用來設定或識別廣告活動中的實體的資料,例如廣告活動名稱或關鍵字出價。無論要求中指定的任何日期或日期範圍為何,Search Ads 360 API 一律會傳回屬性欄目前的值。舉例來說,如果您昨天將關鍵字出價從 2.00 改成 1.50,然後要求取得上個月的資料報表,報表就會傳回 1.50 的關鍵字出價值。

  • 指標欄:指標欄包含廣告活動成效相關資料,例如廣告點擊次數、Floodlight 代碼記錄的造訪次數 或收益。除非您指定一天的時間範圍,API 會傳回指標欄的匯總值。舉例來說,如果您要求取得上個月資料的報表,API 就會傳回上個月的點擊總數。

  • 區隔資料欄:區隔欄會將資料拆分成不同的資料列。舉例來說,date 是一種區隔欄,您可以為多種報表指定區隔欄。如果您在關鍵字報表中指定 date 欄,日期範圍為 2013-01-01 到 2013-01-07,API 就會針對每個關鍵字傳回七列,分別對應一天並顯示當天的指標。請參閱「區隔報表」一文。

貨幣

您必須使用報表要求來指定金額資料的貨幣 (dailyBudget 等屬性和 cost 等指標)。您可以指定下列任一項目:

  • 代理商的貨幣 (如果報表範圍為某個代理商、廣告客戶或引擎帳戶)。
  • 廣告客戶的貨幣 (如果報表範圍限定在廣告客戶或引擎帳戶)。
  • 引擎帳戶的貨幣 (如果報表範圍是引擎帳戶層級)。
  • USD

使用 Reports.request.statisticsCurrency 要求屬性即可指定貨幣。

報表本身會標示 Reports.statisticsCurrencyCode 屬性中的貨幣。

時區

Search Ads 360 指標的儲存日期不含時區。這些日期會對應至引擎指標 (例如點擊、曝光和造訪) 的引擎帳戶時區,以及轉換指標 (例如操作、交易和收益) 的 Campaign Manager 聯播網時區。如果報表中的每個指標都來自相同時區,要求中會傳回該時區。否則系統不會傳回時區。 要求可將 Reports.request.verifySingleTimeZone: true 設為失敗報表,指出顯示多個時區的指標。

如果報表中顯示的所有指標都來自同一個時區,系統會以 Reports.statisticsTimeZoneReports 傳回該時區。