리포트 API - 퍼블리셔

퍼블리셔로서 탭조이 오퍼월의 리포트 API에 접근하여 상세 데이터를 조회하고, 앱 퍼포먼스를 모니터링 및 평가하며, 수익화 전략을 최적화합니다.

읽는 시간 2분

최근 업데이트: 2일 전

퍼블리셔는 리포트 API를 사용하여 오퍼월을 제공하는 앱의 리포트 데이터를 조회할 수 있습니다.

필수 조건

API로 인증해야 합니다. API 인증을 참고하십시오.

리포트 API를 통해 콘텐츠를 관리하는 방법에 대한 정보는 콘텐츠 관리 문서를 참고하십시오.
리포트 API로 오류 처리 및 제한 사항에 관한 내용을 알아보려면 리포트 API 베스트 프랙티스를 참고하십시오.

퍼블리셔 리포트 지표

리포트 API를 사용하면 클릭, 전환, 총 수익 등의 지표를 포함한 오퍼월 콘텐츠의 퍼포먼스 데이터를 요청할 수 있습니다. 사용 가능한 모든 퍼블리셔 리포트 지표는 아래 차트에 나열되어 있습니다. 퍼포먼스 지표를 조회하기 위해 퍼블리셔는 다음 기본 쿼리로 시작할 것을 권장합니다.


{  publisher {    placements(appId: "00000000-0000-0000-0000-000000000000") {      id      name      insights(        timeRange: {from: "YYYY-MM-DDT00:00:00Z", until: "YYYY-MM-DDT00:00:00Z"}      ) {        timestamps        reports {          dailyUniqueViewers          earnings        }      }    }  }}

퍼블리셔 지표	설명	국가	그룹 추가	단일 퍼블리셔 앱	플레이스먼트	모든 퍼블리셔 앱에 대한 합계
`averageDuc`	앱, 플레이스먼트 또는 콘텐츠 카드 내 오퍼월 광고에서 전환한 고유 사용자 평균 수(사용자당 24시간마다 1회 집계)를 일수로 나눈 값	예	예	예	예	예
`arpdau`	일일 활성 사용자당 평균 수익(총 수익을 일일 활성 사용자 수로 나눈 값)	예	예	예	아니요	예
`arpduv`	일일 고유 오퍼월 시청자당 평균 수익(앱 내 오퍼월을 시청한 고유 사용자 수(사용자당 24시간당 1회 집계)로 나눈 총 수익)	예	예	예	아니요	예
`averageDau`	일일 활성 사용자 평균 수(사용자당 24시간당 1회 집계)를 일수로 나눈 값	예	예	예	아니요	예
`averageDuv`	앱 내 오퍼월을 조회한 고유 사용자 평균 수(사용자당 24시간마다 1회 집계)를 일수로 나눈 값	예	예	예	아니요	예
`clicks`	해당 플레이스먼트에서 발생한 클릭 수	예	아니요	아니요	예	아니요
`conversions`	해당 플레이스먼트에서 발생한 전환 수	예	아니요	아니요	예	아니요
`dailyActiveUsers`	일간 이용자 수	예	예	예	아니요	예
`dailyUniqueConversions`	이 플레이스먼트 또는 콘텐츠 카드의 광고를 통해 전환한 사용자 수(사용자당 24시간마다 1회 집계). 현재 오퍼월 콘텐츠 카드에만 적용	예	아니요	아니요	예	아니요
`dailyUniqueOfferwallEngagements`	앱 내 오퍼월 광고에서 전환한 고유 사용자 수(사용자당 24시간마다 1회 집계)	예	예	예	아니요	예
`dailyUniqueOfferwallViewers`	앱 내에서 오퍼월을 조회한 고유 사용자 수(사용자당 24시간마다 1회 집계)	예	예	예	아니요	예
`dailyUniqueViewers`	이 플레이스먼트 또는 콘텐츠 카드에서 광고를 본 고유 사용자 수(사용자당 24시간마다 1회 집계). 현재 오퍼월 콘텐츠 카드에만 적용	예	아니요	아니요	예	아니요
`ducduv`	이 플레이스먼트 또는 콘텐츠 카드의 광고를 통해 전환한 사용자 수(사용자당 24시간마다 1회 집계)를 이 플레이스먼트 또는 콘텐츠 카드의 광고를 본 사용자 수(사용자당 24시간마다 1회 집계)로 나눈 값	예	예	예	예	예
`duvDau`	앱 내에서 오퍼월을 조회한 고유 사용자 수(사용자당 24시간마다 1회 집계)를 일일 활성 사용자 수로 나눈 값	예	예	예	아니요	예
`earnings`	총 수익액	예	아니요	아니요	예	아니요
`eCPM`	총 수익/(총 오퍼월 열람 횟수/1000). USD 단위로 표시됩니다.	예	아니요	아니요	예	아니요
`impressions`	해당 플레이스먼트에서 발생한 노출 수	예	아니요	아니요	예	아니요
`newUsers`	신규 사용자 수	예	예	예	아니요	예
`offerwallViews`	오퍼월 총 개수	예	예	예	아니요	예
`sessions`	앱 실행 횟수	예	예	예	아니요	예
`totalRevenue`	총 매출	예	예	예	아니요	예

대시보드에서 확인할 수 있는 추가 퍼블리셔 지표:

노출/조회
CVR(전환율)

지표 세그먼트

쿼리에 세그먼트 필드를 추가하면 API가 앱, 플레이스먼트 및/또는 국가별로 세분화된 퍼포먼스 데이터를 반환할 수 있습니다. 리포트 API는 다음과 같은 세분화를 지원합니다.

country
id(앱 그룹 ID)
id(퍼블리셔 앱 ID)
placement
platform
total across all Publisher Apps

세분화 예시

국가별 세그먼트


{ publisher { placements(appId: "00000000-0000-0000-0000-000000000000") { id insights(timePreset: TODAY) { timestamps reports { country dailyUniqueViewers } } } } }

Segment by App Group


{ publisher { apps(first: 3) { nodes { appGroupId insights(timePreset: TODAY) { reports { dailyActiveUsers } } } } } }

퍼블리셔 앱별 세그먼트


query { publisher { apps(first:3) { edges { node { name insights(timePreset:TODAY) { reports { dailyActiveUsers } } } } } } }

플레이스먼트별 세그먼트


{ publisher{ placements(appId: "00000000-0000-0000-0000-000000000000") { id name insights(timePreset: TODAY) { reports { impressions } timestamps } } } }

플랫폼별 세그먼트


publisher { placements(appId: "00000000-0000-0000-0000-000000000000") { id insights(timePreset: TODAY) { timestamps reports { platform dailyUniqueViewers } } } }

모든 퍼블리셔 앱 합계

이 퍼블리셔의 모든 앱 요청된 지표의 합계를 나타냅니다.


{ publisher { publisherAppInsights(timePreset: TODAY) { timestamps reports { ecpm totalRevenue offerwallViews } } } }

필터링 기능

API는 쿼리에 필터를 추가하여 지정된 소스의 퍼포먼스 지표만 반환합니다. 리포트 API는 다음 필터링 기능을 지원합니다.

appId(단일 앱)
apps(첫 번째 또는 마지막 x 앱)
appGroupId
content
country
platform
timePreset
timeRange

필터링 예제

앱으로 필터링

이렇게 하면 결과가 단일 앱으로 제한됩니다.


{  publisher{    app(id: "<app ID>") {      id      name      insights(timePreset: TODAY) {        reports {          arpdau        }        timestamps      }    }  }}

다중 앱 필터링

이렇게 하면 결과를 처음 또는_ 마지막_ x개 앱으로 제한합니다


{  publisher {    apps(first: 3) {      nodes {        id        platform        insights {          reports {            arpdau            totalRevenue          }        }      }    }  }}

앱 그룹 ID로 필터링

이는 결과물을 특정 앱 그룹 ID 아래의 앱으로만 제한합니다.


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {appGroupIds: ["00000000-0000-0000-0000-000000000000"]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

콘텐츠 카드로 필터링

이렇게 하면 결과가 단일 콘텐츠 카드 ID로 제한됩니다.


{  publisher {    placements(appId: "<app ID>") {      id      name      content(id: "<content ID>") {        id        type        insights(timePreset: TODAY) {        timestamps          reports {            earnings          }        }      }    }  }}

국가로 필터링

이를 통해 지정된 지역에 결과물이 한정됩니다.


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {countries: ["KR, US"]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

플랫폼으로 필터링

이렇게 하면 결과가 지정된 플랫폼으로 제한됩니다.


{publisher {  publisherAppInsights(timePreset: TODAY, filter: {platforms: [ios]}) {    timestamps    reports {      offerwallViews      eCPM      totalRevenue    }  }

프리셋 기간으로 필터링

이렇게 하면 결과가 프리셋 기간으로 제한됩니다. 상대적인 기간이며, 결과는 쿼리가 실행되는 시점에 따라 달라집니다. 옵션: LAST_30D, LAST_WEEK, TODAY, YESTERDAY.

참고

데이터 집계 레벨을 정의하려면 timeIncrement를 포함합니다. 이는 DAILY, HOURLY, MONTHLY 값을 가질 수 있습니다. timeIncrement는 선택 사항 파라미터이며 _ALL_로 기본 설정됩니다.


{  publisher {    placements(appId: “<app ID>”) {      content(id: “<content card ID>") {        insights(timePreset:LAST_30D, timeIncrement: DAILY) {        timestamps          reports {            dailyUniqueViewers          }        }      }    }  }}

절대 시간 범위로 필터링

이렇게 하면 결과가 지정된 절대 기간으로 제한됩니다. 최대 범위는 3개월이며, 최초 날짜는 지난 2년까지 지원됩니다.

참고


{  publisher {    placements(appId: “<app ID>”) {      content(id: “<content card ID>") {        insights(timeRange: {from: "2024-11-15T00:00:00Z", until: "2024-11-17T00:00:00Z"}, timeIncrement: DAILY) {        timestamps          reports {            dailyUniqueViewers          }        }      }    }  }}

사용 중단 예정인 측정 항목

다음 레거시 측정 항목은 2025년 2월 3일에 리포트 API에서 제거되었습니다. API 쿼리를 통해 탭조이의 오퍼월에서 데이터를 가져올 때 오류를 방지하기 위해 아래의 굵은 글씨로 된 측정 항목을 참고하지 마십시오. Objects > ContentCard > ecpmSettings Enums > PublisherContentType:

```
ANNOUNCEMENT
```
```
DIRECT_PLAY_HOUSE_AD
```
```
FEATURED
```
```
FSI_HOUSE_AD
```
```
IAP_PROMOTION
```
```
INTERSTITIAL_VIDEO
```
```
MEDIATED_DIRECT_PLAY
```
```
MEDIATED_FSI
```
```
PREVIEW_CODE
```
```
PROGRAMMATIC_INTERSTITIAL_VIDEO
```
```
PROGRAMMATIC_REWARDED_VIDEO
```
```
REWARDED_VIDEO
```
```
TJ_RECOMMENDED
```
```
REWARD_UNLOCK
```

Input Objects >

CreatePlacementAndContentSetInput

> ecpmSettingsToAdd Input Objects >

UpdatePlacementAndContentSetInput

```
ecpmSettingsToAdd
```
```
ecpmSettingsToDelete
```
```
ecpmSettingsToUpdate
```

기술 자료

엔진

서비스

Grow

산업 분야

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월