跳轉到主要內容
GET
即時取得您透過 Ayrshare 建立的廣告活動、廣告群組或廣告的 Google Ads 成效,每天一列。
  • 數據會在您呼叫時從 Google 讀取,而不是來自每晚製作的副本。
  • 所有金額皆以廣告帳戶的貨幣計算,並在每一列的 currency 中返回。
  • Google 會省略沒有活動的日期,因此一個日期範圍返回的列數可能少於其天數。
  • Google 會在某天結束後的幾天內調整該天的費用及轉換次數,因此最近幾天的數據在不同次讀取之間可能會有所變動。
  • 對於 Performance Max 廣告活動,請搭配廣告活動 ID 使用 level=campaign。Performance Max 廣告活動本身沒有廣告,因此 level=ad 不會返回任何列。

請求頭參數

查詢參數

string
必填
每一列報告的對象:campaign(建立時返回的 campaignId)、adSet(建立時返回的 adGroupId)或 ad(建立時返回的 adId)。
string
必填
以逗號分隔的廣告活動、廣告群組或廣告 ID,最多 50 個。它們必須全部屬於同一個廣告帳戶。
string
10 位數的 Google Ads 客戶 ID,可包含或不含連字號(123-456-7890)。廣告及廣告群組報表會讀取您在此指定的廣告帳戶。若未指定,廣告報表會搜尋您的 Google Ads 連結可觸及的所有廣告帳戶,最多 25 個;廣告群組報表僅在您的連結只觸及一個廣告帳戶時才能運作。當您的連結觸及超過 25 個廣告帳戶,或在廣告群組報表中觸及超過一個帳戶時,請指定帳戶。否則請求會返回 code: 101。
string
以逗號分隔的要返回的指標。省略則返回所有指標。請參閱 指標。
string
預設值:"30 天前"
第一天,格式為 YYYY-MM-DD。Google 會保留 37 個月的每日數據;更早的 startDate 會返回 code: 101。
string
預設值:"今天"
最後一天,格式為 YYYY-MM-DD。

指標

在您的 Google Ads 帳戶設定轉換追蹤之前,actions 和 conversionValue 都會維持為 0。無法使用 reach,因為 Google 不提供搜尋廣告的不重複觸及人數;Google 也不提供 breakdowns。要求其中任一項都會返回 code: 101。

分頁

所有列都會在同一個回應中返回,因此 nextCursor 一律為 null。

錯誤