Google 广告透明中心的广告主 ID（AR 开头）是什么？

在 Google 广告透明中心打开任意一个广告主，地址栏里都是 adstransparency.google.com/advertiser/AR04718236590142738945 这样的地址。这串 AR… 就是广告主 ID：透明中心用来标识一个广告主的键，也就是在搜索、YouTube、展示广告、购物、地图和 Play 上投广告的那个账号主体。它的每一条广告都挂在它下面，地址是 /advertiser/AR…/creative/CR…。

长什么样

	广告主 ID	广告素材 ID
格式	AR 加 20 位数字，共 22 个字符	CR 加 20 位数字，共 22 个字符
指什么	一个广告主	一条广告
在 okdata 里	广告主搜索返回的 id，每条广告的 advertiser.id	每条广告的 id

两个都按字符串存。20 位数字可能超出有符号 64 位整数的范围，表格软件也会把它四舍五入。

名字为什么对不上

广告主 ID 旁边显示的名字不是给营销看的。Google 的帮助文档写明：完成广告客户验证的广告主，显示的是验证时提交的法定名称或商标名称及所在地；没有完成验证的，显示付款资料里的名称。所以一个知名品牌常常挂在公司主体、控股公司或者代理商的名下。按一个品牌名搜，可能会出来好几个广告主 ID，比如母公司一个、某地区的经销商一个。挑之前先看 region 和 ads 估计数。

怎么找、找到之后怎么用

Google 广告主搜索传 query（品牌名或公司名）和 country，最多返回 10 个广告主，带 id、name、region 和 ads（透明中心估计的广告数量）。然后用 Google 广告主的广告传 id 列出广告；也可以不要 ID，直接传 domain=brand.com。返回广告的格式、预览图、首次和最近展示时间，每页 40 条。

要做的事	调用次数	费用
品牌名换成广告主 ID	1	$0.004
一页广告	1	$0.004
一个约有 600 条广告的广告主，全部翻完	1 + 15	$0.064

示例

import os, requests

H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
SEARCH = "https://api.okdata.online/v1/google/advertisers/search"
ADS = "https://api.okdata.online/v1/google/advertisers/ads/list"

found = requests.get(SEARCH, headers=H, timeout=60,
                     params={"query": "Trail Kit", "country": "US"}).json()
if found["code"] != "ok":
    raise SystemExit(found["message"])
for a in found["data"]["items"]:
    print(a["id"], a["name"], a["region"], a["ads"])

advertiser = max(found["data"]["items"], key=lambda a: a["ads"] or 0)
page = requests.get(ADS, headers=H, timeout=60,
                    params={"id": advertiser["id"], "country": "US"}).json()
for ad in page["data"]["items"]:
    print(ad["id"], ad["format"], ad["first_shown_at"], ad["last_shown_at"], ad["url"])

要下一页的 40 条，就把 page.next_cursor 作为 cursor 传回去，page.has_more 为 false 时停。

限制

• Google 广告的列表里没有广告文案、落地页和触达人数，这些字段返回 null，meta.unavailable 里会列出来。每条广告的 url 可以在透明中心里打开它。
• 广告主的 ads 是 Google 的估计值，和你翻出来的条数对不上很正常。
• country 只看在某个国家展示过的广告，format=text|image|video 只看某一种；两个都不传就是全部。

完整的导出流程，见怎么导出竞品在 Google 广告透明中心的广告。