Amazon S3 인바운드 데이터 파일의 이름 및 파일 크기 요구 사항

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

노트

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

파일 이름 구문

S3 파일 이름에는 다음과 같은 필수 요소와 선택 사항이 포함됩니다.

  • S3접두사로 인해 영구적으로 지정되는 Mbox 매개 변수입니다: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

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

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

노트

Audience Manager 파일 ASCII 과 UTF-8 인코딩된 파일만 처리합니다.

요소 이름 지정

이 표에서는 S3 파일 이름의 요소를 정의합니다.

이름 요소 설명

AWS_directory

Amazon S3 버킷의 경로 및 이름입니다. S3 디렉토리 이름, 경로 및 자격 증명이 필요하면 계정 관리자에게 문의하십시오.

date=yyyy-mm-dd

파일을 S3 버킷으로 보낼 때의 타임스탬프(UTC 시간 기준)입니다.

DPID

데이터 파일에 사용자 ID, Android ID, iOS ID 또는 전역 데이터 소스에 속하는 다른 ID가 포함된 경우 Audience Manager을 알리는 D입니다. 다음 옵션을 적용합니다.

  • 데이터 소스 ID(데이터 공급자 ID라고도 함): Audience Manager이 데이터 소스에 할당하는 고유한 ID입니다(ID의 Audience Manager 인덱스 참조 ). 자신의 사용자 ID가 포함된 데이터를 보낼 때 파일 이름에 이 할당된 ID를 사용합니다. 예를 들어 ...ftp_dpm_21_123456789.sync Audience Manager에게 데이터 소스 21에 속하는 ID에 데이터를 게시하도록 지시합니다.
  • Android ID(GAID): Android ID가 포함되어 있는 경우 데이터 파일 이름에 ID 20914를 사용합니다. Android ID를 사용할 때는 _DPID_TARGET_DATA_OWNER 필드를 사용해야 합니다. 예를 들어 ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync Audience Manager에게 데이터 파일에 Android ID만 포함되며 ID는 _DPID_TARGET_DATA_OWNER 데이터 소스에 속하는 트레이트에 대한 자격이 있어야 한다고 알려줍니다.
  • iOS ID(IDFA): iOS ID가 포함된 경우 데이터 파일 이름에 ID 20915를 사용합니다. iOS ID를 사용할 때는 _DPID_TARGET_DATA_OWNER 필드를 사용해야 합니다. 예를 들어 ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync Audience Manager에게 데이터 파일에 iOS ID만 포함되며 ID는 _DPID_TARGET_DATA_OWNER 데이터 소스에 속하는 트레이트에 적합해야 한다고 지시합니다.
  • 다른 글로벌 데이터 소스에 속하는 ID:RIDA(Advertising), Microsoft Advertising ID(WIDER) 및 기타 ID를 위한 Roku ID를 등록할 수 있습니다. 글로벌 데이터 소스 문서에 설명된 대로 각 데이터 소스에 해당하는 ID를 사용합니다.

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

_DPID_TARGET_DATA_OWNER

이 필드는 데이터를 온보드 소스로 사용할 데이터 소스를 Audience Manager에 알려줍니다. DPID를 Android ID 또는 iOS ID 또는 글로벌 데이터 소스에 속하는 다른 ID로 설정하는 경우 이 필드는 필수입니다. 이렇게 하면 Audience Manager 파일 데이터를 조직에 다시 연결할 수 있습니다.

예:

  • ...ftp_dpm_33_21_1234567890.sync 데이터 소스 21에 속하는 트레이트 또는 신호에 대해 데이터 소스 33에 속하는 고객 ID를 적격한 것으로 Audience Manager에 알립니다.
  • GAID(Android ID): ...ftp_dpm_20914_21_1234567890.sync Audience Manager에게 데이터 파일에 Android ID 만 포함되어 있으며 ID는 데이터 소스 21에 속하는 트레이트를 사용할 수 있어야 한다고 알려줍니다.
  • iOS ID(IDFA): ...ftp_dpm_20915_21_1234567890.sync Audience Manager에게 데이터 파일에 iOS ID 만 있으며 ID는 데이터 소스 21에 속하는 트레이트를 사용할 수 있는 자격이 있음을 알립니다.
  • 다른 글로벌 데이터 소스에 속하는 ID: ...ftp_dpm_121963_21_1234567890.sync 대상 관리자에게 데이터 파일 에 Roku ID만 있고 ID는 데이터 소스 21에 속하는 트레이트를 사용할 수 있어야 한다고 알립니다. 글로벌 데이터 소스 문서에 설명된 대로 각 데이터 소스에 해당하는 ID를 사용합니다.

partner_name

Audience Manager에서 사용하는 회사 또는 조직 이름입니다.

TIMESTAMP

10자리 UTC UNIX 타임스탬프(초)입니다. 타임스탬프는 각 파일 이름을 고유하게 만드는 데 도움이 됩니다.

(.sync|.overwrite)

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

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

[SPLIT_NUMBER]

정수입니다. 대용량 파일을 여러 부분으로 분할할 때 사용하여 처리 시간을 개선합니다. 숫자는 원본 파일을 어느 부분으로 전송하는지를 나타냅니다.

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

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

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

[.gz]

Amazon S3로 파일을 보낼 때는 gzip 압축만 사용하십시오. 압축되면 이러한 파일은 .gz 확장명을 가져옵니다. .zip 압축을 사용하지 마십시오.

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

파일 이름 예

다음 예는 올바른 형식의 파일 이름을 보여 줍니다. 파일 이름이 유사할 수 있습니다.

  • 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

추가 예를 원할 경우 [샘플 파일을 다운로드] (assets/ftp_dpm_1234_1445374061.overwrite)할 수 있습니다. 이 파일은 .overwrite 파일 확장자로 저장되었습니다. 간단한 텍스트 편집기를 사용하여 엽니다.

허용되는 파일 크기

데이터를 Audience Manager / Amazon S3 디렉토리로 보낼 때 파일 크기를 제한하는 것은 물론 파일을 가장 빠르고 가장 빠른 프로세싱에 대한 아래 수치를 고려하십시오.

파일 형식 최적의 크기 최대 크기
압축

200-300MB

3GB

압축되지 않음

1GB

5GB

노트

인바운드 데이터 유효성 검사 프로세스는 빈 파일을 잘못된 파일로 표시하고 처리하지 않습니다.

줄 길이 제한

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

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now