English
Log In
You can then view all documents
增长参谋/数据接入文档/TalkingData
TalkingData
Last updated 2022-04-22 19:32:27

归因结果兼容API使用说明:TalkingData

重点提示:

1. 您选择回传的设备ID类型直接影响和变现数据拼接的成功率,为了数据拼接成功率较高,若三方归因平台支持以下ID,建议全部选择回传:

① Android设备:imei或 imei_md5,android_id或android_id_md5,oaid或oaid_md5

② Ios设备:idfa或idfa_md5,idfv或idfv_md5

2. 回调地址:一个应用一个回调地址,重新更新接入需更新回调地址


接口简介

该接口支持将TalkingData(以下统称TD)的归因结果数据回传给增长参谋,以此为基础融合串联变现数据和买量数据,最终为您提供买量数据服务。

接入操作

第一步:获取归因回调地址

获取路径:管理平台->增长参谋->接入管理->找到对应的应用->立即接入->选择归因回传渠道(第三方归因平台/Talking Data)

以下地址为增长参谋提供回调地址,您可以一键复制,并在TalkingData后台完成配置。


第二步:登录TalkingData配置回调地址

1. 登录TalkingData官方后台( http://www.talkingdata.com/ ),配置流程也可以参照TD官方文档

2. 进入【管理中心】【数据管理】页面,点击新增数据回调,进入新增数据回调页面

3. 在【新增数据回调页面】完成相关信息配置,重点关注以下信息:

- 选择应用:选择接入增长参谋的目标应用

- 回调事件:选择激活事件

- 数据接收URL:填入上述步骤提供的归因回调地址

- 选择需要回传参数:选择目标参数并自定义参数名称,根据下表中的【参数名】字段填入TD后台(未指明的可以自定义命名),参考链接:TD自定义参数回调说明

参数名(必填)

替换宏

字段类型

支持平台

参数说明

样例

spreadurl

#SPREADURL

string

全平台

六位短链,推广活动唯一标识

Vx7b6c

spreadname

#SPREADNAME

string

全平台

推广活动名称

“多盟推广-素材1”

ua

#UA

string

全平台

点击广告的设备 UA 信息


clickip

#CLICKIP

string

全平台

点击广告的设备IP信息

123.123.123.123

clicktime

#CLICKTIME

long

全平台

点击广告的时间,13位unix时间戳

1451379329000

extra

@_

json

全平台

关联点击的参数json格式表现

{"a":"1","b":"2"}

appstoreid

#APPSTOREID

int

IOS

App Store ID

1046850159

appkey

#APPKEY

string

全平台

APP在Ad Tracking系统中的唯一标识

10691808c7dc494eba8afd44cdef1df7

eventtime

#EVENTTIME

long

全平台

事件发生时间,13位unix时间戳

1451379329000

osversion

#OSVERSION

string

全平台

设备的系统版本

9.2

devicetype

#DEVICETYPE

string

全平台

设备的类型

iPad4,4

idfa

#IDFA

string

IOS

ios系统下的广告追踪标识符

6C59CB5A-3091-4246-AA6E-9C025FE0E33B

mac

#MAC

string

Android

符合IEEE 802标准规定的MAC地址字符串

AB:12:CD:34:EF:56

advertisingid

#ADVERTISINGID

string

Android

广告ID,由Google Play Service提供

4c30a866-30d6-4418-a6dc-0f702737bf58

androidid

#ANDROIDID

string

Android

Android设备的唯一设备标识号


imei

#IMEI

string

Android

移动设备国际识别码

493002407599521

oaid

#OAID

string

Android

设备的OAID数值


tdid

#TDID

string

全平台

TalkingData的唯一设备标识号

hc5e59e1926ee0fe142b22610cdda14df

ip

#IP

string

全平台

事件发生时的ip

123.123.123.123

adnetname

#ADNETNAME

string

全平台

广告网络渠道商名称(英文唯一标识)

“Domob”

adnetdesc

#ADNETDESC

string

全平台

广告网络渠道商描述(中文标识,可能随对接升级进行变更)

“多盟”

channelpackageid

#CHANNELPACKAGEID

string

全平台

应用中集成的分包ID,也称为”channeled”

“jifeng_1”

fraud_prevention

#FRAUD_PREVENTION

string

IOSAndroid

作弊防护标识

“0”代表无异常;“1”代表IP异常激活;“2”代表时间差转化异常激活;“3”代表关联异常激活;“4”代表IP迁移激活(高级版防作弊特有);“5”代表LAT异常激活(高级版防作弊特有);“6”代表全新设备激活(高级版防作弊特有);

touch_type

#ATTRIBUTION_TYPE

string

IOSAndroid

归因来源

“click”代表来自点击;“impression”代表来自曝光;“deeplink”代表来自唤醒;

adcreative

#ADCREATIVE

string

全平台

广告创意


adcampaign

#ADCAMPAIGN

string

全平台

广告系列


adgroup

#ADGROUP

string

全平台

广告组



4. 点击保存,保存该条新增数据回调记录。

5. 联调测试

在【数据管理】页面,针对对应的数据回传记录,点击发送调试请求,触发数据联调。


第三步:接入检测

请在本页面(增长参谋)下方点击接入检测,一键检测数据接入结果。


第四步:接入成功

当您完成接入检测,且返回接入成功信息时,

请点击确认接入并进入【接入成功页面】,正式完成接入。

备注:联调期间的数据认为是测试数据,不会被使用,只有完成接入后,数据才会被计算。


Contents
Contact us