KOR쿼리 파라미터
이 API에 대한 지원은 중단되었습니다. 2023년 6월 말부터 이 API는 사용이 불가능하며, 이후 리포트 용도로 Tapjoy GraphQL API를 사용하셔야 합니다.
1. 쿼리 파라미터
| 파라미터 | 필수? | 값 | 설명 |
|---|---|---|---|
| date | YES | YYYY-MM-DD | 데이터를 요청하는 날짜 |
| page_size | NO | 0 < Integer value <= number of apps in your account | 한 페이지의 JSON 응답에서 리턴하는 앱 수입니다. 이 값이 클수록 응답 시간이 더 오래 걸립니다. 값을 전달하지 않으면 기본값은 1입니다]. |
| page | NO | 0 < Integer value <= max pages | 리턴하려는 페이지 넘버입니다. 페이지가 지정되지 않은 경우 첫 페이지를 반환합니다. |
| time_increment | NO | hourly, daily | 시간 또는 일별로 분류 된 데이터를 반환합니다. 일별 구분이 기본값입니다. |
| group_by | NO | placements, content_types, content_cards | 기본적으로 콘텐츠 유형별로 데이터를 반환합니다. placements 또는 content_cards를 사용하는 경우 대신 플레이스먼트 또는 콘텐츠 카드별로 세분화 된 수익이 반환됩니다. |
| mock | NO | 0, 1 | 1을 전달하면 테스트 데이터가 반환되므로 스크립트가 올바른지 확인할 수 있습니다. 이 파라미터가 없거나 0을 사용하면 계정에서 실제 데이터가 반환됩니다. |
2. JSON 예시
A. 앱별로 그룹화할 때 응답 예
{
"Date": "2016-10-01",
"TotalApps": 2,
"PageSize": 1,
"TotalPages": 2,
"CurrentPage": 1,
"Apps": [
{
"Name": "MyTapjoy",
"Platform": "android",
"AppKey": "bba49f11-b87f-4c0f-9632-21aa810dd6f1",
"ContentTypes": [
{
"ContentType": "DirectPlay",
"Global": {
"Clicks": 0,
"Conversions": 0,
"Impressions": 0,
"Revenue": 0,
"ECPM": 0
},
"Countries": []
},
{
"ContentType": "FullScreenInterstitial",
"Global": {
"Clicks": 0,
"Conversions": 0,
"Impressions": 0,
"Revenue": 0,
"ECPM": 0
},
"Countries": []
},
{
"ContentType": "Offerwall",
"Global": {
"Revenue": 6010.0208,
"Impressions": 176610,
"Clicks": 91910,
"Conversions": 24910,
"DAU": 100203,
"DUV": 100203,
"DUC": 17028,
"ECPM": 34.0299
},
"Countries": [
{
"Country": "ae",
"Revenue": 0,
"Impressions": 7,
"Clicks": 3,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ar",
"Revenue": 0,
"Impressions": 6,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "at",
"Revenue": 0.056,
"Impressions": 32,
"Clicks": 21,
"Conversions": 1,
"DAU": 20,
"DUV": 20,
"DUC": 1,
"ECPM": 1.75
},
{
"Country": "au",
"Revenue": 0.3304,
"Impressions": 7,
"Clicks": 6,
"Conversions": 2,
"DAU": 3,
"DUV": 3,
"DUC": 2,
"ECPM": 47.2
},
{
"Country": "ba",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "bd",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "be",
"Revenue": 0.42364,
"Impressions": 19,
"Clicks": 6,
"Conversions": 3,
"DAU": 11,
"DUV": 11,
"DUC": 3,
"ECPM": 22.29684
},
{
"Country": "bg",
"Revenue": 0.0476,
"Impressions": 4,
"Clicks": 4,
"Conversions": 1,
"DAU": 2,
"DUV": 2,
"DUC": 1,
"ECPM": 11.9
},
{
"Country": "bh",
"Revenue": 0.056,
"Impressions": 2,
"Clicks": 1,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 28
},
{
"Country": "br",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ca",
"Revenue": 0.84952,
"Impressions": 9,
"Clicks": 6,
"Conversions": 3,
"DAU": 4,
"DUV": 4,
"DUC": 2,
"ECPM": 94.39111
},
{
"Country": "ch",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "cl",
"Revenue": 0,
"Impressions": 4,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "co",
"Revenue": 0.224,
"Impressions": 19,
"Clicks": 7,
"Conversions": 1,
"DAU": 8,
"DUV": 8,
"DUC": 1,
"ECPM": 11.78947
},
{
"Country": "cz",
"Revenue": 0,
"Impressions": 2,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "de",
"Revenue": 2.4528,
"Impressions": 6,
"Clicks": 3,
"Conversions": 1,
"DAU": 3,
"DUV": 3,
"DUC": 1,
"ECPM": 408.8
},
{
"Country": "dk",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "dm",
"Revenue": 0,
"Impressions": 5,
"Clicks": 2,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "dz",
"Revenue": 0,
"Impressions": 20,
"Clicks": 0,
"Conversions": 0,
"DAU": 17,
"DUV": 17,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ec",
"Revenue": 0,
"Impressions": 4,
"Clicks": 1,
"Conversions": 0,
"DAU": 2,
"DUV": 2,
"DUC": 0,
"ECPM": 0
},
{
"Country": "eg",
"Revenue": 0,
"Impressions": 11,
"Clicks": 8,
"Conversions": 0,
"DAU": 8,
"DUV": 8,
"DUC": 0,
"ECPM": 0
},
{
"Country": "es",
"Revenue": 6.0648,
"Impressions": 321,
"Clicks": 166,
"Conversions": 57,
"DAU": 302,
"DUV": 302,
"DUC": 50,
"ECPM": 18.89346
},
{
"Country": "fi",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "fr",
"Revenue": 10.44092,
"Impressions": 219,
"Clicks": 143,
"Conversions": 50,
"DAU": 202,
"DUV": 202,
"DUC": 47,
"ECPM": 47.67543
},
{
"Country": "gb",
"Revenue": 18.75832,
"Impressions": 351,
"Clicks": 216,
"Conversions": 69,
"DAU": 312,
"DUV": 312,
"DUC": 64,
"ECPM": 53.44251
},
{
"Country": "gh",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "gr",
"Revenue": 0.3094,
"Impressions": 2,
"Clicks": 1,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 154.7
},
{
"Country": "hk",
"Revenue": 0.0532,
"Impressions": 3,
"Clicks": 2,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 17.73333
},
{
"Country": "hr",
"Revenue": 0,
"Impressions": 6,
"Clicks": 0,
"Conversions": 0,
"DAU": 5,
"DUV": 5,
"DUC": 0,
"ECPM": 0
},
{
"Country": "id",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ie",
"Revenue": 0.056,
"Impressions": 33,
"Clicks": 20,
"Conversions": 1,
"DAU": 15,
"DUV": 15,
"DUC": 1,
"ECPM": 1.69697
},
{
"Country": "il",
"Revenue": 0,
"Impressions": 1,
"Clicks": 2,
"Conversions": 0,
"DAU": 2,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "in",
"Revenue": 0.084,
"Impressions": 20,
"Clicks": 8,
"Conversions": 1,
"DAU": 19,
"DUV": 19,
"DUC": 1,
"ECPM": 4.2
},
{
"Country": "iq",
"Revenue": 0,
"Impressions": 15,
"Clicks": 7,
"Conversions": 0,
"DAU": 12,
"DUV": 12,
"DUC": 0,
"ECPM": 0
},
{
"Country": "is",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "it",
"Revenue": 0.6608,
"Impressions": 25,
"Clicks": 13,
"Conversions": 5,
"DAU": 18,
"DUV": 18,
"DUC": 5,
"ECPM": 26.432
},
{
"Country": "je",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "jo",
"Revenue": 0,
"Impressions": 4,
"Clicks": 2,
"Conversions": 0,
"DAU": 2,
"DUV": 2,
"DUC": 0,
"ECPM": 0
},
{
"Country": "jp",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ke",
"Revenue": 0,
"Impressions": 8,
"Clicks": 2,
"Conversions": 0,
"DAU": 4,
"DUV": 4,
"DUC": 0,
"ECPM": 0
},
{
"Country": "kw",
"Revenue": 0,
"Impressions": 1,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "lb",
"Revenue": 0,
"Impressions": 3,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "lt",
"Revenue": 0,
"Impressions": 2,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ma",
"Revenue": 0,
"Impressions": 4,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "mk",
"Revenue": 0.3094,
"Impressions": 2,
"Clicks": 2,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 154.7
},
{
"Country": "mt",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "mx",
"Revenue": 0.14,
"Impressions": 18,
"Clicks": 3,
"Conversions": 1,
"DAU": 5,
"DUV": 5,
"DUC": 1,
"ECPM": 7.77778
},
{
"Country": "ng",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "nl",
"Revenue": 2.5634,
"Impressions": 191,
"Clicks": 107,
"Conversions": 16,
"DAU": 123,
"DUV": 123,
"DUC": 8,
"ECPM": 13.42094
},
{
"Country": "no",
"Revenue": 0,
"Impressions": 4,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "nz",
"Revenue": 0,
"Impressions": 5,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "pe",
"Revenue": 0,
"Impressions": 1,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "pk",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "pm",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "pr",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "ps",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "pt",
"Revenue": 0,
"Impressions": 8,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "qa",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "re",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "rs",
"Revenue": 0,
"Impressions": 4,
"Clicks": 3,
"Conversions": 0,
"DAU": 2,
"DUV": 2,
"DUC": 0,
"ECPM": 0
},
{
"Country": "sa",
"Revenue": 9.48556,
"Impressions": 257,
"Clicks": 101,
"Conversions": 15,
"DAU": 56,
"DUV": 56,
"DUC": 9,
"ECPM": 36.90879
},
{
"Country": "sc",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "se",
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"DAU": 0,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "sg",
"Revenue": 0.4732,
"Impressions": 13,
"Clicks": 5,
"Conversions": 2,
"DAU": 2,
"DUV": 2,
"DUC": 1,
"ECPM": 36.4
},
{
"Country": "si",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "sk",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "sy",
"Revenue": 0,
"Impressions": 0,
"Clicks": 1,
"Conversions": 0,
"DAU": 1,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "th",
"Revenue": 0.448,
"Impressions": 3,
"Clicks": 1,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 149.33333
},
{
"Country": "tr",
"Revenue": 0,
"Impressions": 2,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "tt",
"Revenue": 0,
"Impressions": 3,
"Clicks": 2,
"Conversions": 0,
"DAU": 1,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
{
"Country": "us",
"Revenue": 5944.4562,
"Impressions": 174787,
"Clicks": 90955,
"Conversions": 24647,
"DAU": 6003,
"DUV": 6003,
"DUC": 2004,
"ECPM": 34.0097
},
{
"Country": "uy",
"Revenue": 0,
"Impressions": 1,
"Clicks": 0,
"Conversions": 0,
"DAU": 1,
"DUV": 0,
"DUC": 0,
"ECPM": 0
},
{
"Country": "za",
"Revenue": 0.28,
"Impressions": 2,
"Clicks": 1,
"Conversions": 1,
"DAU": 1,
"DUV": 1,
"DUC": 1,
"ECPM": 140
}
]
},
{
"ContentType": "Tapjoy.com",
"Global": {
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"ECPM": 0
},
"Countries": []
},
{
"ContentType": "Banner",
"Global": {
"Revenue": 0,
"Impressions": 0,
"Clicks": 0,
"Conversions": 0,
"ECPM": 0
},
"Countries": []
}
]
}
]
}
B. 콘텐츠 카드별로 그룹화할 때의 응답 예
{
"Date": "2021-05-21",
"TotalApps": 1,
"PageSize": 1,
"TotalPages": 1,
"CurrentPage": 1,
"Apps": [
{
"Name": "MyTapjoy",
"Platform": "iphone",
"AppKey": "13b0ae6a-8516-4405-9dcf-fe4e526486b2",
"ContentCards": []
}
]
}
C. 플레이스먼트별로 그룹화할 때의 응답 예
{
"Date": "2021-05-21",
"TotalApps": 1,
"PageSize": 1,
"TotalPages": 1,
"CurrentPage": 1,
"Apps": [
{
"Name": "MyTapjoy",
"Platform": "iphone",
"AppKey": "13b0ae6a-8516-4405-9dcf-fe4e526486b2",
"Placements": [
{
"Name": "offerwall_unit",
"Global": {
"Revenue": 0,
"Impressions": 5,
"Clicks": 1,
"Conversions": 0,
"DUV": 1,
"DUC": 0,
"ECPM": 0
},
"Countries": [
{
"Country": "us",
"Revenue": 0,
"Impressions": 5,
"Clicks": 1,
"Conversions": 0,
"DUV": 1,
"DUC": 0,
"ECPM": 0
}
]
}
]
}
]
}
3. 필드 설명
| 일반 개체 | 설명 | 값 |
|---|---|---|
| Date | 다음 형식의 데이터 날짜: YYYY-MM-DD | 다음 형식의 날짜 문자열: YYYY-MM-DD |
| TotalApps | 총 앱 수 | Integer |
| PageSize | 페이지 당 반환 할 앱 수입니다. 모든 앱을 한 번에 응답하려면 총 앱 수로 설정할 수 있습니다. 기본적으로 파라미터에 전달한 값을 반환하므로 앱 목록에 있는 앱 수보다 클 수 있습니다. | Integer |
| TotalPages | 이 보고서의 총 페이지 수 | Integer |
| CurrentPage | 현재 페이지 번호 | Integer |
| Name | 앱 이름 | String |
| AppKey | 이 앱의 고유 앱 ID (SDK 키가 아닙니다) | appID, 정규화되지 않음 |
| Platform | 이 앱의 플랫폼 | android, ios |
| Status | 오류가 있었는지 알려주는 메시지가 반환됩니다. | String |
| Country | 수익/지출이 발생한 국가. (2문자 국가 코드) | us, ca, gb, … 모두 소문자 |
| 콘텐츠 유형 개체 | 설명 | 값 |
|---|---|---|
| Type | 콘텐츠의 유형입니다. e.g) “message to earn”, “native to earn”, “offerwall” | String |
| Impressions | M2E, N2E, P2E의 경우 이것이 프라이머리 오퍼의 임프레션이 됩니다. | Integer |
| Clicks | 프라이머리 콘텐츠의 클릭 | Integer |
| Conversions | 프라이머리 콘텐츠의 전환 | Integer |
| Revenue | 프라이머리 콘텐츠의 총 수익 (미국 달러) | Float |
| eCPM | 지정된 날짜 동안 이 콘텐츠의 eCPM. 이 측정 항목은 시간별 버전이 없습니다.. | Integer |
| DUV | 앱에서 Offerwall을 본 고유 사용자 수 | Integer number |
| DUC | 앱의 Offerwall 광고에서 전환한 순 사용자 수 | Integer number |
| 플레이스먼트 개체 | 설명 | 값 |
|---|---|---|
| 이름 | 대시 보드 상의 플레이스먼트 이름 | String |
| Impressions | 광고 유닛에 대한 이 플레이스먼트의 총 노출 수. M2E와 같이 수익을 창출하지 않는 소스의 노출은 제외됩니다. | Integer |
| Clicks | 이 플레이스먼트에 대한 총 클릭 수 | Integer |
| Conversions | 이 플레이스먼트에 대한 총 전환 수 | Integer |
| Revenue | 이 플레이스먼트의 총 수익 (미국 달러) | Float |
| eCPM | 이 플레이스먼트의 eCPM. 이 측정 항목은 시간별 버전이 없습니다.. | Float |
| DUV | 이 플레이스먼트 또는 콘텐츠 카드에서 광고를 본 순 사용자 수 | Integer number |
| DUC | 이 플레이스먼트 또는 콘텐츠 카드의 광고에서 전환한 사용자 수 | Integer number |
4. 오류
| Error Code | Meaning | Solution |
|---|---|---|
| 400 | Bad Request | 파라미터가 올바른지 확인하십시오. |
| 401 | Bad or missing authentication token | 인증 토큰이 정확하고 만료되지 않았는지 확인하세요. |
| 500 | Internal server error | 다시 시도하거나 문제가 지속되면 support@tapjoy.com에 문의하세요. |
| 429 | Too many requests | 용청 빈도를 낮춥니다. |