Reporting API

概要

Reporting APIを通して、広告主様・パブリッシャー様にダッシュボード上に存在するデータへのプログラマティックなアクセス方法を提供しています。Reporting APIキーは、パブリッシャー様の全アプリに適用します。各アプリは、ユニークReporting API IDを持っています。これは、各アプリページで見つけることができます。

ホストリクエスト・ヘッダーAPI
https://ssl.vungle.com Content-Type: application/json APIキーをquery parameterとして送ることで、セキュリティを操作できます。APIキーは、VungleのダッシュボードのReportsページにあります。
まだAPIキーがない場合は、tech-support@vungle.comにEメールを送り、リクエストしてください。

広告主様

リソースパラメーター説明
GET /api/campaigns key=[API Key] active=[true/false] 広告主様のすべてのキャンペーンのリストを返します。active が指定されている場合、キャンペーンはフィルターにかけられ、active または inactive のキャンペーンのみが表示されます。

例:

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

Geoレベルメトリック

リソースパラメーター説明
GET /api/campaigns/[Campaign ID]/geo/[Country_Code] key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

特定の国におけるキャンペーンの地域情報を返します。国は2文字の国コード(例: US)で指定します。「start」と「end」パラメータまたは特定の「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」を使用して日付範囲を入力することができますが、両方を使うことはできません

例:

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

パブリッシャー様

リソースパラメーター説明
GET /api/applications key=[API Key] パブリッシャー様が所有するアプリのリストを返します。

例:

{
    "id": "51896d9c3436ae313c3939b8",
    "appId" : "com.amazingGames.ProjectComet",
    "name" : "Project Comet", 
    "installs" : 1372,
    "platform" : "iOS",
    "connection" : "all", 
    "status" : "a"
}
リソースパラメーター説明
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]
指定日に、指定されたアプリの統計リストを返します。

応答例:

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

クエリに対するデータがない場合、空の200応答が返信されることにご注意ください。これはリクエストが正常に送信されたものの、返信するデータがないことを示します。

他にご質問がございましたら、リクエストを送信してください

コメント