Ad Quality Raw Data API

通过 Ad Quality Raw Data API 从 Android 应用程序中提取展示量级别的广告质量指标（如收入、点击率、广告来源、广告素材 ID 和 UX 模式），用于 BI 平台分析。

阅读时间10 分钟

最后更新于 2 天前

Ad Quality Raw Data API 允许您从 Ad Quality 中提取展示级别数据以便在内部 BI 平台上使用。

注意

如需访问 Raw Data API，请联系客户经理。

如何使用 API

获取广告质量原始数据是通过完成以下步骤执行的：

发出 API 请求，返回 URL 链接以下载报告
单击提供的链接下载报告

必须为每个单独的应用程序进行每个 API 调用，并在单个日期内执行
每个日期的数据已存储并可供 14 天使用。
- 示例：1 月 1 日的数据将在 1 月 14 日之前可用_
任何给定日期的数据仅在第二天 UTC 上午 08:00 后可用。确保仅在此时间之后调用 API
- 示例：1 月 1 日的数据仅在 UTC_ 时间 1 月 2 日上午 08:00 之后可用
数据将在可用后继续更新 2 天。此后，它们不会改变。
- 示例：1 月 1 日的数据将在 1 月 2 日和 1 月 3 日更新。1 月 3 日之后，数据不会改变_
日期和应用密钥不包含在报告中，因为它们在每个报告（文件）中是唯一的

报告 URL 的 API 请求

有效的 API 命中会返回指向请求文件的链接。

注意

该文件只能下载一小时。

身份验证类型

轴承 API 身份验证

方法

GET

必需参数

Name（名称）	类型	描述
Date（日期）	字符串	YYYY-MM-DD（UTC 时区）
appKey	字符串	应用程序密钥（在我们的平台上可以看到）

请求示例 URL


request GET'https://ad-quality.soomla.com/api/rawdata/v1?appKey=c0492d05&date=2022-07-12'``` ### Response Example URL##response-example-url```js{   "urls": [          ],   “expiration”："2022-07-07 18:47:49"}

字段定义

下表显示了在提取 Ad Quality 原始数据后将显示在报告中的字段。对于每个示例，您可以看到其包含的内容的描述和示例。

选择使用上述步骤提取的 URL 以下载报告。

广告商名称

字段	描述	示例
`event_timestamp`	Bigint	`1657500000000`
`user_id`	字符串	`1834b456-b9ea-4811-a121-9afc165c1eb0`
`ad_unit`	字符串	`Interstitial`
`ad_source`	投放广告的网络名称	`Google AdMob`
`dsp`	dsp 名称（如果有）	`TheTradeDesk`
`instance_name`	网络实例名称	`DefaultRewarded`
`country`	根据 ISO 3166-1 Alpha-2，2 个字母的国家/地区代码。	`US`
`us_state`	发生展示的状态代码	`OR`
`device_model`	字符串	`SM-A127M`
`os_version`	字符串	`18.3.1`
`sdk_version`	字符串	`5.17.0`
`app_version`	字符串	`2.8.9`
`advertiser`	`Project Makeover`
`advertiser_id`	字符串	`com.bgg.jump`
`advertiser_type`	表示游戏中显示的广告主类型的字段，包括 iOS Store ID、Android 包名称、品牌等	`package_name`
`click`	一个整数，其中 1 表示发生了单击，0 表示没有单击	`1`
`click_type`	String，我们是否看到了与此相关的 UX 模式 Ad Quality 术语表（qClick、接近_click、自动_click、早期_click、仓促_click、其他）	`auto_click,proximity_click`
`click_ts`	Bigint，客户端 UTC 时间戳	`1657450000000`
`video_completed`	与视频广告素材类型相关，一个整数，其中 1 表示视频已完成，0 表示未完成。	`1`
`video_completed_ts`	Bigint	`1657450000000`
`revenue`	用户产生的收入（美元）。	`0.5`
`category`	广告主应用在应用商店或 Google Play 中的类别	`Casual`
`content_rating`	在美国 Apple/Google 应用商店上的分级	`{"US":"Everyone"}`
creative_type	主要广告素材类型：试玩广告/视频/图像	`playable`
`creative_id`	字符串，Ad Quality 广告素材 ID	`6c3d78bfe7c74d805c01b13b44e6e1ecff16544c`
`appstore_url` （当前字段名称为 `url` ）	字符串	`https://www.ubereats.com/?utm_campaign=CM2176745-display-doubleclick_42_-99_CR-National_e_all_bra_cpm_es_Eater%7CCR%7CEatsDemandIIYTBumper-L2R0ED22-PO481364&utm_medium=display-programmatic&utm_source=dbm`
`video_urls`	字符串数组	`https://www.youtube.com/watch?v=rdahaLbmxOw`
end_card_urls	字符串数组	`https://v.ssacdn.com/demand-creatives/assets/videos/m29ateosecjmkxt2xamf.mp4`
`icon_urls`	字符串	`https://lh3.googleusercontent.com/y3iFaRQsuLPIiWnCX_Yg7j2IGWiKtnFFbsQPBwRWxIFszsV_xnZYE5VT7d1udxRqQSCPxn_cyw=w256-h256`
`image_urls`	字符串数组	`https://i.ytimg.com/vi/Pv8H5ceSeF0/hqdefault.jpg`
`imp_num`	用户序列中的印象数。对于横幅广告和原生广告，该值为 `-1`	`3`
`ad_closed`	一个整数，其中 `1` 表示已收到广告关闭事件， `0` 表示未收到广告关闭事件	`0`
`ad_closed_ts`	Bigint	`1657450000000`
`developer`	String，广告主的开发者，有广告展示	`Supersonic`
`ad_source_sdk_version`	字符串	`5.17.0`

文档

Development

User Acquisition

Monetization

工业

文档