한눈에 보기: 데이터 락커(Data Locker)는 리포트 데이터를 클라우드 스토리지로 전송하여 BI 시스템에 로드합니다. 여러 저장 위치 중에서 선택할 수 있습니다: 사용자는 AWS의 앱스플라이어 소유 버킷, AWS GCS, Yandex, BigQuery 및 Snowflake와 같은 다양한 스토리지 대상 중에서 선택할 수 있습니다. 데이터 락커는 여러 대상을 지원합니다. 즉, 모든 데이터를 다중 대상으로 보내거나 대상별로 데이터를 분리하거나 이 두 가지를 조합할 수 있습니다.
개요
데이터 락커에서 앱스플라이어가 선택한 클라우드 스토리지 옵션으로 전송할 데이터에 포함할 앱, 미디어 소스, 이벤트 및 리포트를 선택하세요. 스토리지에서 BI 시스템으로 프로그래밍 방식으로 데이터를 로드합니다.
데이터 락커—기능
| 기능 | 설명 |
|---|---|
| 스토리지 옵션(클라우드) |
데이터 락커는 데이터를 다음 클라우드 서비스 제공업체에 전송할 수 있습니다.
데이터 락커에서 대상을 1개 이상 설정할 수 있습니다. 즉, 데이터의 전부 또는 일부를 여러 대상으로보낼 수 있습니다. 예시
|
| 멀티 앱 | 계정에 있는 1개, 그 이상, 또는 모든 앱의 데이터를 전송합니다. 앱을 계정에 추가하면 자동으로 포함될 수 있습니다. |
| 사용가능 기간 | 14일 |
| 데이터 분리 |
사용 가능한 데이터 분리 옵션(버킷 클라우드 스토리지 관련):
|
| 데이터 형식 옵션 |
|
| 데이터 최신성 |
최신성은 리포트 유형에 따라 다릅니다.
|
데이터 락커를 통해 사용 가능한 리포트
데이터 락커 리포트 설정하기
데이터 락커를 설정하려면 다음의 단계에 따라 클라우드 서비스를 연결하고, 내보내기 설정을 정의하고, 리포트 내용을 사용자 지정해야 합니다.
1. 다음을 사용하여 클라우드 서비스를 설정합니다.
2. 클라우드 서비스에 연결 추가
클라우드 서비스 계정을 데이터 락커와 함께 작동하도록 설정한 후(위의 "클라우드 서비스 설정" 참조), 계정의 자격 증명을 사용하여 데이터 락커에서 연결을 생성하십시오. 최대 두 개의 연결을 생성할 수 있습니다.
참고
기본적으로 각 계정은 최대 2개의 데이터 락커 연결을 열 수 있습니다. 추가 연결이 필요한 경우 고객 성공 관리자(CSM)에게 문의하십시오.
클라우드 공급자와 연결을 생성하려면 다음 단계를 수행하십시오.
- 앱스플라이어의 사이드바에서 내보내기(Exports)>데이터 락커로 이동합니다.
- 오른쪽에서 새 연결(New connection)을 클릭하세요.
- 연결 이름(Connection name)에 연결 이름을 입력하세요. 소문자, 숫자, 하이픈 "-"만 사용하세요.
- 연결하려는 클라우드 서비스의 아이콘을 클릭하세요.
-
선택한 서비스에 따라 다음 연결 정보를 입력하십시오.
AWS 클라우드 버킷 연결
AWS 연결을 설정하기 전에 AWS 버킷을 생성하십시오. 생성 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- AWS S3 버킷 이름을 입력하십시오.
af-접두사는 필수이며 수동으로 입력해야 합니다. - 연결 테스트(Test connection)를 클릭합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 이 연결을 Adobe Experience Platform과 호환할지여부를 선택합니다. 선택한 후, 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
- 저장을 클릭하세요.
GCS 클라우드 버킷 연결
GCS 연결을 설정하기 전에 GCS에 버킷을 생성하십시오. 연결 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- GCS 버킷 이름을 입력합니다.
- 연결 테스트(Test connection)를 클릭합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 이 연결을 Adobe Experience Platform과 호환할지여부를 선택합니다. 선택한 후, 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
- 저장을 클릭하세요.
Azure 클라우드 버킷 연결
Azure 연결을 설정하기 전에 Azure에서 스토리지 계정을 엽니다. 스토리지 계정을 여는 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- 연결 이름, 스토리지 계정 이름 및 키를 입력합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 이 연결을 Adobe Experience Platform과 호환할지여부를 선택합니다. 선택한 후, 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
- 저장을 클릭하세요.
Yandex Cloud 버킷 연결
AWS 연결을 설정하기 전에 Yandex에서 서비스 계정을 생성하십시오. 스토리지 계정을 여는 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- 버킷 이름, 액세스 키 및 비밀 키를 입력합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 이 연결을 Adobe Experience Platform과 호환할지여부를 선택합니다. 선택한 후, 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
- 저장을 클릭하세요.
BigQuery 데이터 웨어하우스 연결
BigQuery 연결을 설정하기 전에 BigQuery에서 데이터 세트를 생성하십시오. 스토리지 계정을 여는 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- BigQuery 프로젝트 ID와 데이터셋 이름을 입력합니다.
- 연결 테스트(Test connection)를 클릭합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
Snowflake 데이터 웨어하우스 연결
Snowflake 연결을 설정하기 전에 Snowflake에서 계정을 여세요. 스토리지 계정을 여는 방법에 대해 알아보려면 여기를 참조하세요.
연결을 설정하려면:
- Snowflake 지역과 계정 ID를 입력합니다.
- 연결 테스트(Test connection)를 클릭합니다.
- 버킷 경로가 잘못되었다는 오류 메시지가 표시되지 않는지 확인하십시오.
- 저장을 클릭하고 글로벌 수준 필터 선택을 계속 진행하십시오.
- AWS S3 버킷 이름을 입력하십시오.
- 저장을 클릭하세요. 리포트 출력 설정 섹션이 표시됩니다.
참고
연결이 생성, 업데이트 또는 삭제되었는지, 그리고 누가 변경했는지 확인하려면 감사 로그를 참조하세요.
3. 리포트 출력 설정을 지정합니다.
클라우드 서비스와의 연결을 설정한 후, 데이터 락커 리포팅 출력을 위한 일반 설정을 계속해서 설정할 수 있습니다. 클라우드 서비스가 BigQuery 또는 Snowflake인 경우 이 단계를 건너뛸 수 있습니다
-
Report output settings(리포트 출력 설정) 섹션에서 폴더 구조 (data segregation(데이터 분리))를 선택하십시오.
- 통합 (기본값): 리포트 파일에는 모든 앱의 기록이 포함되어 있습니다.
- 앱별로 분리: 각 리포트 파일은 하나의 앱에 할당됩니다.
- 리포트 파일 형식을 선택하십시오. Parquet(기본값) 또는 CSV.
- 리포트 파일의 압축 유형을 선택하십시오:
- Snappy(Parquet 파일에만 사용 가능)
- GZIP
-
파일에서 원하는 최대 행 번호를 선택하세요. 10k, 25k, 50, 100k, 200k, 또는 500k 중 선택할 수 있습니다. 파일에 행이 많을수록 파일 수는 적지만 파일 크기는 커집니다.
참고
예상 경로 아래에서 리포트의 경로 패턴을 확인하세요. 참고: 실제 경로는 표시된 것과 다를 수 있습니다.
4. 글로벌 수준 필터 선택
글로벌 수준의 필터를 사용하면 앱 또는 미디어 소스별로 리포트를 필터링할 수 있습니다. 이 필터는 귀하의 데이터 락커 계정 대부분의 리포트에 적용되지만, 리포트 수준에서도 설정할 수 있습니다(아래 7-select-the-reportlevel-filters 참조). 두 수준 모두에 동일한 필터가 적용되면 리포트 수준의 필터가 우선합니다.
필터를 적용하려면 다음을 수행하십시오.
-
리포트 섹션에서 필터를 클릭하고 리포트에 포함할 항목을 선택하십시오. 예를 들어,
앱 필터를 클릭하고 리포트에 포함할 앱을 선택합니다.
- Enter (⏎) 버튼을 클릭하세요.
5. 리포트 그룹 선택
클라우드 서비스에서 받고 싶은 리포트를 선택하세요. 리포트는 그룹으로 나열됩니다. 리포트 그룹 이름을 클릭하면 그룹이 확장되거나 축소됩니다.
- 리포트를 선택하려면
를 클릭하여 리포트 그룹을 확장하십시오. 그룹의 각 리포트에 대해 다음 정보가 제공됩니다:
- 리포트 이름: 리포트의 제목.
- 데이터셋 이름: 리포트의 기록이 포함된 데이터셋의 이름.
- 데이터 최신성: 리포트가 새로운 기록으로 얼마나 자주 업데이트되는지 (예: 매시간, 매일 또는 버전별).
- 필드: 선택 가능한 총 필드 수 대비 리포트에서 선택한 필드(또는 열)의 수
6. 리포트 사용자 정의 또는 복제
리포트 그룹에서 하나 이상의 리포트를 선택한 후, 원본 리포트 사용자 정의 또는 복제하여 별도의 사용자 정의 사본을 생성할 수 있습니다. 이렇게 하면 원본 버전에 영향을 주지 않고 리포트의 필드와 필터를 특정 요구 사항에 맞게 조정할 수 있습니다.
옵션 A: 원본 리포트 사용자 정의
- 리포트 이름 옆에 있는
사용자 정의 버튼을 클릭합니다.
- 리포트 편집기가 열리며, 필드를 선택하고 필터를 적용할 수 있습니다.
- 변경 사항은 원본 리포트 구성에 저장됩니다.
참고: 이것은 리포트가 귀하의 클라우드 스토리지에 전달되는 방식을 수정합니다.
옵션 B: 리포트 복제
- 리포트 이름 옆에 있는
를 클릭합니다.
- 드롭다운 메뉴에서
복제를 선택합니다.
- 리포트의 사본이 생성되며, 접두사
copy_of_가 붙어 이름이 지정됩니다. - 복제된 리포트는 추가 사용자 지정을 위해 편집 모드에서 열립니다.
팁: 복제는 다양한 사용 사례에 맞는 리포트 변형을 만드는 데 이상적입니다.
사용자 지정 또는 복제 여부를 선택한 후, 다음 단계에 설명된 대로 리포트 필드를 설정합니다.
7. 리포트 필드 선택
리포트를 사용자 지정하거나 복제하기로 선택하면, 다음 단계에서는 어떤 데이터 필드가 포함되어야 하는지 정의합니다. 각 리포트는 사용 가능한 전체 필드 세트를 보여주며, 분석 또는 연동에 관련된 것만 포함하도록 선택을 사용자 지정할 수 있습니다. 기본적으로 모든 필드가 선택되지만, 특정 필드를 수동으로 선택하여 리포트를 세분화할 수 있습니다.
리포트에 포함될 필드를 선택하려면:
-
선택한 리포트 대화 상자에서 필드 탭 아래의 필드 위에 마우스를 올려 설명을 확인합니다.
- 리포트에 포함할 필드를 선택하거나 제외할 필드의 선택을 해제합니다.
- 설정을 저장하려면 Apply(적용)을 클릭하세요.
다른 리포트에서 필드 선택 복사하기
다른 리포트에서 필드 선택을 복사하여 시작점으로 삼고, 계속해서 필드를 선택하거나 선택 해제하여 리포트를 세밀하게 조정할 수 있습니다.
- 필드 탭에서 임의의 필드를 선택 해제하십시오.
- 리포트에서 스키마 가져오기(Pull schema from report)를 클릭하세요.
- 복사하고자 하는 필드 설정을 포함하는 리포트를 선택하십시오.
- 필드를 계속 선택하거나 선택 해제하십시오.
- 리포트의 원래 필드 선택을 복원하려면
새로 고침을 클릭하십시오.
8. 리포트 수준 필터 선택
리포트 수준 필터를 사용하면 앱, 미디어 소스 또는 기타 디멘션을 기준으로 리포트를 필터링할 수 있습니다. 계정의 모든 리포트에 적용되는 필터를 설정할 수도 있습니다. 글로벌 수준 필터 선택를 참조하십시오. 기본적으로 리포트 수준 필터는 글로벌 수준 필터 설정에 맞춰져 있지만, 선택한 보고서에만 적용되는 사용자 지정 설정으로 업데이트할 수 있습니다.
지정된 리포트에 적용할 필터를 선택하려면:
- 사용자 지정하려는 특정 리포트 위에 마우스를 올립니다.
- 작업 메뉴를 열려면
를 클릭하고,
리포트 편집(Edit report)을 선택하세요.
- 필터 탭을 엽니다. 필터가 글로벌 수준 필터 설정으로 설정되었습니다.
- 필터를 클릭하고 리포트에 포함할 항목을 선택하세요. 예를 들어,
앱 필터를 클릭하고 리포트에 포함할 앱을 선택합니다.
- Enter (⏎) 버튼을 클릭하세요. 귀하의 선택이 글로벌 수준 설정보다 우선합니다.
- (선택 사항) 인앱 리포트의 경우 인앱 이벤트 필터를 설정할 수 있습니다. 이름을 정확하게 입력하여 선택하십시오.
-
설정을 저장하려면 Apply(적용)을 클릭하세요.
9. 레거시 필드를 제거합니다.
레거시 필드는 이전에 리포트 스키마에 포함되었지만 현재는 제외된 필드입니다. 이 필드를 제거하여 리포트에 관련 정보만 포함되도록 하는 것이 좋습니다. 변경하기 전에 워크플로우와 연동이 이 필드에 의존하지 않는지 확인하세요.
특정 레거시 필드 제거하기
- 레거시 필드 탭을 엽니다.
- 켜기: 리포트에 레거시 필드 포함하기
- 제외할 필드를 선택 해제하세요.
- Apply(적용)을 클릭합니다.
- 연결 설정을 저장하십시오.
모든 레거시 필드 제거하기:
- 레거시 필드 탭을 엽니다.
- 끄기: 리포트에 레거시 필드 포함하기
참고
리포트에 레거시 필드를 포함하고 싶지만 레거시 필드 목록이 회색으로 표시되고 잠겨 있어 포함할 수 없는 경우 고객 성공 관리자에게 문의하세요.
비어 있지 않은 레거시 필드
대부분의 레거시 필드는 비어 있거나 null입니다. 그러나 그 중 일부는 값을 포함하고 있지만 여전히 레거시로 간주됩니다. 그 이유는 다음과 같습니다:
- 리포트에 다른 이름(이름 변경됨)으로 나타납니다.
- 리포트 스키마에서 제외되었습니다(사용 중단됨).
10. 연결 저장
저장(Save)을 클릭하면 첫 번째 데이터 덤프가 3시간 이내에 클라우드 서비스에 작성됩니다. 후속 데이터 업데이트 일정은 각 리포트에 따라 다릅니다.
중요!
데이터 락커에 적용한 모든 변경 사항이 적용되는 데 최대 3시간이 소요됩니다.
데이터 스토리지 아키텍처
개요
스토리지 내 데이터 구조는 해당 데이터가 클라우드 스토리지로 전송되는지, 아니면 데이터 웨어하우스로 전송되는지에 따라 달라집니다. 여기에 설명한 폴더 구조는 스토리지(버킷)에 적용됩니다. 데이터 웨어하우스 스토리지의 경우 폴더에 대한 참조가 보기에 적용된다는 점을 고려합니다.
데이터는 선택한 스토리지 옵션에 따라 기록됩니다. 클라우드 스토리지의 경우, 스토리지는 AWS상에서 앱스플라이어가 소유하고 있거나 AWS, GCS 또는 Yandex에서 소유하고 있습니다. 언제든지 스토리지 옵션을 전환하거나 데이터의 일부 또는 전체를 여러 스토리지 옵션으로 전송할 수 있습니다.
클라우드 버킷 스토리지의 데이터는 리포트 유형, 날짜 및 시간에 따라 계층적 폴더 구조로 구성됩니다. 다음 그림은 이 구조의 예시를 나타냅니다.
지정된 리포트의 데이터는 해당 리포트와 연결된 시간(h) 폴더에 포함됩니다.
- 시간 폴더 수는 리포트 데이터 새로 고침(시간별, 일별 또는 버전별)에 따라 달라집니다.
- 데이터는 Snappy 또는 GZIP 압축 파일 또는 Parquet 또는 CSV 형식의 압축되지 않은 파일로 제공됩니다.
- 데이터 파일은 열(필드)로 구성됩니다.
- 사용자 여정 리포트의 스키마(필드) 구조는 서로 동일하며 선택한 필드에 따라 달라질 수 있습니다. 다른 리포트에는 각각 고유한 명시적 필드인 스키마 제외 리포트를 포함합니다. 사용 가능한 리포트와 리포트 사양에 대한 링크는 데이터 락커 마케터 리포트를 참조하세요.
폴더 구조
| 폴더 | 설명 |
|---|---|
| 구독 ID |
버킷 소유자 및 클라우드 제공자에 기반한 폴더 구조 예시
|
| 주제(t) | 리포트 유형은 리포트의 주제와 관련됩니다. |
| 날짜(dt) | 이는 관련된 데이터 날짜입니다. 로데이터의 경우 이벤트가 발생한 날짜를 의미합니다. 집약형 데이터의 경우 바로 리포트 날짜입니다. |
| 시간(h 또는 버전) |
리포트 유형에 따라 날짜 폴더가 시간별(h) 또는 버전 폴더로 구분됩니다. 시간별 폴더h 폴더는 앱스플라이어가 데이터를 수신한 시간과 관련됩니다. 예를 들어, 14:00-15:00 UTC 사이에 수신한 인스톨 이벤트는 h=14 파일에 기록됩니다. 참고! 데이터가 앱스플라이어에 도착하는 시점부터 h 폴더가 데이터 락커에 기록될 때까지 약 1-3시간의 지연이 발생합니다. 예를 들어, h=14 폴더는 15:00 UTC에서 1시간 후에 기록됩니다. 시간별 폴더 특징:
버전 폴더일부 리포트에는 버전별 옵션이 있습니다. 즉, 주어진 날짜에 대해 최근에 업데이트된 데이터가 여러 번 제공됩니다. 데이터가 늦게 도착하거나 더 정확한 데이터로 인해 계속 업데이트될 수 있으므로 동일한 보고서에는 여러 버전이 존재하며, 가장 최근 버전이 가장 정확합니다. 지정된 날짜에 대한 리포트는 해당 날짜의 버전 폴더에 포함됩니다. 각 버전은 별도의 폴더에 포함되며, 해당 폴더 이름은 보고서를 고유하게 식별하는 Epoch 타임스탬프를 사용하여 설정됩니다. 데이터 가져오기 프로세스에서는 데이터를 소급하여 기록할 수 있다는 점을 고려해야 합니다. 예를 들어, 1월 14일에는 데이터가 1월 1일 폴더에 기록될 수 있습니다. 버킷을 소유한 경우 클라우드 서비스 알림을 사용하여 가져오기 프로세스(AWS | GCS)를 트리거합니다. |
앱 분리
버킷 클라우드 스토리지의 경우 데이터는 선택한 모든 앱의 데이터를 포함하는 통합 데이터 파일로 제공되거나 앱별로 폴더로 분리됩니다. 분리는 다음 표에 설명된 대로 h 폴더 내에 있습니다.
| 분리 유형 | 설명 |
|---|---|
| [기본값] 통합 |
모든 앱의 데이터는 통합된 데이터 파일로 제공됩니다. 데이터를 사용할 때 행 수준 app_id 필드를 사용하여 앱을 구별합니다. 데이터 파일의 예시는 h= 2 폴더에 있습니다. 데이터 파일 이름 지정 규칙은 unique_id.gz입니다.
|
| 앱별로 분리 |
폴더에는 앱별 서브폴더가 포함됩니다. 지정된 앱의 데이터 파일은 앱 폴더에 포함되어 있습니다. 다음 그림에서 h=19 폴더에는 앱 폴더가 포함됩니다. 각 앱 폴더에는 연관된 데이터 파일이 포함됩니다. 참고! 데이터 파일에 app_id가 포함되어 있지 않습니다. 폴더를 사용하여 app_id를 확인해야 합니다. 각 앱 폴더에서 이름 지정 규칙은 unique_id.gz입니다.
제한 사항: 이 옵션은 사람 기반 어트리뷰션 리포트에 사용할 수 없습니다. |
데이터 파일
데이터 파일은 분리 유형에 따라 다릅니다.
| 콘텐츠 | 세부 정보 | |
|---|---|---|
| 완료 플래그 |
마지막 파일(완료) 플래그는 지정된 h 폴더에 대한 모든 데이터가 기록될 때 설정됩니다.
|
|
| 파일 형식 |
|
|
| 열 순서(CSV 파일) |
CSV 파일의 경우 리포트의 필드 순서는 항상 동일합니다. 새 필드를 추가하면 기존 필드 오른쪽에 추가됩니다. 이와 관련하여:
|
|
| 필드 채우기 고려사항 |
빈 또는 공백 필드: 일부 필드는 null로 채워져 있거나 비어 있습니다. 이것은 지정된 리포트의 맥락에서 볼 때 리포트할 데이터가 없음을 의미합니다. 일반적으로 null 은 주어진 보고서 및 앱 유형의 컨텍스트에서 이 필드가 채워지지 않음을 의미합니다. 공백 "" 은 필드가 해당 컨텍스트에서는 관련이 있지만 채울 데이터가 없음을 의미합니다. 제한된 미디어 소스의 경우 제한된 필드의 내용이 null로 설정됩니다. 전체적으로 null과 blank를 동일한 것으로 간주하며, 사용할 수 있는 데이터가 없습니다. 시간대와 통화 앱별 시간대와 통화 설정은 데이터 락커에 기록된 데이터에 영향을 주지 않습니다. 다음 사항이 적용됩니다.
쉼표를 포함하는 값: 이 쉼표는 큰따옴표 "" 사이에 포함되어 있습니다. 예를 들어, |
|
스토리지 옵션
주의!
마케터 소유 스토리지 옵션을 사용하는 경우:
- GDPR 및 광고 네트워크/SRN 데이터 리텐션 정책과 같은 개인 정보 보호 규정을 준수하는지 확인합니다.
- 마케터 소유의 스토리지 솔루션을 사용하여 데이터를 제3자에게 전송하지 마십시오.
- 데이터는 다음과 같이 사용자가 선택한 스토리지 소유자에게 기록됩니다.
- 앱스플라이어 스토리지
- 고객 스토리지 - AWS, GCS, Azure, Yandex, BigQuery 및 Snowflake
- 스토리지 선택은 언제든 변경할 수 있습니다.
- 스토리지를 변경하는 경우 다음 사항이 발생합니다.
- 새로 선택한 스토리지에 한 시간 이내에 기록을 시작할 수 있습니다.
- 7일의 전환 기간 동안 기존 스토리지에 계속 기록합니다. 전환 기간 만료 시간이 사용자 인터페이스에 표시됩니다. 전환 기간을 사용하여 데이터 로딩 프로세스를 업데이트합니다. 전환 기간을 다시 시작하거나 필요한 경우 앱스플라이어 버킷으로 되돌릴 수 있습니다.
- 스토리지 변경: 다중 스토리지 옵션을 사용하여 데이터를 여러 대상에 동시에 전송함으로써 한 스토리지 옵션에서 다른 스토리지 옵션으로 마이그레이션할 수 있습니다. 마이그레이션 및 테스트가 완료되면 더 이상 필요하지 않은 스토리지 옵션을 삭제합니다.
| 앱스플라이어 소유 스토리지(AWS) | 마케터 소유 스토리지(GCS, AWS, Azure, Yandex, BigQuery, Snowflake) | |
|---|---|---|
| 버킷 이름 | 앱스플라이어가 설정 |
예시: |
| 스토리지 소유권 | 앱스플라이어 | 마케터 |
| 스토리지 플랫폼 | AWS | AWS, GCS, Azure, Yandex, BigQuery, Snowflake |
| 사용자가 데이터에 액세스하기 위한 자격 증명 | 앱스플라이어 계정 관리자에게 제공되는 데이터 락커 사용자 인터페이스에서 이용 가능합니다. | 앱스플라이어에는 알려지지 않습니다. 클라우드 제공업체가 제공하는 자격 증명을 사용하십시오. |
| 데이터 보존 | 데이터는 14일 이후에 삭제됩니다. | 마케터 책임 |
| 데이터 삭제 요청 | 앱스플라이어 책임 | 마케터 책임 |
| 보안 | 앱스플라이어는 스토리지를 제어합니다. 고객은 읽기 액세스 권한을 가집니다. |
마케터는 스토리지를 제어합니다.
|
| 스토리지 용량 | 앱스플라이어에서 관리 | 마케터가 관리 |
| 버킷 정책을 포함한 VPC 엔드 포인트를 사용한 액세스 제어 | 해당 사항 없음. | [선택 사항] AWS에서 버킷 수준에서 VPC 엔드포인트 보안을 구현하는 경우 앱스플라이어 서버 목록을 허용해야 합니다. |
고객이 관리하는 스토리지의 경우 보안 담당자 알림 사항
효과적 관리를 위해 다음과 같은 사항을 고려해야 합니다.
- 버킷 또는 대상은 앱스플라이어 사용 전용입니다. 다른 엔터티는 해당 대상에 기록할 수 없습니다.
- 데이터를 작성한 후 25시간 후에 대상의 데이터를 삭제할 수 있습니다.
- 대상에 기록된 데이터는 이미 서버에 있는 데이터의 사본입니다. 데이터는 회사 리텐션 정책에 따라 서버에 계속 남아 있습니다.
- 기술적인 이유로 인해, 때때로 데이터는 삭제되고 다시 작성됩니다. 이러한 이유로 인해, 삭제 및 리스트 권한이 필요합니다. 어떤 권한도 사용자에게 보안 위험이 되지 않습니다. 리스트의 경우, 앱스플라이어가 버킷에 기록할 수 있는 유일한 엔티티입니다. 삭제의 경우, 데이터를 재생성할 수 있습니다.
- 추가 정보에 대해서는 hello@appsflyer.com 또는 CSM을 통해 보안 팀에 문의할 수 있습니다.
다중 연결 원칙(하나 이상의 대상)
데이터 락커에서 데이터의 일부 또는 전체를 2개의 대상(연결 설정에서 정의)으로 보낼 수 있습니다. 예를 들어 앱 A 데이터를 AWS로 보내고 앱 B 데이터를 GCS로 보낼 수 있습니다.
각 연결은 대상 위치를 포함한 데이터 락커 설정의 완전한 세트로 구성됩니다. 연결 설정은 서로 독립적입니다.
연결을 관리할 때 다음을 고려하십시오.
- 데이터 락커 설정에서 연결은 탭에 표시됩니다. 각 연결에는 연결을 관리할 수 있는 자체 설정 탭이 있습니다. 각 탭의 아이콘은 스토리지 유형을 나타냅니다.
- 연결 세부사항을 확인하거나, 연결을 복제 혹은 삭제하려면, ⋮ (옵션)을 클릭하세요.
추가 정보
감사 로그에서 연결 변경 사항을 추적합니다.
데이터 락커 연결 변경 사항은 앱스플라이어 대시보드의 보안 센터에서 확인할 수 있는 감사 로그에서 확인할 수 있습니다. 감사 로그를 사용하여 변경이 이루어졌는지, 언제 발생했는지, 누가 했는지 확인합니다. 이것은 서포트팀에 연락할 필요 없이 누락된 데이터나 예상치 못한 연결 변경과 같은 문제를 해결하는 데 도움이 될 수 있습니다.
다음의 연결 수명 주기 이벤트가 추적됩니다:
- 새 연결 생성됨
- 연결 업데이트됨
- 연결 비활성화됨
- 연결 삭제됨
감사 로그에 액세스하는 방법:
- 상단 탐색 바에서
계정 메뉴를 엽니다.
- 보안 센터를 선택합니다.
- 감사 로그 섹션에서 감사 로그 보기를 클릭합니다.
- 서비스별로 필터링: 관련 항목을 보기 위해 Datalocker
자세한 내용은 다음을 참조하세요. 감사 로그.
특징 및 제약 사항
| 특징 | 비고 |
|---|---|
| 애드 네트워크 | 애드 네트워크에서는 사용할 수 없습니다. |
| 에이전시 | 에이전시에서는 사용할 수 없습니다. |
| 앱별 시간대 | 해당 사항 없음. 데이터 락커 폴더는 UTC를 기준으로 시간별로 구분됩니다. 실제 이벤트에는 UTC 시간이 포함됩니다. 필요에 따라 시간을 다른 표준시로 변환합니다. 앱의 시간대와 무관하게 이벤트 발생 시점부터 데이터 락커에 기록될 때까지의 지연 시간은 동일하게 유지됩니다. |
| 앱별 통화 | 지원되지 않음 |
| 사이즈 제한 | 적용 불가 |
| 데이터 최신성 | 이 아티클에 나와있듯이 데이터는 특정 리포트 데이터 최신성에 따라 업데이트됩니다. |
| 과거 데이터 | 지원되지 않음. 과거 데이터가 필요한 경우, 일부 보고서(전부는 아님)는 Pull API를 통해 이용 가능합니다. |
| 제한된 데이터 | 일부 리포트의 필드는 개인 정보 보호로 인해 제한됩니다. 더 알아보기 |
| 유저 액세스 | 필수 권한을 가진 계정 사용자만 데이터 락커를 설정할 수 있습니다. |
| 단일 앱/여러 앱 | 다중 앱 지원. 데이터 락커는 계정 수준에서 적용됩니다. |
| 최대 연결 수 | 기본적으로 각 계정은 최대 2개의 데이터 락커 연결을 열 수 있습니다. 추가 연결을 요청하려면, CSM에 연락하세요. |
문제 해결
- 증상: AWS CLI를 사용하여 데이터를 확보할 수 없습니다.
- 오류 메시지: ListObjectsV2 작업 호출 중 오류가 발생했습니다(액세스 거부됨): 액세스 거부됨
- 원인: 사용된 AWS 인증 정보가 앱스플라이어 버킷에 대한 올바른 인증 정보가 아닙니다. 사용자 머신에 여러 개의 또는 잘못된 인증 정보를 갖고 있을 때 발생할 수 있습니다.
-
해결 방안:
- 버킷에 액세스 하기 위해, CLI가 아닌 Cyber Duck 같은 다른 방법을 사용합니다. 사용 중인 자격 증명이 작동하는지 확인하려면 이 작업을 수행합니다. Cyberduck을 사용하여 연결할 수 있는 경우 자격 증명 캐시에 문제가 있음을 나타냅니다.
-
AWS 인증 정보 캐시를 새로 고칩니다.
AWS 스크린샷에서
AWS 데이터 검색
선호하는 AWS 데이터 검색 툴, AWS CLI, 혹은 다음 섹션에 소개되는 툴 중 하나를 사용하십시오. 참고! 해당 지침은 앱스플라이어 소유 버킷에 적합합니다. 귀하의 버킷에 연결하는 경우 필요에 따라 지침을 조정하십시오.
AWS CLI
시작하기 전에:
- 컴퓨터에 AWS CLI를 설치합니다.
- 앱스플라이어에서 데이터 락커로 이동하여, 인증 정보 창에 포함된 정보를 가져옵니다.
AWS CLI를 사용하려면:
- 터미널을 엽니다. Windows에서 수행하려면, <Windows>+<R>, OK를 클릭합니다.
명령행 창이 열립니다. - aws configure를 입력합니다.
- 인증 정보 창에 표시된 대로, AWS Access Key를 입력합니다.
- 인증 정보 창에 표시된 대로, AWS Secret Key를 입력합니다.
- eu-west-1을 입력합니다.
- 엔터를 누릅니다(없음).
필요할 경우, 다음 CLI 명령을 사용합니다.
다음 명령에서 {home-folder}의 값을 찾을 수 있습니다.
버킷의 폴더를 나열하는 방법은 다음과 같습니다.
aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/
파일 및 폴더 나열하기
데이터 락커 버킷에는 세 가지 유형의 폴더가 있습니다.
- 리포트 유형
- 날짜
dt= - 시간
h=
특정 리포트 유형에 해당하는 모든 리포트를 나열하려면:
aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/
특정 날짜의 특정 리포트 유형에 해당하는 모든 리포트를 나열하려면:
aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17
특정 날짜의 특정 시간대에 속한 특정 리포트의 모든 리포트를 나열하려면:
aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23
특정 날짜의 파일을 다운로드하는 방법은 다음과 같습니다.
aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/
Cyberduck
시작하기 전에:
- Cyberduck 클라이언트를 설치합니다.
- 앱스플라이어에서 데이터 락커로 이동하여 인증 정보 창에 포함된 정보를 가져옵니다.
Cyberduck을 설정하려면:
- Cyberduck에서 Action을 클릭합니다.
- New Bookmark(새 북마크)를 선택하면, 창이 열립니다.
- 첫 번째 필드(아래 스크린샷에서 [1]로 표시됨)에서 Amazon S3.
를 선택합니다.
- 다음과 같이 필드를 완성합니다.
- 닉네임: 자유 텍스트
- 서버: s3.amazonaws.com
- 액세스 키 ID: 앱스플라이어 인증 정보 창에 표시된 AWS Access Key를 복사합니다.
- 비밀 액세스 키: 앱스플라이어 인증 정보 창에 표시된 Bucket Secret key를 복사합니다.
- 경로: {Bucket Name}/{Home Folder} 예: af-ext-reports/1234-abc-ffffffff
- 창을 닫습니다. 창의 우측 상단 모서리의 X를 클릭합니다.
- 연결을 선택합니다.
데이터 디렉토리가 표시됩니다.
Amazon S3 browser
시작하기 전에:
- Amazon S3 Browser를 설치합니다.
- 앱스플라이어에서 데이터 락커로 이동하여 인증 정보 창에 포함된 정보를 가져옵니다.
Amazon S3 Browser를 설정하려면:
- S3 브라우저에서 계정 > 새 계정 추가를 클릭합니다.
새 계정 추가 창이 열립니다. - 다음과 같이 필드를 완성합니다.
- 계정 이름: 자유 텍스트.
- 액세스 키 ID: 앱스플라이어 인증 정보 창에 표시된 AWS Access Key를 복사합니다.
- 비밀 액세스 키: 앱스플라이어 인증 정보 창에 표시된 버킷 비밀 키를 복사합니다.
- 비밀번호 포함 액세스 키 암호화를 선택하고, 비밀번호를 입력합니다. 이 비밀번호를 기록해두십시오.
- 보안 전송 사용을 선택합니다.
- 변경 사항 저장(Save changes)을 클릭합니다.
-
버킷 > 외부 버킷 추가를 클릭합니다.
외부 버킷 추가 창이 열립니다. - 버킷 이름/strong> 을 입력합니다. 버킷 이름은 다음 형식을 가집니다: {버킷 이름}/{홈 폴더}. 버킷 이름과 홈 폴더에 필요한 값은 자격 증명 창에 표시됩니다.
- 클릭 외부 버킷 추가.버킷이 생성되고 창의 왼쪽 패널에 표시됩니다.
이제 데이터 락커 파일에 액세스할 수 있습니다.