报告 API

概览

InMobi Publisher Reporting API 3.0 可让您自动下载应用程序的性能数据。本主题将带您了解关键的 API 功能和用例。

发布商报告 API 符合 REST 规范并支持 JSON 格式。要查询报告 API，您需要发送 API 密钥secretKey。

笔记

我们面向所有发布商（除来自中国的发布商外）的 API 端点为 https://api.inmobi.com/v3.0/reporting/publisher，请求头为“Content-Type:application/json”和“Accept:application/json”。
要请求压缩响应，请在请求中包含以下标头： Accept-Encoding: gzip

正在生成 API 密钥

API密钥是由InMobi生成的用于访问报表功能的凭证。注册或收到新用户邀请时，系统会自动向用户发送一封包含API密钥的邮件。

只有账户的发布者管理员才能为自己或其他用户生成 API 密钥。其他用户角色无法为自己或其他用户生成 API 密钥。此外，只有发布者管理员才能重置账户内其他用户的密钥，其他用户只能重置自己的 API 密钥。

在“帐户设置”部分的“API 密钥”子选项卡中，可以执行以下两项操作：

生成 API 密钥：首次为用户创建 API 密钥。
重置 API 密钥：重置之前已生成 API 密钥的用户的 API 密钥。

生成 API 密钥

前往“我的账户”账户设置。
转到API 密钥选项卡，然后单击“生成 API 密钥”。
选择需要获取密钥的用户邮箱地址。

重置 API 密钥

如果您忘记了之前生成的 API 密钥，可以通过将鼠标悬停在API 密钥子选项卡上的电子邮件地址来重置它。

发布者管理员可以重置自己和其他用户的 API 密钥，而其他用户角色只能重置自己的 API 密钥。

请求有效会话

任何 API 请求都需要有效的会话才能进行身份验证。会话自发出之日起有效期为 8 小时。一个 API 密钥在 8 小时内最多可以生成 15 个有效会话。

样品申请

curl -v <a href=<span class="hljs-string">"https://api.inmobi.com/v1.0/generatesession/generate"</span>> https://api.inmobi.com/v1.0/generatesession/gener...</a>   
-H <span class="hljs-string">"userName:#######"</span>  
-H <span class="hljs-string">"secretKey:########"</span>

笔记

密码并非生成有效会话的必要条件，但如果您已在请求中使用密码，则不会受到影响。

样本响应

JSON
{
"respList": [{
"sessionId": "b8<span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span>d31942",
"accountId": "4028cb<span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span><span class="hljs-strong">****</span>14",
"subAccounts": null
}],
"error": false,
"errorList": []
}

会话长度可以超过 1000 个字符。建议您选择合适的数据类型。

调用 API

所有数据均以格林威治标准时间 (GMT) 返回。例如，以下是获取展示次数的 API 调用：

样品申请

curl -v -X POST   
-H <span class="hljs-string">"Content-Type:application/json"</span>  
-H <span class="hljs-string">"Accept:application/json"</span>  
-H <span class="hljs-string">"accountId:14a************************9e"</span> 
-H <span class="hljs-string">"secretKey: ####"</span>  
-H <span class="hljs-string">"sessionId: ###"</span>  
-d  '{<span class="hljs-string">"reportRequest"</span>:{<span class="hljs-string">"metrics"</span>:[<span class="hljs-string">"adImpressions"</span>],<span class="hljs-string">"timeFrame"</span>:<span class="hljs-string">"2017-07-20:2017-07-30"</span>,<span class="hljs-string">"groupBy"</span>:[<span class="hljs-string">"date"</span>], <span class="hljs-string">"filterBy"</span>:[{ <span class="hljs-string">"filterName"</span>:<span class="hljs-string">"adImpressions"</span>, <span class="hljs-string">"filterValue"</span>: <span class="hljs-string">"300"</span> , <span class="hljs-string">"comparator"</span>:<span class="hljs-string">">"</span>}]}}' 
<a href=<span class="hljs-string">"https://api.inmobi.com/v3.0/reporting/publisher"</span>> 
<span class="hljs-section">https://api.inmobi.com/v3.0/reporting/publisher </span>
</a>

样本响应

<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"error"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"respList"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1786296</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-24 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1951438</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-25 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">8062637</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-29 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">11151057</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-30 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">4190525</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-21 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">10044183</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-27 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">3881191</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-22 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">9841295</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-20 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">4605890</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-26 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">6175605</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-28 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adImpressions"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">2247567</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-23 00:00:00"</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>

报告详情

InMobi 报告 API 支持 CSV 输出，发布商可以从中检索库存绩效数据。

库存效果数据仅包含应用和广告单元的信息。此报告包含广告请求、展示次数、点击次数和点击率 (CTR) 等指标。客户可以根据请求数据计算库存填充率。

以下是支持的指标、分组和筛选参数。

指标

范围	描述
广告请求	所有广告请求的汇总
广告展示次数	所有渲染结果的总和
点击	所有点击次数的汇总
收益	平均收入
已提供服务的印象	所有投放展示次数的总和。
每千美元成本	eCPM值（每千次展示成本）
填充率	填充率值

分组

范围	描述
国家	按区域对报告进行分组
请求槽	按放置尺寸（例如 480x320）对报告进行分组
平台	按操作系统对报告进行分组
日期	报告汇总日期
帐户	按账户（发布商账户下的子账户）对报告进行分组
inmobiAppId	按应用 ID 对报告进行分组（应用的所有展示位置）
放置	放置
广告单元类型	按广告单元类型对报告进行分组
integrationDirect	按集成类型生成的群组报告
请求包 ID	按请求的 BundleID 对报告进行分组

过滤

范围	值类型	描述	比较器
国家	细绳	按目标国家/地区筛选，例如“韩国”	=
inmobiAppId	长的	应用的唯一标识符，例如 14999472554## 按应用 ID 筛选	=，IN
inmobiAppName	姓名	按应用名称筛选，例如“Horoscoper”	=
placementId	长的	应用内广告位的唯一标识符，例如 1478496451110。按广告位 ID 筛选。	=
位置名称	细绳	按植入位置名称筛选，例如“默认间质植入”	=
平台	细绳	按操作系统筛选，例如 iOS、安卓	=，IN
收益	长的	按总收入筛选，例如 100	>、<、=、>=、<=
广告展示次数	长的	按展示次数筛选，例如 100	>、<、=、>=、<=
广告单元类型	细绳	按广告单元类型筛选	=，IN

分页

如果请求返回的数据集可能超过 5000 行数据，则需要进行分页。我们已将每次报表 API 调用返回的数据行数限制为 5000 行。可以通过以下参数在请求中实现分页：

偏移量（从“0”开始）
长度（要提取的行数，应小于 5000）

为了获取完整的数据集，后续调用的偏移量值应为前一次调用中偏移量 + 长度之和。最后一次这样的调用应获取行数小于或等于“长度”的数据。

当使用分页时，必须在请求中发送“orderBy”和“orderType”，以避免响应中出现重复记录。

“orderBy”支持以下指标和维度：
点击次数、广告展示次数、已投放展示次数、每千次展示成本、填充率、广告请求次数、收益、国家/地区、平台、日期、请求槽位、inmobiAppId、广告位
“orderType”的值：“asc”表示升序，“desc”表示降序。

例如：获取三条记录

要求

curl -v -X POST  
-H <span class="hljs-string">"Content-Type:application/json"</span>  
-H <span class="hljs-string">"Accept:application/json"</span>  
-H <span class="hljs-string">"accountId:4028cb************************14"</span>  
-H <span class="hljs-string">"secretKey: ####"</span>  
-H <span class="hljs-string">"sessionId: ####” 
-d  '{"</span>reportRequest<span class="hljs-string">":{"</span>metrics<span class="hljs-string">":["</span>clicks<span class="hljs-string">"],"</span>timeFrame<span class="hljs-string">":"</span>2017-07-20:2017-07-30<span class="hljs-string">","</span>groupBy<span class="hljs-string">":["</span>country<span class="hljs-string">"],"</span>offset<span class="hljs-string">": 0, "</span>length<span class="hljs-string">": 3, "</span>orderBy<span class="hljs-string">": ["</span>clicks<span class="hljs-string">"], "</span>orderType<span class="hljs-string">": "</span>desc<span class="hljs-string">"}}'    
<a href="</span>https://api.inmobi.com/v3.0/reporting/publisher<span class="hljs-string">"> 
https://api.inmobi.com/v3.0/reporting/publisher 
</a></span>

<span class="hljs-punctuation">{</span>
  <span class="hljs-attr">"error"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
  <span class="hljs-attr">"respList"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
    <span class="hljs-punctuation">{</span>
      <span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">8</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"country"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Finland"</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"countryId"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">105</span>
    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
    <span class="hljs-punctuation">{</span>
      <span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">4</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"country"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Suriname"</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"countryId"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">290</span>
    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
    <span class="hljs-punctuation">{</span>
      <span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">3</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"country"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"Belarus"</span><span class="hljs-punctuation">,</span>
      <span class="hljs-attr">"countryId"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">142</span>
    <span class="hljs-punctuation">}</span>
  <span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>

笔记：

以上述示例为基础，要检索 13000 条记录，需要进行 3 次报表调用，偏移量和长度的值如下：

<span class="hljs-attr">1st call :</span> <span class="hljs-string">offset</span> <span class="hljs-string">=</span> <span class="hljs-number">0</span><span class="hljs-string">,</span> <span class="hljs-string">length</span> <span class="hljs-string">=</span> <span class="hljs-number">5000</span>
<span class="hljs-attr">2nd call :</span> <span class="hljs-string">offset</span> <span class="hljs-string">=</span> <span class="hljs-number">5000</span><span class="hljs-string">,</span> <span class="hljs-string">length</span> <span class="hljs-string">=</span> <span class="hljs-number">5000</span>
<span class="hljs-attr">3rd call :</span> <span class="hljs-string">offset</span> <span class="hljs-string">=</span> <span class="hljs-number">10000</span><span class="hljs-string">,</span> <span class="hljs-string">length</span> <span class="hljs-string">=</span> <span class="hljs-number">3000</span>

示例

让我们来看一些不同数据场景下的请求和响应示例。

示例 1：账户的点击量和收益

要求

curl -v -X POST   
-H <span class="hljs-string">"Content-Type:application/json"</span>  
-H <span class="hljs-string">"Accept:application/json"</span>  
-H <span class="hljs-string">"accountId:14a************************9e"</span> 
-H <span class="hljs-string">"secretKey: ####"</span>  
-H <span class="hljs-string">"sessionId: ####” 
-d  '{"</span>reportRequest<span class="hljs-string">":{"</span>metrics<span class="hljs-string">":["</span>earnings<span class="hljs-string">","</span>clicks<span class="hljs-string">"],"</span>timeFrame<span class="hljs-string">":"</span>2017-07-20:2017-07-30<span class="hljs-string">"}}' 
<a href="</span>https://api.inmobi.com/v3.0/reporting/publisher<span class="hljs-string">"> 
https://api.inmobi.com/v3.0/reporting/publisher 
</a></span>

{
<span class="hljs-attr">"error":</span> <span class="hljs-literal">false</span>,
<span class="hljs-attr">"respList":</span> [{
<span class="hljs-attr">"clicks":</span> <span class="hljs-number">3901721</span>,
<span class="hljs-attr">"earnings":</span> <span class="hljs-number">2076.485</span>
}]
}

示例 2：按日期分组的帐户点击量和收益

要求

 curl -v -X POST  
-H <span class="hljs-string">"Content-Type:application/json"</span>  
-H <span class="hljs-string">"Accept:application/json"</span> 
-H <span class="hljs-string">"accountId:4028cb************************14 
-H "</span>secretKey: <span class="hljs-comment">####"  </span>
-H <span class="hljs-string">"sessionId: ####” 
-d  '{"</span>reportRequest<span class="hljs-string">":{"</span>metrics<span class="hljs-string">":["</span>earnings<span class="hljs-string">","</span>clicks<span class="hljs-string">"],"</span>groupBy<span class="hljs-string">":["</span><span class="hljs-built_in">date</span><span class="hljs-string">"],"</span>timeFrame<span class="hljs-string">":"</span>2017-07-20:2017-07-30<span class="hljs-string">"}}'   
<a href="</span>https://api.inmobi.com/v3.0/reporting/publisher<span class="hljs-string">"> 
https://api.inmobi.com/v3.0/reporting/publisher 
</a></span>

<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"error"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"respList"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">131833</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-24 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">228.166</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">145627</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-25 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">231.309</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">351536</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-29 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">85.275</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">563490</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-30 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">148.264</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">318369</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-21 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">313.458</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">773215</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-27 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">76.041</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">295016</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-22 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">276.296</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">471678</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-20 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">314.018</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">350179</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-26 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">116.173</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">332405</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-28 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">69.499</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span> <span class="hljs-punctuation">{</span>
<span class="hljs-attr">"clicks"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">168373</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"date"</span><span class="hljs-punctuation">:</span> <span class="hljs-string">"2017-07-23 00:00:00"</span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"earnings"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">217.987</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>

示例 3：针对特定应用 ID 的广告请求

要求

curl -v -X POST   
-H <span class="hljs-string">"Content-Type:application/json"</span>  
-H <span class="hljs-string">"Accept:application/json"</span>  
-H <span class="hljs-string">"accountId:4028cb************************14 
-H "</span>secretKey: <span class="hljs-comment">####"  </span>
-H <span class="hljs-string">"sessionId: ####” 
-d  '{"</span>reportRequest<span class="hljs-string">":{"</span>metrics<span class="hljs-string">":["</span>adRequests<span class="hljs-string">"],"</span>timeFrame<span class="hljs-string">":"</span>2017-07-20:2017-07-30<span class="hljs-string">","</span>filterBy<span class="hljs-string">":[{ "</span>filterName<span class="hljs-string">":"</span>inmobiAppId<span class="hljs-string">", "</span>filterValue<span class="hljs-string">": "</span>1489455016170<span class="hljs-string">" , "</span>comparator<span class="hljs-string">":"</span>=<span class="hljs-string">"}]}}'  
<a href="</span>https://api.inmobi.com/v3.0/reporting/publisher<span class="hljs-string">"> 
https://api.inmobi.com/v3.0/reporting/publisher 
</a></span>

<span class="hljs-punctuation">{</span>
<span class="hljs-attr">"error"</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
<span class="hljs-attr">"respList"</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">{</span>
<span class="hljs-attr">"adRequests"</span><span class="hljs-punctuation">:</span> <span class="hljs-number">179623</span>
<span class="hljs-punctuation">}</span><span class="hljs-punctuation">]</span>
<span class="hljs-punctuation">}</span>

错误代码

下表列出了可能的错误代码：

错误代码	描述
1000	发布商报告中出现意外错误。
1001	请求对象无效。
1002	请求中包含无效的偏移量。
1003	请求中包含无效的长度。
1004	客户端请求无效。请确保客户端请求格式正确。
2000	请求中缺少账户ID。请在请求中提供账户ID。
2001	过滤器中传递的一个或多个帐户 ID 无效，或者您没有访问其数据的授权：[无效帐户 ID 列表]。
2021	请求包含无效指标：[无效指标列表]。
2022	请求中包含无效的 groupBy：[无效 groupBy 列表]。
2023	请求中包含无效的筛选条件：[无效筛选条件列表]。
2024	[无效筛选器列表] 中的筛选器包含无效的比较器。比较器应具有以下值之一：[有效筛选器列表]。
2025	请求中包含按国家/地区筛选的无效值筛选条件：[无效国家/地区列表]。
2027	起始日期不能晚于结束日期。
2028	请求开始日期和/或结束日期中传递的日期格式无效。
2029	请求中包含无效的排序依据：[无效排序依据列表]。结果只能根据 metrics 或 group by 中提供的字段进行排序。
2030	请求中的排序类型无效。有效值为“asc”和“desc”。
2031	请求中包含以下没有筛选值的筛选器：[无效筛选器列表]。请提供筛选值。
2032	请求中发送的时间范围格式无效。预期格式为开始日期:结束日期（yyyy-MM-dd:yyyy-MM-dd）。
2033	请求中包含按制造商筛选的无效筛选值：[无效制造商列表]。
2034	请求中包含按平台筛选的无效筛选值：[无效平台列表]。
2036	起始日期或结束日期不能晚于今天。

报告指标术语表

指标	定义	计算
eCPM	有效CPM：每千次展示有效成本	总收入/ （总曝光量*1000）
中心率	点击率是指您的广告收到的点击次数。除以您的广告展示次数	总点击次数 / （广告总展示次数）
广告请求总数	收到的来自发布商的广告请求总数	广告请求数量
广告展示次数	InMobi提供的广告展示	广告展示次数
广告展示次数	用户成功查看的广告展示次数	广告渲染数量
填充率	广告投放量占广告请求量的百分比	成功展示次数百分比 /（请求总数）
广告渲染率	广告投放百分比	广告渲染数量 / （广告展示次数）
出版商收入	出版商总收入

最后更新于 : 24 Aug, 2026

You are almost there...

By installing this SDK update, you agree that your Children Privacy Compliance setting remains accurate or that you will update that setting, whenever there is a change in your app's audience. You may update the app's Children Privacy Compliance settings at https://publisher.inmobi.com/my-inventory/app-and-placements.

I AGREE