跳转到主要内容
POST
通过一个请求创建 Google Ads 搜索广告活动。Ayrshare 会一并创建预算、活动、一个广告组、您的关键字、一个自适应搜索广告以及地理位置定位。如果 Google 拒绝其中任何部分,则不会创建任何内容。 该请求使用通用的 广告活动 结构。本页介绍 Google 特有的内容。
  • Google 广告需按账户单独开通。请联系我们以启用该功能。
  • 请先在 Social Accounts(社交账户)页面关联 Google Ads。accountId 是 10 位数的 Google Ads 客户 ID,可带或不带连字符(123-456-7890)。
  • 您关联的 Google 用户必须能直接访问该广告账户。仅能通过经理账户访问的账户不会被列出,目前也无法使用:请将该用户添加到广告账户本身。经理账户同样不会被列出:经理账户无法包含活动。
  • 除非您发送 status: "active",否则新活动以 paused 状态开始。
  • 预算按天计算,使用广告账户的币种。请勿发送 budget.currency:否则会返回 code: 101。
  • 其他币种的支出会按 Open Exchange Rates 提供的当日汇率换算为美元进行结算。使用无法换算的币种的账户会在创建任何内容之前返回 code: 101。
  • 广告仅在 Google 搜索上展示,不会在搜索网络合作伙伴或展示广告网络上展示。
转化跟踪。 只有在您的 Google Ads 账户中设置了转化跟踪后,maximizeConversions 才能生效。Ayrshare 不会替您进行设置。如果没有设置转化跟踪,请使用 maximizeClicks 或 manualCpc。

请求头参数

string
必填
每创建一个新活动,请发送一个新的唯一值,例如 UUID。使用相同的键重复请求会返回首次的响应,且不会创建任何新内容。如果创建请求在 Ayrshare 将活动发送给 Google 之前失败,该键会被释放,因此您可以修正请求后使用相同的键重试。这包括 Ayrshare 拒绝的值(例如不支持的出价策略)、使用无法换算为美元的币种的账户,以及 Ayrshare 事先进行的账户检查的任何失败(包括 Google 拒绝该检查)。如果创建请求在活动已发送给 Google 之后失败,则会保留其响应:请使用新的键重试。

请求体参数

通用字段的用法如 广告活动 中所述。在 Google 上:
string
必填
search.
string
必填
maximizeClicks、manualCpc 或 maximizeConversions。其他任何值都会返回 code: 101。
boolean
必填
Google 要求每个活动都提供此声明。只要账户中有任何活动未声明,Google 就会拒绝对该账户中活动的所有更改。
object
Google 按广告账户时区的整天进行排期。start 从当天的 00:00:00 开始,end 在当天的 23:59:59 结束;您发送的时间仅用于确定日期。start 可以是今天,但不能是更早的日期。如需投放一天的活动,请为 start 和 end 发送相同的日期。end 早于 start 所在日期会返回 code: 101。
object
Google 根据您广告文字的语言将搜索广告匹配给用户,因此没有语言设置。发送 targeting.languages 会返回 code: 101。
object
必填

错误