跳转到主要内容
GET
实时获取您通过 Ayrshare 创建的活动、广告组或广告的 Google Ads 表现数据,每天一行。
  • 数据在您调用时从 Google 读取,而不是来自每晚生成的副本。
  • 所有金额均使用广告账户的币种,并在每一行的 currency 中返回。
  • Google 会略去没有任何活动的日期,因此某个日期范围返回的行数可能少于其天数。
  • Google 会在某天结束后的几天内调整当天的费用和转化,因此最近几天的数据在不同读取之间可能会发生变化。
  • 对于 Performance Max 活动,请使用 level=campaign 并提供活动 ID。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 不报告搜索广告的唯一覆盖人数;breakdowns 在 Google 上也不可用。请求其中任何一项都会返回 code: 101。

分页

所有行都在一个响应中返回,因此 nextCursor 始终为 null。

错误