--- metadata: - name: generator content: Diplodoc Platform v5.64.0 alternate: - https://boost.yandex.com/doc/en/analytics/content/mobile-api/post/post-adrevenue.md - https://boost.yandex.com/doc/ru/analytics/content/mobile-api/post/post-adrevenue.md - https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-adrevenue.md - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-adrevenue.md type: text/markdown title: Markdown version - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21876058 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21876058 # 上传广告收入事件 传输广告收入信息。 使用示例：您可以使用 Post API 传输与每个应用用户相关的广告点击收入信息。 通过 Post API 接收的购买事件用于计算所有指标，也可在漏斗和分群中使用。 事件属性可以通过参数或请求体传递。 当您在请求体中传递数据时，应将`.csv`添加到请求的URL中。 要了解更多信息，请查看[示例请求](#sample)。 要将事件绑定到用户，您需要在API请求中使用以下字段之一： - `profile_id` - `appmetrica 设备 ID` {% note alert %} Post API 有数据加载限制。 要了解更多信息，请查看[限制](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/restrictions.md)。 {% endnote %} ## 请求格式 {#request-format} ``` POST https://api.boost.yandex.com/日志/v1/导入/广告收入 ? post_api_key= & application_id= & profile_id= & appmetrica_device_id= & event_timestamp= & revenue= & currency= & ad_type= & [ad_network=] & [ad_unit_id=] & [ad_unit_name=] & [ad_placement_id=] & [ad_placement_name=] & [precision=] & [payload=] & [session_type=] & [ios_ifa=] & [ios_ifv=] & [google_aid=] & [windows_aid=] & [os_name=] & [os_version=] & [device_manufacturer=] & [device_model=] & [device_type=] & [device_locale=] & [app_version_name=] & [app_package_name=] & [connection_type=] & [operator_name=] & [mcc=] & [mnc=] & [device_ipv6=] ``` #| || `post API 密钥`* | 用于数据上传的令牌。 您可以在应用的 **设置** 部分获取它。 || || `应用ID`* | 应用在 Analytics module 中的唯一数字标识符。 || || `profile_id`* | 用户个人资料 ID。 Post API 仅允许您上传先前通过 SDK 发送的标识符的数据。 {% note alert %} 不要传递带有 `appmetrica_device_id` 参数的值。 服务器只接受这些参数中的一个。 {% endnote %} || || `appmetrica_设备_ID`* | Analytics module 设置的设备唯一标识符的哈希。 Post API 仅允许您上传先前通过 SDK 发送的标识符的数据。 {% note alert %} 不要传递 `profile_id` 参数。 服务器只接受这些参数中的一个。 {% endnote %} || || `事件时间戳`* | 事件的时间，格式为 [Unix time](https://en.wikipedia.org/wiki/Unix_time)。 使用 Post API，您只能在事件日期（event_timestamp）与上传日期之间的差异不超过 14 天时上传事件。 API 期望以秒为单位的值。 || || `收入`* | 每次广告展示的收入。 收入金额，格式为 decimal(10.8)（小数点前 10 位、小数点后 8 位的十进制小数）。 || || `货币`* | 购买的货币。 [可用货币列表](https://boost.yandex.com/doc/zh/analytics/content/data-collection/currency-codes.md). || || `广告类型`* | 广告类型。 可用值：`native, banner, rewarded, interstitial, mrec, other`。 || || `广告网络` | 广告网络名称。 || || `ad_unit_id` | 广告网络中的单元 ID。 || || `广告单元名称` | 广告网络中的单元名称。 || || `广告投放ID` | 广告网络中的广告位 ID。 || || `广告位名称` | 广告网络中的广告位名称。 || || `精度` | 数据传输的精度。 例如，`publisher_defined, estimated`。 || || `payload` | 任意负载：以键值对形式呈现的附加信息。 最大大小为 30 KB。 如果值超过此限制，Analytics module 将截断它。 || || `session_type` | 会话类型。 可能的值： - `foreground` — 在 [事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md) 报告中 Analytics module 用户 **数量** 指标增加。 - `背景` — 在 [事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md) 报告中 Analytics module 增加了 **设备** 指标。 这样的事件不会被包含在按用户分组的报告中，也不会出现在个人卡片中。 Default value is `背景`. || || `ios_ifa` | 设备的 IFA，格式为从设备接收的格式。 || || `ios_ifv` | 应用的 IFV，格式为从设备接收的格式。 || || `google_aid` | 设备的 Google AID，格式为从设备接收的格式。 || || `windows_aid` | 设备的 Windows AID，格式为从设备接收的格式。 || || `os_name` | 用户设备上的操作系统：`ios` \| `android` \| `windows`。 || || `os_version` | 用户设备上的操作系统版本。 || || `设备制造商` | Analytics 服务检测到的设备制造商（例如，Apple 或 Samsung）。 || || `设备模型` | Analytics 服务检测到的设备型号（例如，Galaxy S6）。 || || `device_type` | Analytics 服务检测到的设备类型。 可能的值：`phone` \| `tablet` \| `unknown`。 || || `device_locale` | 设备上的语言。 || || `应用版本名称` | 开发者指定的应用版本格式。 || || `app_package_name` | Android 的包名，或 iOS 的 Bundle ID（例如，ru.yandex.metro）。 || || `连接类型` | 连接类型。 可能的值：`wifi` \| `cell` \| `unknown`。 || || `operator_name` | 移动运营商名称。 || || `mcc` | 移动国家代码。 || || `mnc` | 移动网络代码。 || || `device_ipv6` | 事件时的 IP 地址，格式为 [IPv6](https://en.wikipedia.org/wiki/IPv6)。 例如，2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147。 || |# ## Response codes | Code | 描述 | | ----- | ----- | | 200 | 数据已成功上传。 | | 403 | 请求缺少授权头，或者指定了无效的令牌。 | | 400 | 请求中缺少一个或多个必需参数。 | ## 示例请求 {#sample} {% list tabs %} - 在请求体中发送数据 ```http translate=no POST /logs/v1/import/adrevenue.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1 Host: api.boost.yandex.com Content-Length: 540i Connection: close application_id,profile_id,appmetrica_device_id,event_timestamp,revenue,currency,ad_type,ad_network,ad_unit_id,ad_unit_name,ad_placement_id,ad_placement_name,precision,payload,session_type,ios_ifa,ios_ifv,google_aid,windows_aid,os_name,os_version,device_manufacturer,device_model,device_type,device_locale,app_version_name,app_package_name,connection_type,operator_name,mcc,mnc,device_ipv6 1234567890,1234567890abcdef,1757762239877245682,1689943892,0.0001,usd,banner,some_network_name,0987654321,some_unit_name,12345000,some_placement_name,estimated,"{""key"":""value_1""}",foreground,123456abcde,54321edcba,098765abcde,567890abcde,ios,16.6,Apple,iPhone14Pro,phone,en_US,some_version_name,some_package_name,wifi,MegaFon,250,2,2a02:6b8::40c:6676:baff:fea6:53d8 ``` - 通过请求参数发送数据 ```http translate=no POST /logs/v1/import/adrevenue.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012&application_id=1234567890&profile_id=1234567890abcdef&appmetrica_device_id=1757762239877245682&event_timestamp=1689943892&revenue=0.0001¤cy=usd&ad_type=banner&ad_network=some_network_name&ad_unit_id=0987654321&ad_unit_name=some_unit_name&ad_placement_id=12345000&ad_placement_name=some_placement_name&precision=estimated&payload="{""key"":""value_1""}"&session_type=foreground&ios_ifa=123456abcde&ios_ifv=54321edcba&google_aid=098765abcde&windows_aid=567890abcde&os_name=ios&os_version=16.6&device_manufacturer=Apple&device_model=iPhone14Pro&device_type=phone&device_locale=en_US&app_version_name=some_version_name&app_package_name=some_package_name&connection_type=wifi&operator_name=MegaFon&mcc=250&mnc=2&device_ipv6=2a02:6b8::40c:6676:baff:fea6:53d8 HTTP/1.1 Host: api.boost.yandex.com Content-Length: 0 Connection: close ``` {% endlist %} ## 其他 Post API 方法 {#other-methods} - [上传事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-import-events.md) - [上传应用内收入事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-revenue.md) - [上传电商事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-ecommerce.md) - [个人属性](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-profile-attributes.md) 如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。 联系支持 建议改进文档