适用于广告客户的报告 API 1.0

概览

注意:报告 API 1.0 是我们的旧 API。请使用它来报告 2017 年 7 月 5 日以前发生的交易。对于此日期当天或之后发生的交易,请使用报告 API 2.0,相关文件位于此处

报告 API 为广告客户提供程序化的方式来访问仪表板上的数据。对于您的所有应用,报告 API 密钥都是一样的。每个应用都有一个唯一的报告 API ID,您可在其各自的应用程序页面上找到这个 ID。

主机 请求头 API
https://ssl.vungle.com Content-Type: application/json 通过将 API 密钥作为查询参数传递来确保安全。您的 API 密钥将在 Vungle 仪表板上自动生成。
如果您还没有密钥,请参阅我如何请求报告 API 密钥?

广告客户

资源 参数 描述
GET /api/campaigns key=[API Key] active=[true/false] 返回您所具有的活动的列表。如果指定“可用”,将筛选活动以只显示可用或不可用的活动。

响应示例:

{
    "rate" : 0.01,
    "rateType" : "complete",
    "campaignId" : "51896da23436ae313c3939b9",
    "type" : "external",
    "name" : "Feed the Rat",
    "spent" : 2131
}

资源 参数 描述
GET /api/campaigns/[Campaign ID] key=[API Key] date=[YYYY-MM-DD] 在指定日期为指定活动返回统计信息。

响应示例:

{
    "clicks" : 1129,
    "completedViews" : 23080,
    "date" : "2012-08-19",
    "campaignId" : "51896da23436ae313c3939b9",
    "installs" : 590,
    "impressions" : 26722,
    "name" : "Feed the Rat",
    "views" : 26546,
    "dailySpend": 566
}
资源 参数 描述
GET /api/campaigns/[Campaign ID]/installs key=[API Key] start=[YYYY-MM-DD] end=[YYYY-MM-DD] 在指定日期范围内返回归因于指定活动的安装的列表。

响应示例:

{
    "time_clicked": "2012-08-17T01:52:32.024Z",
    "time_installed": "2012-08-17T01:54:33.034Z",
    "openUDID": "e2c42c159286124f34702e770cc702240c2707e8",
    "mac": "98d6bb786fdd"
},
{
    "time_clicked": "2012-08-17T01:52:32.024Z",
    "time_installed": "2012-08-17T01:54:33.034Z",
    "openUDID": "e2c42c159286124f34702e770cc702240c2707e8",
    "mac": "98d6bb786fdd"
}

地理级别指标

资源 参数 描述
GET /api/campaigns/[Campaign ID]/geo/[Country_Code] key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

返回特定国家/地区的活动的地理信息。国家/地区使用两个字母的“国家_代码”指定,例如,US。您可以使用 'start' 和 'end' 参数或特定 'date' 输入日期范围,但不能同时使用。'start' and 'end' parameters or a specific 'date'

响应示例:

{
"date": "2015-07-08",
"country": "US",
"views": 34029,
"completes": 32094,
"clicks": 1822,
"installs": 609,
"spend": 582,
"eRPM": 8.9
}
资源 参数 描述
GET /api/campaigns/[Campaign ID]/geo/all key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

返回所有国家/地区的活动的地理信息。您可以使用 'start' 和 'end' 参数或特定 'date' 输入日期范围,但不能同时使用。'start' and 'end' parameters or a specific 'date'

响应示例:

[
{
"date": "2015-07-08",
"country": "US",
"views": 34029,
"completes": 32094,
"clicks": 1822,
"installs": 609,
"spend": 582,
"eRPM": 8.9
},
{
"date": "2015-07-08",
"country": "CA",
"views": 34235,
"completes": 3190,
"clicks": 1509,
"installs": 523,
"spend": 498,
"eRPM": 7.6
}
]

请注意,如果您的查询没有可用数据,将会发回一个空白的 200 响应。这表明请求已成功,但没有可用数据返回。

还有其它问题?提交请求

评论