POSThttps://api.airbridge.io/self-serve-data/v1/metric/requests
메트릭 데이터를 CSV 포맷으로 업로드 요청합니다.
Request Header 내 'Content-Type' 은 multipart/form-data 를 사용합니다.
Category | Column Name | Type | Description | Required |
---|
Group by | date | string | 데이터가 기록된 날짜, 'YYYY-MM-DD' 포맷의 데이터만 허용합니다 | Required |
Group by | channel | string | 광고 채널. 에어브릿지와 연동된 채널은 에어브릿지 대시보드에서 사용되는 이름으로 입력해야 합니다 | Required |
Group by | event_category | string | 업로드 데이터의 카테고리 명칭 | Required |
Metric | event_value | double | 업로드 데이터의 값 | Required |
Group by | campaign | string | 캠페인 이름 | Optional |
Group by | ad_group | string | 광고 그룹 이름 | Optional |
Group by | ad_creative | string | 광고 소재 | Optional |
Group by | content | string | 광고 콘텐츠 종류 | Optional |
Group by | event_source | string | 데이터 출처 - app - web - tracking_link | Optional |
Group by | os_name | string | OS 이름 | Optional |
Group by | term | string | 광고 키워드 | Optional |
Group by | country | string | 2문자 국가 코드 | Optional |
Group by | currency | string | 3문자 통화 코드(ISO 4217) | Optional |
Group by | sub_publisher | string | 하위 광고 채널 이름 | Optional |
Group by | sub_sub_publisher_1 | string | 하하위 광고 채널1 이름 | Optional |
Group by | sub_sub_publisher_2 | string | 하하위 광고 채널2 이름 | Optional |
Group by | sub_sub_publisher_3 | string | 하하위 광고 채널 이름 | Optional |
Group by | is_first_event_per_device_id | boolean | 디바이스 ID 기준 각 이벤트의 최초 발생 여부 - true, TRUE: 최초로 발생한 이벤트 - false, FALSE: 추가로 발생한 이벤트 | Optional |
Group by | is_first_event_per_user_id | boolean | 유저 ID 기준 각 이벤트의 최초 발생 여부 - true, TRUE: 최초로 발생한 이벤트 - false, FALSE: 추가로 발생한 이벤트 | Optional |
하나의 CSV 파일 내에 Group by와 event_category가 모두 동일한 Row들이 존재할 경우, 해당 데이터는 리포트에서 동일한 Row들이 합쳐진 값으로 표시됩니다.
date | channel | campaign | event_category | event_Value |
---|
2022-08-01 | owned_website | retargeting_campaign | self_event | 150000 |
2022-08-01 | owned_website | retargeting_campaign | self_event | 100000 |
2022-08-01 | owned_website | retargeting_campaign | self_event | 10000 |
date | channel | campaign | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | self_event | 251000 |
대소문자 입력에 주의해 주세요. Type이 string인 칼럼의 데이터들은 대소문자를 구분하여 인식합니다.
Airbridge에서 측정한 모바일 OS Name은 각각 'Android', 'iOS'로 기록하고 있지만 직접 업로드한 데이터의 OS Name을 'android', 'ios'로 입력한 경우 대시보드 내 별개의 Row로 분리됩니다. 따라서 Group by 결과를 위해서 ‘Android’, 'iOS’로 기록해주셔야 합니다.
Self-serve 데이터 업로드 시 'date', 'channel', 'event_category' 3개 필드값을 기준으로 기존에 동일한 조합이 있는 경우 기존 데이터를 신규 데이터로 Overwrite합니다.
예시 시나리오 1
1. 2022-08-03: date, channel, campaign, ad_group 레벨의 데이터 업로드
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | 2030_female | self_event | 100000 |
2022-08-01 | owned_website | retargeting_campaign | 2030_male | self_event | 80000 |
2. 2022-08-04: date, channel, campaign 레벨의 데이터 업로드
date | channel | campaign | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | self_event | 150000 |
3. 최종 반영: 8월 4일 업로드 데이터 처리 시 'date', 'channel', 'event_category' 3개 필드값을 기준으로 8월 3일에 업로드한 동일 데이터가 있기 때문에 해당 데이터 대신 최종적으로 8월 4일 업로드 데이터만 남게됩니다. (ad group 값은 null)
date | channel | campaign | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | self_event | 150000 |
1. 2022-08-03: date, channel, campaign 레벨의 데이터 업로드
date | channel | campaign | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | self_event | 100000 |
2. 2022-08-04: date, channel, campaign, ad_group 레벨의 데이터 업로드
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | 2030_female | self_event | 150000 |
3. 최종 반영: 8월 4일 업로드 데이터 처리 시 'date', 'channel', 'event_category' 3개 필드값을 기준으로 8월 3일에 업로드한 동일 데이터가 있기 때문에 해당 데이터 대신 최종적으로 8월 4일 업로드 데이터만 남게됩니다.(ad_group 값도 추가 업데이트됨)
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | 2030_female | self_event | 150000 |
1. 2022-08-03: date, channel, campaign, ad_group 레벨의 데이터 업로드
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | promotion_campaign | 2030_female | self_event | 10000 |
2022-08-01 | owned_website | retargeting_campaign | 2030_female | self_event | 100000 |
2022-08-01 | owned_website | retargeting_campaign | 2030_male | self_event2 | 80000 |
2. 2022-08-04: date, channel, campaign, ad_group 레벨의 데이터 업로드
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | 2030_male | self_event | 90000 |
2022-08-01 | owned_website | ua_campaign | 2030_female | self_event | 120000 |
3. 최종 반영: 8월 4일 업로드 데이터 처리 시 'date', 'channel', 'event_category' 3개 필드값을 기준으로 8월 3일에 업로드 데이터 중 동일 데이터는 8월 4일의 데이터로 대체되며, 나머지 데이터는 그대로 남게됩니다.
date | channel | campaign | ad_group | event_category | event_value |
---|
2022-08-01 | owned_website | retargeting_campaign | 2030_male | self_event2 | 80000 |
2022-08-01 | owned_website | retargeting_campaign | 2030_male | self_event | 90000 |
2022-08-01 | owned_website | ua_campaign | 2030_female | self_event | 120000 |
기존에 업로드한 메트릭을 리포트에서 보이지 않게 하고 싶으신 경우 담당 CSM을 통해 요청해주세요.
현재 Metric 데이터 업로드 요청 및 상태 조회 API는 오너, 사내마케터 권한 계정의 API Token으로만 사용 가능합니다.
CSV 파일 내 컬럼명은 정해진 소문자 값만 허용됩니다. CSV 파일 내 모든 Row에서 Required 열은 값이 반드시 존재해야 합니다. 또한 Required 열은 공백을 허용하지 않습니다. event_value도 공백이 아닌 0으로 입력하여 업로드해야 합니다.
CSV 파일 내 칼럼 순서는 업로드 기능에 영향을 미치지 않습니다.
한번의 요청으로 업로드하는 CSV 파일의 최대 크기는 1MB입니다. 만약 1MB 이상 크기의 CSV 파일 업로드가 필요한 경우 gzip 압축을 한 뒤 업로드하거나, 여러 번의 API 호출로 나눠서 업로드 해주세요.
string 타입의 칼럼값은 256글자 이하로 제한됩니다. 또한 칼럼명 및 칼럼값 앞뒤로 공백이 없도록 유의합니다.
event_category에는 영어와 숫자를 사용할 수 있습니다. 하지만 일부 기호(, , ", \)는 사용할 수 없습니다.
등록된 메트릭은 Actuals Report와 Trends Reports의 메트릭 중 Self-serve Metric에서 업로드한 event_category 이름을 찾으면 사용할 수 있습니다.
Upload 시 등록된 새로운 데이터는 (ex. campaign에 self_serve_test_campaign) Filter 사용시 선택옵션에 나타나지 않지만 freeform으로 등록해서 사용할 수 있습니다.