目录 ▼
广告活动分析
广告活动数据分析 API 提供详细报告，可以按应用或素材分组。注意，指定 groupBy 字段后，数据查询队列系统会返回 jobID，在“开始之前” 栏目有详细描述。 HTTP 方法GET端点https://analytics.chartboost.com/v3/metrics/campaign示例请求https://analytics.chartboost.com/v3/metrics/campaign?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认合计字符串可选按时间累计结果 (每日、每周、每月)每日campaignId字符串可选广告活动 ID (既可以是 To Campaign ID 又可以是 From Campaign ID 基于 groupBy 和角色)不适用campaignType字符串可选network, cross_promonetworkdateMin字符串必填最小日期 (YYYY-MM-DD)不适用dateMax字符串必填最大日期 (YYYY-MM-DD)不适用groupBy字符串可选以下其中一项: 'country' 'app' 'app,creative' 'target_creative' 'date' 'campaign' 'campaign_target' 'campaign_type'无platform字符串可选按指定平台筛选结果 (iOS、Google Play、Amazon)全部角色字符串可选广告主或流量主全选
回复字段
参数描述返回用作…adTypeId1 = interstitial 2 = more_apps 3 = in_play 4 = rewarded_video 5 = video_interstitial 10 = banner所有人应用应用名称所有人广告活动广告活动名称所有人campaignId广告活动 ID (既可以是 To Campaign ID 又可以是 From Campaign ID 基于 groupBy 和角色)所有人campaignTarget广告定位名称 (仅在按 campaign_target 分组时返回)广告主campaignSubTypeuser_acquisition所有人clicksDelivered传递点击数流量主clicksReceived接收点击数广告主cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主广告图片广告素材名称 (仅在按 creative 分组时返回)广告主ctrDelivered已传递展示次数的点击率流量主ctrReceived已接收展示次数的点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1,000 次展示收益流量主ecpmSpent每 1,000 次展示成本广告主impressionsDelivered流量主传递展示次数流量主impressionsReceived广告主接收展示次数广告主installDelivered传递安装数流量主installRateDelivered安装率流量主installRateReceived安装率广告主installReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主videoCompletedDelivered传递的视频查看完毕次数流量主videoCompletedReceived接收的视频查看完毕次数广告主 ▲ 返回顶部
应用数据分析
应用数据分析端点提供详细报告，可以按应用、广告类型或广告位置。 HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/app示例请求https://analytics.chartboost.com/v3/metrics/app?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认合计字符串可选按时间累计结果 (每日、每周、每月)每日appId字符串可选一个或多个 (逗号分隔) 应用 ID全部dateMax字符串必填最大日期 (YYYY-MM-DD)不适用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用groupBy字符串可选以下其中一项: app, ad_type,app, date, ad_location (仅限流量主), platform, campaign_type无platform字符串可选以下任何: iOS, Google Play, 亚马逊全部角色字符串可选广告主或流量主全选
回复字段
参数描述返回用作…ad_type广告素材类型 了解广告类型详情
所有人，仅当 groupBy=ad_type,appallInstalls不计来源累计安装总数 (Chartboost 或其他)所有人应用应用名称所有人appBundleId不再发送；用户会在报告中看到弃用所有人appIdChartboost 应用 ID所有人启动数用户在设备上启动您的应用的次数所有人campaignTypenetwork, cross_promo所有人, 仅当 groupBy=campaignTypeclicksDelivered传递点击数流量主clicksReceived接收点击数广告主cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主ctrDelivered已传递展示次数的点击率流量主ctrReceived已接收展示次数的点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1,000 次展示收益流量主ecpmSpent每 1,000 次展示成本广告主eventLocationChartboost 命名位置。广告主会在相应字段看到Default。所有人impressionsDelivered流量主传递展示次数流量主impressionsReceived广告主接收展示次数广告主installDelivered传递安装数流量主installRateDelivered安装率流量主installRateReceived安装率广告主installReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主platformiOS, Google Play 或 Amazon所有人唯一数启动过此应用的唯一设备数所有人videoCompletedDelivered传递的视频查看完毕次数流量主videoCompletedReceived接收的视频查看完毕次数广告主 ▲ 返回顶部
导出安装数
导出安装数端点提供所有接收或提供安装数的完整列表。断点会一直从列队数据分析系统返回工作 ID，在“开始之前”栏中有详细说明。 HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/install示例请求https://analytics.chartboost.com/v3/metrics/install?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}} 参数参数请求类型是否必填?描述默认campaignIds字符串可选一个或多个 (逗号分隔) 广告活动 ID所有广告活动campaignType字符串可选network, cross_promo全部dateMax字符串必填最大日期 (YYYY-MM-DD)不适用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用platform字符串可选以下任何: iOS, Google Play, Amazon全部角色字符串可选广告主或流量主全选
回复字段
参数描述返回用作…广告类型广告素材类型 了解广告类型详情
所有人点击时间戳日期和时间 (DD-MM-YYYY HH:MM:SS)所有人费用类型广告竞价类型 了解竞价类型详情
所有人费用值广告投标数量所有人国家设备双字符国家代码所有人日期日期和时间 (DD-MM-YYYY HH:MM:SS)所有人来自应用文件包发布应用文件包 ID所有人从应用 ID发布应用 ID所有人从应用名称发布应用名称所有人来自广告活动 ID发布活动 ID流量主来自广告活动名称发布活动名称流量主来自广告活动类型network, cross_promo流量主GAIDGoogle 广告 ID所有人 (如果行为定位禁用则仅限流量主)IFAiOS 广告主标识符 (如果 iOS 10 限制广告跟踪已禁用)所有人 (如果行为定位禁用则仅限流量主)MACMAC 地址 (弃用)不适用类型设备型号所有人OS设备操作系统所有人到应用文件包广告应用文件包 ID所有人到应用 ID广告应用 ID所有人到应用名称广告应用名称所有人到广告活动 ID广告活动 ID广告主到广告活动名称广告活动名称广告主到广告活动定位广告活动定位 ID所有人到广告活动类型network, cross_promo广告主UUID设备通用唯一标识符 (如可用)所有人 (如果行为定位禁用则仅限流量主) ▲ 返回顶部
应用数据分析按国家分组
除了您在后台的 API 浏览器页面发现的端点外，我们专门设计了用于在应用、日期和国家层面输出数据分析的端点。此端点还可由需要国家层面数据的第三方归属和中介服务代表 Chartboost 客户使用。应用数据分析按国家分组 API 仅提供过去 40 天的数据查询。
中介网络说明: 强烈建议您忽略广告活动类型字段，因为 API 会自动为 network 返回结果。
“更多应用”数据未包括在此 API 中。注意，应用和广告活动端点和您的后台数据分析可能有出入。使用广告活动端点并按照国家分组以获取应用, 国家, 和 ad_type 数据。
API 返回的数据一般会有几个小时的延迟。默认以 UTC 时区为基准。
所有 adLocation 为空 "" 的记录会被聚合到 Default 这个命名空间下.
HTTP 方法GETAPIhttps://analytics.chartboost.com/v3/metrics/appcountry示例请求https://analytics.chartboost.com/v3/metrics/appcountry?dateMin={{Minimum date}}&dateMax={{Maximum date}}&userId={{Chartboost customer’s user ID}}&userSignature={{CB customer’s user signature}}
参数
参数请求类型是否必填?描述默认appIds字符串可选一个或多个 (逗号分隔) 应用 ID全部应用dateMin字符串必填最小日期 (YYYY-MM-DD)不适用dateMax字符串必填最大日期 (YYYY-MM-DD)不适用campaignType字符串可选network, cross_promo 或者全部networkadTypeIds字符串可选一个或多个 (逗号分隔) 广告类型 ID: 1 = interstitial, 3 = in_play, 4 = rewarded_video, 5 = video_interstitial1,4,5角色字符串可选广告主或流量主流量主时区字符串可选utc 或 pstutcadLocation字符串可选一个或多个 (逗号分隔) adLocations
- 实例 #1: (adLocation=<value which is not 'all'>) 仅针对该 adLocation 并按照指定 adLocation 汇总显示结果。仅当 adLocation 为发布应用的前 3 项 adLocation 时才提供该信息。其他 adLocation 无返回信息。
- 实例 #2: (adLocation='all') 对于发布应用显示前 3 项 adLocation 的分项结果，其他结果汇总为 adLocation = 'other'。
- 实例 #3: (adLocation= 空置或未传入) 汇总所有 adLocation = 'overall' 下的数据。不提供按照 adLocation 细分的信息。
查看实例 #3
adLocation 命名空间的值必须是最近活跃的（譬如被多次请求并展示）。否则它们可能被聚合到 Default 命名空间下。
回复字段
参数描述返回用作…adLocationChartboost 命名位置。广告主会在相应字段看到Default。所有人adTypeinterstitial, rewarded_video, video_interstitial所有人应用应用名称所有人campaignType网络、交叉推广所有人clicksDelivered点击流量主clicksReceived点击广告主countryCode双字母国家代码或 “Unknown”所有人cpcvEarned完成视频收益与查看数比率流量主cpcvSpent完成视频成本与查看数比率广告主ctrDelivered点击率流量主ctrReceived点击率广告主dt日期 (YYYY-MM-DD)所有人ecpmEarned每 1000 次展示收益流量主ecpmSpent每 1000 次展示成本广告主impressionsDelivered展示次数流量主impressionsReceived展示次数广告主installRateDelivered安装率流量主installRateReceived安装率广告主installsDelivered安装流量主installsReceived安装广告主moneyEarned收益金额流量主moneySpent花费金额广告主platformiOS, Google Play 或 Amazon所有人videoCompletedDelivered已完成视频查看流量主videoCompletedReceived已完成视频查看广告主 ▲ 返回顶部
您可能还希望…
