神经末梢理解 · 腾讯广告 Marketing API

腾讯广告 Marketing APIdevelopers.e.qq.com · 接口级全解

这是小心同学把腾讯广告开发者平台啃到「接口级」之后,写给小古的一份投屏版笔记。三件事讲透:学到了什么、准备怎么用、这堆接口到底能为我们赚什么。

一句话结论(先给结论)

Marketing API = 腾讯把「投广告、管账户、回传转化」开成程序可调用的一堆接口。它的本质是给心源接上公域获客的水龙头:花钱买流量 → 客人到店 → 流水进账 → 再按 DRC 自动分钱。
一句话:Marketing API 管「花钱买客」,DRC 管「赚钱分账」,合起来是心源一条完整的资金闭环。

壹 · 学到了什么

六大模块 + 五层账户 + 一张接口清单

账户管理 / 营销资产 / 广告管理 / 数据洞察 / 数据接入 / 人群管理,外加 oCPA「眼睛机制」。

贰 · 准备怎么用

六大创造,从仪表盘到总调度

成本仪表盘、老客扩新客、门店包、动态商品广告、蹊径企微获客、工作台调度。

叁 · 能为我们做什么

15 类接口,对应 6 件心源真事

查消耗、转资金、建广告、看报表、找相似人、回传转化、管门店与商品。

01

我学到了什么

把英文全翻译成人话,接口名用等宽字标出,一眼能分清「概念」和「代码」。

概念

Marketing API 是什么

它是腾讯广告官方开给程序用的「自动操作广告账户」的接口。跟你在网页后台点鼠标,管的是同一个广告账户——只是后台给人用手点,API 给机器用代码干。

对心源的意义:美发店投腾讯广告,走 API 就能把「花钱投广告」做成自动化、可编程,不用人天天登后台盯。

结构

账户结构:五层,从大到小

这是理解所有广告接口的地基,像「文件夹 → 子文件夹 → 文件」。

推广计划campaign一类投放的总集合
›
广告组adgroup共享时间/受众/版位/出价
›
广告ad最小展示单元
›
创意adcreative文字/图/视频的组合
六大核心模块

腾讯开放平台把能力分成六大块

模块人话对心源意味着什么
账户管理账户信息、资质、资金流水实时看「花了多少钱」,管好充值与转账
营销资产落地页、素材、营销链路三杯色的广告图、落地页、链路都在这里管
广告管理广告/创意的增删改查自动建广告、改出价、开关投放
数据洞察多维度报表日报/小时报,看投放效果
数据接入回传用户行为把「谁到店/谁加粉」回传,喂给 oCPA
人群管理行为/关键词/Lookalike 找人用老客画像钓相似的新客
机制

oCPA:智能出价的「眼睛机制」

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
门店;商品;蹊径落地页;线索列表
02

准备怎么用 · 六大创造

把接口拼起来,落到心源的真业务上,能做成六件事。按「先花钱、再分钱、最后闭环」排序。

1

DRC 成本仪表盘

realtime_cost · daily_reports ↔ DRC

把「投广告花的钱」和「DRC 分出去的钱」放在同一块看板。花出去每分钱,都能看到它换回多少流水、分走多少。花钱侧、分钱侧两边都可编程、可对账。

2

Lookalike 老客扩新客

custom_audiences/add · Lookalike

把到过店、染过三杯色的老客打包成「种子人群」,让系统全网去找「像他们的人」投广告——用老客画像钓新客,比盲投准得多。

3

10 店门店包 + 分城市出价

local_stores · update_bid_amount

10 家店打包统一管,但不同城市竞争不同、出价不同:贵城市出高价、便宜城市出低价,各店各价,一店一策。

4

DPA 动态商品广告 × 三杯色 12 SKU

product_items · dynamic_creatives

三杯色 12 个色号用即梦 AI 造图,系统看「看广告的人」的特征自动推最搭的颜色——千人千色,看人推色。

5

蹊径落地页 × 企微获客

xijing_page · leads_list · user_actions

广告点进来落到蹊径落地页,客人加企微/留电话,系统把 click_id 拼到线索上——追得到「这条客是哪个广告带来的」,闭环归因。

6

工作台从记账到调度

全接口 · 统一调度

心源工作台从「只记分账」升级成「能调度投放」的指挥中心——从账房先生,变成总调度。

落地顺序建议

先做①成本仪表盘(能看、能对账,风险最低)→ 再做⑤蹊径×企微获客(先跑通一条「广告→加粉→归因」链路)→ 再上②Lookalike 和 ④DPA 动态商品广告(要有人群和素材积累)→ 最后才是 ③门店包 和 ⑥总调度(规模化)。

03

API 具体能为我们做什么

不玩虚的,把「接口能力」一条条对到「心源要干的事」上。

六件真事 × 接口能力对照

心源要干的事用到的接口能力一句话效果
知道每天广告花了多少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,就看不住花销。这两类必须最先打通。

04

门槛与铁律

开工前必须知道的三条硬约束,实事求是,不粉饰。

① 授权门槛(2026 起)

加粉类广告需要「基础授权 + 转化宝授权」双授权才走得通。这一步不办,后面全白搭。

② oCPA 必须回传

oCPA 是「给眼睛」的智能投放:不回传 click_id 归因 = 盲投。数据接入不是可选优化,是前置条件。

③ 朋友圈广告:最「适配」而非最「先进」

我们的判断要诚实——朋友圈广告对美发不是「最先进的技术」,而是最适配:强信任、公私域无缝、无平台佣金。选它是因为合适,不是因为它新。

一条资金闭环(反复记住)

Marketing API(花钱买客)→ 门店产生流水 → DRC(按净流水自动分成、T+1 打款)。花出去的钱,最终要从这条闭环里赚回来,两头都要可编程、可对账。

神经末梢理解 · v1.0 · 2026-11-11 · 制作:小心同学 · 阅读:小古 来源: 腾讯广告开发者平台 · oCPA 官方 FAQ