.CSV 가져오기 및 내보내기

추적 계획을 로 가져오거나 내보냅니다. CSV를 사용하여 Amplitude 데이터에서 대량 스키마를 변경할 수 있습니다. . CSV 왕복 트립은 이벤트, 이벤트 속성 및 사용자 속성을 다루며, 새 이벤트를 계획하고, 카테고리 및 설명을 편집하고, 엔티티를 한 번에 하나씩 편집하는 대신 한 번의 업로드에서 변경 사항을 적용할 수 있도록 지원합니다.

를 사용하십시오. CSV 가져오기는 여러 이벤트나 속성에 대해 한 번에 대량 스키마를 편집해야 할 때 수행합니다. 프로그래밍 방식, 자동화 또는 스크립트 방식의 스키마 변경의 경우 대신 택소노미 API를 사용하십시오.

이벤트 및 이벤트 속성

다음 단계에 따라 이벤트 및 이벤트 속성을 가져오거나 내보냅니다.

1. 데이터로 이동한 후 왼쪽 창의 추적 계획 아래에서 이벤트를 선택합니다.

2. 가져오려면 가져오기 아이콘을 선택하여 가져오기 모달을 엽니다.

3. 가져오기 파일이 업로드될 준비가 되었으며 이벤트 및 이벤트 속성에 대해 예상되는 스키마를 따른다면 파일을 끌어다 놓을 수 있습니다. CSV 파일을 사용하거나 업로드를 선택하고 로컬에서 파일을 선택합니다. 그렇지 않은 경우 템플릿을 선택하여 템플릿을 다운로드하십시오. 가져오기를 위해 업데이트할 CSV입니다.

   가져온 이벤트와 이벤트 속성은 import라는 이름의 분기에 나타납니다.

4. 가져온 추적 계획 업데이트가 올바른지 확인한 후 변경 사항을 다시 기본 분기에 병합할 수 있습니다.

5. 추적 계획에서 이벤트 및 이벤트 속성을 내보내려면 내보내기 아이콘을 대신 선택합니다.

6. 내보내기 모달이 나타나면 추적 계획의 스키마를 다운로드할지 아니면 를 다운로드할지 선택합니다. CSV 파일 템플릿입니다. 그런 다음 다운로드를 선택합니다.

다운로드됨. 추적 계획의 CSV 파일에는 가져오기에 필요하지 않은 추가 필드가 포함되어 있습니다. 다음 섹션에서는 이벤트 및 이벤트 속성 을 정의합니다. CSV 가져오기 파일 구조 및 내보낸 파일에 표시되는 추가 열

이벤트 및 이벤트 속성 파일 스키마

이벤트 및 이벤트 속성 . CSV 파일은 성공적인 가져오기를 위해 특정 스키마를 필요로 합니다. 아래 표에서는 엔티티 유형별로 필수 스키마를 강조합니다. 참고:

• 파일의 헤더에는 나열된 모든 필드가 포함되어야 합니다.
• 필드 순서는 무관하나, 성공적인 가져오기를 위해서는 이름과 값의 철자와 대문자 표기가 정확히 일치해야 합니다.
• 일부 필드는 다음 목록에 나와 있는 것처럼 엔티티 유형에 따라 값을 요구합니다.

동작

• 정의: 특정 엔티티에 대해 수행할 작업입니다.
• 값:
  • Ignore: 엔티티 또는 해당 하위 속성에 변경 사항이 없습니다.
  • Remove: 추적 계획에서 이벤트 및 속성 그룹을 제거할 수 있습니다. 제거 값은 개별 속성에 영향을 주지 않습니다. 이벤트 또는 속성 그룹을 제거하면 관련 속성의 연결이 해제되고 라이브 속성의 상태가 예기치 않은 상태로 변경됩니다. 제거 값은 엔티티를 삭제하거나 수집을 중지하지 않습니다.
  • <blank>: 엔티티 및 연관된 하위 엔티티를 생성하거나 업데이트합니다.
• 이벤트, 이벤트 속성, 속성 그룹 및 속성 그룹 속성.

배열 최소 항목

• 정의: 배열 속성 값 유형을 가진 속성의 최소 항목 수
• 이벤트 속성 및 속성 그룹 속성의 경우

배열 최대 항목

• 정의: 배열 속성 값 유형을 가진 속성의 최대 항목 수
• 이벤트 속성 및 속성 그룹 속성의 경우

고유 항목 배열

• 정의: 배열 속성 값 유형에 고유한 항목이 있는지 여부를 나타냅니다.
• 값:
  • TRUE: 배열에 고유한 항목이 있습니다.
  • <any>: 배열에 고유한 항목이 없다고 가정합니다.
• 이벤트 속성 및 속성 그룹 속성의 경우

상수 값

• 정의: const 속성 값 유형을 가진 속성의 Const 값
• 이벤트 속성 및 속성 그룹 속성의 경우

열거형 값

• 정의: 열거 속성 값 유형을 가진 속성에 대한 열거 값
• 형식: 각 열거 값을 쉼표로 구분하십시오.
• 이벤트 속성 및 속성 그룹 속성의 경우

이벤트 활동

• 정의: 이벤트의 활동에 대한 설명입니다.
• 값:
  • Active.
  • Inactive. 이벤트를 비활성 상태로 표시하면 즉시 소급적으로 적용되며 해당 이벤트가 Any Active Event지표에서 제외됩니다.
• 이벤트용.

드롭다운에서 숨겨진 이벤트

• 정의: 드롭다운에서 이벤트 표시 설정
• 값:
  • True: 이벤트가 이벤트 드롭다운에 숨겨져 있음
  • False: 이벤트는 이벤트 드롭다운에 표시됩니다.
  • <blank>: 현재 값을 유지합니다.
• 이벤트용

페르소나 결과에 숨겨진 이벤트

• 정의: 페르소나 결과에서 이벤트 가시성 설정
• 값:
  • True: 페르소나 결과에서 이벤트가 숨겨져 있음
  • False: 이벤트는 페르소나 결과에 표시됩니다.
  • <blank>: 현재 값을 유지합니다.
• 이벤트용

Pathfinder에서 숨겨진 이벤트

• 정의: Pathfinder에서 이벤트 가시성 설정
• 값:
  • True: 이벤트가 경로 찾기에서 숨겨져 있습니다.
  • False: 이벤트가 Pathfinder에서 표시됩니다
  • <blank>: 현재 값을 유지합니다.
• 이벤트용

타임라인에 숨겨진 이벤트

• 정의: 타임라인에서 이벤트 가시성 설정
• 값:
  • True: 이벤트가 타임라인에서 숨겨져 있음
  • False: 이벤트가 타임라인에 표시됨
  • <blank>: 현재 값을 유지합니다.
• 이벤트용

이벤트 범주

• 정의: 이벤트의 범주
• 이벤트용

이벤트 표시 이름

• 정의: 이벤트의 선택적 표시 이름에만 적용가능
• 이벤트용

이벤트 속성 이름

• 정의: 속성의 이름
• 이벤트 속성 및 속성 그룹 속성에 필수

이벤트 소스

• 정의: 이벤트와 연관된 소스
• 이벤트용

숫자 속성 값 최소

• 정의: 숫자 속성 값 유형을 가진 속성의 최소값
• 이벤트 속성 및 속성 그룹 속성의 경우

숫자 속성 값 최대

• 정의: 숫자 속성 값 유형을 가진 속성의 최대 값
• 이벤트 속성 및 속성 그룹 속성의 경우

숫자는 정수입니다

• 정의: 숫자 속성 값 유형을 가진 속성이 정수인지 여부를 나타냅니다.
• 값:
  • True: 속성은 정수입니다.
  • False또는<blank>: 속성이 정수가 아닙니다.
• 이벤트 속성 및 속성 그룹 속성의 경우

객체 유형

• 정의: 엔티티 유형
• 값:
  • Event
  • Property Group
• 이벤트 및 속성 그룹에 필요함

객체 이름

• 정의: 이벤트 또는 속성 그룹의 이름
• 이벤트 및 속성 그룹에 필요함

객체 소유자

• 정의: 이벤트 또는 속성 그룹의 소유자
• 이 값을 <blank>로 두면 이벤트 또는 속성 그룹에 소유자가 있는 경우 소유자가 제거됩니다.

객체 설명

• 정의: 엔티티에 대한 설명
• 이벤트 및 속성 그룹의 경우

속성 유형

• 정의: 이벤트와 연관된 속성의 유형
• 값:
  • Event Property
  • Event Property Group
• 이벤트에 필요함

속성 그룹 이름

• 정의: 이벤트와 연관된 속성 그룹
• 이벤트용

속성 설명

• 정의: 속성에 대한 설명
• 이벤트 속성 및 속성 그룹 속성의 경우

속성 값 유형

• 정의: 이벤트 속성 또는 속성 그룹 속성의 값 유형
• 값:
  • string
  • number
  • boolean
  • any
  • enum
  • const
• 이벤트 속성 및 속성 그룹 속성의 경우

필수 속성

• 정의: 속성의 필수 상태를 나타냅니다.
• 값:
  • True: 속성이 필요합니다.
  • False 또는 <blank>: 속성은 선택 사항입니다.
• 이벤트 속성 및 속성 그룹 속성의 경우

속성 가시성

• 정의: 차트에서 속성 표시 설정
• 값:
  • VISIBLE: 속성이 차트에 표시됩니다.
  • HIDDEN: 속성이 차트에 숨겨져 있습니다.
  • <blank>: 현재 값을 유지합니다.
• 이벤트 속성에만 해당됨

속성은 배열입니다.

• 정의: 속성이 배열인지 여부를 나타냅니다.
• 값:
  • True: 속성은 배열입니다.
  • False or <blank>: 속성은 배열이 아닙니다.
• 이벤트 속성 및 속성 그룹 속성의 경우

속성 정규식

• 정의: 문자열 속성 값 유형을 가진 속성에 대한 정규 표현식(Regex) 값
• 이벤트 속성 및 속성 그룹 속성의 경우

문자열 속성 값의 최소 길이

• 정의: 문자열 속성 값 유형을 가진 속성의 최소 길이
• 이벤트 속성 및 속성 그룹 속성의 경우

문자열 속성 값의 최대 길이

• 정의: 문자열 속성 값 유형을 사용하는 속성의 최대 길이
• 이벤트 속성 및 속성 그룹 속성의 경우

태그

• 정의: 이벤트와 연관된 태그
• 형식: 각 태그를 쉼표로 구분합니다
• 이벤트용

추가 필드 . 이벤트 및 이벤트 속성의 CSV 내보내기

다음 목록에는 에 있는 추가 필드가 포함되어 있습니다. 추적 계획의 이벤트 및 이벤트 속성을 CSV로 내보냅니다.

동작

• 정의: 특정 엔티티에 대해 수행할 기본 작업입니다. 이 필드는 가져오기 템플릿에 있지만 다운로드된 파일에는 기본값이 포함되어 있습니다.
• 값:
  • Ignore: 사용자 속성이 예기치 않거나 차단되었거나 삭제되었습니다.
  • <blank>: 사용자 속성이 계획되어 있거나 사용 중입니다.
• 이벤트, 이벤트 속성, 속성 그룹, 속성 그룹 속성의 경우

처음 본 이벤트

• 정의: 이벤트가 처음 표시된 날짜입니다.
• 형식: mm/dd/yyyy
• 이벤트용

마지막으로 본 이벤트

• 정의: 이벤트가 마지막으로 표시된 날짜입니다.
• 형식: mm/dd/yyyy
• 이벤트용

처음 확인된 속성

• 정의: 속성이 처음 확인된 날짜입니다.
• 형식: mm/dd/yyyy
• 속성 그룹의 경우

마지막으로 본 속성

• 정의: 해당 속성이 마지막으로 확인된 날짜입니다.
• 형식: mm/dd/yyyy
• 속성 그룹의 경우

사용자 속성

사용자 속성을 가져오거나 내보내려면 다음 단계를 수행하십시오.

1. 데이터로 이동한 후 왼쪽 창의 추적 계획 아래에서 속성을 선택합니다. 그런 다음 사용자 속성을 선택합니다.
2. 가져오기 아이콘을 선택하여 가져오기 모달을 엽니다.
3. 가져오기 파일이 업로드될 준비가 되었고 예상된 사용자 속성 스키마를 따른다면 파일을 드래그 앤 드롭할 수 있습니다. CSV 파일을 사용하거나 업로드를 선택하고 로컬에서 파일을 선택합니다. 그렇지 않은 경우 템플릿을 선택하여 템플릿을 다운로드하십시오. 가져오기를 위해 업데이트할 CSV입니다.

가져온 이벤트와 이벤트 속성은 import라는 이름의 분기에 나타납니다.

4. 가져온 추적 계획 업데이트가 올바른지 확인한 후 변경 사항을 다시 기본 분기에 병합할 수 있습니다.
5. 추적 계획에서 사용자 속성을 내보내려면 내보내기 아이콘을 대신 선택합니다.
6. 내보내기 모달이 나타나면 추적 계획의 스키마를 다운로드할지 아니면 를 다운로드할지 선택합니다. CSV 파일 템플릿입니다. 그런 다음 다운로드를 선택합니다.

다음 섹션에서는 사용자 속성 을 정의합니다. CSV 가져오기 파일 구조 및 사용자 속성 내보내기에 표시되는 추가 열

사용자 속성 파일 스키마

아래 목록은 사용자 속성 에 필요한 스키마를 강조표시합니다. CSV 파일 가져오기 참고:

• 파일의 헤더에는 나열된 모든 필드가 포함되어야 합니다.
• 필드 순서는 무관하나, 성공적인 가져오기를 위해서는 이름과 값의 철자와 대문자 표기가 정확히 일치해야 합니다.
• 일부 필드는 다음 목록에 표시된 값을 요구합니다.

동작

• 정의: 특정 사용자 속성에 대해 수행할 작업입니다.
• 값:
  • Ignore: Amplitude는 사용자 속성을 변경하지 않습니다.
  • Remove: Amplitude는 추적 계획에서 사용자 속성을 제거합니다. 제거된 값은 사용자 속성을 삭제하거나 해당 속성의 수집을 중지하지는 않습니다.
  • <blank>: 사용자 속성이 아직 존재하지 않는 경우 해당 속성을 생성하거나, 사용자 속성이 존재하는 경우 해당 속성을 업데이트합니다.

배열 최소 항목

• 정의: 배열 속성 값 유형을 가진 속성의 최소 항목 수

배열 최대 항목

• 정의: 배열 속성 값 유형을 가진 속성의 최대 항목 수

고유 항목 배열

• 정의: 배열 속성 값 유형에 고유한 항목이 있는지 여부를 나타냅니다.
• 값:
  • TRUE: 배열에 고유한 항목이 있습니다.
  • <any>: 배열에 고유한 항목이 없다고 가정합니다.

상수 값

• 정의: const 속성 값 유형을 가진 속성의 Const 값

열거형 값

• 정의: 열거 속성 값 유형을 가진 속성에 대한 열거 값
• 형식: 각 열거 값을 쉼표로 구분하십시오.

숫자 속성 값 최소

• 정의: 숫자 속성 값 유형을 가진 속성의 최소값

숫자 속성 값 최대

• 정의: 숫자 속성 값 유형을 가진 속성의 최대 값

숫자는 정수입니다

• 정의: 숫자 속성 값 유형을 가진 속성이 정수인지 여부를 나타냅니다.
• 값:
  • True: 속성은 정수입니다.
  • False또는<blank>: 속성이 정수가 아닙니다.

속성 유형

• 정의: 사용자 속성 유형
• 값: 사용자 속성**(필수)**

속성 이름

• 정의: 사용자 속성의 이름
• 이 값은 필수입니다.

속성 설명

• 정의: 사용자 속성에 대한 설명

속성 가시성

• 정의: 차트에서 속성 표시 설정
• 값:
  • VISIBLE: 속성이 차트에 표시됩니다.
  • HIDDEN: 속성이 차트에 숨겨져 있습니다.
  • <blank>: 현재 값을 유지합니다.

속성 값 유형

• 정의: 사용자 속성의 값 유형
• 값:
  • string
  • number
  • boolean
  • any
  • enum
  • const

속성은 배열입니다.

• 정의: 속성이 배열인지 여부를 나타냅니다.
• 값:
  • True: 속성은 배열입니다.
  • False or <blank>: 속성은 배열이 아닙니다.

속성 정규식

• 정의: 문자열 속성 값 유형을 가진 속성에 대한 정규 표현식(Regex) 값

문자열 속성 값의 최소 길이

• 정의: 문자열 속성 값 유형을 가진 속성의 최소 길이

문자열 속성 값의 최대 길이

• 정의: 문자열 속성 값 유형을 사용하는 속성의 최대 길이

의 추가 필드 사용자 속성의 CSV 내보내기

다음 목록에는 에 있는 추가 필드가 포함되어 있습니다. 추적 계획의 사용자 속성을 CSV로 내보냅니다.

동작

• 정의: 특정 엔티티에 대해 수행할 기본 작업입니다. 이 필드는 가져오기 템플릿에 있지만 다운로드된 파일에는 자동으로 기본값이 포함됩니다.
• 값:
  • Ignore: 사용자 속성이 예기치 않거나 차단되었거나 삭제되었습니다.
  • <blank>: 사용자 속성이 계획되어 있거나 사용 중입니다.

처음 확인된 속성

• 정의: 속성이 처음 확인된 날짜입니다.
• 형식: mm/dd/yyyy.

마지막으로 본 속성

• 정의: 해당 속성이 마지막으로 확인된 날짜입니다.
• 형식: mm/dd/yyyy.

자주 묻는 질문

원시 차트 또는 이벤트 데이터에 대한 내보내기 옵션

이 질문들은 모두 같은 답을 가지고 있습니다:

• 차트나 이벤트에 대한 원시 데이터를 어떻게 내보낼 수 있습니까?
• 차트 결과 대신 이 차트에 포함된 이벤트에 대한 원시 이벤트 데이터를 내보낼 수 있습니까?
• 내보내려면 어떻게 해야 합니까? 특정 이벤트의 모든 발생 사례에 대한 CSV 파일인가요?
• 이 차트에 가져온 데이터를 어떻게 볼 수 있습니까?
• 지난 30일 동안 이 이벤트의 모든 인스턴스에 대한 이벤트 및 사용자 속성 값을 볼 수 있습니까?

차트에 대해 선택한 원시 데이터 또는 선택한 이벤트에 대한 모든 데이터를 내보낼 수 있는 방법은 없습니다. Amplitude는 애플리케이션 내에서 대규모의 복잡한 분석을 수행하도록 설계되었으므로 SQL과 유사한 방식으로 이벤트 데이터를 격리하고 내보내는 것은 지원되지 않습니다. 몇 가지 대안:

• 내보내기 API: 이벤트의 모든 값과 이벤트 속성을 내보내려면 Amplitude의 내보내기 API를 사용하십시오. 지정된 시간 범위의 모든 이벤트를 내보내고 JSON 형식으로 반환합니다. 여기에서 원하는 특정 이벤트를 추출할 수 있습니다. 데이터가 Export API 크기 제한을 초과하는 경우 Amazon S3 Export를 대신 사용하십시오.
• Amazon S3 내보내기: Amplitude를 Amazon S3와 통합하여 이벤트 데이터를 S3 버킷으로 내보냅니다. 이 연동은 무료 요금제를 포함한 모든 계정에서 사용할 수 있습니다. Amazon S3 내보내기를 참조하십시오.

Amplitude는 의 구조를 어떻게 결정합니까? 이벤트 세분화 차트에서 내보낼 때의 CSV 파일?

Amplitude는 를 생성할 때 분석 데이터 테이블을 지침으로 사용합니다. CSV입니다. Amplitude는 에 있는 테이블의 형식과 구조를 반영합니다. CSV입니다.

왜 는 아닌가요? 사용자 또는 이벤트 속성의 가능한 모든 값을 보여주는 CSV 파일인가요?

에 나타나는 값의 수에는 제한이 있습니다. CSV입니다. 제한은 차트마다 다릅니다. 제한 및 할당량을 참조하십시오.

차트와 대상 구간 사이에서 사용자 속성의 값이 다른 이유는 무엇입니까? CSV 내보내기?

Microscope를 통해 차트에서 사용자를 다운로드할 때, CSV에는 사용자의 최신 속성 값이 포함되어 있습니다. 차트는 이벤트 발생 시점의 속성 값을 반환합니다.

이 경우에도 동일하게 적용됩니다. CSV에는 차트에 표시된 대로 속성 값이 나열됩니다. "none": CSV는 가장 최근의 값을 보여주며, 차트는 이벤트 발생 당시의 값을 보여줍니다.

내보낸 내 의 앞에 스페이스(탭)가 있는 이유는 무엇입니까? CSV 파일인가요?

기본적으로 내보낸 파일의 셀에는 앞에 빈 스페이스가 나타날 수 있습니다. CSV입니다. 기본값을 변경하려면 다음과 같이 하십시오.

1. 개인 설정으로 이동합니다.
2. 프로필로 이동합니다.
3. 사이트 설정에서 내보내기에서 항상 선행 스페이스 제거를 활성화합니다.

자세한 내용은 설정 관리를 참조하십시오.