> For the complete documentation index, see [llms.txt](https://growingio.gitbook.io/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://growingio.gitbook.io/v3/developer-manual/api-reference/originaldata-export-v2/characters/ads-character.md).

# 广告相关字段

广告相关事件字段共分为2个事件类型。

激活事件指GrowingIO 移动端Android/iOS SDK采集上报的激活事件数据。

如果激活事件能归因到某次点击事件，其中linkId、campaignId、channelId、linkName、campaignName、channelName、adsVariable 是对应点击事件的链接信息。

点击事件指Growingio广告监测链接收到(点击)访问数据。 其中的idfa、imei、uuid、androidId，如果有通常是由渠道方通过监测链接发送过来的数据。

{% tabs %}
{% tab title="ads\_track\_activation（广告激活事件）" %}

| 名称 | 类型（长度） | 说明 |
| -- | ------ | -- |

| visitUserId | string（64） | <p><访问用户ID></p><p>访问用户的唯一标识，由GrowingIo自动生成。 示例：fc55728b-41ab-42ff-8b1f-714e44c65fd6</p> |
| ----------- | ---------- | --------------------------------------------------------------------------------------: |

| idfa | string（40） | <p>\<iOS独有的广告标识符></p><p>苹果系统用于监测广告的ID。</p><p>示例：A075A0F9-32D2-4671-A78D-144B6B7D2920</p> |
| ---- | ---------- | ---------------------------------------------------------------------------------------: |

| imei | string（40） | <p>\<IMEI></p><p>Android平台用于广告监测的ID。</p><p>示例：100500636E9AA9</p> |
| ---- | ---------- | ---------------------------------------------------------------: |

| uuid | string（40） | <p>\<UUID></p><p>用于广告监测的ID的UUID格式。</p><p>示例：00000000-37fc-f5ob-1e8d-484b190312e1</p> |
| ---- | ---------- | -----------------------------------------------------------------------------------: |

| androidId | string（40） | <p>\<Android ID></p><p>SSAID，又称为Android ID。示例：2cab90e2a3b489ed</p> |
| --------- | ---------- | -----------------------------------------------------------------: |

| ip | string（15） | <p>\<IP地址></p><p>示例：127.0.0.1</p> |
| -- | ---------- | --------------------------------: |

| userAgent | string（512） | <p><用户代理></p><p>简称 UA，它是一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。</p><p>示例：Mozilla/5.0 (iPhone; CPU iPhone OS 11\_2\_6 like Mac OS X) AppleWebKit/604.5.6 (KHTML, like Gecko) Mobile/15D100</p> |
| --------- | ----------- | -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| platform | string（20） | <p><平台></p><p>访问所属平台，可能值为 iOS / Android  等。 示例：Android</p> |
| -------- | ---------- | ---------------------------------------------------------: |

| operatingSystemVersion | string（50） | <p><操作系统版本></p><p>示例：iOS 11.0.1 /Android 6.0.1</p> |
| ---------------------- | ---------- | -------------------------------------------------: |

| sendTime | bigint | <p><发送时间></p><p>请求在SDK发送的时间戳。</p><p>示例：1520899221211</p> |
| -------- | ------ | -------------------------------------------------------: |

| linkId | string（20） | <p><链接ID></p><p>监测链接ID。</p><p>示例：Yo1KJXRl</p> |
| ------ | ---------- | --------------------------------------------: |

| campaignId | string（20） | <p><活动ID></p><p>示例：GPndl79Y</p> |
| ---------- | ---------- | ------------------------------: |

| channelID | string（20） | <p><渠道ID></p><p>示例：inmobi</p> |
| --------- | ---------- | ----------------------------: |

| linkName | string（60） | <p><链接名称></p><p>2018/5/8 开始生效。</p><p>示例：测试链接</p> |
| -------- | ---------- | -----------------------------------------------: |

| campaignName | string（60） | <p><活动名称></p><p>2018/5/8 开始生效。</p><p>示例：双十一推广</p> |
| ------------ | ---------- | ------------------------------------------------: |

| channelName | string（60） | <p><渠道名称></p><p>2018/5/8 开始生效。</p><p>示例：今日头条</p> |
| ----------- | ---------- | -----------------------------------------------: |

| adsVariable | map\<String,String> | <p><链接维度参数></p><p>2018/8/7 开始生效。</p><p>示例：{"city"->"beijing"}。</p> |
| ----------- | ------------------- | -----------------------------------------------------------------: |

| OAID         | string（64） | <匿名设备标识符>Android平台用于广告监测的ID。2020/01/07 开始生效。 |
| ------------ | ---------- | -------------------------------------------- |
| {% endtab %} |            |                                              |

{% tab title="ads\_track\_click（广告点击事件）" %}

| 名称 | 类型（长度） | 说明 |
| -- | ------ | -- |

| idfa | string（40） | <p>\<iOS独有的广告标识符></p><p>苹果系统用于监测广告的ID。</p><p>示例：A075A0F9-32D2-4671-A78D-144B6B7D2920</p> |
| ---- | ---------- | ---------------------------------------------------------------------------------------- |

| IMEI | string（40） | <p><国际移动设备识别码></p><p>示例：867459000000000</p> |
| ---- | ---------- | ------------------------------------------- |

| uuid | string（40） | <p>\<UUID></p><p>用于广告监测的ID的UUID格式。</p><p>示例：00000000-37fc-f5ob-1e8d-484b190312e1</p> |
| ---- | ---------- | ------------------------------------------------------------------------------------ |

| androidId | string（40） | <p>\<Android ID></p><p>SSAID，又称为Android ID。</p><p>示例：2cab90e2a3b489ed</p> |
| --------- | ---------- | ------------------------------------------------------------------------- |

| ip | string（15） | <p>\<IP地址></p><p>示例：127.0.0.1</p> |
| -- | ---------- | --------------------------------- |

| userAgent | string（512） | <p><用户代理></p><p>简称 UA，它是一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。</p><p>示例：Mozilla/5.0 (iPhone; CPU iPhone OS 11\_2\_6 like Mac OS X) AppleWebKit/604.5.6 (KHTML, like Gecko) Mobile/15D100</p> |
| --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

| platform | string（20） | <p><平台></p><p>访问所属操作系统，可能值为 iOS / Android  等。 示例：Android</p> |
| -------- | ---------- | ------------------------------------------------------------ |

| operatingSystemVersion | string（50） | <p><操作系统版本></p><p>示例：iOS 11.0.1 /Android 6.0.1</p> |
| ---------------------- | ---------- | -------------------------------------------------- |

| eventTime | bigint | <p><点击请求时间></p><p>请求在SDK发送的时间戳.。</p><p>示例：1521315962320</p> |
| --------- | ------ | ----------------------------------------------------------- |

| linkId | string(20) | <p><链接ID></p><p>监测链接ID。 示例：Yo1KJXRl</p> |
| ------ | ---------- | --------------------------------------- |

| campaignId | string（20） | <p><活动ID></p><p>示例：GPndl79Y</p> |
| ---------- | ---------- | ------------------------------- |

| channelId | string（20） | <p><渠道ID></p><p>示例：inmobi</p> |
| --------- | ---------- | ----------------------------- |

| linkName | string（60） | <p><链接名称></p><p>2018/5/8 开始生效。</p><p>示例：测试链接</p> |
| -------- | ---------- | ------------------------------------------------ |

| campaignName | string（60） | <p><活动名称></p><p>2018/5/8 开始生效。</p><p>示例：双十一推广</p> |
| ------------ | ---------- | ------------------------------------------------- |

| channelName | string（60） | <p><渠道名称></p><p>2018/5/8 开始生效。</p><p>示例：今日头条</p> |
| ----------- | ---------- | ------------------------------------------------ |

| adsVariable | map\<string,string> | <p><链接维度参数></p><p>2018/8/7 开始生效。</p><p>示例：{"city"->"beijing"}</p> |
| ----------- | ------------------- | ----------------------------------------------------------------- |

| OAID          | string（64） | <匿名设备标识符>Android平台用于广告监测的ID。2020/01/07 开始生效。                                                              |
| ------------- | ---------- | --------------------------------------------------------------------------------------------------------- |
| clickUrl      | string     | <p><链接点击url> 监测链接的点击url信息。2020/09/20 开始生效。</p><p>示例: <br><https://datayi.cn/rABC?idfa=IDFAXX> </p><p></p> |
| {% endtab %}  |            |                                                                                                           |
| {% endtabs %} |            |                                                                                                           |
