鲸鸿动能转化跟踪API-数据回传

广告转化数据回传：广告转化数据是指归因给鲸鸿动能的转化行为数据，在回传广告转化数据
时，需要将广告跟踪标识（callback）回传给鲸鸿动能，广告主可以从监测链接、智能分包参数或
落地页携带的跟踪参数中获取到。
一方转化数据回传：一方转化数据是指推广产品积累的原始转化行为数据，回传需要携带匿名
设备ID（OAID或OAID_MD5）,并指定回传账号（advertiser_id）
注：鲸鸿动能只能匹配距离点击时间30天以内的广告转化数据，超过该期限的回传数据无效。

请求参数

Body 参数application/json

oaid

string

设备标识符

可选

明文

conversion_type

string

转化事件的类型

必需

详细枚举值见《鲸鸿动能转化跟踪接口对接说明(中国大陆)v1.9_0000001815222030.pdf》附录3

content_id

string

创意id

可选

与该条转化行为匹配的、广告主接收到创意id

device_id

string

设备ID

可选

在指定id_type时传入

id_type

string

ID类型

可选

包含0,6,8,9,10,11,12,13, 20：OAID_MD5

gaid_tracking_enabled

string

gaid转化跟踪是否开启

可选

conversion_extend

object

可选

revenue

string

付费金额/退款金额

可选

在 conversion_type传入paid和refund 时使用

value

string

转化价值

可选

currency

string

币种

可选

请使用ISO 4217的字母代码(Alphabetic Code)，例如：USD,EUR,CNY

price

string

单个商品价格

可选

content_type

string

商品类型

可选

content_list

array[string]

商品名称列表

可选

content_id

string

商品ID

可选

content_sku_id

string

Vmall商品ID

可选

quantity

string

商品数量

可选

payment_info_available

string

可用付款信息

可选

validated

string

验证

可选

receipt_id

string

收据号

可选

order_id

string

订单号

可选

contend_ids

array[string]

商品ID列表

可选

content_category

string

商品所属类别

可选

promotion_id

string

与商品相关的促销活动ID

可选

search_term

string

搜索关键词

可选

content_list_id

string

商品列表

可选

callback

string

广告转化回传标识

必需

campaign_id

string

计划ID

可选

与该条转化行为匹配的、广告主接收到的事件中的计划ID

timestamp

string

本请求发起的时间戳

必需

Unix时间戳，单位毫秒

app_version

string

归属话单中的应用版本

可选

app_packagename

string

归属话单中的应用包名

可选

is_retargetting

string

是否重定向

可选

attribution_lookback

string

归因回溯

可选

attributed_touchtype

string

属性触摸类型

可选

match_type

string

匹配类型

可选

user_agent

string

用户代理

可选

URLEncode UTF-8格式

referrer

string

referrer归因参数

可选

conversion_time

string

转化时间

必需

advertiser_id

string

广告主ID

可选

一方数据回传时callback不用填，advertiser_id字段必填

示例

{
    "oaid": "string",
    "conversion_type": "string",
    "content_id": "string",
    "device_id": "string",
    "id_type": "string",
    "gaid_tracking_enabled": "string",
    "conversion_extend": {
        "revenue": "string",
        "value": "string",
        "currency": "string",
        "price": "string",
        "content_type": "string",
        "content_list": [
            "string"
        ],
        "content_id": "string",
        "content_sku_id": "string",
        "quantity": "string",
        "payment_info_available": "string",
        "validated": "string",
        "receipt_id": "string",
        "order_id": "string",
        "contend_ids": [
            "string"
        ],
        "content_category": "string",
        "promotion_id": "string",
        "search_term": "string",
        "content_list_id": "string"
    },
    "callback": "string",
    "campaign_id": "string",
    "timestamp": "string",
    "app_version": "string",
    "app_packagename": "string",
    "is_retargetting": "string",
    "attribution_lookback": "string",
    "attributed_touchtype": "string",
    "match_type": "string",
    "user_agent": "string",
    "referrer": "string",
    "conversion_time": "string",
    "advertiser_id": "string"
}

application/json

Body

resultCode

integer

返回码

必需

resultMessage

string

返回描述

可选

示例

成功鉴权失败参数非法

{
    "resultCode": 0,
    "resultMessage": "success"
}

鲸鸿动能转化跟踪API-数据回传

请求参数

返回响应