CSJ: A global platform dedicated to developer growth.

Support Center

English

You can then view all documents

Details

Introduction

Registration

Configurement

Installation

Payment

Compliance

GroMore

AdSpark（增长参谋）

成长工具

AdSpark（增长参谋）/技术接入文档/其他数据类型接入文档/运营成本&内购收益数据接入说明

运营成本&内购收益数据接入说明

Last updated 2023-09-27 16:47:30

接口介绍

该接口用于开发者将运营成本&内购收益数据回传给增长参谋。

重点提示

请求签名signature：需要根据分配的secret_key对参数计算，然后添加请求body里

回调地址：一个应用对应一个独立的回调地址，切勿用同一个回调地址，会对应401002的报错错误码

content-type 使用的方式：application/json，使用错误会导致接口报错
回传时机：产生提现行为回传即可，不限次数，不区分新老设备

接入操作

第一步：获取运营成本&内购收益数据上报地址、签名秘钥

1. 回调地址

以下地址为增长参谋提供回调地址，您可以复制地址链接，并在地址后添加根据4.1.签名算法的指引生成signature使用，该回调地址将用于后续上报请求。

复制

2. 签名密钥

下方为增长参谋为当前应用分配的secretKey（用于计算signature）：

复制

第二步：数据上报

请参照以下信息，按照请求信息，将需要的参数上报到对应的接口地址，同时，请参照签名计算生成对应的签名，并作为请求body中的signature参数，来保障安全鉴权要求。

1.请求信息

Method:Post

Content-Type:Application/json

2.请求上报参数

注意：所有的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=全部	int	是
数据值	data_value	数据值（单位：分），当日IAP变现收益/当日用户提现成本/当日其他ADN IAA变现收益中的某一个值，基于event_type决定	long	是(两个字段二选一必传，且大于0)
数据值	data_value_thousandth_fen	数据值（单位：千分之一分），与data_value仅单位区别，1元=100000	long	是(两个字段二选一必传，且大于0)

3.签名计算

该步骤为了计算上报地址中的signature

3.1.签名算法

请用上面提供的secret_key以下面的方式生成signature

复制

3.2.生成签名

3.2.1 golang

复制

3.2.2 Java

复制

4.请求示例

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	内部参数序列化错误，联系增长参谋

Contents