# Callback 回调参数

## 数据回调参数

您可以指定您自己的键名称并从如下的键值中选择。

您也可以点击 [+] 按钮然后添加自定义的静态或者动态参数。

![](/assets/images/articles/2023_advertising_callbacks_callbackparameters_001.png)

|值|类型|描述|
|--|--|--|
|广告类型|字符串|广告显示类型 (例如 interstitial, more_apps, inplay, rewarded_video, video_interstitial)|
|奖励总数|字符串|完成视频查看后的货币奖励数量|
|投标类型|字符串|Chartboost 投标类型 (CPI, CPC, CPCV 等)； 如果广告活动为交叉推广或使用直接开票的直接交易则返回免费|
|投标值|字符串|广告活动投标值； 如果广告活动为交叉推广或使用直接开票的直接交易则返回免费或空字符串|
|广告活动 ID|字符串|您的广告活动 ID|
|广告活动名称|字符串|您的广告活动名称|
|广告活动类型|字符串|Chartboost 广告活动类型  (交叉推广、直接交易、发布活动或广告)|
|点击 ID|字符串|Chartboost 点击事件触发数据传输的唯一 ID — 仅限广告主|
|广告图片 ID (仅广告主)|字符串|广告图片 ID — 24 位数字字母混合， 例如: `5361f8abc26ee43e1c3aafe2`|
|广告图片名称 (仅广告主)|字符串|广告图片名称|
|货币名称|字符串|完成视频奖励货币类型， 三个字母 ISO 4217 货币代码格式|
|自定义 ID|字符串|来自 Chartboost SDK 发送到 `POST` 主体的自定义标识符用于 Chartboost API 服务器请求； 可用于验证通过服务器而非来自 SDK 的激励式视频。仅用于 SDK 5.0+。|
|设备国家代码|字符串|设备国家代码 — 反向 IP 搜索或 ISO 639-1 (两位字母代码)|
|设备语言|字符串|{::nomarkdown}两位字母 ISO 639-1 语言代码依据:<br><li>iOS: 首选系统键盘</li><li>Android: 设备语言</li>{:/}|
|设备型号|字符串|设备电话的范畴描述 (例如 Nexus 4)|
|设备 OS|字符串|设备操作系统版本|
|设备类型|字符串|设备型号详情 (例如 LGE Nexus 4)|
|事件类型|字符串|事件类型描述 (点击、完成查看数或结算安装数)|
|点击时间戳格式|字符串|如需将信息 (如`时间=12:51:01PM 2013-08-04PST`) 附加到您的数据传输中,  您需要在键字段`输入时间`并且在格式字段输入 `H:i:sA Y:m:de`。|
|时间戳格式|字符串|如需将信息 (如`时间=12:51:01PM 2013-08-04PST`) 附加到您的数据传输中,  您需要在键字段`输入时间`并且在格式字段输入 `H:i:sA Y:m:de`。|
|格式化 IFA|字符串|类似 IFA 但插入横线，字母大写。 仅用于 iOS SDK v3.0.7+。|
|从应用 ID|字符串|发布应用的 Chartboost 应用 ID — 24 位数字字母混合，例如: `53bc620bc26ee47f7f21fec6`|
|从应用昵称|字符串|发布应用的名称，由开发者输入到 Chartboost 后台， 名称会在广告活动数据分析 API 中显示|
|从应用官方名称|字符串|应用商店中发布应用的官方名称|
|从文件包 ID|字符串|用于发布应用的文件包 ID；iOS 文件包 ID 可以在游戏的 iTunes Connect 记录中找到； Google Play 文件包 ID 请见应用的 [Play Store URL](https://s3.amazonaws.com/chartboost/help_assets/10071.png)。|
|从公司名称|字符串|发布公司名称，在 Chartboost 帐户中所输入名称|
|从商店 ID|字符串|发布应用的 iTunes 商店 ID； 即应用所在[应用商店](https://s3.amazonaws.com/chartboost/help_assets/12_5_1.png)列表上的 9 位数字。|
|GAID|字符串|Google 广告标识符。 仅用于 Android SDK v4.0+。详情请见[设备标识符](/zh/advertising/tools/device-identifiers/)。|
|IFA|字符串|iOS 广告标识符无哈希码。 仅用于 iOS SDK v3.0.7+。详情请见[设备标识符](/zh/advertising/tools/device-identifiers/)。|
|IP 地址|字符串|触发事件的设备的 IP 地址 (例如 “10.1.2.3”) — 仅限广告主|
|平台|字符串|应用平台 — iOS, ANDROID, 或亚马逊|
|事件所有方 (广告主/媒体)|字符串|返回`广告主`或`媒体`值|
|目标名称|字符串|Chartboost 广告活动目标名称|
|到应用 ID|字符串|广告应用的 Chartboost 应用 ID — 24 位数字字母混合， 例如: `53bc620bc26ee47f7f21fec6`|
|到应用昵称|字符串|广告应用的名称，由开发者输入到 Chartboost 后台， 名称会在广告活动数据分析 API 中显示|
|到应用官方名称|字符串|应用商店中广告应用的官方名称|
|到应用签名|字符串|广告中应用的签名 — 40 为数字字母混合， 例如: `8f64804162d9c912ff290ec43d9773ef1ba121cd — 仅限广告主`|
|到文件包 ID|字符串|用于广告中应用的文件包 ID；iOS 文件包 ID 可以在游戏的 iTunes Connect 记录中找到； Google Play 文件包 ID 请见应用的 [Play Store URL](https://s3.amazonaws.com/chartboost/help_assets/10071.png)。|
|到公司名称|字符串|广告公司名称， 在 Chartboost 帐户中所输入名称|
|到商店 ID|字符串|广告中应用的 iTunes 商店 ID； 即应用所在[应用商店列表](https://s3.amazonaws.com/chartboost/help_assets/12_5_1.png)上的 9 位数字|
|用户代理|字符串|触发点击事件的移动代理设备字符串， 例如“Mozilla/5.0 (iPhone; U; CPU iPhone OS 5_0 like Mac OS X; en-us) AppleWebKit/528.18 (KHTML, like Gecko) Version/4.0 Mobile/7A341 Safari/528.16” — 仅限广告主|
|用户 ID|字符串|您的 Chartboost 用户 ID (24 位数字字母混合， 例如: `50c8cc5516ba47d406000016`)|
|UUID|字符串|{::nomarkdown}设备 ID 无哈希码:<br><li>旧版 Android ID 用于 Android OS</li><li>旧版 Android ID 用于亚马逊 OS</li><li>详情请见[设备标识符](/zh/advertising/tools/device-identifiers/)。</li>{:/}|





### 可接受的 PHP 时间戳格式和范围

|时间戳格式|描述|
|--|--|
|`D`|工作日作为区域简略名称|
|`l`|工作日作为区域全称|
|`M`|月份作为区域简略名称|
|`F`|月份作为区域全称|
|`d`|月份日期用十进制数字表示 [01,31]|
|`H`|小时数用十进制数字表示 [00,23] (24 小时制)|
|`h`|小时数用十进制数字表示 [01,12] (12 小时制)|
|`z`|天数用十进制数字表示 [001,366]，其 PHP 范围为 [000,365] 但仍将 364 天算作一年|
|`m`|月份用十进制数字表示 [01,12]|
|`i`|分钟用十进制数字表示 [00,59]|
|`a`|AM 或 PM 的区域对应表述；在 PHP 中为小写，在 Python 中为大写|
|`A`|AM 或 PM 的区域对应表述|
|`s`|秒钟用十进制数字表示 [00,61]|
|`w`|工作日用十进制数字表示 [0,6]；0 = Sunday|
|`W`|一年中的星期数，周一为周中第一天|
|`y`|年份用十进制数表示，不显示前两位数 [00,99]|
|`Y`|年份用十进制数表示 (例如 2016)|
|`O`|UTC 以 +HHMM 或 -HHMM 体现在形式上|
|`T`|时区名称，原生对象字符串为空|
|`e`|时区名称，原生对象字符串为空|
|`U`|Unix 时间|




