Skip to main content
Explorer에서 만드는 모든 쿼리는 AftersellQL (AQL) 문이에요. 대부분의 경우 쿼리를 시각적으로 만들기 때문에 AQL을 직접 작성할 일은 없어요. 이 페이지는 선택할 수 있는 지표와 차원, AQL 텍스트 형식, 시간대 규칙에 대한 참조 문서예요.

사용 가능한 지표

선택할 수 있는 지표들로, 지표 선택기와 같은 방식으로 그룹화되어 있어요.

수익 및 이익

전환

참여

스토어 성과

Rokt 네트워크

차원

차원은 속성별로 지표를 세분화해요. 모든 차원이 모든 지표와 호환되는 것은 아니며, Explorer는 호환되지 않는 조합을 자동으로 방지해요(예: Decline rate와 Show rate는 Currency별로 세분화할 수 없어요).

사용 가능한 차원

사용할 수 없는 차원

다음 차원은 아직 개발 중이에요. 선택기에 표시되지만 구현될 때까지 모든 지표에 대해 ‘Not compatible’로 표시돼요.

AQL 문 구문

AQL 문은 여러 절로 구성된 하나의 질문이에요. SELECT와 시간 범위(SINCE)만 필수이고 나머지는 모두 선택 사항이에요. 선택 절을 포함할 때는 다음 순서로 작성해야 해요:
최소 예시로, 지난 30일간의 일별 업셀 수익과 수락률은 다음과 같아요:
키워드는 대소문자를 구분하지 않으며(SELECT와 select 모두 작동), 문은 세미콜론으로 끝나지 않아요. 문자열 값은 큰따옴표로 감싸고, 숫자와 목록은 감싸지 않아요.

SELECT와 GROUP BY

  • **SELECT**는 측정할 지표를 쉼표로 구분해 나열해요. 예: SELECT revenue, impressions, accept_rate.
  • **GROUP BY**는 date, device, surface, funnel 같은 하나 이상의 차원으로 지표를 세분화해요. GROUP BY가 없으면 전체 기간에 대한 단일 합계가 나와요.

WHERE로 필터링하기

WHERE는 측정 전에 데이터를 좁혀요. 조건은 AND로 결합하세요.
impressions, accept_rate, rpv는 기기, 퍼널, 플레이스먼트, 상품별로 필터링하거나 그룹화할 수 없어요. 해당 소스 롤업에 그런 열이 없기 때문이에요. 이 중 하나를 선택하는 쿼리에 WHERE device = "mobile"을 추가하면 metric "impressions" cannot be filtered by "device" 오류와 함께 거부돼요.
지원되는 비교 연산자는 =, !=, IN, NOT IN, >, <, >=, <=예요. 여러 값을 일치시키려면 IN과 목록을 사용하세요:
experiment는 필터링 가능한 필드가 아니에요. 롤업 소스가 없으므로 WHERE experiment IN [...]은 filters on "experiment" are not supported. 오류와 함께 거부돼요. funnel 필터는 다중 선택을 지원해요. is one of(IN)는 선택한 퍼널만 포함하고, is not one of(NOT IN)는 선택한 퍼널을 제외해요. Funnel로 그룹화하고 is one of 필터를 적용하면 차트에 선택한 퍼널마다 하나의 선이 표시되며, “Other”로 합쳐지지 않아요.

시간 범위와 비교

모든 쿼리에는 SINCE로 설정하는 시간 범위가 필요해요: 사용 가능한 프리셋: last_1d, last_7d, last_30d, last_90d, this_month, last_month, this_year.
  • **GRAIN**은 시계열의 버킷 크기를 설정해요: day, week, month. (hour는 구문 분석되지만 시간별 데이터를 제공하는 롤업이 없으므로 이러한 쿼리는 group_by / time_grain combination is not supported. 오류와 함께 거부돼요.)
  • **COMPARE**는 두 번째 기간을 겹쳐 표시해요. 바로 직전의 같은 길이 기간인 previous_period를 사용하세요. previous_year는 웨어하우스에 2026년 2월 이전 데이터가 없기 때문에 Compare 선택기에서 숨겨져 있어요. 이전에 저장된 쿼리가 계속 구문 분석되도록 AQL에서만 입력할 수 있어요.
보고 데이터는 2026년 2월부터 시작되므로, 그보다 이전 기간은 두 기간 모두 빈 결과를 반환해요.

차트 선택하기

  • **CHART**는 결과 표시 방식을 설정해요: scorecard, line_chart, bar_chart, area_chart, funnel_chart, table.
  • **TIMEZONE**은 날짜 버킷에 사용할 시간대를 따옴표로 감싼 IANA 이름으로 설정해요. 예: TIMEZONE "America/New_York". 기본값은 UTC예요(시간대 참조).
funnel_chart 유형에는 특정 요구 사항이 있어요:
  • 플레이스먼트 모드. placement로 그룹화하고 지표 하나를 선택하세요. 단계는 표준 플레이스먼트 순서(기본 업셀, 다운셀, 추가 업셀 순)로 정렬돼요. 첫 번째 지표만 표시되며, 추가 지표는 각주에 표시돼요.
  • 지표 모드. GROUP BY 없이 두 개 이상의 지표를 선택하세요. 각 지표가 쿼리 순서대로 퍼널 단계가 돼요(예: SELECT impressions, conversions는 노출에서 전환으로의 이탈을 보여줘요). 모든 지표는 같은 단위를 사용해야 해요.
플레이스먼트 모드에는 플레이스먼트별로 세분화할 수 있는 지표가 필요해요. impressions, accept_rate, rpv는 세분화할 수 없으므로, 이들에 대해서는 퍼널 차트에 “These metrics can’t be grouped by placement”가 표시돼요.

정렬 및 제한

  • **ORDER BY**는 지표나 차원을 기준으로 ASC 또는 DESC로 결과를 정렬해요.
  • **LIMIT**은 반환되는 행 수를 제한하며, “상위 N개” 질문에 유용해요.

추가 예시

impressions, accept_rate, rpv는 기기별로 세분화할 수 없어요. 이들의 롤업은 스토어 × 서피스 × 일 단위이며 기기 열이 없어요. 기기 비교에는 revenue(또는 전환 기반의 다른 지표)를 사용하세요.

시간대

기본적으로 쿼리는 UTC로 실행돼요. 날짜 버킷 결과가 현지 시간을 반영하도록 시간대를 재정의할 수 있어요(툴바 단계는 시간대 설정하기 참조).
Impressions, Accept Rate, Revenue Per Visit가 포함된 쿼리는 선택한 시간대와 관계없이 항상 UTC로 날짜를 버킷화해요. 이 지표들은 UTC 기준 일 단위로 보고되는 일별 롤업에서 가져오기 때문이에요. 쿼리에 이 중 하나와 다른 지표가 섞여 있으면 날짜 버킷이 맞춰지도록 전체 결과 집합이 UTC로 대체돼요.

TIMEZONE 절

CHART와 ORDER BY 사이에 위치하는 TIMEZONE 절로 AQL에서 직접 시간대를 지정하세요:
이 절이 있으면 해당 쿼리에 대해 툴바 선택을 재정의하며, 저장 후 다시 불러올 때도 유지돼요.

사용 가능한 시간대

선택기(및 TIMEZONE 절)는 정해진 10개 시간대만 허용해요. 그 외의 IANA 시간대는 지원되지 않는 것으로 거부돼요.

계정 기본값과 시간대가 결과에 미치는 영향

애널리틱스 설정에서 Lock reporting timezone이 활성화되어 있으면 Account default를 선택할 때 고정된 시간대가 사용돼요(툴바에 확인된 시간대가 표시돼요. 예: Timezone: Account default (Paris (CET))). 애널리틱스 설정 페이지는 전체 IANA 목록을 허용하지만 Reports는 위의 10개 시간대만 지원해요. 고정된 시간대가 그중 하나가 아니면 Account default는 별도 안내 없이 UTC로 처리돼요. Lock reporting timezone이 활성화되어 있지 않으면 Account default는 UTC로 대체돼요. 시간대가 설정되면 날짜 버킷화에 UTC 대신 현지 시간이 사용돼요. 예를 들어 2026-03-29T01:30:00Z에 발생한 이벤트는 뉴욕(ET)에서는 3월 28일, 파리(CET)에서는 3월 29일에 해당해요. 이전에 저장된 쿼리를 포함해 시간대가 없는 쿼리는 계속 UTC로 실행돼요.