Show Menu
화제×

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
DPID( 데이터 공급자 ID )는 데이터 파일에 사용자 ID나 Android 또는 iOS ID가 포함되어 있는지 Audience Manager을 알려주는 식별자입니다. 다음 옵션을 수락합니다.
데이터 파트너 ID
회사 또는 조직에 할당하는 고유한 ID Audience Manager입니다. 사용자 ID가 포함된 데이터를 보낼 때 파일 이름에 이 할당된 ID를 사용합니다. 예를 들어, ID 21을 가진 파트너가 파일을 전송했으며 해당 파트너가 할당한 사용자 ID를 포함하고 있다고 Audience Manager에 ...ftp_dpm_21_123456789.sync 알려줍니다.
Android ID(GAID)
파일에 Android ID가 포함된 경우 데이터 파일 이름에 DPID로 ID 20914를 사용하십시오. ID 20914를 DPID로 사용하는 경우 여전히 Audience Manager 을 위해 회사를 식별해야 합니다. 즉, 파일 이름은 _DPID_TARGET_DATA_OWNER 매개 변수를 사용하여 회사 ID를 보유해야 합니다. 예를 들어 Android ID가 있는 파일을 전달하면 데이터 공급자 ID가 21이 됩니다. 이 경우 파일 이름은 다음과 같습니다 ...ftp_dpm_20914_21_123456789.sync . 이 ID는 Audience Manager 파일에 Android ID가 포함되어 있고 ID 21로 식별된 파트너의 파일임을 나타냅니다.
iOS ID(IDFA)
파일에 iOS ID가 포함된 경우 데이터 파일 이름에 DPID로 ID 20915를 사용하십시오. ID 20915를 DPID로 사용하는 경우 여전히 Audience Manager 을 위해 회사를 식별해야 합니다. 즉, 파일 이름은 _DPID_TARGET_DATA_OWNER 매개 변수를 사용하여 회사 ID를 보유해야 합니다. 예를 들어 Android ID가 있는 파일을 전달하면 데이터 공급자 ID가 21이 됩니다. 이 경우 파일 이름은 다음과 같습니다 ...ftp_dpm_20915_21_123456789.sync . 그러면 파일이 iOS ID를 포함하고 ID 21로 식별된 파트너의 파일임을 Audience Manager에 알려줍니다 .
참고: 데이터 파일에 ID 유형을 혼합하지 마십시오. 예를 들어 파일 이름에 Android 식별자가 포함된 경우 iOS ID나 자신의 ID를 데이터 파일에 넣지 마십시오.
자세한 내용은 글로벌 데이터 소스 를 참조하십시오.
아래 _DPID_TARGET_DATA_OWNER 항목도 참조하십시오.
_DPID_TARGET_DATA_OWNER
ID의 자리 표시자 예를 들어 DPID를 데이터 소스 ID 또는 Android 또는 iOS ID로 설정하는 경우 Audience Manager ID로 설정할 수 있습니다. 이렇게 하면 Audience Manager 에서 파일 데이터를 조직에 다시 연결할 수 있습니다.
예:
  • ...ftp_dpm_33_21_1234567890.sync ID 21이 있는 파트너가 ID 33을 사용하는 데이터 소스에서 데이터를 보낸 것으로 보여줍니다.
  • ...ftp_dpm_20914_21_1234567890.sync 은 Android ID가 포함된 데이터로 보낸 ID 21의 파트너를 보여줍니다.
  • ...ftp_dpm_20915_21_1234567890.sync 는 iOS ID가 포함된 데이터로 보낸 ID 21의 파트너를 보여줍니다.
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
추가 예를 원할 경우 샘플 파일을 다운로드할 수 있습니다. 이 파일은 파일 확장자와 함께 .overwrite 저장되었습니다. 간단한 텍스트 편집기로 엽니다.

허용되는 파일 크기

파일 처리 속도가 빠르고 빨라진 것은 물론 데이터를 Audience Manager / Amazon S3 디렉토리로 전송할 때는 파일 크기 제한을 고려해야 합니다.
파일 형식 최적 크기 최대 크기
압축
200-300MB
3GB
압축되지 않음
1GB
5GB
인바운드 데이터 유효성 검사 프로세스는 빈 파일을 유효하지 않은 것으로 표시하고 처리하지 않습니다.