소스 내의 데이터는 다음 요구 사항을 충족해야 합니다.

• 날짜 (만) : yyyy-mm-dd (예:2023-04-18 )
• 날짜와 시간:
  • 형식: yyyy-MMM-dd hh:mm:ss (예시, 2023-APR-18 15:30:352023-APR-18 15:30:352023-APR-18>)
  • 시간대: UTC
• 숫자: 소수점 이하 최대 2자리
• 문자열 길이: 최대 256자
• 문자 제한:
  • 필드 이름(열 머리글): 공백 또는 특수 문자 없음
  • 기타 모든 데이터: 제한 없음(모든 문자가 유효함)

처리를 위해 공유되는 데이터 외에도 BigQuery 또는 Snowflake의 소스 테이블에는 2개의 추가 열인 날짜 및 버전이 포함되어야 합니다.

• 날짜:
  • 열 머리글
  • 열 유형: 날짜
  • 데이터 형식: yyyy-mm-dd (예, 2023-04-182023-04-182023-04-18)
  • 추가: 추가 사항: BigQuery 테이블은 상기 열로 분할되어야 합니다.
• 버전:
  • 열 머리글
  • 열 유형: 문자열
  • 데이터 형식: 숫자(예, 111, 222, 333, 101010)
  • 중요! DCR이 이 열에서 새 값을 검색할 때마다 새 버전의 리포트가 트리거됩니다. 리포트의 완전성을 보장하려면 열 값이 변경될 때마다 원본 테이블을 전체 데이터 집합으로 채워야 합니다.

Amazon S3 또는 GCS에 저장된 소스 파일은 다음 파일 이름 및 형식 요구 사항을 충족해야 합니다.

• 파일 이름은 DCR 이름 지정 요구 사항을 준수해야 합니다.
• CSV 또는 GZIP 형식
  • GZIP 압축의 기반 파일은 CSV 파일이어야 합니다.
• 데이터 폴더당 데이터 소스 파일 수:
  • CSV: 최대 1개
  • GZIP: GZIP: 최대 1개의 단일 파트 파일. 다음과 같이 파일 이름이 지정된 경우 여러 부분으로 구성된 GZIP 파일이 지원됩니다.filename_part01.csv.gz ,filename_part02.csv.gz , 등.

1. 앱스플라이어 에서 측면 메뉴의 공동 작업 > 데이터 _x0008_클린룸 선택합니다.
    

   

2. 메인 페이지 또는 소스 탭에서 + 새 소스 클릭하세요.
    

   

3. 새 소스 설치 절차를 진행하세요.

소스 이름을 입력하세요. 소스 식별하는 데 돕다 되는 고유한 이름이면 어떤 것이든 가능합니다. 출처를 쉽게 식별 돕다 있도록 소스 에 대한 설명을 선택적으로 추가할 수도 있습니다(예: "2025년 이후 모든 구매 내역").

요구 사항 및 지침

• 계정에 있는 다른 모든 소스 중에서 소스 이름이 고유한지 확인하십시오. 그렇지 않으면 소스 저장할 수 없습니다.
• 클라우드 통합의 경우, 이름이 파일 이름과 일치할 필요는 없습니다.
• 소스 이름 요구 사항:
  • 길이: 2~80자
  • 유효한 문자:
    • 편지 (A-Z, a-z)
    • 숫자 (0-9)(0-9)(0-9), 이름의 첫 문자가 될 수 없습니다
    • 밑줄,
  • 유효하지 않은 문자:
    • 공백
    • 기타 모든 기호 또는 특수 문자

소스 위치를 지정하는 방법:

1. 소스가 생성될 (또는 생성된) 연결을 선택합니다.
   • 계정에 정의된 연결이 없는 경우 새 연결 대화 상자가 열리고 연결을 만들라는 메시지가 표시됩니다. 상기 지침에 따라 만드십시오.
   • 기존 연결이 있지만 새 연결을 사용하려면 '+ 새 연결'을 클릭 다음 지침에 따라 연결을 생성하세요.
2. 소스에 대한 데이터가 있는 위치에 따라 아래의 관련 지침을 따라 계속 진행합니다.

참고: 데이터 양이 많을 때 최상의 성과 위해 데이터의 일부를 별도로 저장할 수 있습니다. 이 데이터는 소스 업데이트될 때마다 업데이트되고 소스 삭제될 때 삭제됩니다.

BigQuery의 소스 위치

BigQuery 소스의 소스 위치 지정을 완료하려면 다음 안내를 따르십시오.

1. 소스 테이블이 있는 데이터 집합을 선택합니다.
2. 소스 데이터가 있는 테이블을 선택합니다.

이러한 선택 목록에는 연결을 만들 때 지정한 BigQuery 프로젝트에서 각각 사용 가능한 데이터 세트와 테이블이 포함됩니다.

Snowflake의 소스 위치

Snowflake 소스에 대한 소스 위치 지정을 완료하려면:

1. 소스 데이터가 포함된 공유를 선택합니다.
2. 소스 테이블이 있는 스키마를 선택합니다.
3. 소스 데이터가 있는 테이블을 선택합니다.

이러한 선택 목록에는 연결을 생성할 때 지정한 Snowflake 계정의 공유, 스키마 및 테이블이 각각 포함됩니다.

Cloud Storage 버킷의 소스 위치

Amazon S3 또는 GCS의 소스 위치는 연결에서 지정한 클라우드 스토리지 버킷과 DCR이 업데이트될 때마다 소스 파일을 읽는 기본 폴더 경로로 구성됩니다.  

연결을 지정하면 앱스플라이어는 소스 생성 프로세스의 일부로 필요한 기본 폴더 경로를 자동으로 생성할 수 있습니다.

• 앱스플라이어 폴더를 생성하도록 허용하면 프로세스가 간편해집니다. 하지만 여기 자세히 설명된 지침에 따라 수동으로 생성하는 방법을 선택할 수도 있습니다.

앱스플라이어 폴더를 생성하는 경우, 추가로 필요한 정보는 소스 폴더에 지정할 이름뿐입니다. (이 폴더는 새 리포트 버전을 작동하는 때마다 소스 를 업데이트하는 최상위 폴더입니다.) 소스 폴더를 상위 폴더 ( 일반적으로 input이라는 이름) 아래에 생성할지 여부를 표시하다 수도 있습니다 .

Cloud Storage 버킷에서 소스 위치 지정을 완료하려면 소스 폴더 이름을 입력합니다.

• 기본적으로 표시된 소스 폴더 이름은 다음과 같습니다.
  • 소스에 지정한 이름을 기반으로 합니다. DCR 이름지정 요구 사항을 준수하는 한 필요에 맞게 폴더 이름을 변경할 수 있습니다.
  • 입력이라는 상위 폴더 내에서 생성됨을 나타냅니다. 이 폴더는 DCR에 업로드하는 모든 소스의 상위 폴더 역할을 합니다.
    • 입력 폴더는 필요하지 않으며 DCR 이름지정 요구 사항을 준수하는 한 제거하거나 다른 이름을 지정할 수 있습니다.
    • 이 폴더가 필수는 아니지만 입력 폴더(또는 다른 이름의 동등한 폴더)를 가지는 것이 가장 좋은 방법입니다. 이 방법은 데이터 파일 업로드(입력)와 리포트 수신(출력)에 동일한 클라우드 스토리지 버킷을 사용하는 경우 더욱 권장됩니다.

소스 위치는 로컬 파일입니다. 

로컬 파일을 사용하여 소스 데이터를 업로드할 수도 있습니다. 하지만 클라우드 서비스를 소스 위치로 설정하는 것이 강력히 권장됩니다 (대규모 데이터 세트 및 자동 업데이트에 필수적). 로컬 파일은 주로 테스트 목적으로 사용되며 플랫폼 기능을 익히는 데 도움이 됩니다. 

로컬 파일을 사용하여 소스 데이터를 업로드하려면 다음 단계를 따르세요. 

소스 위치를 선택할 때 '로컬 파일 시스템'을 클릭 하고 '다음'을 클릭하면 기기에서 로컬 파일을 업로드하는 옵션이 추가됩니다. 

데이터 협업 플랫폼(DCP)에서 소스 설정할 때 해당 소스 에 대한 업데이트를 처리하는 방법을 선택해야 합니다. DCP는 두 가지 동기화 방식을 지원합니다. 스냅샷 및 추가 . 각 방법은 서로 다른 사용 사례와 데이터 흐름에 적합합니다.

• 스냅샷 - 이 방법은 소스 업데이트될 때마다 전체 데이터 세트를 업로드하여 이전 데이터 세트를 새 데이터 세트로 완전히 대체합니다. 파일 업로드가 항상 전체 최신 데이터 세트를 포함하는 경우에만 선택하십시오.
• 추가 - 이 방법은 전체 데이터 세트가 아닌 새롭거나 변경된 데이터만 업로드합니다. 오래된 데이터 세트는 삭제되거나 업데이트되지 않습니다. 일일 또는 주간 보고서와 같은 반복 업로드에 이상적입니다. 이점으로는 업로드 용량 감소(클라우드 스토리지 비용 유도하다 가능성 있음), 데이터 업로드 성과 향상, 간편한 기록 관리 등이 있습니다.

스냅샷 업로드 요구 사항

이 방법을 사용하다 소스 업데이트될 때마다 이전 데이터 세트를 완전히 대체하는 완전하고 독립적인 파일을 업로드할 수 있습니다.

지원되는 클라우드 서비스

• Amazon S3
• Google 클라우드 스토리지
• BigQuery
• Snowflake

스냅샷 업데이트 방법을 사용하려면 다음 지침을 따르세요.

1. 소스 폴더 경로

   DCP에 클라우드 스토리지 소스 등록할 때 루트 경로(예:input/my_source_folder/ )는 해당 소스 에 대해 정의됩니다. 데이터셋을 새로 고칠 때마다 현재 모든 행이 포함된 전체 스냅샷 파일(스냅샷)을 이 폴더에 업로드합니다. 이를 통해 DCP는 항상 최신의 완벽한 데이터 정보를 처리할 수 있습니다.

2. 전체 스냅샷 파일 업로드 중

/v=1/data/

/v=1/

폴더 구조:

s3://af-dcr-xyz/abcd9876/input/source_name1/dt=2025-mm-dd/v=1/data/
└ bucket ┘ └ tenant ┘ └ingestion┘ └source┘└snapshot date┘└ver┘└files┘

이틀간의 스냅샷 구조 예시:

source_name1/
  dt=2025-08-10/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS
  dt=2025-08-11/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS

소스 파일의 전체 스냅샷을 2일 동안 업로드한 후(프로그램적으로 날짜/버전/데이터 폴더와 _SUCCESS 파일을 생성한 후) 폴더 구조가 어떻게 보이는지 예시를 보여드리겠습니다. 버킷/폴더 구조는 다음과 같을 수 있습니다.
 

업로드 요구 사항 추가

이 방법을 사용하다 이전 업로드 이후 변경되거나 추가된 데이터만 업로드할 수 있습니다.

왜 추가 기능을 사용해야 할까요?

• 효율성 – 업로드 용량 감소
• 데이터 무결성 – 시계열 분석을 위해 전체 변경 이력을 보존합니다.
• 개인정보 보호 정보보호법 준수 – 기록 삭제 및 동의 관리 간소화

지원되는 클라우드 서비스 AWS S3 및 구글 클라우드 스토리지(GCS)
참고: BigQuery 및 Snowflake는 Append 메서드를 지원하지 않으며 Snapshot 메서드를 사용해야 합니다.

추가 업데이트 방법을 사용할 때는 다음 지침을 따르세요.

1. 소스 폴더 설정

2. 추가(델타) 파일 업로드 

폴더 구조:

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/
└ bucket ┘ └ tenant ┘ └ ingestion ┘ └ source ┘ └ day partition ┘

주간 델타 폴더 구조 예시:

source_name/
  dt=2025-08-04/
  dt=2025-08-05/
  dt=2025-08-06/
  dt=2025-08-07/
  dt=2025-08-08/
  dt=2025-08-09/
  dt=2025-08-10/

간편한 계산 요령 요약:

핵심 요약 매주 업로드하더라도 항상 데이터를 일별별로 정리하세요.dt=YYYY‑MM‑DD 폴더.

소스 필드를 DCP 필드에 매핑하고, 테스트 후, 구성된 데이터를 저장합니다.

1. 소스 필드를 로드하세요
2. 소스 필드를 구성합니다.
3. EU 사용자 포함 여부 확인
4. 소스 데이터를 테스트합니다
5. 소스 저장

1. 소스 필드를 로드하세요

소스 필드가 자동으로 로드됩니다. 수동 로딩이 필요한 경우, 소스 위치에 따라 아래 지침을 따르십시오.

데이터 웨어하우스 소스

데이터 웨어하우스(BigQuery 또는 Snowflake)에 있는 소스에서 필드를 로드하려면 버튼을 클릭합니다.

Cloud Storage 버킷 소스

클라우드 스토리지 버킷(Amazon S3 또는 GCS)에 있는 소스에서 필드를 로드하려면 프로토타입 소스 파일을 업로드해야 합니다.

소스 필드를 DCP 필드에 매핑하기 위한 목적으로: 

• 로컬 파일에서 소스의 프로토타입 버전을 업로드할 수 있습니다.
  • 이 옵션을 선택하면 앱스플라이어는 항상 소스 폴더 경로를 자동으로 생성합니다.

                                                                또는

• 연결된 클라우드 버킷에서 소스 파일의 프로토타입 버전을 직접 업로드할 수 있습니다.
  • 이 옵션을 선택하면 다음을 추가로 선택할 수 있습니다.
    • 앱스플라이어 소스 파일에 대한 클라우드 폴더를 자동으로 생성하도록 허용하거나,
    • 소스 파일용 클라우드 폴더를 수동으로 생성하세요.

프로토타입 소스 파일을 업로드하려면 아래 관련 탭의 지침을 따르십시오.

2. 소스 필드를 구성합니다.

소스 필드를 불러온 후, 각 소스 필드(열)에는 DCP 필드가 표시됩니다. 각 소스 필드를 검토하고 옆에 있는 드롭다운 목록에서 적절한 DCP 필드에 매핑하십시오. 다음 사항을 고려하십시오.

필드를 삭제하려면:

• 삭제하려는 필드의 오른쪽에 마우스 커서를 올리면 나타나는 휴지통 아이콘을 클릭 .

필드를 수동으로 추가하려면:

이 옵션을 사용하면 데이터 소스 에 현재 없는 필드를 대상 그룹에 포함할 수 있습니다.

1. + 새 필드를 클릭하세요. 빈 필드가 추가되었습니다.
2. 필드 이름을 입력하고 유형을 선택하세요.
    

필드 유형은 다음과 같습니다. 

• 식별자
  • Android ID
  • 앱스플라이어 ID
  • CUID
  • 이메일
  • {해시된_이메일}
  • 해시 처리된 이메일 (점 없음)
  • IDFA
  • IP 주소
  • ID5 Id
  • MediaMath ID
  • 모바일 광고 ID
  • 전화번호
  • 해시된 전화 (플러스 없음)
  • 플랫폼 ID
  • SHA256 해싱 ID
  • SHA256 전화번호
  • ZIP+5 코드
  • ZIP+4 코드
  • LUID
  • 개인 ID
• 식별자 목록
  • 해시 처리된 이메일(점 없음)
  • 해시된 폰(플러스 없음)
  • {해시된_이메일}
  • 해시된 전화번호
  • 이메일
  • 전화번호
  • ID5 Ids
  • MediaMath ID
  • 모바일 광고 ID
  • IDFAs
  • Android ID
  • IP 주소
• 부울리언
• 날짜와 시간:
  • 날짜 시간
  • 날짜
• DMA
  • ad_personalization_enabled
  • ad_user_data_enabled
  • EU DMA 적용
• 숫자
  • double
  • 번호 목록
  • 롱 링크
  • 숫자
• 텍스트
  • 텍스트
  • app_id
  • 텍스트 목록

식별자 vs. 식별자 목록

식별자 유형은 행당 하나의 가치 저장합니다(예: 행당 하나의 이메일 또는 하나의 CUID). 식별자 유형 목록은 행당 값 배열을 저장합니다(예: 단일 행에 여러 개의 해시된 이메일 또는 장치 ID가 포함될 수 있음). 소스 에서 레코드당 둘 이상의 식별자를 일치시켜야 하는 경우에 사용합니다.

소스 필드 다시 로드

데이터 파일 중 하나의 구성이 변경된 경우, 소스 파일을 업데이트하여 변경 사항을 반영할 수 있습니다.

파일에서 업데이트된 필드를 다시 로드하려면 다음 단계를 따르세요.

1. 필드 새로고침을 클릭하세요.
2. 파일 위치를 선택하세요.
   • 로컬 파일의 경우: 파일을 업로드하세요.
   • 클라우드 서비스의 파일을 보려면: "클라우드 버킷에서 로드"를 클릭하고 지침을 따르세요.
3. 확인을 클릭하세요. 업데이트된 파일이 이제 표시됩니다. 

3. EU 사용자 포함 여부 확인

• 질문에 대해 '예' 또는 '아니오'를 선택하세요. 귀하의 소스에 EU DMA 규정이 적용되는 유럽 사용자가 포함되어 있습니까?

EU 디지털 시장법의 개인정보 보호 규정에 대해 더 알아보기 .

4. 소스 데이터를 테스트합니다

• [선택사항] 을 클릭하여 소스 필드의 형식 또는 유효성 오류를 확인합니다.

5. 소스 저장

• 저장을 클릭하여 소스를 저장합니다.

확인 후 새 소스 가 소스 탭에 추가됩니다.

1. Data Clean Room의 소스 탭으로 이동합니다.
2. 출처 목록에서 편집하려는 소스 위에 마우스를 올리고 편집 아이콘을 클릭 . 행의 맨 끝에 .
3. '소스 편집' 페이지에서 아래에 자세히 설명된 대로 관련 필드를 편집하세요.
4. 저장을 클릭하세요.

소스 이름을 편집하는 방법:

소스 이름을 편집할 때는 다음 명명 규칙을 준수 해야 합니다.

 소스 위치를 편집하는 방법:

1. [소스 편집] 페이지 > [소스 위치] 에서 다른 데이터 연결을 선택하십시오.
2. 관련 위치 정보를 선택하세요.
3. [선택 사항] 소스 를 테스트합니다 .
4. 저장을 클릭하세요.

필드 매핑을 편집합니다.

1. 필드 매핑으로 이동하여 필요한 변경 사항을 적용하세요. 필드를 변경하거나 매핑된 DCP 필드를 업데이트합니다.
2. 저장을 클릭하세요.

청중에게 공개된 자료를 제외하고는 모든 소스 삭제할 수 있습니다. 이 경우, 알림에는 해당 소스 사용하는 오디언스 명시됩니다. 소스 를 삭제하려면 먼저 해당 소스에 연결된 잠재고객을 삭제해야 합니다. 공유받은 자료는 소스 소유자만이 삭제할 수 있습니다.

1. Data Clean Room의 소스 탭으로 이동합니다.
2. 소스 목록에서 삭제하려는 소스 행 위로 마우스를 가져갑니다.
3. 삭제 아이콘을 클릭하세요 행의 오른쪽에 표시됩니다.
4. 대화 상자에서 삭제를 클릭 확인합니다.

일반적으로 앱스플라이어가 소스 생성 프로세스의 일부로 필요한 폴더 구조를 자동으로 생성하도록 허용하는 것이 가장 쉽습니다. 그러나 이러한 폴더를 수동으로 만들려면 다음과 같이 해야 할 수 있습니다.

DCR 키 폴더 만들기

최대 보안을 보장하려면 버킷 바로 아래에 있는 폴더("DCR 키 폴더")의 이름을 계정에 할당된 8자의 영숫자 DCR 키(예: 01bcc5fb01bcc5fb01bcc5fb )로 지정해야 합니다. 이는 AppsFlyer 계정과 연결된 다른 비밀번호 또는 키와는 다릅니다.

DCR 키 폴더는 일반적으로 선택한 클라우드 서비스의 인터페이스를 사용하여 수동으로 생성합니다.

계정의 DCR 키를 받으려면 다음 단계를 따르세요.

• 오른쪽 상단의 점 3개(작업) 메뉴를 클릭하고 DCR 키를 선택하세요.

DCR 키 폴더를 생성한 후 버킷/폴더는 다음과 같은 구조를 가져야 합니다.

최상위 입력 폴더

필수 사항은 아니지만 가장 좋은 방법은 DCR 키 폴더 바로 아래에 최상위 입력 폴더를 만드는 것입니다. 이 폴더는 DCR에 업로드하는 파일을 위한 전용 폴더입니다.

최상위 입력 폴더는 일반적으로 선택한 클라우드 서비스의 인터페이스를 사용하여 수동으로 생성합니다.

• 이 방법은 데이터 파일 업로드(입력) 및 보고서 수신(출력)에 동일한 버킷을 사용하는 경우 더욱 강력히 권장됩니다.
• DCR 이름 지정 요구 사항을 준수하는 조건에서는 이 폴더의 이름을 원하는 대로 지정할 수 있습니다. 쉽게 식별할 수 있도록 일반적으로 이름을 input/로 명명합니다.

최상위 입력 폴더를 만든 후 버킷/폴더는 다음과 같은 구조를 가질 수 있습니다.

각 데이터 소스의 두 번째 수준 폴더

다양한 데이터 소스 파일을 정기적으로 DCR에 업로드하여 처리할 수 있습니다. 이러한 각 데이터 소스에는 별도의 폴더("데이터 소스 폴더")가 할당되어야 합니다.

예를 들어, 매일 DCR에 처리할 파일 2개를 업로드할 계획이라면 다음과 같습니다. BI-data.csv 그리고 CRM-data.gzip과 같은 파일 이름을 지정하면, 각 데이터 소스에 폴더를 할당할 수 있습니다. 이 폴더들에 원하는 이름을 붙일 수 있습니다.BI-data/ 그리고CRM-data/ .

데이터 소스 폴더는 일반적으로 선택한 클라우드 서비스의 인터페이스를 사용하여 수동으로 생성합니다.

2개의 데이터 소스 폴더를 생성한 후 버킷/폴더는 다음과 같은 구조를 가질 수 있습니다.

각 데이터 소스 폴더에서 소스가 업데이트될 때마다 날짜 및 버전별로 중첩된 하위 폴더를 만들어야 합니다.

구글 은 디지털 시장법(DMA) 시행의 일환으로 2024년 3월 6일부로 EU 사용자 동의 정책을 업데이트했습니다. Google 앱 어트리뷰션 파트너인 앱스플라이어는 광고주가 Google Ads 마케팅 채널에서 가치를 극대화할 수 있도록 지원하며, Google의 정책 요구사항을 충족하기 위한 필요한 변경을 진행하고 있습니다. 

동의 입력란 추가

구글 에서 잠재고객 활성화를 위한 소스 설정하고 "귀하의 소스 EU DMA 규정의 적용을 받는 유럽 사용자가 포함됩니까?"라는 질문에 "예" 라고 답할 경우, 아래 표 에 있는 추가 동의 필드가 소스 파일에 포함되어 있는지 확인하십시오. 이를 통해 앱스플라이어 활성화 과정 중에 필요한 정보를 구글 에 전송할 수 있습니다.

추가 동의 항목 및 응답 값:

시청자 규모에 미칠 수 있는 잠재적 영향

구글 에 전송되는 실제 및 예상 잠재고객 규모는 동의 여부를 결정하는 사용자 수에 따라 달라질 수 있습니다.