사용자 지정 내보내기
데이터 파트너를 통한 공유가 불가능하거나 선호되지 않는 경우 내부 BI시스템 에서 데이터를 사용자 지정 내보내기로 보안된 S3 버킷을 통해 MetricWorks와 공유할 수도 있습니다.
S3 보안 버킷에 업로드 된 각 파일에는 파일 이름에 두 가지 구성 요소가 포함되어야 합니다:
데이터 카테고리(마케팅 또는 이벤트)
파일명 . CSV 또는 파일명 . csv.gz (GZIP 압축을 사용하는 경우) 확장자
이 섹션에 나열된 요구 사항 외에 파일은 이름과 접두사 폴더 구조를 가질 수 있습니다. 불러오기가 완료되면 파일 이름이 자동으로 바뀌지만 여전히 동일한 S3 보안 버킷 위치에 있습니다. 파일을 다시 불러오기 때문에 파일 이름을 원래 확장자로 다시 바꾸면 안 됩니다.
하나의 앱 파일은 파일 이름에 앱의 스토어 ID (Android의 경우 com.company.app 와 같은 패키지 이름, iOS 의 경우 123456789와 같은 숫자 ID)도 포함해야 합니다.
예를 들어 스토어 ID가 "com.company.app"인 Android 앱의 마케팅 데이터 파일 이름은 marketing_com.company.app_2021_01.csv 로 지정할 수 있습니다 . 스토어 ID가 "123456789" 인 iOS 앱용 앱 이벤트 데이터 파일의 이름은 events_123456789_2021_02_01.csv 로 지정할 수 있습니다.
여러 앱에 대한 데이터가 포함된 파일은 파일 이름의 아무 곳에나 텍스트 '__multi__'(선행 및 후행에 이중 밑줄)를 포함해야 합니다. 각 앱의 스토어 ID는 CSV 파일 콘텐츠 내에서 “Store ID"라는 열 아래의 각 줄에 지정되어야 합니다. 각 데이터 범주에 대한 자세한 내용은 사용자 지정 마케팅 데이터 및 사용자 지정 앱 이벤트 데이터를 참조하십시오.
예시: 멀티 앱에 대한 데이터가 포함된 마케팅 데이터 파일의 이름은 marketing_2021_01__multi__.csv 로 지정할 수 있고 앱 이벤트 파일의 이름은 events_2021_02_01__multi__.csv 로 지정할 수 있습니다 .
각 파일(마케팅 및 앱 이벤트 모두)의 허용 용량은 선택적 압축 후 최대 1GB 미만 이어야 합니다. 데이터 세트 용량 초과 시 각각 허용용량 크기에 맞도록 기간별로 구분된 더 작은 파일로 분할되어야 합니다. 데이터 세트를 둘 이상의 파일로 분할하는 경우 덮어쓰기 규칙도 숙지 하십시오.
파일은 GZIP 형식을 사용하여 압축할 수 있습니다. 파일은 모두 파일명. csv.gz 확장자 (자세한 내용은 파일 이름 지정 참조).
사용자 지정으로 내보낸 파일은 다음 CSV 파일형식 요구 사항을 준수해야 합니다:
기록은 새로운 줄로 구분되어야 합니다.
값은 쉼표(,)로 구분되어야 합니다.
첫 번째 줄은 헤더 행이어야 합니다.
쉼표(,)가 포함된 텍스트 값은 큰 따옴표(“ “)로 묶어야 합니다.
소수점 값은 소수점 구분 기호로 점(.)을 사용해야 합니다.
텍스트 값에 큰 따옴표 문자가 포함된 경우 큰 따옴표는 두 번째 큰 따옴표(“ “) 문자로 공간을 두어야 합니다.
날짜는 ISO 8601 표준에 따라 형식을 지정해야 합니다.(예시: 2021년 1월 1일의 경우 2021-01-01)
국가는 ISO 3166-1 alpha-2 표준에 따라 형식을 지정해야 합니다.(예시: 미국의 경우 US 한국의 경우 KR).
파일 인코딩은 BOM(바이트 순서 표시)이 없는 UTF-8이어야 합니다.
CSV 파일에는 중복된 행이 없어야 합니다. 일치하는 디멘션 열(예: Date, Channel, Campaign, Country 등)이 있는 행은 중복으로 간주됩니다. CSV에 중복 항목이 포함된 경우 가져오기 프로세스는 실패하지 않지만 각 중복 세트 내에서 하나의 행만 실제로 가져오기 때문에 가져온 매트릭스가 낮게 표시될 수 있습니다.
데이터의 정확한 사양은 데이터 범주에 따라 다릅니다. 추가정보 및 예시는 아래를 클릭 하시면 보실 수 있습니다.
마케팅
앱 이벤트
MetricWorks에서 암호화된 S3 보안 버킷에 대한 쓰기 액세스 권한을 부여하고 S3 URI, AWS 리전 및 프로그래밍 방식 자격인증서(Access Key ID 및 Secret Access Key)을 제공합니다. AWS S3 CLI 또는 API를 사용하여 제공된 자격인증서(Credentials)를 사용하여 버킷 및 Prefix 폴더에 파일을 업로드할 수 있습니다. 자격인증서를 사용하여 파일을 나열하고 다운로드할 수도 있습니다. 단 보안상의 이유로 AWS Management Console 접근은 비활성화 되어 있습니다.
단계별 지침에 대한 자세한 AWS CLI S3 업로드 지침을 참조하십시오.
과거 데이터 내보내기 기간은 전체 데이터를 사용할 수 있는 가장 최근 날짜(보통 어제)까지로 1년이 이상적 입니다. 가능하지 않은 경우 기간은 사용 가능한 전체 기간 이어야 합니다. 진행중인 데이터 내 보내기의 경우 마지막 내보내기 이후의 새 데이터만 포함되어야 합니다. 따라서 현재 진행중인 데이터의 동기화 빈도가 매일인 경우 내 보내기에는 전날의 새 데이터만 포함되어야 합니다. 단 마케팅 및 앱 이벤트 파일에 대하여 다르게 작동 함을 숙지하십시오.
마케팅 파일의 경우 전날의 새로운 데이터에는 하나의 날짜만 포함됩니다. 앱 이벤트 파일의 경우 전날의 새로운 데이터에 여러 설치 날짜에 대한 코호트 매트릭스가 포함될 수 있습니다. 따라서 진행중인 앱이벤트 내 보내기는 이전 내보내기 후 최신의 코호트 설치 날짜로부터 시작해야 합니다 . 이 값은 이전 내 보내기의 최신 설치 날짜에서 가져오는 가장 높은 코호트 날짜를 빼서 계산됩니다. 예를 들어 코호트 일 30일까지 매트릭스를 가져오고 이전 내보내기가 1월 31일에 종료된 경우 다음 내 보내기에는 1월 1일(1월 31일에서 30일을 뺀)의 앱 이벤트가 포함되어야 합니다.
요금제에 포함된 빈도에 따라 모델이 새로 고쳐지는 빈도 뿐 아니라 새로운 입력 데이터를 가져오는 빈도도 결정됩니다. 신규 데이터는 언제든지 S3 보안 버킷에 업로드할 수 있지만 요금제에 지정된 빈도수 로만 가져올 수 있습니다. 자세한 내용은 아래 표을 참조하세요.
요금 책정 계획이 데이터 가져오기 빈도를 지정하지 않는 유일한 시간은 첫 번째 모델이 학습되기 전의 초기 데이터 가져오기 단계 동안입니다. 이 단계의 주요 목표는 입력 데이터가 올바른지 확인하여 해당 데이터에서 생성된 모델을 신뢰할 수 있도록 하는 것입니다. 이러한 이유로 데이터가 검증되고 초기 모델이 학습될 때까지 데이터를 매일 가져오게 됩니다.
다음 기본 서비스가 사용되며 고객 성공 관리자에게 연락하시면 데이터 불러오기 수행 요일을 변경할 수 있습니다.
불러오기 이전에 가져온 기존 데이터와 겹치는 날짜가 포함된 경우 새 데이터는 겹치는 날짜의 기존 데이터를 덮어씁니다. 이전 불러오기가 완료되지 않았거나 잘못된 경우처럼, 동일한 날짜가 포함된 고정 복사본을 나중에 업로드하는 것만으로도 결함이 있는 데이터를 쉽게 덮어쓸 수 있습니다.
하나의 앱에 대해 동일한 데이터 범주의 파일을 여러 개 업로드하는 경우 업로드 된 순서대로 한 번에 하나씩 가져옵니다. 따라서 덮어쓰기 규칙으로 인해 겹치는 날짜가 포함된 동일한 데이터 범주의 파일을 가져올 순서대로 업로드하는 것이 중요합니다. 일반적으로 이전 날짜가 포함된 파일을 먼저 업로드 해야 합니다.
이는 요금제에 포함된 빈도가 매일보다 자주인 경우에 가장 적합합니다. 여러 파일이 며칠 동안 업로드 되어 불러오기를 보류할 수 있습니다. 항상 업로드 된 순서대로 한 번에 하나씩 가져오며, 각 파일은 덮어쓰기 규칙에 따라 이전 파일과 겹치는 날짜를 덮어씁니다.
파일 요구 사항
파일 이름 지정
S3 보안 버킷에 업로드 된 각 파일에는 파일 이름에 두 가지 구성 요소가 포함되어야 합니다:
데이터 카테고리(마케팅 또는 이벤트)
파일명 . CSV 또는 파일명 . csv.gz (GZIP 압축을 사용하는 경우) 확장자
이 섹션에 나열된 요구 사항 외에 파일은 이름과 접두사 폴더 구조를 가질 수 있습니다. 불러오기가 완료되면 파일 이름이 자동으로 바뀌지만 여전히 동일한 S3 보안 버킷 위치에 있습니다. 파일을 다시 불러오기 때문에 파일 이름을 원래 확장자로 다시 바꾸면 안 됩니다.
Single 앱
하나의 앱 파일은 파일 이름에 앱의 스토어 ID (Android의 경우 com.company.app 와 같은 패키지 이름, iOS 의 경우 123456789와 같은 숫자 ID)도 포함해야 합니다.
예를 들어 스토어 ID가 "com.company.app"인 Android 앱의 마케팅 데이터 파일 이름은 marketing_com.company.app_2021_01.csv 로 지정할 수 있습니다 . 스토어 ID가 "123456789" 인 iOS 앱용 앱 이벤트 데이터 파일의 이름은 events_123456789_2021_02_01.csv 로 지정할 수 있습니다.
Multiple 앱
여러 앱에 대한 데이터가 포함된 파일은 파일 이름의 아무 곳에나 텍스트 '__multi__'(선행 및 후행에 이중 밑줄)를 포함해야 합니다. 각 앱의 스토어 ID는 CSV 파일 콘텐츠 내에서 “Store ID"라는 열 아래의 각 줄에 지정되어야 합니다. 각 데이터 범주에 대한 자세한 내용은 사용자 지정 마케팅 데이터 및 사용자 지정 앱 이벤트 데이터를 참조하십시오.
예시: 멀티 앱에 대한 데이터가 포함된 마케팅 데이터 파일의 이름은 marketing_2021_01__multi__.csv 로 지정할 수 있고 앱 이벤트 파일의 이름은 events_2021_02_01__multi__.csv 로 지정할 수 있습니다 .
파일 크기
각 파일(마케팅 및 앱 이벤트 모두)의 허용 용량은 선택적 압축 후 최대 1GB 미만 이어야 합니다. 데이터 세트 용량 초과 시 각각 허용용량 크기에 맞도록 기간별로 구분된 더 작은 파일로 분할되어야 합니다. 데이터 세트를 둘 이상의 파일로 분할하는 경우 덮어쓰기 규칙도 숙지 하십시오.
파일 압축
파일은 GZIP 형식을 사용하여 압축할 수 있습니다. 파일은 모두 파일명. csv.gz 확장자 (자세한 내용은 파일 이름 지정 참조).
데이터 요구 사항
파일 포맷
사용자 지정으로 내보낸 파일은 다음 CSV 파일형식 요구 사항을 준수해야 합니다:
기록은 새로운 줄로 구분되어야 합니다.
값은 쉼표(,)로 구분되어야 합니다.
첫 번째 줄은 헤더 행이어야 합니다.
쉼표(,)가 포함된 텍스트 값은 큰 따옴표(“ “)로 묶어야 합니다.
소수점 값은 소수점 구분 기호로 점(.)을 사용해야 합니다.
텍스트 값에 큰 따옴표 문자가 포함된 경우 큰 따옴표는 두 번째 큰 따옴표(“ “) 문자로 공간을 두어야 합니다.
날짜는 ISO 8601 표준에 따라 형식을 지정해야 합니다.(예시: 2021년 1월 1일의 경우 2021-01-01)
국가는 ISO 3166-1 alpha-2 표준에 따라 형식을 지정해야 합니다.(예시: 미국의 경우 US 한국의 경우 KR).
파일 인코딩은 BOM(바이트 순서 표시)이 없는 UTF-8이어야 합니다.
데이터 중복기입
CSV 파일에는 중복된 행이 없어야 합니다. 일치하는 디멘션 열(예: Date, Channel, Campaign, Country 등)이 있는 행은 중복으로 간주됩니다. CSV에 중복 항목이 포함된 경우 가져오기 프로세스는 실패하지 않지만 각 중복 세트 내에서 하나의 행만 실제로 가져오기 때문에 가져온 매트릭스가 낮게 표시될 수 있습니다.
데이터 사양
데이터의 정확한 사양은 데이터 범주에 따라 다릅니다. 추가정보 및 예시는 아래를 클릭 하시면 보실 수 있습니다.
마케팅
앱 이벤트
데이터 불러오기 프로세스
S3 업로드
MetricWorks에서 암호화된 S3 보안 버킷에 대한 쓰기 액세스 권한을 부여하고 S3 URI, AWS 리전 및 프로그래밍 방식 자격인증서(Access Key ID 및 Secret Access Key)을 제공합니다. AWS S3 CLI 또는 API를 사용하여 제공된 자격인증서(Credentials)를 사용하여 버킷 및 Prefix 폴더에 파일을 업로드할 수 있습니다. 자격인증서를 사용하여 파일을 나열하고 다운로드할 수도 있습니다. 단 보안상의 이유로 AWS Management Console 접근은 비활성화 되어 있습니다.
단계별 지침에 대한 자세한 AWS CLI S3 업로드 지침을 참조하십시오.
데이터 입력을 위한 기간설정
과거 데이터 내보내기 기간은 전체 데이터를 사용할 수 있는 가장 최근 날짜(보통 어제)까지로 1년이 이상적 입니다. 가능하지 않은 경우 기간은 사용 가능한 전체 기간 이어야 합니다. 진행중인 데이터 내 보내기의 경우 마지막 내보내기 이후의 새 데이터만 포함되어야 합니다. 따라서 현재 진행중인 데이터의 동기화 빈도가 매일인 경우 내 보내기에는 전날의 새 데이터만 포함되어야 합니다. 단 마케팅 및 앱 이벤트 파일에 대하여 다르게 작동 함을 숙지하십시오.
마케팅 파일의 경우 전날의 새로운 데이터에는 하나의 날짜만 포함됩니다. 앱 이벤트 파일의 경우 전날의 새로운 데이터에 여러 설치 날짜에 대한 코호트 매트릭스가 포함될 수 있습니다. 따라서 진행중인 앱이벤트 내 보내기는 이전 내보내기 후 최신의 코호트 설치 날짜로부터 시작해야 합니다 . 이 값은 이전 내 보내기의 최신 설치 날짜에서 가져오는 가장 높은 코호트 날짜를 빼서 계산됩니다. 예를 들어 코호트 일 30일까지 매트릭스를 가져오고 이전 내보내기가 1월 31일에 종료된 경우 다음 내 보내기에는 1월 1일(1월 31일에서 30일을 뺀)의 앱 이벤트가 포함되어야 합니다.
요금제에 따른 데이터 가져오기 빈도
요금제에 포함된 빈도에 따라 모델이 새로 고쳐지는 빈도 뿐 아니라 새로운 입력 데이터를 가져오는 빈도도 결정됩니다. 신규 데이터는 언제든지 S3 보안 버킷에 업로드할 수 있지만 요금제에 지정된 빈도수 로만 가져올 수 있습니다. 자세한 내용은 아래 표을 참조하세요.
요금 책정 계획이 데이터 가져오기 빈도를 지정하지 않는 유일한 시간은 첫 번째 모델이 학습되기 전의 초기 데이터 가져오기 단계 동안입니다. 이 단계의 주요 목표는 입력 데이터가 올바른지 확인하여 해당 데이터에서 생성된 모델을 신뢰할 수 있도록 하는 것입니다. 이러한 이유로 데이터가 검증되고 초기 모델이 학습될 때까지 데이터를 매일 가져오게 됩니다.
다음 기본 서비스가 사용되며 고객 성공 관리자에게 연락하시면 데이터 불러오기 수행 요일을 변경할 수 있습니다.
| Frequency | Default Days of the Week |
|---|---|
| Weekly | Monday |
| 2x Per Week | Monday and Thursday |
| 3x Per Week | Monday, Wednesday, and Friday |
덮어쓰기
불러오기 이전에 가져온 기존 데이터와 겹치는 날짜가 포함된 경우 새 데이터는 겹치는 날짜의 기존 데이터를 덮어씁니다. 이전 불러오기가 완료되지 않았거나 잘못된 경우처럼, 동일한 날짜가 포함된 고정 복사본을 나중에 업로드하는 것만으로도 결함이 있는 데이터를 쉽게 덮어쓸 수 있습니다.
큐잉
하나의 앱에 대해 동일한 데이터 범주의 파일을 여러 개 업로드하는 경우 업로드 된 순서대로 한 번에 하나씩 가져옵니다. 따라서 덮어쓰기 규칙으로 인해 겹치는 날짜가 포함된 동일한 데이터 범주의 파일을 가져올 순서대로 업로드하는 것이 중요합니다. 일반적으로 이전 날짜가 포함된 파일을 먼저 업로드 해야 합니다.
이는 요금제에 포함된 빈도가 매일보다 자주인 경우에 가장 적합합니다. 여러 파일이 며칠 동안 업로드 되어 불러오기를 보류할 수 있습니다. 항상 업로드 된 순서대로 한 번에 하나씩 가져오며, 각 파일은 덮어쓰기 규칙에 따라 이전 파일과 겹치는 날짜를 덮어씁니다.
업데이트 날짜: 16/09/2022
감사합니다!