该接口用于开发者将运营成本&内购收益数据回传给AdSpark。
重点提示
AdSpark -> 接入管理 -> 运营成本和内购收益数据 -> 立即接入
以下地址为AdSpark提供回调地址,您可以根据自助接入流程进行获取,复制地址链接,并在地址后添加根据31.签名算法指引生成的signature使用,该回调地址将用于后续上报请求。
您可以根据自助接入流程获取AdSpark分配的ecretKey(用于计算signature),根据3.1.签名算法的指引生成signature使用:
请参照以下信息,按照请求信息,将需要的参数上报到对应的接口地址,同时请参照签名计算生成对应的签名,并作为请求body中的signature参数,来保障安全鉴权要求。
接口地址:根据自助接入流程获取数据上报地址
Method:Post
Content-Type:Application/json
注意:所有的md5均采用32位小写
字段英文名 | 字段中文名 | 类型 | 是否必填 | 说明 | |
通用信息 | site_id | 在穿山甲平台绑定的应用ID | long | 是 | 根据上传的siteID自动绑定包名 |
设备信息 | bd_did | 非常重要,建议通过回调的方式获取,由于参数获取可能存在一定的延迟性,所以建议通过回调的方式获取,以及回调后,再通过Applog.getDid( )方法确保一定获取,详细可以参考>>> 附:Android和IOS获取did的方法 | string | 尽量回传,以提升设备的拼接率 | 若不回传did,内购事件无法匹配到对应激活归因,参谋会使用其他设备ID(imei、oaid、idfa等)兜底,建议开发者尽量回传bd_did |
imei | 安卓设备唯一标识:imei | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | ||
imei_md5 | 安卓设备唯一标识:md5加密后的imei | string | |||
oaid | 安卓设备唯一标识:oaid | string | |||
oaid_md5 | 安卓设备唯一标识:md5加密后的oaid | string | |||
android_id | 安卓设备唯一标识:android_id | string | |||
android_id_md5 | 安卓设备唯一标识:md5加密后的android_id | string | |||
google_aid | 安卓设备唯一标识:google_aid | string | |||
google_aid_md5 | 安卓设备唯一标识:md5加密后的google_aid_md5 | string | |||
idfa | IOS设备唯一标识:idfa | string | 若有idfa、idfv请全部回传,以增加设备的拼接率 | ||
idfa_md5 | IOS设备唯一标识:md5加密后的idfa | string | |||
idfv | IOS设备唯一标识:idfv | string | |||
idfv_md5 | IOS设备唯一标识:md5加密后的idfv | string | |||
ip | 设备ip | string | 否 | ||
ua | 设备User-Agent | string | 否 | ||
os_version | 操作系统版本 | string | 否 | ||
model | 设备机型 | string | 否 | ||
language | 设备的系统语言 | string | 否 | ||
device_brand | 设备品牌 | string | 否 | ||
region | 设备所在地区 | string | 否 | ||
mac | 设备mac地址 | string | 否 | ||
事件数据 | unique_id | 开发者侧,对数据的唯一标识符 | string | 否 | |
时间戳 | time_ts | 发生时间戳,单位ms | long | 是 | |
事件类型 | event_type | 事件类型: | string | 是 | |
数据类型 | data_type | 数据类型:0=全部 | int | 是 | |
数据值 | data_value | 数据值(单位:分),当日IAP变现收益/当日用户提现成本/当日其他ADN IAA变现收益中的某一个值,基于event_type决定 | long | 是(两个字段二选一必传,且大于0) | |
data_value_thousandth_fen | 数据值(单位:千分之一分),与data_value仅单位区别,1元=100000 | long |
该步骤为了计算上报地址中的signature
请用上面提供的secret_key按如下方式生成signature
curl请求示例
curl响应结果:
请在本页面(AdSpark)下方点击接入检测,一键检测数据接入结果。
当您完成接入检测,且返回接入成功信息时,
请点击确认接入并进入【接入成功页面】,正式完成接入。
错误码 | 错误信息 | 建议操作 |
0 | success | 成功 |
400005 | invalid or missing params | 检查必填参数是否丢失(具体参数请参考第二步第2点-请求参数上报) |
400008 | failed to get CSJ site id | url中是否有site_id参数 |
400009 | empty body | 检查请求中的body是否为空 |
400010 | invalid body | 检查请求中的body是否为json格式 |
401002 | user unauthorized | url中是否有signature参数,若有,请核查signature计算方式是否正确 |
500000 | unknown error | 服务内部错误,联系AdSpark |
500001 | internal error | 服务内部错误,联系AdSpark |
500104 | DB operation error | 服务内部错误,联系AdSpark |
500105 | send data error | 服务内部错误,联系AdSpark |
500106 | data serialization error | 内部参数序列化错误,联系AdSpark |
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock