Marketing API对接

做上火箭的羊

于 2024-12-12 15:04:05 发布

阅读量1.2k

点赞数 13

分类专栏：广告投放用户增长文章标签：广告投放 MarketingAPI Auth2.0授权 MarketingAPI对接频控方案

本文链接：https://blog.youkuaiyun.com/mengfeichuan2013/article/details/144426129

版权

广告投放同时被 2 个专栏收录

9 篇文章

订阅专栏

用户增长

8 篇文章

订阅专栏

一、🌟 Why：与我何干？

接入Marketing API对于希望在数字营销领域保持竞争力的企业和开发者来说至关重要。它允许你直接与广告平台的后端系统交互，实现以下好处：

自动化和效率：自动化广告投放流程，减少手动操作，提升工作效率。
数据驱动决策：实时获取广告表现数据，基于数据做出更精准的营销决策。
技术整合：将广告平台的功能整合到你的技术栈中，实现数据和流程的无缝对接。
创新服务：开发新的营销工具和服务，提供更个性化的广告解决方案，增强市场竞争力。

二、📚 What：定义、概念解释，可以做什么

Marketing API是广告投放平台提供的一种服务，它允许开发者通过编程方式访问广告平台的后端系统，实现以下高级功能：

广告投放管理：创建、修改、暂停和删除广告活动，以及管理广告预算和出价策略。
报表分析：获取广告投放的详细数据，进行效果分析和ROI计算，包括点击率、转化率等关键指标。
创意素材管理：上传和管理广告素材，包括图片、视频等，以及A/B测试不同创意的效果。
DMP人群管理：管理和分析目标受众数据，实现精准营销，包括创建和维护自定义受众列表。
商品管理：DPA投放、商品创编等相关接口

三、🛠️ How：接入步骤流程方法

对接 Marketing API的整体流程是什么？

如果你要对接Marketing API，整体要经过以下流程：注册为开发者→申请APPID应用→使用授权URL引导广告主完成广告账户授权→使用授权后得到的auth_code换取token→使用token做相关接口调用。

由于一般Marketing API的调用和OAuth授权紧密相关，关于Auth2.0这里不做过多解释，后面会有单独的文章来介绍，你可以简单理解为通过Auth授权拿到了能够访问API的accessToken，才能访问各个接口。

接入Marketing API的详细步骤如下：

注册成为开发者：
1. 访问某开放平台官网，点击注册按钮。
2. 使用公司邮箱注册，并完成企业认证。
3. 📝 Tips：一个公司信息只能注册认证一个开发者账户。
创建应用程序：
1. 登录开放平台，进入「APPID管理」页面。
2. 选择创建广告管理或服务市场类型的应用。
3. 填写应用名称、图标、回调地址和申请权限。
4. 📝 Tips：回调地址是用户自定义的链接地址，用于接收授权信息。
获取权限：
1. 根据开发需求，申请相应的功能接口使用权限。
2. 提交申请后，等待审核通过。
发起请求：
1. 获取广告主授权，通过授权URL引导广告主完成授权。
2. 使用返回的auth_code获取AccessToken和RefreshToken。
3. 📝 Tips：AccessToken有效期为24小时，需要定期刷新。

比如，接入Marketing API就像是学习如何驾驶飞机。你需要获得飞行员执照（注册成为开发者），选择你的飞机型号（创建应用程序），学习飞行规则（申请权限），然后起飞（发起请求并使用API）。

四、🏆 How good：可以给听众带来什么好处，什么改变

接入Marketing API的好处包括：

提高效率：自动化处理大量营销任务，减少手动操作。
数据洞察：获取深入的数据分析，优化营销策略。
技术优势：利用先进技术提升服务质量，增加客户满意度。
竞争优势：开发独特的营销工具，在市场上脱颖而出。

五、📢注意事项

频控限制

一般MarketingAPI在调用时都会有频控限制，通常以**QPS（每秒查询率）**来衡量。它包括两种类型：

开发者频控：限制单个开发者在单位时间内对单个接口的请求次数。
接口总频控：限制所有开发者在单位时间内对单个接口的总请求次数。

频控限制确保了API服务的可用性和响应速度，防止因过度请求而导致的服务崩溃。

频控建议方案

限流器

您可以在客户端自己实现限流器，控制并发请求数量。例如，您可以实现令牌桶算法：按照频控规则下发令牌（如每秒下发 10 个令牌），在请求前尝试获取令牌，如果当前没有令牌则等待一段时间后重试。

消息队列

一种更加健壮的实现是使用消息队列。定时脚本不直接负责请求 API，而是采用生产者-消费者模型：将请求任务推送至消息队列，由专门的消费者从队列中取出任务进行消费（即请求 API）。您可以通过限制对某一类任务的并发消费者数量或使用限流器，从而达到限制请求并发数量的目的。对于执行失败的任务，可以将其重新推送至队列中（并设置一定延时）进行重试。

PS: 你在对接MarketingAPI时都遇到了哪些问题？欢迎留言讨论，也欢迎长按下图关注订阅号坐上火箭的羊，一起沟通学习