一、背景介绍

为满足搜狐广告主对广告效果的监测需求，本文档介绍如何把从搜狐渠道的转化效果数据回传给搜狐广告平台，帮助广告主跟踪转化效果。

本回调方案适用于 Android 和 iOS 的 APP 端以及使用 ip+ua 归因的 WAP 端，对接方式为 API 对接。

二、转化定义

2.1 定义

广告点击：搜狐用户点击广告素材时触发点击事件，该事件被认为是一次有效的广告点击。

2.2 数据流程

流程说明：

1) 用户点击广告后触发点击事件。

2) 客户端将点击事件发送给搜狐服务器。

3) 搜狐服务器将点击事件上报至搜狐广告服务器。

4) 搜狐广告服务器通过广告主提供的点击监测接口（即接口一）将点击事件通知到广告主服务器。

5) 广告主在收到接口一的请求后，根据请求参数的用户信息，同自己的转化数据进行匹配。

6) 广告主服务端通过转化上报接口（即接口二：callback url）将转化事件上报至搜狐服务器。

7) 搜狐广告服务器将收到的转化数据与广告账户匹配。

8) 搜狐广告投放前端呈现转化报表。

三、接口定义

3.1 接口一

接口一是由广告主监测方提供的用于帮助广告主接收搜狐的广告点击信息的接口。

3.1.1 接口一规范：

请求方：搜狐广告服务器

处理方：广告主监测方服务器

请求方式：HTTP GET

请求地址：广告主需提供点击监测 url。监测 url 中，使用双下滑线的形式来设置所需返回的数据，如__PARAM__。

3.1.2 响应方式及内容

返回数据需要为 json 格式，例如：{"desc":"成功","status":true}，表示广告主监测平台收到点击数据，异常情况

desc 字段可描述失败原因。

说明

 宏格式必须全大写，必须使用双下滑线“__参数__“的形式，否则会导致宏替换失败

 监测链接不能是下载链接

 __CALLBACK__宏必填，其他宏可根据监测需要灵活配置，详细宏参数说明见下方 4.1 部分。

3.2 接口二

接口二是由搜狐广告服务器以 callback 参数的形式提供给广告主，广告主可通过接口二将转化数据回传给搜

狐广告服务器，搜狐广告服务器会将收到的转化数据与广告组关联，跟踪每一个广告组的转化效果。

广告主必须实现实时上报回传，以免出现统计无效的情况。

3.2.1 接口二规范

请求方：广告主监测方服务器

处理方：搜狐广告服务器

请求方式：HTTP GET

请求地址：我们会在下发点击事件时通过宏__CALLBACK__将转化上报的接口提供给广告主，广告主需按照 callback

url 中的接口地址进行转化事件的上报，参数的详细说明见下方 4.2 部分。

3.2.2 响应方式及内容

请求成功：success

更多搜狐广告投放‍的方式，详情官网咨询！