AdX对接指南：广告主审核与BuyerAPI详解

本文档主要关注iwanvi-adx广告主和素材审核接口的相关指南，旨在帮助DSP（需求方平台）与程序化交易市场高效地集成，确保广告内容的合法性和有效性。文档分为两个关键部分： 1. 接入步骤：这部分是针对DSP商务人员的，详细阐述了DSP与AdExchange（广告交易平台）之间对接的流程和具体操作步骤。广告主和广告信息在投放前必须先通过AdExchange的审核，未审核通过的广告将不会展示，以维护市场的规范和用户体验。 2. BuyerAPI：这是针对产品和开发人员的部分，重点介绍了DSP与AdExchange交互的BuyerAPI（买家API）。这个接口支持广告主和广告信息的上传、修改，以及查询审核状态。开发者需要遵循特定的编码规则，如使用UTF-8编码，通过RESTful的HTTP协议发送JSON格式的数据，其中包含错误码、错误信息和返回的审核状态数据。 - **接口操作方法**：API支持的主要操作包括添加（add）、更新（update）、查询审核状态（audit_status）。每个操作都有其明确的参数，如code和message用于返回错误信息，而data字段则根据操作类型可能返回jsonarray或jsonobject形式的数据。 - **权限认证**：为了保证安全，所有API请求都需要携带用户授权令牌（token），并且授权信息需要包含在API请求的HTTP头部。 - **API URL格式**：API请求的URL由基础URL、版本号、资源名和操作方法组成，例如`http://{host}/adx/v1/${resource_name}/${resource_action}`。 - **请求和响应**：所有请求使用POST方式，并且在Header中设置Content-Type和鉴权信息。请求体中包含JSON格式的参数。HTTP返回码200表示请求成功，其他代码可能表示错误或异常情况。 这篇文档为DSP平台提供了清晰的指导，确保他们在与AdExchange交互时能够正确处理广告主和广告内容的审核流程，实现合规投放，提升广告效果。对于任何想集成这些功能的DSP团队来说，理解和使用这些接口是至关重要的。