文档

​
​

Development

User Acquisition

Monetization

工业

Unity Offerwall

Offerwall Android SDK

Offerwall iOS SDK

Offerwall Unity SDK

Unity Offerwall

Tapjoy Offerwall
​
​
开始使用
  • 访问 Tapjoy Offerwall 变现后台
  • 开始使用 Offerwall
  • 在 Unity Ads 中推广 Offerwall
  • 应用设置
Dashboard（后台）
  • AB 测试
  • 货币促销
  • 兑换比例
  • 消息
  • Offerwall 卡片
  • 广告位
  • 发行商客户服务工具
  • 定向投放
  • 指标参考
优化
  • 变现策略规划
API
  • API 身份验证
  • Reporting API 发行商
  • Reporting API 最佳实践
  • 内容管理
  • 用户级收入 API 概述
虚拟货币
  • 虚拟货币概述
  • 自管货币
  • Tapjoy 托管货币
  • 回调故障故障排除
其他
  • Offerwall Monetization（变现）后台用户角色和权限
  • 故障排除
  • 应用隐私 - iOS
  • 数据安全 - Android
  • 常见问题解答
  1. 实现游戏增长
  3. Unity Offerwall
  5. Offerwall 变现

用户级收入 API 概述

使用 Tapjoy Offerwall 的用户级收入 API 追踪特定用户的收入，并根据实用的洞察信息调整应用的变现策略。
阅读时间8 分钟
最后更新于 2 天前
Tapjoy 允许发行商通过用户级广告收入 API 访问其 Offerwall 用户级广告收入数据，此外还可使用我们现有的任务数据回调。此 API 通过存储在 Amazon Web Services (AWS) S3 中的 CSV 文件，直接向移动端成效衡量合作伙伴 (MMP) 或发行商合作伙伴提供用户级广告收入报告。
为了发起请求，用户需要提供相关的 Tapjoy app ID（与 Tapjoy LTV 后台的应用关联的 ID）和所需数据的日期。
要使用此 API，MMP 或合作伙伴必须使用其 Reporting API/Marketing API 密钥向 Tapjoy OAuth 终端发起请求以获取访问令牌。获得访问令牌后，用户向 Tapjoy Report API 发起请求以获取指向 AWS S3 报告的预签名 URL。预签名 URL 在获取后 5 分钟内有效，可用于访问这些报告。最后，对 AWS S3 报告 URL 的请求将返回包含用户级广告收入数据的 CSV 报告。

Report API

终端：
https://api.tapjoy.com/api/client/publisher/apps/<app_id>/user_revenue_report
可使用 Reporting API/Marketing API 密钥通过 OAuth 进行访问。
必需参数：
  • 发行商 App ID
  • UTC 日期
可接受的日期格式为 mm/dd、mm/dd/yyy、mm/dd/yy、dd-mm yyy-mm-dd
返回一个静态报告 URL 数组，包括有效期为 5 分钟的预签名身份验证令牌。

请求示例

以下示例显示了用户收入报告请求所需的标头。
GET api/client/publisher/apps/<publisher_app_id>/user_revenue_report?date=<date> Host: api.tapjoy.com Authorization: Bearer <access_token_string> Accept: application/json

响应示例

成功

成功的请求会返回指向 S3 中报告文件的预签名 URL 数组。
{	"urls": [	"https://tapjoy.amazon.s3.com/data/report.csv.gz&key=secure"  	  ]}

失败

如果未找到发布者 app ID，则请求返回 404 状态并带有描述性报错消息。
status 404 { 	"reason":“No Publisher app with id <publisher_app_id> found。”}

S3 API

数据 SLA - 第 x 天的数据在第 x+1 天 01:00（UTC 时间）之前准备就绪
留存 SLA - 报告的可用时间为 14 天（第 x 天 + 15 天）
返回用户级收入报告的 CSV 文件

请求示例

以下示例展示了如何从预签名的 S3 网址请求报告文件。
GET /data/report.csv.gz&key=secureHost: tapjoy.amazon.s3.com Accept: application/json

响应示例

成功

以下示例显示了成功 S3 请求的响应以及未经授权或未找到条件的报错响应。
status 200 {   CSV File}
status 401 {   "error":"Unauthorized" }status 404 {   "error":“Not Found” }

字段概述

下表详细说明了报告中的不同列的含义。

字段

描述

date_id 和 report_date这是 API 请求中由用户指定的报告日期。报告中的指标会基于这个指定日期
partner_id这是您在 Tapjoy 内部的标识符
app_name 和 appkey这些是应用的名称和 Tapjoy 标识符
IDFA/IDFV/GAID根据具体平台，这些列将具有标识符值或为“UNKNOWN（未知）”
device_os_version关联的移动设备的操作系统版本
att_status设备的 iOS 应用追踪透明度状态（如果已知）
publisher_user_id与设备关联的发行商标识符（如果可用）
ad_unit此字段的值将始终为 offerwall，供 MMP 用于处理
placementTapjoy 广告位名称
content_cardTapjoy 内容卡片名称
geoip_country与设备相关的国家/地区（如果可通过 IP 查找获得）
currency_sale值为 1 表示发生相关转化时未在进行货币促销，如果存在促销，则为货币乘数值
conversion_rate这是交易使用的货币兑换比例
impressions此设备 ID 在指定日期关联的总展示量。这一数值反映用户在完成转化当天查看转化任务的次数
publisher_amount此设备 ID 在指定日期关联的总收入

常见问题解答

否，此报告仅包含 Offerwall 广告收入。如果需要用户级广告收入数据，合作伙伴应联系他们的聚合平台以访问适用的 API 或报告。

发行商合作伙伴可以在 14 天内访问报告，每天凌晨 1:00（UTC 时间）开始可以访问前一天的报告。

在 MR-CPE 产品中，从广告展示到用户后续在多重奖励漏斗图中完成事件转化，通常会有延迟（可能长达几天甚至几周）。

以美元 (USD) 显示

Appsflyer

同一名用户在同一个发行商应用中查看任务和最终完成转化时，其 
publisher_user_ids
或 
geoip_countries
有可能会不同。这些 ID 由发行商在 SDK 初始化时设置，因此有可能会发生如下情况：
1.用户以 
publisher_user_id A
进行连接。 2.他们查看任务 A。查看记录中显示 
publisher_user_id A
。 3.用户稍后以 
publisher_user_id B
进行连接。 4.他们再次查看任务 A。查看记录中显示 
publisher_user_id B
。 5.他们完成转化。转化记录中显示 
publisher_user_id B
。
geoip_countries
也可能发生同样的情况。为了避免收入膨胀，需要将这些值合并为一行。
Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择（Cookie 设置）

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标（此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见，一些页面是机器翻译的，可能包含不准确的内容。如有信息不一致的情况，以英文版本为准。

  • 在本页上

    • Report API

      • 请求示例

      • 响应示例

      • 成功

      • 失败

    • S3 API

      • 请求示例

      • 响应示例

      • 成功

    • 字段概述

    • 常见问题解答

报告此页面的问题