- 유저 가이드
- 광고 성과 조회하기
- 에어브릿지에 데이터 업로드하기
메트릭 데이터 업로드하기
알립니다
오너 계정과 사내 마케터 계정만 데이터 업로드 기능을 사용할 수 있습니다. 대행사 계정과 미디어 파트너 계정에는 데이터 업로드 기능이 제공되지 않습니다.
에어브릿지 대시보드에서 해당 기능이 보이지 않는다면 앱 역할을 확인해 주세요.
에어브릿지에 메트릭 데이터를 CSV 파일 형식으로 업로드할 수 있습니다. 이를 통해 에어브릿지가 채널 연동이나 트래킹 링크로 수집하지 않은 데이터를 에어브릿지 대시보드에서 확인할 수 있습니다.
메트릭 데이터를 업로드하면 에어브릿지를 아래처럼 활용할 수 있습니다. 메트릭 데이터는 [연동]>[셀프 서브 메트릭 업로드]에서 업로드할 수 있습니다.
오버뷰 대시보드, 액츄얼스 리포트, 트렌드 리포트에서 사용할 수 있는 셀프 서브 메트릭을 정의합니다
메트릭 데이터가 아닌 광고 비용 데이터는 [비용 데이터 업로드]를 통해서 업로드할 수 있습니다. 광고 비용 데이터 업로드에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
메트릭 데이터는 CSV 파일 형식으로 에어브릿지에 업로드됩니다. 아래 예시 CSV 파일을 참고해 주세요.
메트릭 데이터를 CSV 파일에 아래 규칙에 따라 입력해 주세요. 규칙을 따르지 않으면 데이터가 에어브릿지 리포트에 정상적으로 반영되지 않습니다.
그룹바이로 사용하는 데이터는 에어브릿지와 같은 표기로 입력해 주세요. 예를 들어 에어브릿지 대시보드 표기는 ‘Android’이기 때문에 ‘android’로 업로드된 데이터와 함께 집계되지 않습니다.
한번에 업로드할 수 있는 CSV 파일 크기는 최대 1MB입니다. 또한 한번에 업로드할 수 있는 CSV 파일의 최대 행 수는 10000개입니다.
데이터에 공백이 없도록 주의해 주세요. 또한 string 타입의 데이터는 1글자 이상 256글자 이하를 입력할 수 있습니다.
event_category는 영어와 숫자만 사용할 수 있습니다. 특수 기호(\)는 사용할 수 없습니다. 메트릭 데이터 업로드로 등록한 셀프 서브 메트릭은 event_category이 메트릭 이름입니다.
또한 CSV 파일의 열 이름은 정해진 이름만 사용할 수 있습니다. 공백이 열 이름에 포함되지 않게 주의해 주세요. 입력할 수 있는 열에는 반드시 데이터를 입력해야 하는 열이 있습니다. 필수 열에 빈칸이 있으면 데이터가 정상적으로 반영되지 않습니다. 필수 열에 입력할 데이터가 없다면 0, none 등을 필수항목의 데이터 타입에 맞게 넣어 주세요.
열 이름 | 데이터 형식 | 설명 | 예시 | 메트릭 또는 그룹바이 |
|---|---|---|---|---|
date | string | 데이터가 기록된 날짜 | 2022-01-01 | 그룹바이 |
channel | string | 광고 채널 | naver.searchad | 그룹바이 |
event_category | string | 업로드 데이터의 카테고리 명칭 | Click-email | 메트릭, 그룹바이 |
event_value | double | 업로드 데이터의 값 | 10000 | 메트릭 |
event_category는 셀프 서브 메트릭의 이름입니다. 액츄얼스 리포트에서 event_category 이름으로 메트릭을 검색하면 찾을 수 있습니다. 셀프 서브 메트릭을 참고해 주세요.
또한 date, channel, event_category 조합이 같으면 event_value를 더합니다.
channel 열에 입력하는 광고 채널 이름은 에어브릿지 대시보드 표기와 동일해야 업로드한 데이터를 에어브릿지에서 수집한 데이터와 함께 조회할 수 있습니다. 광고 채널의 에어브릿지 대시보드 표기는 에어브릿지 대시보드의 [연동]>[광고 채널 연동]에 있는 각 광고 채널의 이름 아래에서도 확인할 수 있습니다.
date에는 형식에 맞게 입력해 주세요. 예를 들어 date 열에 2022.01.02로 입력하면 정상적으로 업로드되지 않습니다. 또한 event_value 열에 입력하는 수치에는 ,를 입력하지 마세요. ,를 입력하면 메트릭 데이터가 정상적으로 업로드되지 않습니다.
열 이름 | 데이터 형식 | 설명 | 그룹바이 |
|---|---|---|---|
campaign | string | 캠페인 이름 | Campaign |
ad_group | string | 광고 그룹 이름 | Ad Group |
ad_creative | string | 광고 소재 | Ad Creative |
content | string | 광고 콘텐츠 종류 | Content |
event_source | string | 데이터 출처 - app - web - tracking_link | Event Source |
os_name | string | OS 이름 | OS Name |
term | string | 광고 키워드 | Term |
country | string | 2문자 국가 코드 | Country |
currency | string | 3문자 통화 코드(ISO 4217) | Currency |
sub_publisher | string | 하위 광고 채널 이름 | Sub Publisher |
sub_sub_publisher_1 | string | 하위 광고 채널1 이름 | Sub Sub Publisher 1 |
sub_sub_publisher_2 | string | 하위 광고 채널2 이름 | Sub Sub Publisher 2 |
sub_sub_publisher_3 | string | 하위 광고 채널3 이름 | Sub Sub Publisher 3 |
is_first_event_per_device_id | boolean | 디바이스 ID 기준 각 이벤트의 최초 발생 여부 - true: 최초로 발생한 이벤트 - false: 추가로 발생한 이벤트 | Is First Event per Device ID |
is_first_event_per_user_id | boolean | 유저 ID 기준 각 이벤트의 최초 발생 여부 - true: 최초로 발생한 이벤트 - false: 추가로 발생한 이벤트 | Is First Event per User ID |
event_source, os_name 같은 일부 열에 입력하는 데이터는 에어브릿지 대시보드와 동일한 이름과 형식으로 입력해 주세요. 예를 들어 CSV 파일에서 os_name 열에 안드로이드나 android로 입력하면 이 데이터를 에어브릿지에 수집한 데이터와 함께 확인할 수 없습니다. 에어브릿지와 동일하게 Android라고 입력해야 함께 확인할 수 있습니다.
에어브릿지에서 지원하는 주요 counry는 아래와 같습니다. 2문자 국가 코드를 소문자로 사용합니다.
kr, jp, us, ru, kz
에어브릿지에서 지원하는 주요 os_name은 아래와 같습니다.
Windows, Ubuntu, Tizen, Other, Mac OS X, Linux, iOS, Chrome OS, Android
에어브릿지에서 지원하는 주요 currency는 아래와 같습니다. 3문자 통화 코드를 대문자로 사용합니다.
KRW, USD, EUR
또한 event_source 열에 Web을 입력하면 메트릭 데이터가 정상적으로 업로드되지 않습니다. Web 대신 web으로 입력해야 합니다.
is_first_event_per_device_id, is_first_event_per_user_id 열에는 true, false 외에 TRUE, FALSE도 입력할 수 있습니다. 하지만 True, False 등 대소문자를 통일하지 않으면 정상적으로 에어브릿지에 업로드되지 않습니다.
에어브릿지 대시보드의 [연동]>[셀프 서브 메트릭 업로드]에서 메트릭 데이터를 CSV 파일 형식으로 업로드할 수 있습니다.
업로드하기 전에 업로드하는 메트릭 데이터를 CSV 파일에 입력해 주세요.
‘CSV 파일 업로드’를 클릭합니다.
업로드하는 CSV 파일을 에어브릿지에 드래그합니다. 또는 파일 탐색기에서 업로드하는 CSV파일을 찾아 클릭합니다.
선택한 파일이 업로드하는 CSV 파일이 맞는지 한번 더 확인해 주세요. 파일이 맞다면 ‘업로드’를 클릭합니다.
데이터 업로드가 시작됩니다. 데이터 업로드 완료에는 최대 10분이 필요합니다. ‘확인’을 클릭하고 다른 에어브릿지 기능을 사용할 수 있습니다.
업로드 상태는 에어브릿지 대시보드의 [연동]>[셀프 서브 메트릭 업로드]에 있는 목록의 [상태]에서 확인할 수 있습니다. 업로드 상태는 자동으로 업데이트됩니다.
자세한 상태 메시지의 의미는 아래 표에서 확인해 주세요.
상태 메시지 | 설명 |
|---|---|
In progress | 파일이 에어브릿지에 업로드 되고 있습니다. 최대 10분이 걸립니다. 잠시만 기다려 주세요 |
Failed | 파일이 업로드되지 않았습니다. [액션]>[상세보기]에서 파일이 업로드 되지 않은 이유를 확인해 주세요 |
Success | 파일이 성공적으로 에어브릿지에 업로드됐습니다 |
대부분의 문제는 CSV 파일을 정해진 규칙으로 올리지 않거나 데이터를 덮어쓰는 과정에서 발생합니다. 또는 네트워크 상태를 다시 확인해 주세요.
에어브릿지 대시보드 [연동]>[비용 데이터 업로드] 또는 [연동]>[셀프 서브 메트릭 업로드]에 있는 목록의 [액션]>[상세보기]에서 에러코드를 확인할 수 있습니다. 에러코드에 따라 CSV 파일을 수정하고 다시 업로드해 주세요.
에러코드 | 의미 | 해결 방법 |
|---|---|---|
unknown field | 열 이름이 잘못 입력됐거나 업로드를 지원하지 않는 열이 있습니다 | 해당 열을 에어브릿지가 지원하는 열로 수정합니다 |
required field | 필수 입력 열이 CSV 파일에 존재하지 않습니다 | 필수 입력 열을 모두 입력합니다 |
empty values not allow | 필수 입력 열에 빈 데이터가 있습니다 | 필수 입력 열의 데이터를 모두 입력합니다. 입력할 데이터가 없다면 데이터 타입에 맞게 ‘0’ 또는 ‘none’을 입력해 주세요 |
‘OOO’ cannot be coerced | OOO 열에서 지원하는 데이터 타입이 아닙니다 | OOO 열에서 지원하는 데이터 타입에 맞게 데이터를 새로 입력합니다 |
ad-id라는 열은 업로드를 지원하는 열이 아닙니다. 업로드 목적에 따라 해당 열을 ad_group_id, ad_creative_id, ad_account_id 중 하나로 변경해 주세요.
impressions은 반드시 입력해야 하는 열입니다. 하지만 업로드하는 CSV 파일에 impressions 열이 없습니다. 해당 열을 추가해야 정상적으로 업로드할 수 있습니다.
업로드한 메트릭 데이터는 기존에 업로드한 데이터를 덮어 쓸 수 있습니다.
아래 사항을 주의해 주세요.
CSV 파일에서 열 이름은 정해진 이름만 사용할 수 있습니다. 대문자와 공백도 허용하지 않습니다. 정확하게 입력해 주세요.
CSV 파일에 입력하는 데이터는 정해진 형식을 따라야 합니다. 또한 필수 항목은 빈칸을 허용하지 않습니다. 입력하는 데이터가 없다면 0 또는 none을 데이터 형식에 맞게 입력해 주세요.
에어브릿지 대시보드에서 업로드한 데이터와 에어브릿지 SDK 등으로 수집한 데이터를 같은 이름으로 확인하기 위해서는 동일한 이름과 형식으로 데이터를 입력해야 합니다.
예를 들어 CSV 파일에서 os_name 열에 안드로이드나 android로 입력하면 이 데이터를 에어브릿지에 수집한 데이터와 함께 확인할 수 없습니다. 에어브릿지와 동일하게 Android라고 입력해야 함께 확인할 수 있습니다.
또한 currency 열에는 대문자로 3문자 통화 코드를 입력해야 합니다. 예를 들어 KRW 대신 krw를 입력하면 정상적으로 업로드되지 않습니다.
업로드하는 CSV파일에서 date, channel, event_category가 동일한 행은 나중에 업로드한 파일의 내용이 먼저 업로드한 파일의 내용을 덮어씁니다. 아래 예시를 참고해 주세요.
아래와 같은 데이터를 업로드합니다.
date | channel | event_category | event_value |
|---|---|---|---|
2023-01-01 | Example-channel | click | 100 |
2023-01-02 | Example-channel | click | 150 |
2023-01-02 | Other | click | 200 |
아래 데이터를 업로드하는 CSV 파일에 추가합니다.
date | channel | event_category | event_value |
|---|---|---|---|
2023-01-02 | Example-channel | click | 200 |
2023-01-02 | Other | view | 400 |
2023-01-03 | Example-channel | click | 300 |
date, channel, event_category가 동일한 행이 있습니다. 나중에 업로드한 파일에 있는 2023년 1월 2일 Example-channel의 click 수치 200은 먼저 업로드한 파일에 있는 2023년 1월 2일 Example-channel의 click 수치 150을 덮어씁니다.
에어브릿지에서 확인할 수 있는 데이터는 아래와 같습니다.
date | channel | event_category | event_value |
|---|---|---|---|
2023-01-01 | Example-channel | click | 100 |
2023-01-02 | Example-channel | click | 200 |
2023-01-02 | Other | click | 200 |
2023-01-02 | Other | view | 400 |
2023-01-03 | Example-channel | click | 300 |
도움이 되었나요?