파트너용 데이터 락커

• 버킷의 최상위 폴더는 스토리지 제공업체에 따라 다릅니다.
• data-locker-hourly 폴더에는 리포트 주제가 포함되어 있습니다. 

 버킷 소유자 및 클라우드 제공자에 기반한 폴더 구조 예시:

• AWS 버킷: <af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
• GCS 버킷: <your bucket name>/<generated-home-folder>/<subscription-id>

이는 관련 데이터 날짜입니다. 대부분의 경우 이 날짜는 이벤트가 발생한 날짜를 의미합니다. 

h 폴더는 앱스플라이어가 데이터를 수신한 시간과 관련됩니다. 예를 들어 UTC 14:00-15:00 사이에 수신된 인스톨 이벤트는 h=14 파일로 스트리밍됩니다. 일러두기! 데이터가 앱스플라이어에 도착한 시점부터 h 폴더가 데이터 락커로 스트리밍될 때까지 약 6시간의 지연이 있습니다. 예를 들어 h=14 폴더는 6시간 후 23:00 UTC에 스트리밍됩니다. 

폴더 특성:

• 0-23으로 번호가 지정된 24개 h 폴더가 있습니다. 예를 들어, h= 0, h= 1 등입니다. 
• 또한 late 폴더에는 자정 이후에 도착하는 전날의 이벤트(즉, 다음 날 00:00-02:00 UTC 사이에 도착하는 이벤트)가 포함됩니다. 예를 들어 사용자가 월요일 08:00에 앱을 설치하고 이벤트가 화요일 01:00에 도착하면 이벤트는 월요일 late 폴더에 기록됩니다. 
• 02:00 이후에 도착한 데이터는 실제 도착일시 폴더에 기록됩니다. 
• 사용자는 late 폴더의 데이터를 사용해야 합니다. 다른 폴더에는 포함되어 있지 않습니다. 
• _temporary folder: 경우에 따라 h 폴더 내에 임시 폴더를 생성하는 경우도 있습니다. 임시 폴더 및 하위 폴더는 무시합니다. 예시: /t=impressions/dt=2021-04-11/h=18/_temporary.

모든 앱의 데이터는 통합된 데이터 파일로 제공됩니다. 데이터를 로드할 때 행 수준 app_id 필드를 사용하여 앱을 구별합니다.

데이터 파일의 예시는 h= 2 폴더에 있습니다.

• 데이터 로드 프로세스에서 다음을 확인하십시오.
  • _SUCCESS 플래그가 설정된 후에만 데이터 사용을 시작합니다.
  • 확장자가 .gz인 모든 파일을 로드합니다.

마지막 파일(완료) 플래그는 지정된 h 폴더에 대한 모든 데이터가 기록될 때 설정됩니다. 

• _SUCCESS 플래그가 존재하는지 확인하기 전에 폴더의 데이터를 읽지 마십시오.

• 폴더에 데이터가 기록되지 않은 경우에도 _SUCCESS 플래그가 설정됩니다. 다시 말하면 폴더가 비어 있을 때입니다.

파일은 gz를 사용하여 압축됩니다. 압축을 푼 후:

• 파일에는 확장자가 없습니다.
• 각 파일에는 열(필드) 이름이 포함된 헤더 행이 있습니다. 

리포트에서 필드 순서는 항상 동일합니다. 새 필드는 기존 필드의 오른쪽에 추가됩니다. 

열(필드) 정의는 리포트별로 정의됩니다. 설명은 관련 리포트 기사를 확인하십시오. 

공백 또는 비어 있는 필드: null로 채워지거나 빈 필드가 있을 수 있습니다. 이것은 지정된 리포트의 맥락에서 볼 때 리포트할 데이터가 없음을 의미합니다. 일반적으로 null 은 이 필드가 지정된 리포트 및 앱 유형의 컨텍스트로 채워지지 않음을 의미합니다. 공백 "" 은 필드가 해당 컨텍스트에서 관련이 있지만 채우는 데이터가 없음을 의미합니다. 

시간대와 통화:

데이터 락커에서 제공하는 데이터는 앱별 시간대 및 통화 설정이 무시됩니다. 다음과 같습니다. 

• 시간대: 날짜와 시간 데이터는 UTC 기준입니다.
• 통화: event_revenue_usd 필드는 미국 달러화(USD) 기준입니다.

쉼표를 가진 값: 이 쉼표는 큰따옴표 `"` 사이에 포함되어 있습니다. 예를 들어 `"iPhone6,1"`입니다.

마지막 파일(완료) 플래그는 지정된 h 폴더에 대한 모든 데이터가 기록될 때 설정됩니다. 

• _SUCCESS 플래그가 존재하는지 확인하기 전에 폴더의 데이터를 읽지 마십시오.

• _SUCCESS 플래그는 지정된 폴더에 기록할 데이터가 없고 폴더가 비어 있는 경우에도 설정됩니다. 

• 일러두기! 앱별 구분 옵션에서는 플래그가 개별 앱 폴더가 아닌 h 폴더에 설정됩니다. 이전 절의 그림을 참조하십시오. 

• 데이터는 Snappy 또는 GZIP 압축 파일 또는 Parquet 또는 CSV 형식의 압축되지 않은 파일로 제공됩니다.
• 압축 해제 이후 데이터 파일은 사용자의 설정에 따라 Parquet 또는 CSV 형식을 가집니다.

CSV 파일의 경우 리포트의 필드 순서는 항상 동일합니다. 새 필드를 추가하면 기존 필드 오른쪽에 추가됩니다. 

이와 관련하여: 

• 사용자 여정 리포트의 열 구조는 동일합니다. 따라서 서로 다른 리포트 유형에 대해 유사한 데이터 로드 절차를 수행할 수 있습니다. 리포트에 포함될 필드를 선택합니다. 필드 의미는 로데이터 사전에 자세히 설명되어 있습니다. 
• 리포트 가용성 섹션에 FF 표기가 있는 리포트는 공통 열 구조를 따르지 않습니다. 

공백 또는 비어 있는 필드: null로 채워지거나 빈 필드가 있을 수 있습니다. 이것은 지정된 리포트의 맥락에서 볼 때 리포트할 데이터가 없음을 의미합니다. 일반적으로 null 은 이 필드가 지정된 리포트 및 앱 유형의 컨텍스트로 채워지지 않음을 의미합니다. 공백 "" 은 필드가 해당 컨텍스트에서 관련이 있지만 채우는 데이터가 없음을 의미합니다. 

제한된 미디어소스의 경우 제한된 필드의 내용이 null로 설정됩니다. 

전체적으로 null과 blank를 동일한 것으로 간주하며 모두 사용할 수 있는 데이터가 없습니다. 

시간대와 통화

앱별 시간대와 통화 설정은 데이터 락커에 기록된 데이터에 영향을 주지 않습니다. 다음 사항이 적용됩니다. 

• 시간대: 날짜와 시간 데이터는 UTC입니다.
• 통화: event_revenue_usd 필드는 미국 달러화(USD) 기준입니다.

쉼표를 가진 값: 이 쉼표는 큰따옴표 `"` 사이에 포함되어 있습니다. 예를 들어 `"iPhone6,1"`입니다.

• GCS: 제한 없음
• AWS: 사용자가 설정합니다. 접두사 af-가 있어야 합니다.

예시: af-datalocker-your-bucket-name

사용자가 스토리지를 제어합니다. 

• AWS: 앱스플라이어를 사용하려면 버킷에 대한 GetObject, ListBucket, DeleteObject, PutObject 사용 권한이 필요합니다. 버킷은 앱스플라이어 사용 전용이어야 합니다. 다른 목적으로 사용하지 마십시오.
• GCS