리포트 만들기

리포트는 좌측 설정 패널에서 기간, 메트릭, 그룹화(차원), 필터, 이벤트 조건을 차례로 설정한 뒤 쿼리 실행 버튼을 눌러 만듭니다. 이 문서는 각 설정 항목과 실제로 제공되는 메트릭·차원·필터 목록을 설명합니다.

1. 기간(Period) 설정

설정 패널 맨 위 기간 영역에서 분석 기간을 지정합니다. 날짜 선택기는 세 가지 모드를 지원합니다.

모드	설명
`Between`	시작일과 종료일을 직접 지정합니다.
`Since`	시작일만 지정하고 종료일은 오늘로 자동 설정합니다.
`Last`	"최근 N일" 같은 상대 기간을 지정합니다. (오늘 포함 여부 등 옵션 제공)

빠른 선택용 프리셋으로 Yesterday(어제), Last 7 Days(최근 7일), Last 14 Days(최근 14일), Last 28 Days(최근 28일), Last 30 Days(최근 30일), Last 90 Days(최근 90일)를 제공합니다. 선택 가능한 최대 기간은 366일입니다.

2. 메트릭(Metrics) 선택

메트릭 영역에서 표에 표시할 성과 지표를 고릅니다. 최대 20개까지 선택할 수 있습니다. 메트릭은 출처에 따라 Channel / App / Web / App+Web 그룹과, 이벤트 단위로 집계하는 이벤트 메트릭 그룹으로 나뉩니다.

2-1. Channel (광고 플랫폼 공식 데이터)

메트릭	설명
`Ad Spend (Channel)`	광고비 합계
`Impressions (Channel)`	노출수 합계
`Clicks (Channel)`	클릭수 합계
`Conversions (Channel)`	플랫폼 공식 전환수 합계
`Conversion Value (Channel)`	플랫폼 공식 전환 금액 합계
`CTR (Channel)`	클릭률 (클릭수 ÷ 노출수 × 100)
`IPM (Channel)`	노출 1,000건당 설치수 (앱 설치수 ÷ 노출수 × 1,000)
`CVR (Channel)`	전환율 (전환수 ÷ 채널 클릭수 × 100)
`CPC (Channel)`	클릭당 비용 (광고비 ÷ 채널 클릭수)
`CPA (Channel)`	전환당 비용 (광고비 ÷ 채널 전환수)
`ROAS (Channel)`	광고비 대비 매출 (채널 전환 금액 ÷ 광고비 × 100)
`Est. First Page CPC (Channel)`	첫 페이지 노출 추정 CPC (Google Ads 키워드)
`Est. First Position CPC (Channel)`	첫 번째 위치 노출 추정 CPC (Google Ads 키워드)

2-2. App (앱 데이터)

메트릭	설명
`Installs (App)`	앱 설치수
`Clicks (App)`	앱 광고 클릭수 (click + first_open)
`All Conversions (App)`	앱 전환 합계 (purchase + signup + trial)
`Conversion Value (App)`	앱 매출 합계 (purchase + subscribe)
`CVR (App)`	앱 전환율 (전환수 ÷ 앱 클릭수 × 100)
`CPC (App)`	앱 클릭당 비용 (광고비 ÷ 앱 클릭수)
`CPA (App)`	앱 전환당 비용 (광고비 ÷ 앱 전환수)
`ROAS (App)`	앱 매출 기준 ROAS (앱 매출 ÷ 광고비 × 100)

2-3. Web (웹 데이터)

메트릭	설명
`Clicks (Web)`	웹 광고 클릭수 (명시적 click 이벤트만)
`All Conversions (Web)`	웹 전환 합계 (purchase + signup + trial)
`Conversion Value (Web)`	웹 매출 합계 (purchase + subscribe)
`CVR (Web)`	웹 전환율 (전환수 ÷ 웹 클릭수 × 100)
`CPC (Web)`	웹 클릭당 비용 (광고비 ÷ 웹 클릭수)
`CPA (Web)`	웹 전환당 비용 (광고비 ÷ 웹 전환수)
`ROAS (Web)`	웹 매출 기준 ROAS (웹 매출 ÷ 광고비 × 100)

2-4. App + Web (앱·웹 통합)

메트릭	설명
`Clicks (App+Web)`	앱·웹 통합 클릭수
`All Conversions (App+Web)`	통합 전환 합계 (purchase + signup + trial)
`Conversion Value (App+Web)`	통합 매출 합계 (purchase + subscribe)
`CVR (App+Web)`	통합 전환율 (전환수 ÷ 통합 클릭수 × 100)
`CPC (App+Web)`	통합 클릭당 비용 (광고비 ÷ 통합 클릭수)
`CPA (App+Web)`	통합 전환당 비용 (광고비 ÷ 통합 전환수)
`ROAS (App+Web)`	통합 매출 기준 ROAS (통합 매출 ÷ 광고비 × 100)

표준 이벤트와 커스텀 이벤트를 단위로 한 메트릭도 선택할 수 있습니다. 메트릭 목록 하단에 App Events, App Custom Events, Web Events, Web Custom Events, App+Web Events, App+Web Custom Events 카테고리로 표시되며, 커스텀 이벤트 항목은 조직에 수집된 이벤트에 따라 동적으로 채워집니다.

유형	설명
Count	해당 이벤트의 발생 횟수입니다. (예: `Purchase (App)`, `Login (App+Web)`)
Value	해당 이벤트의 `params.value` 합계입니다. 금액성 표준 이벤트(purchase, refund, subscribe, add_to_cart, begin_checkout, start_trial 등)에만 제공됩니다. (예: `Purchase Value (App)`)

커스텀 이벤트는 Count 메트릭만 제공합니다. Value 메트릭은 의미가 명확한 표준 이벤트에서만 제공됩니다.

3. 그룹화(Group By, 차원) 선택

그룹화 영역에서 데이터를 묶을 기준(차원)을 고릅니다. 최대 10개까지 선택할 수 있으며, 카테고리별로 다음 차원을 제공합니다.

3-1. Time

차원	설명
`Date`	일자별 그룹화
`Hour`	시간(시)별 그룹화

3-2. Channel

차원	설명
`Channel`	채널명 (facebook, google, naver 등)
`Campaign`	캠페인명
`Campaign ID`	캠페인 고유 ID
`Campaign Status`	캠페인 상태 (ENABLED, PAUSED, REMOVED)
`Ad Group`	광고그룹명
`Ad Group ID`	광고그룹 고유 ID
`Ad Group Status`	광고그룹 상태 (ENABLED, PAUSED, REMOVED)
`Creative`	광고 소재명
`Creative ID`	소재 고유 ID
`Creative Status`	소재 상태 (ENABLED, PAUSED, REMOVED)
`Creative Type`	광고 유형 (RESPONSIVE_SEARCH_AD, IMAGE_AD, VIDEO_AD 등)
`Keyword`	검색 키워드
`Keyword ID`	키워드 고유 ID
`Keyword Status`	키워드 상태 (ENABLED, PAUSED, REMOVED)
`Search Term`	사용자가 실제 입력한 검색어
`Match Type`	키워드 매칭 유형 (EXACT, PHRASE, BROAD)

3-3. Device

차원	설명
`Source`	출처 (App 또는 Web)
`Device Category`	디바이스 카테고리 (mobile, desktop, tablet)
`OS Name`	OS 이름 (iOS, Android, Windows 등)
`OS Version`	OS 버전
`Browser`	브라우저 이름 (Chrome, Safari, Firefox 등)
`Browser Version`	브라우저 버전
`Adstage Device ID`	Adstage가 생성한 디바이스 고유 ID

3-4. User

차원	설명
`Country`	사용자 국가
`Language`	사용자 언어

3-5. Event

차원	설명
`Event Type`	이벤트 유형

4. 필터(Filters) 설정

필터 영역에서 필터 추가 버튼을 눌러 특정 조건의 데이터만 남기거나 제외할 수 있습니다. 필터는 필드 → 연산자 → 값 순서로 지정합니다. 필터로 사용 가능한 필드는 위의 Channel / Device / User 차원과 동일합니다. (Time, Event 차원은 필터에서 제외되며, 기간은 별도의 기간 설정으로 대체됩니다.)

4-1. 연산자

연산자	설명	값 입력
`is`	값이 정확히 일치	필요 (복수 값 가능)
`is not`	값이 일치하지 않음	필요 (복수 값 가능)
`contains`	값에 입력 문자열을 포함	필요
`does not contain`	값에 입력 문자열을 포함하지 않음	필요
`exists`	필드 값이 존재	불필요
`does not exist`	필드 값이 비어 있음	불필요

일부 필드(예: Channel, Device Category, OS Name, Match Type, 각종 Status)는 미리 정의된 값 목록에서 선택할 수 있고, 그 외 필드는 값을 직접 입력합니다. 각 필터는 호버 시 눈 모양 아이콘으로 일시 숨김(쿼리에서 제외) 처리할 수 있습니다.

5. 이벤트 조건(Event Conditions) 설정

이벤트 조건 영역에서 이벤트 조건 추가 버튼을 눌러 특정 이벤트와 그 파라미터 조건에 해당하는 데이터만 집계할 수 있습니다.

단계	설명
이벤트 선택	표준 이벤트 또는 커스텀 이벤트 중 하나를 검색해 선택합니다.
파라미터 조건 추가	`조건 추가`를 눌러 선택한 이벤트의 파라미터 키·연산자·값 조건을 추가합니다. 값은 실제 수집된 값 목록에서 자동완성으로 선택하거나 직접 입력합니다.

이벤트 조건은 한 번에 하나만 설정할 수 있습니다. 파라미터 조건은 여러 개 추가할 수 있습니다.

6. 쿼리 실행

설정을 마쳤으면 설정 패널 상단의 쿼리 실행 버튼을 누릅니다. 결과는 우측 테이블에 표시되며, 맨 위에 합계(Sum)와 평균(Avg) 요약 행이 함께 나타납니다. 설정 패널 상단의 초기화 버튼을 누르면 기간·메트릭·차원·필터·이벤트 조건이 기본값으로 초기화됩니다.

7. 결과 테이블 다루기

동작	방법
정렬	컬럼 헤더를 클릭하면 해당 컬럼 기준으로 정렬됩니다. 같은 컬럼을 다시 클릭하면 오름차순/내림차순이 전환됩니다.
페이지 이동	표 하단 페이지네이션으로 페이지를 이동합니다.
페이지 크기	한 페이지에 표시할 행 수를 10, 20, 50, 100 중에서 선택합니다.

금액 메트릭은 조직 기준 통화 코드가 값 뒤에 함께 표시됩니다. (예: 7,633 KRW)