이벤트
데이터 추출
데이터 추출은 수집된 이벤트를 기반으로 광고 대상자(오디언스)의 광고 식별자(ADID)를 CSV로 내보내는 화면입니다. 좌측 메뉴 이벤트 > 데이터 추출에서 접근하며, 추출 조건을 설정해 모수를 미리 확인한 뒤(미리보기 카운트) CSV를 내려받는(CSV 다운로드) 순서로 진행됩니다. 추출된 CSV는 Meta·Google·TikTok 등 광고 플랫폼의 맞춤 타겟(Custom Audience) 업로드에 사용할 수 있습니다.
1. 추출 흐름
- 좌측
필터패널에서 모수 프리셋·기간 설정·플랫폼·CSV 프리셋·해시 포맷을 설정합니다. [미리보기 카운트]버튼을 눌러 추출될 모수(플랫폼별 고유 ADID 수)를 확인합니다.- 우측 결과 표에서 합계·Android·iOS 수치를 검토합니다.
[CSV 다운로드]버튼을 눌러 파일을 내려받습니다.
모수가 0건이면 [CSV 다운로드] 버튼이 비활성화됩니다. 기간이나 프리셋을 조정한 뒤 다시 미리보기를 실행합니다.
2. 필터 항목
| 항목 | 설명 |
|---|---|
모수 프리셋 | 추출할 사용자 집단의 종류입니다(아래 표 참고). |
기간 설정 | 이벤트 집계 기간입니다. 기본값은 최근 90일입니다. |
플랫폼 | 전체 / Android / iOS 중 선택합니다. |
휴면 기간(무활동) | 휴면 유저 프리셋을 선택했을 때만 표시됩니다. 활동이 없는 기준 일수이며 기본 30일(최소 7일, 최대 365일)입니다. |
광고 플랫폼 CSV 프리셋 | 내려받을 CSV의 컬럼 형식입니다(아래 표 참고). |
해시 포맷 | ADID를 SHA256으로 해시할지, 원문(Plain) 그대로 내보낼지 선택합니다. |
모수 프리셋
| 프리셋 | 추출 대상 |
|---|---|
| 설치 유저 (Installers) | 선택 기간에 설치(install/first_open) 이벤트가 발생한 디바이스입니다. |
| 구매 유저 (Purchasers) | 선택 기간에 구매(purchase/first_purchase) 이벤트가 발생한 디바이스입니다. |
| 설치 후 미구매 유저 (Installed Non-Purchasers) | 선택 기간에 설치했으나 구매하지 않은 디바이스입니다(설치 유저에서 구매 유저를 제외). |
| 휴면 유저 (Dormant Users) | 설치 후 최근 휴면 기간 동안 어떤 이벤트도 발생하지 않은 디바이스입니다. |
광고 플랫폼 CSV 프리셋
선택한 프리셋에 따라 CSV의 컬럼 구성이 달라집니다.
| 프리셋 | CSV 컬럼 | 비고 |
|---|---|---|
| Meta (Facebook/Instagram) | madid | IDFA(iOS)와 GAID(Android)를 단일 컬럼으로 통합합니다. |
| Google Ads | Mobile Device ID | 단일 컬럼입니다. |
| TikTok Ads | IDFA, GAID | iOS 값은 IDFA 컬럼, Android 값은 GAID 컬럼에 분리해 채웁니다. |
| Custom (raw columns) | advertising_id, platform | 광고 식별자와 플랫폼을 그대로 내보냅니다. |
3. 해시 포맷 (SHA256 권장)
| 형식 | 설명 |
|---|---|
| SHA256 (광고 플랫폼 권장) | ADID를 소문자로 정규화한 뒤 SHA256으로 해시해 내보냅니다. |
| Plain text | ADID 원문을 그대로 내보냅니다. |
광고 플랫폼의 맞춤 타겟 업로드는 일반적으로 해시된 식별자를 요구하므로, 외부 광고 플랫폼에 업로드할 목적이라면 SHA256을 권장합니다.
4. 미리보기 결과 표
[미리보기 카운트] 실행 후 우측에 표시되는 결과 표는 다음 컬럼으로 구성됩니다.
| 컬럼 | 설명 |
|---|---|
| 플랫폼 | 합계(Total), Android, iOS 행으로 구분됩니다. |
| 광고 ID 종류 | 합계는 ADID, Android는 GAID, iOS는 IDFA로 표시됩니다. |
| 고유 ADID | 중복을 제거한 고유 광고 식별자 개수입니다. |
| 비율 | 합계 대비 각 플랫폼이 차지하는 비율입니다. |
5. 자동 제외 규칙
추출 시 광고 식별자가 유효하지 않은 디바이스는 모수에서 자동으로 제외됩니다.
| 제외 대상 | 설명 |
|---|---|
| 광고 식별자 없음 | advertisingId가 비어 있는(null/빈 값) 디바이스입니다. |
| 0값 IDFA | iOS에서 추적 동의를 받지 못해 0으로 채워진 IDFA(00000000-0000-0000-0000-000000000000)입니다. |
| Android·iOS 외 플랫폼 | 광고 식별자 기반 추출 특성상 Android·iOS 디바이스만 집계됩니다. |
이러한 자동 제외 때문에, 실시간 로그에서 보이는 전체 이벤트 수보다 추출 모수가 적게 나오는 것이 정상입니다.