Customer Data Feeds customer-data-feeds

다음에 대한 기본 정보: Customer Data Feed (CDF) 파일 및 시작 방법에 대한 지침을 제공합니다. 수신에 관심이 있는 경우 여기에서 시작하십시오. CDF 파일 또는 추가 정보만 필요합니다.

파일 내용 및 목적 file-contents-purpose

CDF 파일에는 Audience Manager 이벤트 호출(/event)이 서버에 보내는 것과 동일한 데이터가 포함되어 있습니다. 여기에는 사용자 ID, trait IDs, segment IDs및 이벤트 호출로 캡처된 다른 모든 매개 변수. 내부 Audience Manager 시스템은 이벤트 데이터를 CDF 콘텐츠가 설정된 순서로 표시되는 필드로 구성된 파일입니다. Audience Manager 생성 시도 CDF 는 시간별로 파일을 만들어 의 안전한 고객별 버킷에 저장합니다 Amazon S3 서버입니다. 다음 작업을 수행할 수 있도록 이 파일을 제공합니다. Audience Manager 사용자 인터페이스가 부과한 제한을 벗어난 데이터입니다.

시작하기 getting-started

시작할 셀프 서비스 프로세스가 없습니다. CDF 파일 전달. 다음으로 연락 Audience Manager 시작하려면 컨설턴트 또는 고객 지원 팀에서 확인하십시오. 구현 중에 Audience Manager 담당자는 다음을 수행합니다.

파일 알림 및 CDF 에 파일이 표시됩니다. S3 다운로드 준비가 되면 버킷으로 이동합니다. 할당된 파일을 모니터링하고 다운로드할 책임이 있습니다. S3 디렉토리. 고객 데이터 피드 파일 처리 알림을 참조하십시오.

다음 단계 next-steps

아래 섹션 및 고객 데이터 피드 FAQ 이 서비스에 대해 더 잘 알게 될 수 있습니다.

Customer Data Feed 정의된 콘텐츠 cdf-defined

의 데이터 요소와 배열을 나열하고 정의합니다. CDF 파일(모양 순서대로). 정의에는 데이터 유형이 포함되지만 이 정보는 CDF 파일.

정의 definitions

A CDF 파일에는 아래에 정의된 일부 또는 모든 필드가 포함되어 있습니다. 내부 파일 조직에 대한 자세한 내용은 고객 데이터 피드 파일 구조.

Customer Data Feed 파일 구조 cdf-file-structure

의 데이터 구조를 나열하고 정의합니다. CDF 파일. 여기에는 데이터 시퀀스, 필드 구분 기호 및 구분 기호, 데이터 파일 맵 및 샘플 파일이 포함됩니다.

데이터 필드 식별자 및 시퀀스 identifiers-and-sequence

CDF 파일에 레이블이 지정된 열 또는 필드 헤더가 포함되어 있지 않습니다. 대신, CDF 파일은 인쇄되지 않는 필드 및 배열을 정의합니다. ASCII 자. 또한 CDF 파일은 각 필드와 배열을 특정 순서로 나열합니다. 필드 식별자 및 순서를 이해하면 파일을 올바르게 구문 분석하는 데 도움이 됩니다.

CDF 파일 맵 cdf-file-map

CDF 파일 데이터는 아래 표시된 순서로 표시됩니다.

배열 식별

의 배열 CDF 파일 시작 및 종료 Ctrl + a 필드 구분 기호입니다. 이렇게 하면 배열의 첫 번째 요소가 독립 실행형 데이터 필드처럼 표시됩니다. 예를 들어 는 traits 배열 시작 문자 ^A1234. 배열 구분 기호 및 ID ^B5678 이 항목을 따릅니다. 그 결과, 실현된 첫 번째 요소라고 생각하고 싶은 유혹을 느낄 수 있다 traits 배열은 ID 5678입니다(다음으로 시작하므로). ^B). 그렇지 않으므로 데이터 파일의 시퀀스 및 구조에 익숙해야 합니다. 비록 첫 번째 요소가 실현되었을지라도 trait 배열(또는 의 다른 배열) CDF 파일) 시작 문자 ^A파일의 모양 또는 위치 순서는 배열의 시작을 정의합니다. 그리고 배열의 첫 번째 요소는 항상 다음 방법으로 이전 항목과 분리됩니다. ^A.

샘플 CDF 파일 sample-file

샘플 CDF 파일은 다음과 비슷합니다. 페이지에 맞게 하기 위해 이 예제에 줄바꿈을 삽입했습니다.

Customer Data Feed 파일 이름 지정 규칙 cdf-naming-conventions

아래 섹션에서는 의 요소를 나열하고 정의합니다 CDF 파일 이름.

CDF 파일 이름: 구문 및 예제 cdf-file-name

일반 CDF 파일 이름에는 아래 나열된 요소가 포함되어 있습니다. 참고, 기울임체 변수 자리 표시자를 나타냅니다.

구문

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz

예

s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_0_0_0.gz

내 S3 저장소 버킷, 파일은 파트너 ID( )별로 오름차순으로 정렬됩니다.PID), 일 및 시간.

CDF 정의된 파일 이름 요소 cdf-file-name-elements

다음 표는 의 요소를 나열하고 정의합니다. CDF 파일 이름.

Customer Data Feed 파일 처리 알림 cdf-file-processing-notifications

Audience Manager 쓰기: .info 파일을 S3 다음 경우에 알려 주는 디렉토리 Customer Data File (CDF)을(를) 다운로드할 준비가 되었습니다. 다음 .info 파일에는 다음 항목도 포함됩니다 JSON 의 콘텐츠에 대한 서식 있는 메타데이터 CDF 파일. 이 알림 파일에서 사용하는 구문과 필드에 대한 정보는 이 섹션을 검토하십시오.

샘플 정보 파일 sample-info-file

각 .info 파일에 Files 및 Totals 섹션. 다음 Files 섹션에는 각 시간별 파일에 대한 특정 지표를 저장하는 배열이 포함되어 있습니다. 다음 Totals 섹션에는 모든 항목에서 집계된 지표가 포함됩니다. CDF 특정 날짜의 파일입니다. 의 콘텐츠 .info 파일은 다음 예제와 유사할 수 있습니다.

{
    "Files": [
        {
            "FileByteSize": 2709730,
            "FileChecksumMD5": "a9ea418e79511642cff11c2a898037dc-1",
            "FileName": "AAM_CDF_1109_000000_0.gz",
            "FileSequenceNumber": 1
        },
        {
            "FileByteSize": 2783351,
            "FileChecksumMD5": "7b469485d60274b6991acd0817855840-3",
            "FileName": "AAM_CDF_1109_000001_0.gz",
            "FileSequenceNumber": 2
        }
    ],
    "Totals": {
        "Day": "2017-09-26",
        "Hour": "18",
        "TotalByteSize": 150092997,
        "TotalNumberFiles": 2
    }
}

정의된 정보 파일 필드 info-file-fields-defined

다음 표는 의 요소를 나열하고 정의합니다 CDF .info 파일.

Files 개체

Totals 객체

Customer Data Feed 파일 이름 시간과 파일 컨텐츠 시간이 다릅니다. different-processing-times

사용자 CDF 파일에는 파일 이름과 파일 내용에 타임스탬프가 들어 있습니다. 이러한 타임스탬프는 동일한 이벤트에 대해 서로 다른 이벤트 프로세스를 기록합니다 CDF 파일. 동일한 파일의 이름과 내용에서 서로 다른 타임스탬프를 보는 것은 드문 일이 아닙니다. 각 타임스탬프를 이해하면 이 데이터로 작업하거나 시간별로 정렬하려고 할 때 발생하는 일반적인 실수를 방지하는 데 도움이 됩니다.

찾기 CDF 파일 타임스탬프 locating-timestamps

CDF 파일은 두 개의 서로 다른 위치에 시간을 다르게 기록합니다.

타임스탬프 간 차이점 이해 understanding-timestamps

다음 표는 다음에 대한 추가 세부 정보를 제공합니다. CDF 타임스탬프를 적절하게 사용하는 방법에 대한 정보와 함께 파일입니다.