索取報告

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

同步

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

• 只能傳回廣告客戶 和引擎帳戶報表
• 在 Search Ads 360 產生報表前封鎖客戶

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

非同步

您必須傳送初始要求，指定報表中需要的資料。接著，您傳送其他要求給 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 傳回該時區。