- 请求签名signature:需要根据分配的secretKey对参数计算,然后添加到url地址后面
- 回调地址:一个应用对应一个独立的回调地址,切勿用同一个回调地址,会对应401002的报错错误码
- ad_platform 的枚举值:不可自定义,详细请参考附件:(注意:自建归因-渠道映射关系 )
- content-type 使用的方式:application/json,使用错误会导致接口回调报错
- 归因渠道需按标准回传映射 自建归因-渠道映射关系
- 同时支持服务端SDK和API接入
服务端SDK
该接口用于自建归因的开发者将归因后的分渠道数据回传给增长参谋,以实现细分查看全渠道ROI报表。
获取路径:管理平台->增长参谋->接入管理->找到对应的应用->立即接入->选择归因回传渠道(自建平台)->API自助接入
以下地址为增长参谋提供回调地址,您可以复制地址链接,并在地址后添加根据4.1.签名算法的指引生成signature使用,该回调地址将用于后续上报请求。
下方为增长参谋为当前应用分配的secretKey(用于计算signature):
请参照以下信息,按照请求信息,将需要的参数上报到对应的接口地址,同时,请参照签名计算生成对应的签名,并更新到回调地址中的signature,来保障安全鉴权要求。
请在上述步骤获取的回调地址{callback_url}
1. 所有的md5均采用32位小写
2. 必传字段说明:
①设备信息:安卓-若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 IOS-若有idfa、idfv、caid,请全部回传,以增加设备的拼接率
② 激活时间:time_ts参数类型是int,不是string
③ 计划ID虽为非必传,但除自然量&厂商外,建议其他渠道均回传
分类 | 字段英文名 | 字段中文名 | 类型 | 会否必填 | 说明 |
通用信息 | package | app安装包 | string | ||
设备信息 | unique_id | 自归因平台设备唯一标识 | string | 否(开发者自己对设备标识的ID) | |
设备信息 | imei | 安卓设备的设备标识 | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | |
设备信息 | oaid | 安卓设备的设备标识 | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | 如有取到,一定要传原值!否则会被过滤,影响指标计算,length(>=10 and <=64) |
设备信息 | android_id | 安卓设备的设备标识 | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | |
设备信息 | google_aid | google广告平台的用户标识 | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | |
设备信息 | imei_md5 | md5加密后的imei | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | oaid_md5 | md5加密后的oaid | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | android_id_md5 | md5加密后的android_id | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | google_aid_md5 | md5加密后的google_aid | string | 若有andriod_id、imei、oaid, 请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | idfa | ios设备的设备标识 | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | 无效字段示例: |
设备信息 | idfv | ios设备的设备标识 | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | idfv有可能存在获取失败的查宁,注意获取时间和获取频率,增加获取率 |
设备信息 | zgx_caid | ios设备的设备标识,这里特指中广协的caid | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | |
设备信息 | idfa_md5 | md5加密后的idfa | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | idfv_md5 | md5加密后的idfv | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | zgx_caid_md5 | md5加密后的caid | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | zgx_pre_caid_md5 | md5加密后的caid | string | 若有idfa、idfv、caid,请全部回传,以增加设备的拼接率 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | mac | 设备mac地址 | string | 否 | |
设备信息 | device_brand | 设备品牌 | string | 否 | |
设备信息 | model | 设备机型 | string | 否 | |
设备信息 | os_version | 操作系统版本 | string | 否 | |
设备信息 | language | 设备的系统语言 | string | 否 | |
设备信息 | region | 区域 | string | 否 | md5转化前,不对原值进行大小写转变,转化后,不对MD5值截断 |
设备信息 | ip | 设备ip | string | 否 | 如果imei或imei_md5或idfa为空,该字段尽量上传,需要和ua一起上传 |
设备信息 | ua | 设备User-Agent | string | 否 | 如果imei或imei_md5或idfa为空,该字段尽量上传,需要和ua一起上传 |
归因信息 | time_ts | 激活时间 | bigint | 是 | 设备激活的时间戳,定义为每个设备首次激活app的时间 兼容毫秒/秒级时间戳,不是click和show的时间戳。而且回传时间必须在次日凌晨1点之前,否则会有gap问题 |
归因信息 | click_id | 点击id | string | 否 | |
归因信息 | ad_platform | 广告投放平台 | string | 是 | |
归因信息 | ad_platform_sub | 广告投放平台—自定义 | string | 否 | |
归因信息 | ad_account_id | 广告账户id | string | 否 | 广点通:account_id; 巨量引擎:advertiser_id; 磁力引擎:advertiser_id |
归因信息 | campaign_id | 广告第一层级,广告组id | string | 否 | 广点通:campaign_id; 巨量引擎:campaign_id; 磁力引擎:campaign_id; 注意区分ad_id,上传之前核对下 |
归因信息 | campaign_name | 广告第一层级,广告组名称 | string | 否 | 广点通:campaign_name; 巨量引擎:campaign_name; 磁力引擎:campaign_name |
归因信息 | ad_id | 广告第二层级,广告计划id | string | 是(自然量、厂商渠道无计划id可不传)同一个设备的激活信息注意不要重复上传,多次上传容易引起数据GAP,去重规则(小时级别以当天最早的一次激活信息为准,天级别以当天最后一次激活信息为准) | 广点通:adgroup_id; 巨量引擎:ad_id; 磁力引擎:unit_id; 除了自然量、应用商店没有广告计划id可不传,其他投放渠道都必传广告计划id,否则会导致数据无法正常查看 |
归因信息 | ad_name | 广告第二层级,广告计划名称 | string | 否 | 广点通:adgroup_name; 巨量引擎:ad_name; 磁力引擎:unit_name |
归因信息 | creative_id | 广告第三层级,创意id | string | 否(如果要使用增长参谋的素材效果分析功能,则本参数必传,详见 素材功能介绍 ) | 广点通:ad_id 巨量引擎:creative_id 磁力引擎:creative_id |
其他 | touch_type | 归因到的触点类型 | string | 否 | click:点击 impression:展示 |
该步骤为了计算回调地址中的signature
请用上面提供的secretkey(PS:每次更新接入流程都会重新生成一个secretKey,注意要用最新生成的),结合对参数排序,以下面的方式生成signature,并更新到回调地址中的signature
curl请求示例
请在本页面(增长参谋)下方点击接入检测,一键检测数据接入结果。
当您完成接入检测,且返回接入成功信息时,
请点击确认接入并进入【接入成功页面】,正式完成接入。
备注:联调期间的数据认为是测试数据,不会被使用,只有完成接入后,数据才会被计算。
错误码 | 错误信息 | 建议操作 |
0 | success | 成功 |
400005 | invalid or missing params | 检查必填参数是否丢失(具体参数请参考第二步第3点-请求参数上报) |
400008 | failed to get CSJ site id | url中是否有pg_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