리포팅 API 문서

개요

리포팅 API는 대쉬보드에 보여지는 데이터들을 프로그램적으로 광고주와 퍼블리셔들에게 제공되는 수단입니다. 당신의 리포팅 API 키는 당신의 모든앱들에서 동일합니다. 각 앱은 특별한 리포팅 API 아이디를 갖습니다. 아이디는 각 어플리케이션 페이지에서 찾을 수 있습니다.

HostRequest HeadersAPI
https://ssl.vungle.com Content-Type: application/json Security is handled by passing an API key as a query parameter. Your API key can be found in the Reports page on the Vungle dashboard. 
If you don't have one already, email tech-support@vungle.com to request one!

광고주

ResourceParametersDescription
GET /api/campaigns key=[API Key] active=[true/false] Returns a list of the campaigns you own. If active is specified, the campaigns will be filtered to show only active or inactive campaigns.

Example Response:

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

ResourceParametersDescription
GET /api/campaigns/[Campaign ID] key=[API Key] date=[YYYY-MM-DD] Returns the statistics for the specified campaign on the specified date.

Example Response:

{
    "clicks" : 1129,
    "completedViews" : 23080,
    "date" : "2012-08-19",
    "campaignId" : "51896da23436ae313c3939b9",
    "installs" : 590,
    "impressions" : 26722,
    "name" : "Feed the Rat",
    "views" : 26546,
    "dailySpend": 566
}
ResourceParametersDescription
GET /api/campaigns/[Campaign ID]/installs key=[API Key] start=[YYYY-MM-DD] end=[YYYY-MM-DD] Returns a list of the installs that have been attributed to the specified campaign during the specified date range.

Example Response:

{
    "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"
}

Geo Level Metrics

ResourceParametersDescription
GET /api/campaigns/[Campaign ID]/geo/[Country_Code] key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

Returns the geo information for a campaign in specific countries. The country is specified using a two letter Country_Code e.g. US. You can either enter a date range using the 'start' and 'end' parameters or a specific 'date' but not both. 

Example Response:

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

Returns the geo information for a campaign over all countries. You can either enter a date range using the 'start' and 'end' parameters or a specific 'date' but not both. 

Example Response:

[
{
"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
}
]

퍼블리셔

ResourceParametersDescription
GET /api/applications key=[API Key] Returns a list of the applications you own.

Example Response:

{
    "id": "51896d9c3436ae313c3939b8",
    "appId" : "com.amazingGames.ProjectComet",
    "name" : "Project Comet", 
    "installs" : 1372,
    "platform" : "iOS",
    "connection" : "all", 
    "status" : "a"
}
ResourceParametersDescription
GET /api/applications/[REPORTING API ID] key=[API Key] date=[YYYY-MM-DD] 
or 
key=[API Key] start=[YYYY-MM-DD] end=[YYYY-MM-DD]
Returns a list of the statistics for the specified application on the specified date(s).

Example Response:

{
    "date" : "2012-08-16",
    "impressions" : 5165,
    "views" : 5156,
    "completes" : 1686,
    "revenue" : 16.86,
    "eCPM" : 3.26
}

Please note that if there is no data available for your query an empty 200 response will be sent back. This reflects that the request has succeeded but that there is no data available to return.

또 다른 질문이 있으십니까? 문의 등록

댓글