按照「我的第一個應用程式」中的說明設定用戶端應用程式後,您可使用 Search Ads 360 API 要求及下載報表。您可以發出下列任一類型的要求:
資料模型:資料列和資料欄
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
傳回該時區。