百度流量交易服务API接口2.7详细规范与使用教程

需积分: 10 11 下载量 45 浏览量 更新于2024-07-21 收藏 765KB PDF 举报
百度流量交易服务API接口规范2.7(PC&Mobile&Video)是一份详细指导 DSP 公司与百度广告平台集成的重要文档,旨在促进双方高效的数据交换和广告管理。该规范于2014年10月10日更新,主要针对PC、Mobile和Video三种流量类型,涵盖了广告主管理、创意操作、报告查询以及特定功能如Cookies和APPID/开发者ID管理等内容。 1. **授权机制**:规范强调了严格的保密性,要求对接的DSP公司必须遵守协议,不得泄露接口细节给第三方。接入过程中,可能涉及OAuth或其他认证机制,确保数据的安全性和权限控制。 2. **编码格式与请求方式**:接口采用JSON消息格式,所有通信通过HTTPS加密传输,请求头部指定Content-Type为application/json。这表明所有的数据包都是以JSON对象形式发送和接收,提高了数据的标准化和可读性。 3. **API结构**: - URL定义:接口地址明确,便于开发者根据功能需求构建请求路径。 - API请求:包括但不限于添加或修改广告主、创意、报告数据的操作,每项操作都有明确的请求结构和参数要求。 - API响应:预期返回的JSON格式结果,包含成功与否的状态码、详细信息和可能的错误提示。 4. **操作指南**: - 广告主管理:支持新增、修改、查询广告主信息,以及检查资质状态和开放域名状态。 - 创意管理:包括创建、修改、查询创意,检查创意的静态检查状态、百度修正记录以及被拒动态创意的历史。 - 报告功能:提供实时竞价报告、消费报告和广告主报告,以便用户监控广告效果。 5. **特殊功能**: - PC流量相关的Cookies管理:允许批量添加和删除用户标识信息。 - Mobile流量相关的APPID和开发者ID对应表下载,用于移动应用广告的适配。 6. **错误处理**:详尽地列出了各类错误代码,包括系统错误、公共错误、广告主和创意相关错误,有助于快速识别和解决接口调用中的问题。 7. **调用示例**:文档提供实际操作示例,帮助开发人员理解如何构造和解析API请求和响应,以便更快上手。 8. **补充说明**:针对不同类型的流量(Web、Mobile和Video),可能有特定的创意格式要求,确保了跨平台的一致性和兼容性。 百度流量交易服务API接口规范2.7是DSP与百度广告平台高效协作的关键,它不仅明确了接口的功能和使用方法,还提供了必要的错误处理机制,对于提升广告投放效率和数据分析能力具有重要意义。