请求说明
该接口对大小写敏感,请求的地址及参数需要严格按照规定的大小
以下是关于tiktok的特别说明
tiktok对于参数有严格要求,请务必按文档尽可能完善参数(能传必传)
如果设备最终参与竞价,则还需调用【/rta/report】接口上报参竞结果
如果您的请求对于响应时间敏感,建议不同地区的单子选用不同的域名,以获取最佳响应时间
对于false的设备,建议增加缓存,以减少请求流量
URL
分地区域名
| 位置 | 域名 | 说明 |
|---|---|---|
| us地区 | 3s-smart-rtb-vg.mobvista.com | 如果跑us、br等地区的单子 && 您的机房位于us,则可以使用该域名 |
| 欧洲地区 | 3s-smart-rtb-eu.mobvista.com | 如果跑欧洲的单子 && 您的机房位于欧洲,则可以使用该域名 |
| 默认 | 3s-smart-rtb.mobvista.com | 其它地区请使用该默认域名,该域名所在机房位于sg |
请求协议
- HTTPS
请求类型
- GET
请求参数
| 参数 | 类型 | 必填 | 默认值 | 示例 | 说明 |
|---|---|---|---|---|---|
| package_name | string | Y | 无 | 跑RTA项目的包名,联系渠道经理获取,如 tiktok us地区 com.zhiliaoapp.musically | |
| campid | int | N | 无 | 推广offerID(如果有package_name+geo参数, 该字段不要传,该参数优先级比package_name高),联系渠道经理获取 | |
| token | string | Y | 无 | 联系渠道经理获取 | |
| is_rt | string | N | 无 | 是否拉活,拉活单=1,拉新单=0,不传默认为0 | |
| device_id | string | Y | 无 | 对应设备的 idfa / gaid | |
| user_agent | string | Y | 无 | user-agent | |
| client_ip | string | Y | 无 | 客户端ip | |
| geo | string | Y | 无 | US | 推广地区 |
| state | string | Y | 无 | 客户端设备所在州 | |
| city | string | Y | 无 | 客户端设备所在城市 | |
| media_source | string | Y | 无 | af partner id(仅Tiktok需要) | |
| site_id | string | Y | 无 | 1234322 | 子渠道ID(仅Tiktok需要) |
| bundle_id | string | Y | 无 | com.tf.thinkdroid.viewer | 媒体侧包名(仅Tiktok需要) |
| campaign_name | string | Y | 无 | Tiktok-BR-android | 广告计划名称(仅Tiktok需要) |
| campaign_id | string | Y | 无 | 1234 | 广告计划ID(仅Tiktok需要) |
| ad_name | string | Y | 无 | tt_br_android | 广告名称(仅Tiktok需要) |
| ad_id | string | Y | 无 | 4567 | 广告ID(仅Tiktok需要) |
| os_version | string | Y | 无 | 13.0.0 | 系统os版本(仅Tiktok需要) |
| model | string | Y | 无 | RMX3830 | 设备型号(仅Tiktok需要) |
| brand | string | Y | 无 | xiaomi | 设备品牌(仅Tiktok需要) |
| language | string | Y | 无 | en | 设备语言(仅Tiktok需要) |
| resolution | string | Y | 无 | 1920×1080 | 设备分辨率(仅Tiktok需要) |
| carrier | string | Y | 无 | 无 | 设备运营商(仅Tiktok需要) |
| network_access | string | Y | 无 | wifi/5g | 设备网络类型(仅Tiktok需要) |
| timezone | string | Y | 无 | 无 | 设备时区(仅Tiktok需要) |
| network_registration_time | string | Y | 无 | 无 | 设备首次入网时间(仅Tiktok需要) |
| ad_type | string | Y | 无 | app icon | 广告类型(仅Tiktok需要) |
| ad_placement | string | Y | 无 | 无 | 广告位(仅Tiktok需要) |
| ad_width | string | Y | 无 | 1920 | 广告位宽(仅Tiktok需要) |
| ad_height | string | Y | 无 | 1080 | 广告位高(仅Tiktok需要) |