接口文档SDK业务专题开发者工具

API应用参考案例

Tencent Marketing API为客户提供了一整套营销接口服务,不同的诉求的客户均可以自由组合接口,从而实现自身个性化的投放营销能力。通过下文,将介绍一些常见的API使用场景,希望可以开拓你的开发应用思路,使API成为你提效提速的利器。

场景一:跨媒体素材库

通过API你可以搭建一个自身的跨媒体素材库,实现设计师团队与广告投放的无缝对接,具体可以参考下述步骤实现:

步骤一:

事项:创建本地素材库,支持设计师上传素材
接口:不涉及,本地处理

步骤二:

事项:选择素材上传至特定的广告主账号中。你可以选择同时上传多个素材至多个媒体、多个账号中,获得图片id和视频id、MD5、预览地址等
接口:images/addvideos/add

步骤三:

事项:通过获取图片信息、视频信息的方式,你也可以获得图片id、视频id等素材信息
接口:images/getvideos/get

步骤四:

事项:通过MD5将投放至多个媒体的图片进行关联
接口:不涉及,本地处理

参考案例: ​​ ​

场景二:素材分析

通过API你可以进行素材维度的分析;也可以对素材设计师进行设计质量考核等,实际指标你可以根据自身业务特征进行调整。

步骤一:

事项:通过daily_reports/gethourly_reports/get获得ad_id及广告层级数据报表(表A)。你可以根据自身诉求选择合适的时间窗口
接口:daily_reports/gethourly_reports/get

步骤二:

事项:通过ads/get接口获得创意id adcreative_id及图片、视频id(adcreative_elements)(表B)
接口:ads/get

步骤三:

事项:组合上面两步获取的内容,以ad_id作为连接项,可以获得带有素材id的数据报表(表C)
接口:不涉及,本地处理

步骤四:

事项:通过获取图片信息、视频信息的方式,你可以获得图片id、视频id等素材id及MD5(表D)
接口:images/getvideos/get

步骤五:

事项:将表C与表D通过素材id进行关联,你可以获得带有MD5的数据报表
接口:不涉及,本地处理

你可以通过在本地素材库中增加原始素材与设计师的关系、与图片风格的关系,生成设计师报表、风格报表等内容,帮助你进行业绩考核、素材筛选等
参考案例: ​​ ​

场景三:定制化报表

进行投放决策时,客户会有一些定制化的诉求,通过api可以搭建定制化报表,满足个性化的诉求。可以参考的方式如下:

步骤一:

事项:通过daily_reports/get获得广告主、计划、广告组、广告层级数据,可以输出客户粒度跨平台数据
接口:daily_reports/gethourly_reports/get

步骤二:

事项:通过adgroups/get获得广告组的站点、推广目标id、定向、渠道包,通过adcreatives/get获得创意的落地页、规格
接口:adgroups/getadcreatives/get

步骤三:

事项:上面两步的数据通过adgroup_id作为连接项,输出站点、推广目标id、定向(包括人群包)、渠道维度报表;通过adgroup_id和adcreative_id组合作为连接项,可以输出落地页、规格维度报表
接口:不涉及,本地处理

你也可以根据素材分析的信息,获得素材设计师报表、素材报表、素材标签报表等。

具体报表的维度可以根据实际需求组合,如可以定制定向+推广目标id的报表 。

特别说明:腾讯广告的报表数据非实时数据,建议获取数据的间隔时长为15分钟以上。

参考案例: ​​ ​

场景四:自动化规则

投放中需要根据广告数据进行调整,当前只能通过人工的经常查看账号数据进行对应的数据分析判断及操作。通过API可以让投放更加智能和自动化,减少人工管理的成本,使你的优化师专注在更有价值的事情上。
实现方案参考如下:

  • 首先确定你希望规则应用到的对象范围。这个对象可以是计划、广告组、创意,也可以是账号,具体范围根据你实际的业务需求确定。
  • 其次设定规则条件,即进行规则判断时需要考虑的维度信息。这里的维度可以是广告的基础数据,如消耗、曝光量、点击量等,也可以是根据你的后端转化数据计算的转化成本、转化量等信息。你可以根据实际业务诉求,选择合适的数据维度和时间窗口,通过daily_reports/get或hourly_reports/get指定条件获得数据。
  • 最后,设定规则条件满足时对对象进行的操作。这里的具体操作可以有很多种,比如开启/暂停计划/广告组/广告,调整出价及预算,发送内部通知等。具体的接口与进行的操作有关 对于你的自动化规则,你可以设定执行频率,根据设定的频率定期获取数据进行判断。

下面以一个具体的规则进行接口示例说明:
对象范围:所有的非朋友圈广告计划
规则条件:计划消耗到达计划日预算
操作:计划日预算向上增加10%
执行频率:每个小时一次
具体步骤:

  1. 通过daily_reports/get获取计划当日的消耗。请求中需设定日期为当日,报表类型级别为REPORT_LEVEL_CAMPAIGN
  2. 通过campaigns/get获取计划的日预算
  3. 判断1和2是否相等,若相等,计算新预算=min{4000000000,[max(旧预算*110%,旧预算+5000)]} 备注:4000000000分为非朋友圈广告的计划日预算上限,每次修改后预算不能低于计划今日消耗+5000分
  4. 通过campaigns/update修改计划日预算
  5. 每一个小时重新执行一轮上面4步

更多应用案例敬请期待