Customer Data Feeds

Customer Data Feed (CDF) 파일에 대한 기본 정보 및 시작 방법에 대한 지침입니다. CDF 파일을 받거나 추가 정보를 원할 경우 여기에서 시작합니다.

파일 내용 및 목적

CDF 파일에는 Audience Manager 이벤트 호출(/event)이 서버에 보내는 것과 동일한 데이터가 포함되어 있습니다. 여기에는 사용자 ID, trait IDs, segment IDs 및 이벤트 호출에서 캡처한 다른 모든 매개 변수와 같은 데이터가 포함됩니다. 내부 Audience Manager 시스템은 이벤트 데이터를 CDF 파일로 처리하며 컨텐츠는 설정된 순서로 표시되는 필드로 구성됩니다. Audience Manager 시마다 CDF 파일을 생성하여 Amazon S3 서버의 안전한 고객별 버킷에 저장합니다. Adobe는 이러한 파일을 제공하므로 사용자 인터페이스가 지정한 제한 범위 밖의 Audience Manager 데이터로 작업할 수 있습니다.

시작하기

CDF 파일 배달을 시작하는 셀프 서비스 프로세스가 없습니다. 시작하려면 Audience Manager 컨설턴트 또는 고객 지원 센터에 문의하십시오. 구현 중에 Audience Manager 담당자가 다음을 수행합니다.

• Amazon S3 저장소 버킷을 설정합니다.
• 파일 저장소 버킷에 읽기 전용 S3 인증 자격 증명을 제공합니다. 다른 고객에 속한 디렉토리와 파일은 보거나 액세스할 수 없습니다.

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

다음 단계

아래 섹션 및 고객 데이터 피드 FAQ에서 이 서비스에 대해 더욱 잘 알고 있도록 도움을 줄 수 있습니다.

Customer Data Feed 정의된 콘텐츠

모양별 순서로 CDF 파일의 데이터 요소와 배열을 나열하고 정의합니다. 정의는 데이터 형식을 포함하지만 이 정보는 CDF 파일의 일부가 아닙니다.

정의

CDF 파일에는 아래에 정의된 일부 또는 전체 필드가 포함되어 있습니다. 내부 파일 조직에 대한 자세한 내용은 고객 데이터 피드 파일 구조를 참조하십시오.

Customer Data Feed 파일 구조

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

데이터 필드 식별자 및 시퀀스

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

CDF 파일 맵

CDF 파일 데이터는 아래에 표시된 순서대로 나타납니다.

스토리지 식별

CDF 파일의 배열은 Ctrl + a 필드 구분 문자로 시작하고 끝납니다. 이렇게 하면 배열의 첫 번째 요소가 독립형 데이터 필드와 같이 표시됩니다. 예를 들어 실현 traits 배열은 ^A1234로 시작합니다. 배열 구분 기호와 ID ^B5678는 이 항목을 따릅니다. 따라서 실현된 traits 배열의 첫 번째 요소가 ID 5678(이 요소가 ^B로 시작됨)이라고 생각할 수 있습니다. 이러한 경우가 아니므로 데이터 파일의 순서와 구조에 익숙해야 합니다. 실현된 trait 배열(또는 CDF 파일의 다른 배열)의 첫 번째 요소가 ^A로 시작되더라도 파일의 모양 또는 위치 순서는 배열의 시작을 정의합니다. 그리고 배열의 첫 번째 요소는 항상 이전 항목과 ^A로 구분됩니다.

샘플 CDF 파일

샘플 CDF 파일은 다음과 유사할 수 있습니다. 이 예제에 줄바꿈을 삽입하여 페이지에 맞출 수 있도록 했습니다.

Customer Data Feed 파일 이름 지정 규칙

아래 섹션을 참조하여 CDF 파일 이름의 요소를 정의합니다.

CDF 파일 이름:구문 및 예

일반적인 CDF 파일 이름에는 아래 나열된 요소가 포함됩니다. 참고: 기울임체​는 변수 자리 표시자를 나타냅니다.

구문

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF-PARTNER-ID-AAM PROCESS-ID_0.gz

예

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

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

CDF 정의된 파일 이름 요소

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

Customer Data Feed 파일 처리 알림

Audience Manager 다운로드 준비가 되면 알 수 있도록 .info 파일을 S3 디렉토리 Customer Data File 에 CDF기록합니다. .info 파일에는 CDF 파일의 내용에 대한 JSON 형식 메타데이터도 포함되어 있습니다. 이 알림 파일에 사용되는 구문 및 필드에 대한 자세한 내용은 이 섹션을 검토하십시오.

샘플 정보 파일

각 .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
    }
}

정보 파일 필드 정의

다음 표 목록을 표시하고 CDF .info 파일의 요소를 정의합니다.

파일 개체

합계 개체

Customer Data Feed 파일 이름 시간 및 파일 컨텐츠 시간이 다릅니다.

CDF 파일에 파일 이름 및 파일 내용에 타임스탬프가 포함되어 있습니다. 이러한 타임스탬프는 동일한 CDF 파일에 대해 다른 이벤트 프로세스를 기록합니다. 동일한 파일의 이름과 내용에 서로 다른 타임스탬프가 표시되는 것은 일반적이지 않습니다. 각 타임스탬프를 이해하면 이 데이터를 사용하여 작업하거나 시간별로 정렬하려고 할 때 일반적인 실수를 방지할 수 있습니다.

CDF 파일 타임스탬프 찾기

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

타임스탬프 간의 차이 이해

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