Top-Rated Team
简体中文

报告 Google Ads 账户的搜索字词

一次调用,问账户人们实际搜了什么、花了多少、带来了什么,而且不改变任何东西。

搜索字词是人们实际输入的字词,而不是你买下的关键字。两者之间的差距,是大部分浪费的花费所在,而读取它只需一次不可能改变任何东西的调用。

调用

curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \
  -H "X-API-KEY: $MAKEHYBRID_KEY" \
  --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \
  --data-urlencode 'max_rows=200'

查询用的是 Google Ads Query Language,Google 能报告的一切都可以这样询问:广告系列、广告组、关键字、广告、素材资源、预算、转化、受众、更改历史。每次回答最多 200 行。

读懂返回的内容

这个做法里的任何一步都改变不了账户。报告是读取,改变东西的调用是另一个,而且另一头有一个人。

常见问题

我需要懂 GAQL 吗?

如果要手写查询,需要,不过它和 SQL 很接近,不用专门学也能读懂。实际上,这个密钥上的 AI 智能体会根据你用话说出的要求写出查询,运行它,再把各行读给你听。

为什么用微单位?

这是 Google 报告金额的方式,所以这里也这样回答:以百万分之一为单位的整数,避免了来回传递货币小数时的舍入误差。除以一百万,就得到人们会说出口的金额。

报告能碰到账户吗?

不能。报告调用会拒绝任何不是 SELECT 的内容,所以没有哪个查询能通过它改动账户 — 在这里出错,代价只是得到一个令人困惑的回答,别无其他。

让它自己运转起来

说说你的业务是做什么的,它就成了你自己的服务和产品合二为一:工作自己运转,用的是你的名字、你的账号和你的 AI 密钥。前 30 天免费,这里的一切都不需要工程师。

开始试用