百度流量交易API接口规范2.7（涵盖PC、移动及视频）

简介：
本文档介绍了百度流量交易API接口规范版本2.7，全面覆盖了PC端、移动端和视频平台的相关规则与技术要求。 ### 百度流量交易服务API接口规范2.7（PC&Mobile&Video） #### 概述 百度流量交易服务API接口规范2.7是为数字广告交易平台设计的一套标准化编程接口，旨在帮助需求方平台(Demand-Side Platform, DSP)与其系统实现无缝对接。这使得广告主能够更高效地管理账户、创意，并获取各类报告数据。本规范适用于个人电脑(PC)、移动设备(Mobile)和视频(Video)等多种媒介形式。 #### 重要组成部分 1. **使用入门** - **API概述**：介绍了百度流量交易服务API的基本信息，包括使用的JSON格式及HTTP请求Content-Type头部值为application/json以及HTTPS协议。 - **授权机制**：为了确保数据安全性和操作合法性，API采用了基于用户ID(dspid)和授权令牌(token)的认证方式。这些信息需包含在API请求头中。 - **编码格式**：规定了所有参数都应使用UTF-8进行编码。 - **请求方式**：推荐使用HTTPS协议下的HTTP POST方式进行数据交互以提高安全性。 - **API基本结构**：定义了API URL的组成及其中各个部分的具体含义。 2. **指南** - **广告主**：涵盖了广告主账户新增、修改和查询等功能。包括但不限于： - 新增广告主账户； - 修改广告主信息； - 查询广告主账户状态及其资质。 - 查询开放域名状态。 - **创意**：涉及创意的管理和监控，具体如下： - 新增创意； - 修改创意内容； - 查询所有创意列表； - 按ID查询特定创意； - 查询静态创意检查结果的状态； - 获取百度修改过的创意及其所属行业信息； - 查询特定时间范围内被拒绝的动态创意。 - **报告**：提供了多种类型的报告，用于分析广告效果和优化策略。例如： - RTB(Real-Time Bidding)竞价报告； - 消费报告； - 广告主报告。 - **Cookies管理**：对于PC流量，提供了批量添加和删除Cookies的方法。 - **excluded_landing_page_url文件功能**: 排除特定的落地页URL以避免不符合规则页面被投放。 - **APPID与应用名称对应表下载**: 仅适用于移动流量，提供APPID与应用名称之间的关系。 - **开发者ID与名称对应表下载**：同样针对移动流量，提供了开发者ID和名称之间的对应。 3. **错误代码**：列举了可能出现的各种错误代码。包括但不限于： - 系统错误（如服务器内部问题、网络故障等）； - 公共错误（非系统或服务相关的常见问题）； - 特定模块的错误（例如广告主相关和创意管理中的具体异常情况）。 4. **调用示例**：提供了具体的API调用实例，帮助开发者更好地理解和实践API使用方法。 5. **补充说明**: 对一些特殊场景进行了额外解释。如不同流量类型的创意差异等。 #### 深入理解 - **API架构设计**：该规范采用了RESTful API设计理念，使得接口更加灵活且易于扩展；通过定义清晰的资源操作（例如GET、POST、PUT），简化了开发者的工作流程。 - **安全性考量**：采用HTTPS协议增强了数据传输的安全性，并使用基于用户ID和授权令牌的认证机制进一步加强访问控制，防止未经授权的数据泄露或恶意行为。 - **灵活性与扩展性**: API支持批量处理功能，使得一次请求可以同时操作多个资源提高了效率；API版本化策略也方便了后续的功能迭代和服务升级。 - **详尽文档和支持**：该文档详细列出了每个接口的功能和使用方法，并提供了错误代码的解释及示例，便于开发者快速定位并解决问题。 - **适应多场景需求**: 考虑到不同媒介特性和应用场景多样性，API不仅支持PC端还覆盖了移动端和视频流媒体以满足多元化的需求。 百度流量交易服务API接口规范2.7为DSP公司提供了一套全面、安全且高效的工具集，旨在帮助他们更好地管理和优化在线广告活动。