这是小心同学把腾讯广告开发者平台啃到「接口级」之后,写给小古的一份投屏版笔记。三件事讲透:学到了什么、准备怎么用、这堆接口到底能为我们赚什么。
Marketing API = 腾讯把「投广告、管账户、回传转化」开成程序可调用的一堆接口。它的本质是给心源接上公域获客的水龙头:花钱买流量 → 客人到店 → 流水进账 → 再按 DRC 自动分钱。
一句话:Marketing API 管「花钱买客」,DRC 管「赚钱分账」,合起来是心源一条完整的资金闭环。
账户管理 / 营销资产 / 广告管理 / 数据洞察 / 数据接入 / 人群管理,外加 oCPA「眼睛机制」。
成本仪表盘、老客扩新客、门店包、动态商品广告、蹊径企微获客、工作台调度。
查消耗、转资金、建广告、看报表、找相似人、回传转化、管门店与商品。
把英文全翻译成人话,接口名用等宽字标出,一眼能分清「概念」和「代码」。
它是腾讯广告官方开给程序用的「自动操作广告账户」的接口。跟你在网页后台点鼠标,管的是同一个广告账户——只是后台给人用手点,API 给机器用代码干。
对心源的意义:美发店投腾讯广告,走 API 就能把「花钱投广告」做成自动化、可编程,不用人天天登后台盯。
这是理解所有广告接口的地基,像「文件夹 → 子文件夹 → 文件」。
| 模块 | 人话 | 对心源意味着什么 |
|---|---|---|
| 账户管理 | 账户信息、资质、资金流水 | 实时看「花了多少钱」,管好充值与转账 |
| 营销资产 | 落地页、素材、营销链路 | 三杯色的广告图、落地页、链路都在这里管 |
| 广告管理 | 广告/创意的增删改查 | 自动建广告、改出价、开关投放 |
| 数据洞察 | 多维度报表 | 日报/小时报,看投放效果 |
| 数据接入 | 回传用户行为 | 把「谁到店/谁加粉」回传,喂给 oCPA |
| 人群管理 | 行为/关键词/Lookalike 找人 | 用老客画像钓相似的新客 |
oCPA = Optimized CPA,人话叫「按转化效果自动出价」。你只定一个目标:「我每拿到 1 个有效转化(加粉/到店/留资)最多花 X 元」,剩下的交给机器的转化预估模型:实时估算每次点击的转化价值,自动出价,按点击扣费。
系统必须知道「到底谁真的转化了」——这叫回传 click_id 归因。不回传,系统就是瞎子,只能瞎投。所以「数据接入」模块不是可选项,是 oCPA 的命根子。
以下是深扒到「接口名」级别的一张总表,分六类。接口名用等宽字,是官方文档里真实存在的调用名。
| 类别 | 接口 | 干什么(人话) |
|---|---|---|
| 管钱 | realtime_cost/get fund_transfer/add | 查账户实时消耗;账户间划拨资金 |
| 管广告 | adgroups dynamic_creatives update_bid_amount update_configured_status | 广告组增删改查;动态创意;改出价;开关投放 |
| 看数据 | daily_reports hourly_reports targeting_tag_reports | 日报表;小时报表;定向标签报表 |
| 找人 | custom_audiences/add | 建人群包(含 Lookalike 相似扩量) |
| 回传 | user_actions/add | 上报转化:预约 / 下单 / 确认有效线索,click_id 必传 |
| 管资产 | local_stores product_items xijing_page leads_list | 门店;商品;蹊径落地页;线索列表 |
把接口拼起来,落到心源的真业务上,能做成六件事。按「先花钱、再分钱、最后闭环」排序。
把「投广告花的钱」和「DRC 分出去的钱」放在同一块看板。花出去每分钱,都能看到它换回多少流水、分走多少。花钱侧、分钱侧两边都可编程、可对账。
把到过店、染过三杯色的老客打包成「种子人群」,让系统全网去找「像他们的人」投广告——用老客画像钓新客,比盲投准得多。
10 家店打包统一管,但不同城市竞争不同、出价不同:贵城市出高价、便宜城市出低价,各店各价,一店一策。
三杯色 12 个色号用即梦 AI 造图,系统看「看广告的人」的特征自动推最搭的颜色——千人千色,看人推色。
广告点进来落到蹊径落地页,客人加企微/留电话,系统把 click_id 拼到线索上——追得到「这条客是哪个广告带来的」,闭环归因。
心源工作台从「只记分账」升级成「能调度投放」的指挥中心——从账房先生,变成总调度。
先做①成本仪表盘(能看、能对账,风险最低)→ 再做⑤蹊径×企微获客(先跑通一条「广告→加粉→归因」链路)→ 再上②Lookalike 和 ④DPA 动态商品广告(要有人群和素材积累)→ 最后才是 ③门店包 和 ⑥总调度(规模化)。
不玩虚的,把「接口能力」一条条对到「心源要干的事」上。
| 心源要干的事 | 用到的接口能力 | 一句话效果 |
|---|---|---|
| 知道每天广告花了多少 | realtime_cost / daily_reports | 花多少、赚多少,一眼看穿 |
| 把预算在账户间挪动 | fund_transfer | 钱不够随时调,不卡投放 |
| 自动建广告、调出价 | adgroups / update_bid_amount | 不用人工登后台,机器自动盯 |
| 用老客找相似新客 | custom_audiences(Lookalike) | 精准获客,少花冤枉钱 |
| 回传「谁真的到店/加粉」 | user_actions / click_id | 喂饱 oCPA,越投越准 |
| 管门店、商品、落地页、线索 | local_stores / product_items / xijing_page / leads_list | 资产、线索全在系统里流转 |
把接口按「重要性」分三档,投屏时一眼扫到重点:
命根子 · user_actions/add 命根子 · click_id 归因 关键 · realtime_cost 关键 · custom_audiences 常规 · 其余接口
没有 click_id 回传,oCPA 就瞎了,钱花出去没效果;没有 realtime_cost,就看不住花销。这两类必须最先打通。
开工前必须知道的三条硬约束,实事求是,不粉饰。
加粉类广告需要「基础授权 + 转化宝授权」双授权才走得通。这一步不办,后面全白搭。
oCPA 是「给眼睛」的智能投放:不回传 click_id 归因 = 盲投。数据接入不是可选优化,是前置条件。
我们的判断要诚实——朋友圈广告对美发不是「最先进的技术」,而是最适配:强信任、公私域无缝、无平台佣金。选它是因为合适,不是因为它新。
Marketing API(花钱买客)→ 门店产生流水 → DRC(按净流水自动分成、T+1 打款)。花出去的钱,最终要从这条闭环里赚回来,两头都要可编程、可对账。