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에 지시하는 ID입니다. 다음 옵션을 허용합니다.

  • 데이터 소스 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(Roku ID for Advertising), Microsoft Advertising ID(WIDER) 및 기타 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 는 Audience Manager에게 데이터 소스 21에 속하는 트레이트 또는 신호에 대해 데이터 소스 33에 속하는 고객 ID에 자격을 부여하는 것을 알려줍니다.
  • Android ID(GAID): ...ftp_dpm_20914_21_1234567890.sync 데이터 파일에 Android ID 만 포함되어 있으며 ID는 데이터 소스 21에 속하는 트레이트에 대한 자격이 있어야 함을 Audience Manager에 알려줍니다.
  • 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에 속하는 트레이트에 대한 자격이 있어야 함을 Audience Manager에 알려줍니다. 글로벌 데이터 소스 문서에 설명된 대로 각 데이터 소스에 해당하는 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이 대용량 파일을 처리할 수 있지만 파일 크기를 줄이고 데이터 전송을 보다 효율적으로 수행할 수 있습니다. 인바운드 데이터 전송 파일에 대한 파일 압축을 참조하십시오.

파일 이름 예

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

  • 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바이트입니다. 이 제한을 초과하는 라인은 이전에서 제외됩니다.

관련 글

이 페이지에서는