세그먼트

세그먼트는 조건을 설정하여 게임 유저를 분류하는 기능입니다. 세그먼트 기능을 통해 게임 유저를 분류하고, 생성된 세그먼트 스냅샷을 활용하여 타겟팅 캠페인을 진행할 수 있습니다. (본 가이드 문서에서 게임 유저를 사용자로 표현합니다.)
게임 SDK 연동을 통해 기본적으로 제공되는 30가지 이상의 속성 조건을 설정할 수 있으며, 클라이언트 로그 전송 기능을 이용하면 직접 전송한 속성을 세그먼트 생성에 활용할 수 있습니다.
- 사용자 속성 클라이언트 로그 전송에 대한 자세한 내용은 커스텀 사용자 속성 로그에서 확인할 수 있습니다.

세그먼트 목록

게임 선택을 통해 게임을 선택하지 않는 경우 권한이 있는 모든 게임의 세그먼트를 한 번에 확인할 수 있으며, 게임을 선택하는 경우 선택된 게임에 대한 세그먼트만을 확인할 수 있습니다.
세그먼트 삭제는 해당 세그먼트를 생성한 계정을 통해서 가능합니다. 세그먼트를 삭제하면 삭제된 세그먼트를 통해 진행되고 있는 타겟팅 캠페인은 유지되지만, 새로운 스냅샷 및 타겟팅 캠페인은 생성할 수 없습니다.
세그먼트 번호 좌측의 라디오 버튼을 클릭한 후 “불러와서 새 세그먼트 정의” 버튼을 클릭하면 해당 세그먼트에서 설정된 속성 조건에 새로운 속성을 추가하여 새로운 세그먼트를 생성할 수 있습니다.
세그먼트 제목에 마우스 커서를 올리면 세그먼트 생성시 입력한 해당 세그먼트에 대한 설명을 확인할 수 있으며, 제목을 클릭하는 경우 세그먼트 상세 페이지로 이동하여 세그먼트 생성시 설정한 속성 조건에 대한 정보를 자세히 확인할 수 있습니다.

세그먼트 상세

세그먼트 상세 페이지를 통해 세그먼트 생성시 설정한 조건을 확인할 수 있으며, 세그먼트 스냅샷을 생성하고 이를 타겟팅 캠페인에 활용할 수 있습니다.
세그먼트 스냅샷
- 세그먼트 스냅샷은 세그먼트에서 설정된 속성 조건에 따라 추출된 사용자 목록을 의미합니다. 세그먼트 스냅샷 탭을 통해 생성한 세그먼트에서 추출한 유저 수를 확인할 수 있습니다.
- 세그먼트 스냅샷 데이터는 매시간 동기화되므로 스냅샷 생성 시마다 추출된 유저 수가 변경될 수 있습니다.
  - 세그먼트 스냅샷 데이터는 매시 10분까지 유입된 데이터로 집계하여 매시 35분에 동기화됩니다.
    - 매시 35분 이후 스냅샷 생성시 생성 시간대 10분까지 유입된 데이터 기준
      - 예 : 2023-04-06 19시 50분에 스냅샷 생성한 경우 2023-04-06 19시 10분까지 유입된 데이터
    - 매시 35분 이전 스냅샷 생성시 생성 시간대 1시간 전 10분까지 유입된 데이터 기준
      - 예 : 2023-04-06 19시 25분에 스냅샷 생성한 경우 2023-04-06 18시 10분까지 유입된 데이터
- 스냅샷을 추가로 생성하고 싶은 경우 스냅샷 추가 버튼을 통하여 생성할 수 있습니다. 스냅샷 추가 버튼을 클릭하고 제목을 입력한 후 저장 버튼을 클릭하면 스냅샷 리스트에서 생성된 스냅샷을 확인할 수 있습니다.
- 다운로드 옵션에서 기본 옵션을 선택하는 경우 playerId, uid, did, appId 필드로 이루어진 사용자 목록을 다운로드 받을 수 있으며, 추가정보 포함 옵션을 선택하여 다운로드 받는 경우 기본 옵션에서 제공하는 사용자 목록과 함께 세그먼트 생성시 설정한 속성 값을 다운로드 받을 수 있습니다.
  - 추가정보 포함 옵션을 선택하여 다운로드 받았을 때 노출되는 속성 필드 순서는 세그먼트 상세 페이지에 노출되는 속성 순서와 동일합니다. 단, 클라이언트 로그 전송 기능을 활용해 전송한 사용자 정의 속성의 속성 이름이 영문, 숫자 이외의 다른 문자(예 : 국문, 일문, 중문 등)인 경우 customInfoProperty1, customInfoProperty2와 같은 필드명으로 노출됩니다.
- 다운로드 기능을 통해 사용자 목록을 다운로드하고, 애널리틱스 빅쿼리 기능을 활용하여 다운로드 받은 사용자의 다양한 특성 정보를 확인해보세요. 애널리틱스 빅쿼리에 대한 자세한 내용은 애널리틱스 빅쿼리에서 확인할 수 있습니다.
타겟팅 캠페인
- 생성된 세그먼트 및 스냅샷을 활용하여 해당 사용자에 대한 타겟팅 캠페인을 진행할 수 있습니다. 타겟팅 캠페인에 대한 자세한 내용은 타겟팅에서 확인할 수 있습니다.

세그먼트 생성

세그먼트 생성을 원하는 게임을 선택한 후 생성 버튼을 클릭하면 세그먼트 생성 페이지로 이동하여 세그먼트를 생성할 수 있습니다.
구버전 전환
- 세그먼트 생성 페이지 내 구버전 전환 버튼을 클릭하면 10개의 속성을 제공하는 세그먼트 구버전을 사용할 수 있습니다.
  - 세그먼트 구버전에 대한 자세한 설명은 세그먼트(구버전)에서 확인할 수 있습니다.
세그먼트 정보

- - 대상 게임 선택 : 세그먼트 목록 페이지에서 선택한 게임이 표시됩니다. 대상 게임의 변경이 필요한 경우 세그먼트 목록 페이지에서 변경할 수 있습니다.
  - 세그먼트 제목(필수 입력 항목) : 세그먼트의 이름입니다. 해당 항목에서 설정한 세그먼트 제목이 세그먼트 목록에 노출됩니다.
  - 세그먼트 설명(필수 입력 항목) : 세그먼트를 설명할 수 있는 문장을 입력합니다. 세그먼트 목록 페이지 내 각 세그먼트 제목에 마우스 커서를 올리면 해당 항목에서 설정한 세그먼트 설명이 노출됩니다.

사용자 속성 선택

사용자 속성은 사용자가 갖는 특징 정보를 의미합니다. 사용자 속성 선택을 통해 속성을 선택하고 세부 조건을 설정하면 설정된 조건에 해당하는 사용자를 추출할 수 있습니다.

속성 그룹 추가

속성 그룹 추가 버튼을 클릭하면 속성 선택 팝업이 노출되며, 해당 화면에서 사용자 속성을 선택할 수 있습니다. 하나의 세그먼트는 최대 5개의 속성 그룹을 가질 수 있으며, 하나의 그룹은 최대 5개의 속성을 가질 수 있습니다.

게임 SDK 연동을 통해 기본적으로 확인할 수 있는 속성 목록은 아래와 같습니다. 단, SDK 버전 차이 등의 이유로 인해 각 속성에 대해 수집되는 로그가 없는 경우 일부 속성이 선택 화면에 노출되지 않을 수 있습니다.

속성 구분	속성 유형	속성 이름	설명
광고 정보	숫자형	기간 광고 시청 시작 횟수	사용자가 특정 기간 동안 인게임 광고 시청을 시작한 횟수입니다.
	숫자형	기간 광고 시청 완료 횟수	사용자가 특정 기간 동안 인게임 광고 시청을 완료한 횟수입니다.
	숫자형	총 광고 시청 시작 횟수	사용자의 최초 접속 이후 인게임 광고 시청을 시작한 횟수의 누적 값입니다.
	숫자형	총 광고 시청 완료 횟수	사용자의 최초 접속 이후 인게임 광고 시청을 완료한 횟수의 누적 값입니다.
구매 정보	숫자형	기간 결제 금액(KRW)	사용자가 특정 기간동안 결제한 금액(단위 : 원)입니다.
	숫자형	기간 결제 금액(USD)	사용자가 특정 기간동안 결제한 금액(단위 : 달러)입니다.
	숫자형	기간 결제 횟수	사용자가 특정 기간동안 결제한 횟수입니다.
	숫자형	총 결제 금액(KRW)	사용자의 최초 접속 이후 누적 결제 금액(단위 : 원)입니다.
	숫자형	총 결제 금액(USD)	사용자의 최초 접속 이후 누적 결제 금액(단위 : 달러)입니다.
	숫자형	총 결제 횟수	사용자의 최초 접속 이후 누적 결제 횟수입니다.
	날짜형	첫 구매 일자	사용자의 첫 구매 일자입니다.
사용자 정보	문자형	OS	사용자의 운영체제(예 : IOS)입니다.
	문자형	OS 버전	사용자의 운영체제 버전(예 : 13.0.1)입니다.
	문자형	게스트 유저	사용자의 게스트 유저 여부입니다.
	문자형	국가	사용자의 국가(예 : 대한민국)입니다.
	문자형	마켓	사용자가 게임을 설치한 마켓(예 : 구글 플레이)입니다.
	문자형	서버 아이디	사용자의 서버 아이디(예 : global)입니다.
	문자형	앱 버전	사용자의 게임 앱 버전(예 : 1.6.5)입니다.
	문자형	앱 아이디	사용자의 앱 아이디입니다. 앱센터에서 발급 받은 appId 값을 선택할 수 있습니다.
	문자형	언어	사용자의 언어(예 : 한국어)입니다.
	문자형	유저 분류 유형	사용자의 유저 분류 유형(예 : 고래)입니다. 유저 분류 유형에 대한 자세한 설명은 유저 분류 지표에서 확인할 수 있습니다.
	문자형	인증수단	사용자의 게임 접속시 인증 수단(예 : 페이스북)입니다.
게임 플레이 정보	숫자형	계정 레벨	사용자의 계정 기준 레벨입니다. 게임 플레이 분석 – 레벨업 로그의 “levelUpType 필드 – account”로 전송된 경우 선택 가능합니다.
세션 정보	숫자형	기간 세션 수	사용자의 특정 기간 동안의 세션 개수 입니다.
	숫자형	기간 플레이타임(초)	사용자의 특정 기간 동안의 플레이타임(단위 : 초)입니다.
	숫자형	총 세션 수	사용자의 최초 접속 이후 누적 세션 개수입니다.
	숫자형	총 플레이타임(초)	사용자의 최초 접속 이후 누적 플레이타임(단위 : 초)입니다.
접속 정보	숫자형	기간 접속 일수	사용자의 특정 기간 동안의 접속 일수입니다.
	숫자형	기간 접속 횟수	사용자의 특정 기간 동안의 접속 횟수입니다.
	문자형	기간 신규 유저	사용자의 특정 기간 동안의 신규 유저 여부입니다.
	날짜형	첫 접속 일자	사용자의 첫 접속 일자입니다.
	숫자형	총 접속 일수	사용자의 최초 접속 이후 누적 접속 일 수 입니다.
	숫자형	총 접속 횟수	사용자의 최초 접속 이후 누적 접속 횟수 입니다.
	숫자형	휴면 일수	사용자가 연속으로 로그인하지 않은 일 수입니다. 휴면 일수 속성은 세그먼트 생성일을 기준으로 계산하여 제공됩니다. 예 : 04월 10일에 휴면 일수 속성을 3일 이상으로 선택한 경우 → 마지막 접속일이 4월 8일 이전인 사용자 추출
푸시 정보	숫자형	기간 대용량 푸시 오픈 횟수	사용자의 특정 기간 동안의 대용량 푸시 오픈 횟수입니다.
	숫자형	기간 타겟팅 푸시 오픈 횟수	사용자의 특정 기간 동안의 타겟팅 푸시 오픈 횟수입니다.
	숫자형	총 대용량 푸시 오픈 횟수	사용자의 최초 접속 이후 누적 대용량 푸시 오픈 횟수 입니다.
	숫자형	총 타겟팅 푸시 오픈 횟수	사용자의 최초 접속 이후 누적 타겟팅 푸시 오픈 횟수 입니다.

클라이언트 로그 전송 기능을 활용하여 사용자 속성 로그를 전송하면 전송 후 최대 1시간 이내에 세그먼트 생성에 사용자 정의 속성을 활용할 수 있습니다.
- 사용자 속성 클라이언트 로그 전송 기능에 대한 자세한 내용은 커스텀 사용자 속성 로그에서 확인할 수 있습니다.

속성 선택 화면에서 세그먼트 생성에 활용하고자 하는 속성을 모두 선택한 뒤 적용하기 버튼을 클릭하면 선택된 모든 속성이 하나의 그룹으로 노출됩니다. 선택된 속성을 제거하거나 변경하고 싶은 경우 [-] 버튼과 속성 추가 버튼을 통해 제거, 변경할 수 있습니다. 원하는 속성을 모두 선택한 후에는 각 속성에 원하는 조건을 부여할 수 있습니다.
- 선택한 속성이 횟수, 일수 등을 비롯한 “숫자형 속성”일 때, 자료형이 integer(예 : 접속 횟수)인 경우 1 이상의 정수 값을, 자료형이 float(예 : 기간 결제 금액(USD))인 경우 0 이상의 실수 값을 입력한 뒤 이상/이하/사이/포함/포함하지 않음 중 하나를 택하여 속성 조건을 설정할 수 있습니다.
  - 이상 : 입력한 숫자와 같거나 큰 속성 값을 가지는 사용자를 추출합니다.
  - 이하 : 입력한 숫자와 같거나 작은 속성 값을 가지는 사용자를 추출합니다.
  - 사이 : 입력한 두 개의 숫자를 포함한 두 숫자 사이의 속성 값을 가지는 사용자를 추출합니다.
  - 포함 : 입력한 숫자에 해당하는 속성 값을 가지는 사용자를 추출합니다.
  - 포함하지 않음 : 입력한 숫자에 해당하지 않는 속성 값을 가지는 사용자를 추출합니다.
    - 예 : 총 결제 금액(KRW) 속성에 10000을 입력하고 포함하지 않음 옵션을 선택하는 경우 → 총 결제 금액이 10000원이 아닌 사용자 추출
- 선택한 속성이 국가, 언어 등을 비롯한 “문자형 속성”인 경우(사용자 정의 속성은 전송한 속성의 자료형이 string인 경우), 속성 값 드롭다운 박스를 통해 선택할 수 있는 값을 검색, 조회하고 선택할 수 있습니다. 단, 일부 속성 값에 대해 국문 또는 영문 값(예 : 대한민국 또는 Korea)이 아닌, 원본 값(예 : KR)이 노출될 수 있습니다.
- 선택한 속성이 첫 접속 일자와 같은 “날짜형 속성”인 경우(사용자 정의 속성은 전송한 속성의 자료형이 timestamp인 경우), 달력을 통해 날짜 값을 선택한 뒤 이전/이후/당일/사이 중 하나를 택하여 속성 조건을 설정할 수 있습니다.
  - 이전 : 특정 날짜를 선택하고 이전을 선택하면 선택된 날짜보다 이전인 기간 동안의 속성 값을 조회할 수 있습니다.
  - 이후 : 특정 날짜를 선택하고 이후를 선택하면 선택된 날짜보다 이후인 기간 동안의 속성 값을 조회할 수 있습니다.
  - 당일 : 특정 날짜를 선택하고 당일을 선택하면 선택된 날짜 당일의 속성 값을 조회할 수 있습니다.
  - 사이 : 사이를 선택하고 두 날짜를 선택하면 선택된 두 날짜 사이의 속성 값을 조회할 수 있습니다.
- 기간 세션 수와 같이 속성 이름이 “기간”으로 시작하는 경우, 조건에 기간을 추가로 설정하여 특정 기간 동안의 속성 값을 조건으로 설정할 수 있습니다.
  - 기간은 최근 기간 항목과 날짜 항목 중 하나를 택하여 설정할 수 있습니다.
    - 최근 기간
      - 당일 또는 1 이상 365 이하의 숫자 값을 입력하여 절대적인 기간이 아닌 상대적인 일 수를 지정할 수 있습니다.
      - 조회하는 시점을 기준으로 속성 값을 계산하기 때문에 조회 시점에 따라 스냅샷 유저 수가 상이할 수 있습니다.
        
        예 : 세그먼트 조건을 최근 기간 1일 전으로 설정한 경우
        
        4월 10일에 스냅샷 생성 또는 타겟팅 캠페인 설정 → 4월 9일 ~ 4월 10일 생성 시점까지의 속성 값 조회
        
        4월 11일에 스냅샷 생성 또는 타겟팅 캠페인 설정 → 4월 10일 ~ 4월 11일 생성 시점까지의 속성 값 조회
    - 날짜
      - 설정한 기간동안의 속성 값을 조회합니다. 설정할 수 있는 날짜에는 제한이 없으나, 날짜 범위는 최대 1년의 제한이 있습니다. 예를 들어, 2018년 1월 1일 ~ 2019년 1월 1일은 설정된 날짜의 범위가 1년을 초과하지 않으므로 설정할 수 있지만 2022년 1월 1일 ~ 2023년 4월 10일은 설정된 날짜의 범위가 1년을 초과하므로 설정할 수 없습니다.
      - 날짜 옵션을 선택하면 날짜형 속성의 이전/이후/당일/사이 조건 중 하나를 택하여 속성 조건을 설정할 수 있습니다.

- 속성 간 연결
  - 세그먼트 생성에 활용하고자 하는 속성과 그에 대한 조건을 모두 설정한 후 선택된 속성을 AND, OR 조건 중 하나를 택하여 연결할 수 있습니다. 해당 옵션에서 선택한 값으로 그룹 내 모든 속성이 연결됩니다.
    - AND : 설정된 속성 조건을 모두 만족시키는 사용자를 추출합니다.
    - OR : 설정된 속성 조건 중 하나라도 만족시키는 사용자를 추출합니다.
    - 예 : 총 접속 횟수 속성이 3회 이상 속성 조건과 국가가 한국인 속성 조건을 설정한 경우
      - 속성 간 연결 옵션을 AND로 설정 → 총 접속 횟수가 3회 이상 이면서 한국인 사용자가 추출
      - 속성 간 연결 옵션을 OR로 설정 → 총 접속 횟수가 3회 이상인 사용자이거나 국가가 한국인 사용자 모두가 추출
- 다중 값이 조회되는 경우
  - 국가, 언어 속성과 같이 속성 이름이 “기간”으로 시작하지 않는 경우, 사용자의 최초 접속 이후의 모든 속성 값을 기준으로 제공합니다. 이 때 다중 값이 조회되는 경우 옵션을 활용하여 최초 접속 이후 사용자가 갖는 속성 값의 마지막 값과 모든 값 중 하나를 택하여 조건을 설정할 수 있습니다.
    - 마지막 값 : 사용자의 첫 접속부터 조회 시점까지의 사용자가 갖는 모든 속성 값 중 가장 마지막 값을 기준으로 사용자를 추출합니다.
    - 모든 값 : 사용자의 첫 접속부터 조회 시점까지의 사용자가 갖는 모든 속성 값을 기준으로 사용자를 추출합니다.
    - 예 : A 사용자가 4월 9일에 미국, 한국에서 접속하고 4월 10일에 마지막으로 한국에 접속한 경우
      - 다중 값이 조회되는 경우 옵션을 마지막 값으로 설정 → 국가 속성을 “한국”을 선택하는 경우에 추출
      - 다중 값이 조회되는 경우 옵션을 모든 값으로 설정 → 국가 속성을 “미국”과 “한국” 중 어느 것을 선택해도 추출

- 속성 그룹 연결 조건
  - 2개 이상의 속성 그룹을 추가하는 경우 속성 그룹 연결 조건 박스가 노출되며, AND나 OR 중 하나를 택하여 설정할 수 있습니다. 해당 옵션에서 선택한 값으로 생성된 모든 속성 그룹을 연결합니다.
    - AND : 설정된 그룹의 공통된 사용자(교집합)를 추출합니다.
    - OR : 설정된 그룹의 모든 사용자(합집합)를 추출합니다.
    - 예 : 속성 그룹 1은 총 결제 금액(KRW) 5000원 이상인 조건을, 속성 그룹 2는 총 플레이타임(초) 3600초 이상인 조건을 설정한 경우
      - 속성 그룹 연결 조건을 AND로 설정 → 총 결제 금액(KRW)이 5000원 이상이면서 동시에 총 플레이타임(초) 3600초 이상인 사용자 추출
      - 속성 그룹 연결 조건을 OR로 설정 → 총 결제 금액(KRW)이 5000원 이상이거나 총 플레이타임(초) 3600초 이상인 사용자 모두가 추출

기본 스냅샷 생성 설정
- 기본 스냅샷 생성 설정 항목을 통해 playerId, uid, did, appId 필드를 포함하는 기본 정보 스냅샷 생성 여부를 설정할 수 있습니다.
- 설정을 선택하고 세그먼트를 생성하면 세그먼트 생성과 동시에 “Basic Segment”라는 이름의 기본 정보 스냅샷이 생성되며, 생성된 스냅샷은 세그먼트 상세 페이지 – 세그먼트 스냅샷 탭을 통해 확인할 수 있습니다.
- 미설정을 선택하고 세그먼트를 생성하면 세그먼트 스냅샷은 생성되지 않으며, 필요한 경우 세그먼트 스냅샷 페이지에서 스냅샷을 수동으로 생성할 수 있습니다.

세그먼트 스냅샷 스케줄 설정
- 세그먼트 스냅샷 스케줄 설정 항목을 통해 세그먼트 스냅샷 생성을 자동화할 수 있습니다. 스케줄 설정 개수에 대한 제한은 없으며, 자유롭게 설정 가능합니다.
- 설정을 선택하고 하단의 기간, 주기, 시간(KST 기준)을 설정하면 설정된 기간동안 설정된 시간에 설정된 주기를 통해 스냅샷을 생성합니다.
  - 예 : 기간을 4월 8일 15:00 ~ 4월 10일 15:00로 설정하고, 주기는 매일, 시간은 16:00로 설정한 경우 → 4월 8일 16시, 4월 9일 16시 2회에 걸쳐 세그먼트 스냅샷 생성
- 생성된 스냅샷은 세그먼트 상세 페이지 – 세그먼트 스냅샷 탭을 통해 확인할 수 있습니다.

세그먼트

세그먼트 목록

세그먼트 상세

세그먼트 스냅샷

타겟팅 캠페인

세그먼트 생성

구버전 전환

세그먼트 정보

사용자 속성 선택

속성 그룹 추가

속성 간 연결

다중 값이 조회되는 경우

속성 그룹 연결 조건

기본 스냅샷 생성 설정

세그먼트 스냅샷 스케줄 설정

추천 세그먼트

게임 전체 사용자

최근 7일 이내 신규 유입 사용자

최근 1년 이내 특정 국가에서 1회 이상 접속한 사용자

특정 마켓 사용자 중 3일 이상 휴면 사용자

특정 기간 동안 접속한 사용자 중 3일 이상 휴면 사용자

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원

속성 이름	속성 값	속성 조건	기간 조건
앱 아이디	앱 아이디 값 전체 선택	–	–