 |
字节巨量引擎-巨量引擎
专用API
【更新时间: 2024.07.23】
巨量引擎商业开放平台提供广告投放、账户管理、数据洞察、人群管理、转化管理等一站式服务，支持批量操作和实时管理。
咨询
去服务商官网采购>
|
服务星级：2星
浏览次数
100
采购人数
1
试用次数
0
SLA: N/A
响应: N/A
适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
|
相似API
飞猪旅行开放服务
191
飞猪开放平台是阿里巴巴集团旗下的综合性旅游服务平台的重要组成部分，旨在为开发者提供全面的旅行服务接入能力。
Linkedln广告标题生成
25
LinkedIn广告标题生成器是一款专为LinkedIn广告设计的API服务，旨在帮助用户创建引人注目、吸引点击且转化率高的广告标题。通过分析用户提供的广告相关信息和目标受众特征，此API能够生成与广告内容高度相关且吸引人的标题，提升广告的效果和转化率。
谷歌广告生成
24
谷歌广告文案生成专门设计用于创建最佳效果的Google广告文案，帮助将访问者转化为客户。该服务通过分析用户的广告目标和目标受众，结合市场趋势和搜索引擎优化(SEO)原则，生成具有高转化率的广告内容。
- API详情
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是巨量引擎的字节巨量引擎?
巨量引擎商业开放平台是一个为广告主和开发者提供全面服务的平台，包括广告投放管理、账户管理、数据洞察、DMP人群管理、转化管理和建站管理等。该平台支持广告组/计划/创意的批量化操作，实现实时的账号资料及资金消耗管理，提供多维度的报表数据查询，以及高效的人群包管理和转化目标设置。此外，平台还支持搜索广告的精准投放和定向包管理，以及素材的上传和管理。平台还提供企业号相关的私信管理、自动回复设置和经营数据分析等功能，旨在帮助用户优化广告投放效果，构建卓越的开发者生态。
什么是巨量引擎的字节巨量引擎接口？
由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用巨量引擎的字节巨量引擎，从而实现程序的自动化交互，提高服务效率。
巨量引擎的字节巨量引擎有哪些核心功能？
|
投放管理 转化管理 账户管理 建站管理 数据洞察 搜索广告 DMP人群管理 定向包管理 |
投放管理
账户管理
数据报表
素材管理 |
任务列表
订单列表
投后分析
受众分析 |
私信管理 私信菜单 自动回复 经营分析 |
巨量引擎的字节巨量引擎的核心优势是什么？
-
全面的广告投放能力：巨量引擎提供了从广告组、计划到创意的批量化增删改查功能，支持广告主在不同场景下进行精准的广告投放。
-
高效的数据管理：通过连山数据同步服务，巨量引擎能够实现数据与广告后台的自动同步，确保广告主能够实时获取到最新的数据，同时支持指定数据的订阅更新，提高数据查询效率。
-
丰富的营销解决方案：巨量引擎不仅支持传统的广告投放，还通过巨量千川为商家和创作者提供抖音电商一体化营销解决方案，帮助商家在抖音平台上实现销售增长。同时，巨量星图触达头条、抖音、西瓜视频等多端海量创作者，为品牌提供高价值的内容服务。
-
多场景支持：巨量引擎、巨量千川、巨量星图、企业号等多个业务板块的开放能力，能够满足不同客户的广告营销诉求，无论是品牌宣传、产品销售还是内容营销，都能找到适合的解决方案。
-
卓越的开发者生态：巨量引擎开放平台致力于构建卓越的开发者生态，通过提供接口开放能力、数据订阅推送等相关服务，支持开发者快速接入平台，共同推动广告营销行业的创新发展。
在哪些场景会用到巨量引擎的字节巨量引擎？
|
广告投放优化 广告主可以使用巨量引擎的API接口来管理广告组、计划和创意，实现批量化的增删改查操作，从而优化广告投放效果。 |
 |
 |
数据分析和报表生成 通过API接口，广告主可以实时获取广告投放后的数据，进行全方位的投后数据分析，并生成详细的数据报表，帮助广告主更好地了解广告效果。 |
|
素材管理 广告主可以使用API接口上传和获取图片、视频等广告素材，提高素材管理的效率和准确性。 |
 |
 |
电商营销 对于在抖音等平台进行电商销售的商家，巨量千川的API接口可以帮助他们实现商品与广告的深度结合，提升销售效果。 |
|
内容营销 品牌主可以通过巨量星图的API接口触达海量创作者，合作创作高质量的内容，进行品牌宣传和产品推广。 |
 |
 |
企业号运营 企业号用户可以使用API接口来管理自己的账户信息和关系，以及接收和处理各类事件通知，提升企业在抖音平台上的运营效率。 |
使用指南
产品问答
?
调取接口，提示“Request too frequent”？
接口调用超出频控限制，具体说明可以查看：频控限制说明
?
调接口时，返回“No permission to operate advertiser XXXX”的...
该报错是由于使用Access Token下已授权的相应广告主账户中不包含要操作的广告主ID，可参考下述方式查询Token下已授权的账户。 查询已授权账户可参考接口文档：获取已授权账户 注意：如果是通过代理商或纵横组织账户授权（接口返回advertiser_role字段 = 2-纵横组织，3-一级代理商，4-二级代理商），还需要通过相应接口获取对应代理商或纵横组织账户下广告主账户。 查询代理商账户下广告主列表：广告主列表（代理商） 查询管家账户下广告主列表：广告主列表（纵横组织） 按照上述方式查询没有相应广告主ID，如需操作该广告主，则需要申请对应广告主授权，并使用获取到的auth_code重新获取该广告主相应的AccessToken，授权方式可参考文档：Oauth2.0 授权
?
调用接口时，返回504/502错误？
接口调用峰期，持续获取大量数据易导致超时。目前的建议如下： 1）服务在整时整点压力较大（比如12:00，12:30这种），建议获取数据时候错开这些时间点，请求数据相应时间会变的快一些; 2）page_size设置的小一些，减少一次请求的数据量 ; 3）设置过滤条件，减少整体处理（total_number）的数据量 ; 4）建议设置一个重试机制; 5）历史报表数据获取建议可以通过异步任务获取
?
对某些可选的字段，实际不需要，能否传“”或者null/调用接口，报错“xxx不能为空”
不可以，如果您实际不需要，参数中就不要传这个字段，而不是将这个字段置空或者null，如果传了就会检验；
?
调取接口时，返回http 414 url 太长？
传递的参数太长，可以用json的形式传递过来（get请求也可以发json）。Python形式,可以参考文档示例。Java形式可以查看如下代码： // 请求参数 Map data = new HashMap(){}; // 构造请求 HttpEntityEnclosingRequestBase httpEntity = new HttpEntityEnclosingRequestBase() { @Override public String getMethod() { return "GET";} }; client = HttpClientBuilder.create().build(); httpEntity.setEntity(new StringEntity(JSONObject.toJSONString(data),ContentType.APPLICATION_JSON));
?
调取接口时，返回“405 Method Not Allowed”错误？
请求方法使用错误，确认使用的请求方法与此接口请求方法是否相同（POST请求或者GET请求）。
?
调用接口，报： advertiser does no grant you XXXX permissi...
您可以按照以下两个步骤完成授权： 步骤一： 确认开发者账户是否拥有相应Scope权限 1. 登陆开发者账户，进入APPID管理（点击进入），确认开发者是否拥有相应权限 2. 开发者账户尚未拥有相应权限，点击申请进入提交 注意：对于第三方角色暂不开放「广告主信息与资质管理」、「代理商账号管理-创建和修改广告主」、「代理商账号管理-资金和流水管理」权限，如果需要获取账户信息可以通过广告主公开信息（/advertiser/public_info/）接口查询到账户名、公司名等基础信息。 步骤二： 开发者拥有相应权限后需申请广告主重新授权 1. 确认申请接口对应scope权限点 可以对照【接口清单】查询接口对应Scope权限点数值 2. 设置授权URL（注意授权URL中的Scope授权范围） 设置授权URL：授权URL的形式如： https://ad.oceanengine.com/openapi/audit/oauth.html?app_id=XXX&state=xxx&scope=xxx&redirect_uri=xxx 其中主要包括四个元素 app_id： 即应用ID，开发者创建应用的唯一标识，可通过应用管理查看； state：即自定义参数，可用于传递自定义信息，回调时会原样带回。常见应用比如将广告主账号作为自定义参数，回调时以区分授权码对应的广告主，其他应用方式可按实际需要选择 scope：即授权范围，授权的权限范围，不传时代表当前应用拥有的所有权限。注意，权限范围只能在此应用拥有的权限范围之内。格式例如：scope=[1, 2, 3, 41]。具体权限范围取值见Scope权限说明，每个权限后面的数字记为该权限的表示数值 redirect_uri：即回调链接，由开发者自行提供和定义，用于授权成功跳转并接受回调信息。注意：redirect_uri 需要与APP应用的回调链接保持一致，否则会报错,回调地址示范：https://yourdomain.com/oauth2/callback/ 3. 授权URL发送给广告主，引导广告主完成授权，重新获取Token使用即可
?
调用接口时，报： Missing data for required field ？
您需要确认对应的字段是否传进来了哈（可以在代码里debugger仔细排查），如果确实传进来了，可以确认接口尾部是否带上了反斜杠/。
?
对于PHP传数组的建议
以上内容未解决问题可反馈工单【提交工单】
?
对于一个广告主创建广告计划及广告创意的要求
单日最多创建500个计划 单日最多创建500个自定义创意
?
传入advertiser_id非广告主类型，导致接口返回报错或没有数据内容
字段 类型 描述 advertiser_role number 1-普通广告主，2-纵横组织，3-一级代理商，4-二级代理商 参考文档：获取已授权账户 注：类型为1-普通广告主的对应advertiser_id为广告主id，其他类型还需通过相应接口获取对应账户下的广告主id 账号管家：广告主列表（纵横组织） 代理商：广告主列表
关于我们
北京巨量引擎网络技术有限公司是一家位于北京的高科技企业，专注于提供全场景的数字营销解决方案。公司依托强大的技术平台和丰富的广告资源，为品牌和商家提供从广告创意制作到效果优化的一站式服务。通过智能化的内容分发、技术应用、规模化用户覆盖和科学化评估，巨量引擎助力企业实现品牌建设、搜索营销、电商经营等多目标营销，推动商业增长。同时，公司还提供营销学堂、成功案例分享等学习资源，帮助企业提升营销能力。
联系信息
服务时间：
7 * 24
网页在线客服：
咨询
API接口列表
使用指南
依赖服务
产品问答
?
调取接口，提示“Request too frequent”？
接口调用超出频控限制，具体说明可以查看：频控限制说明
?
调接口时，返回“No permission to operate advertiser XXXX”的...
该报错是由于使用Access Token下已授权的相应广告主账户中不包含要操作的广告主ID，可参考下述方式查询Token下已授权的账户。 查询已授权账户可参考接口文档：获取已授权账户 注意：如果是通过代理商或纵横组织账户授权（接口返回advertiser_role字段 = 2-纵横组织，3-一级代理商，4-二级代理商），还需要通过相应接口获取对应代理商或纵横组织账户下广告主账户。 查询代理商账户下广告主列表：广告主列表（代理商） 查询管家账户下广告主列表：广告主列表（纵横组织） 按照上述方式查询没有相应广告主ID，如需操作该广告主，则需要申请对应广告主授权，并使用获取到的auth_code重新获取该广告主相应的AccessToken，授权方式可参考文档：Oauth2.0 授权
?
调用接口时，返回504/502错误？
接口调用峰期，持续获取大量数据易导致超时。目前的建议如下： 1）服务在整时整点压力较大（比如12:00，12:30这种），建议获取数据时候错开这些时间点，请求数据相应时间会变的快一些; 2）page_size设置的小一些，减少一次请求的数据量 ; 3）设置过滤条件，减少整体处理（total_number）的数据量 ; 4）建议设置一个重试机制; 5）历史报表数据获取建议可以通过异步任务获取
?
对某些可选的字段，实际不需要，能否传“”或者null/调用接口，报错“xxx不能为空”
不可以，如果您实际不需要，参数中就不要传这个字段，而不是将这个字段置空或者null，如果传了就会检验；
?
调取接口时，返回http 414 url 太长？
传递的参数太长，可以用json的形式传递过来（get请求也可以发json）。Python形式,可以参考文档示例。Java形式可以查看如下代码： // 请求参数 Map data = new HashMap(){}; // 构造请求 HttpEntityEnclosingRequestBase httpEntity = new HttpEntityEnclosingRequestBase() { @Override public String getMethod() { return "GET";} }; client = HttpClientBuilder.create().build(); httpEntity.setEntity(new StringEntity(JSONObject.toJSONString(data),ContentType.APPLICATION_JSON));
?
调取接口时，返回“405 Method Not Allowed”错误？
请求方法使用错误，确认使用的请求方法与此接口请求方法是否相同（POST请求或者GET请求）。
?
调用接口，报： advertiser does no grant you XXXX permissi...
您可以按照以下两个步骤完成授权： 步骤一： 确认开发者账户是否拥有相应Scope权限 1. 登陆开发者账户，进入APPID管理（点击进入），确认开发者是否拥有相应权限 2. 开发者账户尚未拥有相应权限，点击申请进入提交 注意：对于第三方角色暂不开放「广告主信息与资质管理」、「代理商账号管理-创建和修改广告主」、「代理商账号管理-资金和流水管理」权限，如果需要获取账户信息可以通过广告主公开信息（/advertiser/public_info/）接口查询到账户名、公司名等基础信息。 步骤二： 开发者拥有相应权限后需申请广告主重新授权 1. 确认申请接口对应scope权限点 可以对照【接口清单】查询接口对应Scope权限点数值 2. 设置授权URL（注意授权URL中的Scope授权范围） 设置授权URL：授权URL的形式如： https://ad.oceanengine.com/openapi/audit/oauth.html?app_id=XXX&state=xxx&scope=xxx&redirect_uri=xxx 其中主要包括四个元素 app_id： 即应用ID，开发者创建应用的唯一标识，可通过应用管理查看； state：即自定义参数，可用于传递自定义信息，回调时会原样带回。常见应用比如将广告主账号作为自定义参数，回调时以区分授权码对应的广告主，其他应用方式可按实际需要选择 scope：即授权范围，授权的权限范围，不传时代表当前应用拥有的所有权限。注意，权限范围只能在此应用拥有的权限范围之内。格式例如：scope=[1, 2, 3, 41]。具体权限范围取值见Scope权限说明，每个权限后面的数字记为该权限的表示数值 redirect_uri：即回调链接，由开发者自行提供和定义，用于授权成功跳转并接受回调信息。注意：redirect_uri 需要与APP应用的回调链接保持一致，否则会报错,回调地址示范：https://yourdomain.com/oauth2/callback/ 3. 授权URL发送给广告主，引导广告主完成授权，重新获取Token使用即可
?
调用接口时，报： Missing data for required field ？
您需要确认对应的字段是否传进来了哈（可以在代码里debugger仔细排查），如果确实传进来了，可以确认接口尾部是否带上了反斜杠/。
?
对于PHP传数组的建议
以上内容未解决问题可反馈工单【提交工单】
?
对于一个广告主创建广告计划及广告创意的要求
单日最多创建500个计划 单日最多创建500个自定义创意
?
传入advertiser_id非广告主类型，导致接口返回报错或没有数据内容
字段 类型 描述 advertiser_role number 1-普通广告主，2-纵横组织，3-一级代理商，4-二级代理商 参考文档：获取已授权账户 注：类型为1-普通广告主的对应advertiser_id为广告主id，其他类型还需通过相应接口获取对应账户下的广告主id 账号管家：广告主列表（纵横组织） 代理商：广告主列表
关于我们
北京巨量引擎网络技术有限公司是一家位于北京的高科技企业，专注于提供全场景的数字营销解决方案。公司依托强大的技术平台和丰富的广告资源，为品牌和商家提供从广告创意制作到效果优化的一站式服务。通过智能化的内容分发、技术应用、规模化用户覆盖和科学化评估，巨量引擎助力企业实现品牌建设、搜索营销、电商经营等多目标营销，推动商业增长。同时，公司还提供营销学堂、成功案例分享等学习资源，帮助企业提升营销能力。
联系信息
服务时间：
7 * 24
网页在线客服：
咨询
