该接口用于开发者将运营成本&内购收益数据回传给增长参谋。
重点提示
增长参谋 -> 数据接入 -> 运营成本&内购收益数据 - API自助接入 -> 立即接入
以下地址为增长参谋提供回调地址,您可以复制地址链接,并在地址后添加根据4.1.签名算法的指引生成signature使用,该回调地址将用于后续上报请求。
下方为增长参谋为当前应用分配的secretKey(用于计算signature):
请参照以下信息,按照请求信息,将需要的参数上报到对应的接口地址,同时,请参照签名计算生成对应的签名,并作为请求body中的signature参数,来保障安全鉴权要求。
Method:Post
Content-Type:Application/json
注意:所有的md5均采用32位小写
字段英文名 | 字段中文名 | 类型 | 是否必填 | 说明 | |
通用信息 | site_id | 在穿山甲平台绑定的应用ID | long | 是 | 根据上传的siteID自动绑定包名 |
设备信息 | 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 | 事件类型:IAP=IAP变现收益REWARD_COST=激励提现成本OTHER_ADN_INCOME=其他ADN广告变现收益 | string | 是 | |
数据类型 | data_type | 数据类型:0=全部,1~10支持开发者自定义 | int | 是 | |
数据值 | data_value | 数据值(单位:分),当日IAP变现收益/当日用户提现成本/当日其他ADN IAA变现收益中的某一个值,基于event_type决定 | long | 是 |
该步骤为了计算上报地址中的signature
请用上面提供的secret_key以下面的方式生成signature
curl请求示例
curl响应结果:
请在本页面(增长参谋)下方点击接入检测,一键检测数据接入结果。
当您完成接入检测,且返回接入成功信息时,
请点击确认接入并进入【接入成功页面】,正式完成接入。
错误码 | 错误信息 | 建议操作 |
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 | 服务内部错误,联系增长参谋 |
500001 | internal error | 服务内部错误,联系增长参谋 |
500104 | DB operation error | 服务内部错误,联系增长参谋 |
500105 | send data error | 服务内部错误,联系增长参谋 |
500106 | data serialization error | 内部参数序列化错误,联系增长参谋 |
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock