跳转到主要内容
POST
请先设置转化跟踪。 Performance Max 会根据您的转化来决定在哪里展示广告以及出价多少。Ayrshare 不会阻止没有转化跟踪的活动,但在您的 Google Ads 账户中设置转化跟踪之前,Google 可能会限制其支出。Ayrshare 不会替您进行设置。当账户没有转化跟踪时,创建响应中会包含一条说明此情况的 warnings 条目。
通过一个请求创建 Google Ads Performance Max 活动。您发送文字和图片 URL,Google 会将它们组合成在搜索、YouTube、展示广告网络、Discover、Gmail 和地图上投放的广告。Ayrshare 会一并创建预算、活动、一个素材资源组及其所有素材资源。如果 Google 拒绝其中任何部分,则不会创建任何内容。 该请求使用通用的 广告活动 结构。读取和更改活动、数据分析以及错误的处理方式与 Google 搜索广告活动 相同。本页介绍不同之处。
  • Google 广告需按账户单独开通。请联系我们以启用该功能。
  • 除非您发送 status: "active",否则新活动以 paused 状态开始。
  • 预算按天计算,使用广告账户的币种,并且绝不会与其他活动共享。
  • 其他币种的支出会按 Open Exchange Rates 提供的当日汇率换算为美元进行结算。使用无法换算的币种的账户会在创建任何内容之前返回 code: 101。
  • 不支持视频。Google 可能会根据您的图片制作视频。

请求头参数

string
必填
每创建一个新活动,请发送一个新的唯一值,例如 UUID。使用相同的键重复请求会返回首次的响应。如果创建请求在 Ayrshare 将活动发送给 Google 之前失败(例如图片尺寸不正确),该键会被释放,因此您可以修正请求后使用相同的键重试。

请求体参数

string
必填
performanceMax.
object
必填
Performance Max 仅接受以下策略。其他任何值都会返回 code: 101。
  • maximizeConversions:在预算内获得尽可能多的转化。
  • targetCpa 搭配 targetCpa:同上,并以该单次转化费用为目标。
  • maximizeConversionValue:在预算内获得尽可能高的转化价值。
  • targetRoas 搭配 targetRoas:同上,并以该广告支出回报率为目标,例如 3.5 表示 350%。
boolean
必填
Google 要求每个活动都提供此声明。
string[]
Google 地理位置 ID,例如 2840 表示美国。省略此字段则定位所有地区。
object
必填

图片

Ayrshare 会从每个图片的 URL 下载图片,并在向 Google 发送任何内容之前对其进行检查:
  • GIF、JPG 或 PNG 格式,每张最大 5120 KB。
  • 不小于上述最小尺寸,并符合其字段的宽高比(误差在 1% 以内)。
  • 所有图片合计最大 45 MB。
  • URL 必须是公开的。私有地址会被拒绝。
未通过检查的图片会返回 code: 101 并指出该图片,例如 platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.