- 유저 가이드
- 광고 성과 조회하기
- 원본 데이터 활용하기
원본 데이터 추출하기
에어브릿지가 수집한 광고 성과를 원본 데이터(Raw Data) 형태의 CSV 파일로 다운로드할 수 있습니다. 원본 데이터 추출은 에어브릿지 대시보드의 [원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에서 활용할 수 있습니다.
원본 앱 데이터 또는 원본 웹 데이터를 추출할 수 있습니다. 에어브릿지 대시보드의 [원본 데이터]>[원본 앱 데이터 추출]에서는 원본 앱 데이터를 추출하고 다운로드할 수 있습니다. 에어브릿지 대시보드의 [원본 데이터]>[원본 웹 데이터 추출]에서는 원본 웹 데이터를 추출하고 다운로드할 수 있습니다.
[원본 앱 데이터 추출] 또는 [원본 웹 데이터 추출]에서 '원본 데이터 추출'을 클릭해 주세요. 원본 데이터 추출은 5단계로 진행됩니다. 아래 과정을 참고해 주세요.
원본 데이터로 추출하고 싶은 이벤트를 선택합니다. 이벤트 선택에서 반드시 1개 이상의 이벤트를 선택해야 다음 단계를 진행할 수 있습니다.
에어브릿지 이벤트는 스탠다드 이벤트(Standard Event)와 커스텀 이벤트(Custom Event)로 구분됩니다. 이벤트를 개별로 선택하거나 이벤트 카테고리를 선택해 원본 데이터로 추출할 이벤트를 지정할 수 있습니다.
대시보드 오른쪽에서 각 이벤트 카테고리별로 선택한 이벤트 개수를 확인할 수 있습니다. 또한 이벤트 카테고리 이름을 클릭해 해당 이벤트 카테고리로 이동할 수 있습니다.
추출한 원본 데이터에서 확인하고 싶은 이벤트의 프로퍼티를 선택합니다. 프로퍼티는 이벤트의 하위 속성입니다. Event Category는 항상 선택됩니다. 추가 프로퍼티를 선택하지 않아도 다음 단계를 진행할 수 있습니다.
대시보드 오른쪽에서 각 프로퍼티 카테고리별로 선택한 프로퍼티 개수를 확인할 수 있습니다. 또한 프로퍼티 카테고리 이름을 클릭해 해당 프로퍼티 카테고리로 이동할 수 있습니다.
프로퍼티는 다운로드하는 CSV 파일에서 열로 확인할 수 있습니다. 에어브릿지에서 지원하는 프로퍼티 목록과 자세한 설명은 에어브릿지 데이터 스펙을 참고해 주세요. 프로퍼티 이름은 Field Name에서 찾을 수 있습니다.
프로퍼티별로 필터를 추가할 수 있습니다. 필터를 선택하지 않아도 다음 단계를 진행할 수 있습니다.
필터를 설정하면 특정 값을 포함하거나 포함하지 않는 프로퍼티를 추출할 수 있습니다. 프로퍼티별로 지원하는 필터가 다를 수 있습니다.
이전 단계에서 완료한 설정 결과를 미리보기에서 확인할 수 있습니다.
미리보기는 최근 3일 동안 수집된 데이터를 기준으로 제공됩니다. 추출 기간은 다음 단계에서 설정할 수 있습니다. 또한 실제 추출 결과는 미리보기와 다를 수 있습니다. 원하는 추출 결과가 나오지 않는다면 10분 정도 기다린 이후에 다시 시도해 주세요.
원본 데이터의 추출 기간을 설정합니다. 추출 기간으로 설정할 수 있는 기간은 추출하는 날을 기준으로 오늘(D-0)부터 179일 전(D-179) 사이입니다. 또한 1번에 설정할 수 있는 최대 추출 기간은 31일입니다.
예를 들어 8월 30일에 원본 데이터를 추출한다면 추출 기간으로 설정할 수 있는 기간은 아래와 같습니다.
추출 기간으로 설정할 수 있는 기간: 3월 4일부터 8월 30일까지
해당 기간에서 원본 데이터를 최대 31일 치를 추출할 수 있습니다.
추출 기간 설정을 마치고 ‘추출 요청’을 클릭하면 원본 데이터 추출이 진행됩니다. 추출이 완료되면 에어브릿지 계정에 등록한 이메일로 완료 알림이 전송됩니다.
원본 데이터 추출이 정상적으로 완료되면 [원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에 있는 목록의 처리상태·다운로드에서 파일 크기를 확인할 수 있습니다. 파일 크기를 클릭하면 원본 데이터를 CSV 파일로 다운로드할 수 있습니다.
[원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에 있는 목록에서 원본 데이터를 요청한 계정, 템플릿 이름, 추출한 원본 데이터의 기간, 요청 일시, 처리상태를 확인할 수 있습니다.
원본 데이터 관련 항목이 포함된 각 행을 클릭하면 설정된 이벤트, 프로퍼티, 필터의 상세 내역과 계정 권한을 추가로 확인할 수 있습니다.
원본 데이터 추출이 정상적으로 완료되면 [원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에 있는 목록의 처리상태·다운로드에서 파일 크기를 확인할 수 있습니다. 파일 크기를 클릭하면 원본 데이터를 CSV 파일로 다운로드할 수 있습니다.
파일 크기가 나오지 않는다면 다운로드할 수 없습니다. 원본 데이터 추출이 정상적으로 완료되지 않았거나 원본 데이터를 다운로드할 수 없다면 상태 메시지를 통해 확인할 수 있습니다.
원본 데이터 추출에서 확인할 수 있는 상태 메시지의 자세한 의미는 아래에서 확인해 주세요.
상태 메세지 | 설명 |
|---|---|
처리중 | 요청한 원본 데이터를 추출하고 있습니다. 원본 데이터 파일을 다운로드 완료하면 에어브릿지 계정에 등록한 이메일로 알림이 전송됩니다 |
취소 | 원본 데이터 추출 요청을 취소했습니다 |
실패 | 일시적인 오류로 원본 데이터 추출이 실패했습니다. ‘재시도’를 클릭해 원본 데이터 추출을 다시 요청할 수 있습니다 오류가 계속 된다면 에어브릿지 CSM에게 문의해 주세요. 담당 CSM이 없는 경우 문의하기를 통해 문의해 주세요. |
만료 | 원본 데이터를 다운로드할 수 있는 기간(최대 30일)이 만료됐습니다 동일한 조건의 원본 데이터를 다운로드하고 싶다면 ‘데이터 추출’을 클릭해 원본 데이터 조건을 다시 설정해 주세요 |
요청 시간 초과 | 원본 데이터를 추출하는 시간이 정상 범위를 초과했습니다. 많은 원본 데이터 양이 원인일 수 있습니다 필터를 추가 설정하거나 요청 기간을 줄여 원본 데이터 양을 조정해 주세요 |
5GB 초과 | 추출 요청한 원본 데이터의 파일 크기가 제한 크기인 5GB를 넘어 추출할 수 없습니다 필터를 추가 설정하거나 요청 기간을 줄여 원본 데이터 양을 조정해 주세요 |
결과 없음 | 추출 요청한 원본 데이터에 대한 추출 과정을 완료했지만 결과 데이터가 존재하지 않습니다 ‘데이터 추출’을 클릭해 요청 조건을 다시 설정해 주세요 |
저장한 원본 데이터 설정을 각 원본 데이터의 [저장된 템플릿]에서 확인할 수 있습니다. 원본 데이터 템플릿을 활용하면 추출하고 싶은 원본 데이터를 반복적으로 설정하지 않아도 템플릿을 선택해 원본 데이터를 추출할 수 있습니다. 모든 원본 데이터 추출 내역은 [원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에 있는 목록에서 확인할 수 있습니다.
[저장된 템플릿]에서 ‘템플릿 생성’을 클릭하거나 이미 저장된 템플릿을 복사해 새로운 원본 데이터 템플릿을 생성할 수 있습니다.
템플릿 중 프리셋(Preset)으로 기본 설정과 프로드 체크(Fraud Check) 데이터가 있습니다. 기본 설정은 일반적으로 확인하는 이벤트와 프로퍼티를 선택한 프리셋입니다. 프로드 체크 데이터는 프로드를 확인하기 위해 일반적으로 확인하는 이벤트와 프로퍼티를 선택한 프리셋입니다.
템플릿 중 프리셋인 기본 설정과 프로드 체크 데이터는 별도 설정 없이 목적에 부합하는 원본 데이터를 추출할 수 있습니다. 프리셋을 복사한 후에 일부 설정만 변경해 다른 이름의 템플릿으로 저장할 수 있습니다.
또한 [원본 데이터]>[원본 앱 데이터 추출] 또는 [원본 데이터]>[원본 웹 데이터 추출]에 있는 목록에서 각 행을 클릭하면 나오는 ‘템플릿으로 저장’을 활용해 새로운 템플릿을 생성할 수 있습니다. 또한 액션 항목 아래에 있는 버튼을 클릭하면 ‘템플릿으로 저장’을 클릭할 수 있습니다.
원본 앱 데이터 추출과 원본 웹 데이터 추출은 기본적인 기능을 제공합니다. 아래를 참고해 주세요.
[저장된 템플릿]에 있는 목록의 행을 클릭하거나 액션 항목을 클릭하면 '수정', '복제', '설정값 복사'를 확인할 수 있습니다.
‘수정’을 클릭하면 저장한 템플릿에서 이벤트, 프로퍼티, 필터 등을 수정할 수 있습니다. ‘복제’를 클릭하면 저장한 템플릿을 다른 이름으로 추가로 저장할 수 있습니다. ‘설정값 복사’를 클릭하면 저장한 템플릿의 설정값을 복사할 수 있습니다. 복사한 템플릿의 설정값을 엑셀, 스프레드 시트 등에 붙여 넣을 수 있습니다.
[저장된 템플릿]에서 삭제하려는 템플릿의 액션 항목에서 클릭하면 '삭제'가 나옵니다. '삭제'를 클릭하면 해당 템플릿이 삭제됩니다. 템플릿을 삭제하면 복구할 수 없습니다. 주의해 주세요.
대행사 계정은 별도 권한을 받지 않으면 원본 데이터 추출 기능을 진행하는 과정에서 접근할 수 있는 프로퍼티가 없습니다. 오너 계정, 사내 마케터 계정이 대행사별로 접근할 수 있는 프로퍼티에 관한 권한을 허용해야 대행사 계정이 원본 데이터를 정상적으로 추출할 수 있습니다.
[원본 데이터]>[대행사 설정]에서 [원본 앱 데이터 추출]와 [원본 웹 데이터 추출]에 접근할 수 있는 대행사 계정을 확인할 수 있습니다. 또한 대행사별로 접근할 수 있는 프로퍼티를 설정할 수 있습니다.
아래 사항을 주의해 주세요.
추출 시점 기준으로 최근 10분 동안 에어브릿지에 업데이트된 원본 데이터는 누락될 수 있습니다. 충분한 시간을 가진 후에 원본 데이터를 추출해 주세요.
메타 개인정보보호정책에 따라 메타 애즈에 기여된 데이터는 제한됨(Restricted)으로 표기됩니다.
프리뷰에서 확인할 수 있는 데이터는 실제 추출되는 원본 데이터와 다릅니다. 프리뷰에서는 추출하는 원본 데이터와 관계없이 오늘을 포함해 항상 최근 3일동안 수집된 데이터를 확인할 수 있습니다.
원본 데이터 추출 기능의 특징과 제한은 아래와 같습니다.
특징과 제한 |
설명 |
|---|---|
타임존 | 설정한 앱 타임존를 따름 |
데이터 업데이트 주기 | 실시간 |
확인할 수 있는 데이터 | 앱 이벤트 데이터, 웹 이벤트 데이터 |
제공하는 최대 파일 크기 | 5기가바이트(GB) |
원본 데이터 조회 기간 | D-179 ~ D-0 |
원본 데이터 조회 기간 (프리뷰) | D-4 ~ D-0 |
한 번에 추출할 수 있는 최대 기간 | 31일 |
한 번에 확인할 수 있는 최대 기간 (프리뷰) | 5일 |
도움이 되었나요?