인바운드 데이터 파일에 대한 Amazon S3 이름 및 파일 크기 요구 사항 amazon-s-name-and-file-size-requirements-for-inbound-data-files

Audience Manager에 데이터를 보낼 때 따라야 하는 필수 필드, 구문, 이름 지정 규칙 및 파일 크기를 설명합니다. 데이터를 Audience Manager / Amazon S3 디렉터리로 보낼 때 이러한 사양에 따라 파일의 이름과 크기를 설정하십시오.

NOTE
텍스트 스타일(monospaced text, 기울임체, 괄호 [ ] ( ) 등)은 이 문서에서는 코드 요소 및 옵션을 나타냅니다. 자세한 내용은 코드 및 텍스트 요소에 대한 스타일 규칙을 참조하십시오.

파일 이름 구문 file-name-syntax

S3 파일 이름에는 다음과 같은 필수 요소와 선택적 요소가 포함되어 있습니다.

  • S3접두사: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

  • 파일 이름 요소: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

허용되는 다른 파일 이름 형식은 사용자 지정 파트너 통합을 참조하십시오.

NOTE
Audience Manager은(는) ASCII 및 UTF-8개의 인코딩된 파일만 처리합니다.

요소 이름 지정

테이블은 S3 파일 이름의 요소를 정의합니다.

이름 요소
설명
AWS_directory
Amazon S3 버킷의 경로 및 이름입니다. S3 디렉토리 이름, 경로 및 자격 증명은 계정 관리자에게 문의하십시오.
date=yyyy-mm-dd
파일을 S3 버킷으로 보낼 때의 타임스탬프(UTC 시간 기준)입니다.
DPID

데이터 파일에 고유한 Audience Manager ID, Android ID, iOS ID 또는 글로벌 데이터 원본에 속하는 기타 ID가 포함되어 있는지 여부를 사용자에게 알리는 ID입니다. 다음 옵션을 적용합니다.

참고: 데이터 파일에서 ID 유형을 혼합하지 마십시오. 예를 들어 파일 이름에 Android 식별자가 포함된 경우 데이터 파일에 iOS ID 또는 사용자 ID를 추가하지 마십시오.

_DPID_TARGET_DATA_OWNER

이 필드는 데이터를 온보딩할 데이터 소스를 Audience Manager에게 알려줍니다. DPID를 Android ID, iOS ID 또는 글로벌 데이터 소스에 속하는 다른 ID로 설정하는 경우 이 필드는 필수입니다. 이렇게 하면 Audience Manager이 파일 데이터를 다시 조직에 연결할 수 있습니다.
이 대상 데이터 원본은 회사가 소유해야 합니다. 제2자 데이터 공유를 위해 데이터를 다른 회사에 속한 대상 데이터 소스로 수집하려면 회사와 대상 데이터 소스 간에 액세스 매핑이 있어야 합니다. 매핑을 설정하려면 Adobe 컨설턴트나 고객 지원에 문의하십시오.

중요 참고 사항: 기존 데이터 공유 관계(2022년 3월 14일 이전에 데이터를 온보딩한 다른 회사에 속한 대상 데이터 소스의 경우)에 대한 매핑을 요청할 필요가 없습니다. PID에 속하는 대상 데이터 소스에 데이터를 온보딩할 때도 매핑이 필요하지 않습니다.

예:

  • ...ftp_dpm_33_21_1234567890.sync은(는) 데이터 원본 21에 속하는 트레이트 또는 신호에 대해 데이터 원본 33에 속하는 고객 ID를 검증하고 있음을 Audience Manager에게 알려 줍니다.
  • Android ID(GAID): ...ftp_dpm_20914_21_1234567890.sync은(는) 데이터 파일에 Android ID만 포함되어 있으며 ID가 데이터 소스 21에 속하는 트레이트에 적합해야 한다고 Audience Manager에게 알려줍니다.
  • iOS ID(IDFA): ...ftp_dpm_20915_21_1234567890.sync은(는) 데이터 파일에 iOS ID만 포함되어 있으며 ID가 데이터 소스 21에 속하는 트레이트에 적합해야 한다고 Audience Manager에게 알려 줍니다.
  • 다른 전역 데이터 원본에 속하는 ID: ...ftp_dpm_121963_21_1234567890.sync은(는) Audience Manager에게 데이터 파일에 Roku ID만 포함되어 있으며 ID가 데이터 원본 21에 속하는 트레이트에 적합해야 한다고 알립니다. 전역 데이터 원본 문서에 설명된 대로 각 데이터 원본에 해당하는 ID를 사용하십시오.
partner_name
Audience Manager에서 사용하는 회사 또는 조직 이름입니다.
TIMESTAMP
10자리 UTC UNIX 타임스탬프(초). 타임스탬프는 각 파일 이름을 고유하게 만드는 데 도움이 됩니다.
(.sync|.overwrite)

다음을 포함하는 동기화 옵션:

  • sync: 서드파티 데이터 공급자가 Audience Manager 시스템에서 추가하거나 제거할 트레이트를 사용자별로 전송하는 일반적인 시나리오입니다.
  • overwrite: 데이터 공급자가 Audience Manager에 있는 이 데이터 공급자에 대한 이 사용자의 기존 타사 트레이트를 모두 덮어써야 하는 트레이트 목록을 사용자별로 보낼 수 있습니다. 덮어쓰기 파일에 모든 사용자를 포함할 필요는 없습니다. 변경하려는 사용자만 포함합니다.
[SPLIT_NUMBER]

정수. 처리 시간을 향상시키기 위해 큰 파일을 여러 부분으로 분할할 때 사용됩니다. 번호는 보내는 원본 파일의 일부를 나타냅니다.

효율적인 파일 처리를 위해 데이터 파일을 표시된 대로 분할합니다.

  • 압축되지 않음: 1GB
  • 압축: 200-300MB

아래의 처음 2개의 파일 이름 예제를 참조하십시오.

[.gz]

Amazon S3에 파일을 보낼 때 gzip 압축만 사용하십시오. 압축하면 이 파일의 확장명은 .gz입니다. .zip 압축을 사용하지 마십시오.

압축된 파일은 3GB 이하여야 합니다. 파일이 더 큰 경우 고객 지원 센터에 문의하십시오. Audience Manager은 대용량 파일을 처리할 수 있지만 파일 크기를 줄이고 데이터 전송을 보다 효율적으로 수행할 수 있습니다. 인바운드 데이터 전송 파일에 대한 파일 압축을(를) 참조하십시오.

파일 이름 예 file-name-examples

다음 예제에서는 올바른 형식의 파일 이름을 보여 줍니다. 파일 이름이 비슷해 보일 수 있습니다.

  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite

추가 예제를 원하는 경우 샘플 파일을 다운로드할 수 있습니다. 이 파일은 .overwrite 파일 확장명으로 저장되었습니다. 간단한 텍스트 편집기로 엽니다.

허용되는 파일 크기 accepted-file-sizes

데이터를 Audience Manager/Amazon S3 디렉터리로 보낼 때 파일의 가장 빠른/가장 빠른 처리와 파일 크기 제한에 대해 아래 수치를 고려하십시오.

파일 형식
최적 크기
최대 크기
압축
200-300MB
3 GB
압축되지 않음
1 GB
5 GB
NOTE
인바운드 데이터 유효성 검사 프로세스는 빈 파일을 잘못된 것으로 표시하여 처리하지 않습니다.

라인 길이 제한 line-limits

인바운드 데이터 파일의 라인 길이는 102400바이트로 제한됩니다. 이 한도를 초과하는 라인은 전송에서 제외됩니다.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695