광고주용 보고 API 1.0

개요

참고: 보고 API 1.0은 당사의 기존 API입니다. 2017년 7월 5일 이전에 발생한 거래를 보고할 때 사용하고, 2017년 7월 5일 이후에 발생한 거래에는 여기에 설명된 보고 API 2.0을 사용하십시오.

보고 API를 사용하면 광고주가 대시보드에 있는 데이터에 프로그래밍 방식으로 액세스할 수 있습니다. 보고 API 키는 모든 앱에서 동일하게 사용됩니다. 앱마다 고유한 보고 API 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]

특정 국가의 캠페인에 대한 지리 정보를 반환합니다. 국가는 두 글자짜리 Country_Code로 지정합니다. 예: US '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' 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 응답이 반환됩니다. 이는 요청은 성공했지만 반환할 수 있는 데이터가 없다는 의미입니다.

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

댓글