Audience Optimization 보고서 및 실행 가능 로그 파일을 위한 데이터 파일

데이터 파일에는 노출, 클릭 또는 전환 데이터가 포함됩니다. 형식이 제대로 지정되면 이 데이터를 Audience Manager으로 가져와 Audience Optimization 보고서에서 보고 실행 가능한 로그 파일을 통해 데이터를 사용하여 트레이트를 만들 수 있습니다. 이 섹션의 이러한 사양에 따라 데이터 파일의 형식을 지정합니다.

개요

적절한 이름 및 형식 지정된 데이터 파일을 사용하면 노출, 클릭 또는 전환 데이터를 Audience Optimization 보고서로 가져올 수 있습니다. 이 기능은 통합되지 않은 파트너와 함께 작업하고 해당 보고서 세트에서 해당 데이터 Audience Manager 로 작업하려는 경우 유용합니다. 이 프로세스에서는 노출, 클릭 및 전환 데이터를 위해 개별 파일이 필요합니다. 이러한 이벤트를 하나의 파일로 취합하지 마십시오.

데이터 파일에는 메타데이터 파일이 있어야 합니다. 메타데이터 파일 컨텐츠는 보고서 메뉴에서 읽을 수 있는 관련 레이블과 데이터 파일 정보를 일치시킵니다. 자세한 내용은 메타데이터 파일에 대한 개요 및 매핑을 참조하십시오.

Naming Conventions for Data Files

다음 구문은 형식이 올바른 데이터 파일 이름의 구조를 정의합니다. 기울임꼴은 파일 내용에 따라 변경되는 변수 자리 표시자를 나타냅니다.

구문:

이벤트 유형_yyyyymdd

파일 이름:

  • 이벤트 유형은 노출, 클릭 또는 전환이 포함된 파일을 나타냅니다. 각 이벤트 유형에 대해 별도의 파일을 만듭니다.
  • 밑줄이 이벤트 유형과 연도 날짜 타임스탬프를 구분합니다.
  • 업로드하기 전에 gzip을 사용하여 파일을 압축하고 .gz 파일 확장자와 함께 저장합니다.

이러한 요구 사항이 주어지면 다음과 같은 내용에 따라 데이터 파일의 이름을 지정합니다.

  • 노출 횟수 데이터:
    impressions_yyyymdd.gz
  • 데이터 클릭:
    clicks_yyyymdd.gz
  • 전환 데이터:
    conversions_yyyymdd.gz

Content Format for Data Files

다음 구문은 형식이 올바른 데이터 파일의 콘텐츠 구조를 정의합니다. 기울임꼴은 변수 자리 표시자를 나타내며 실제 데이터 파일의 레이블로 대체됩니다.

구문:

헤더 레이블 1 | 헤더 레이블 2헤더 레이블 n | 버전

파일 내용에서:

  • 머리글 레이블은 아래 표에 표시된 순서대로 표시되어야 합니다. 노출 횟수 및 클릭 수는 동일한 레이블을 사용합니다. 전환 파일에는 추가 헤더가 포함되어 있습니다.

  • 특정 열에 대한 데이터가 없는 경우 해당 필드를 a로 채웁니다 -1.

  • 파일은 버전 번호로 끝나야 합니다 . 현재 버전은 1.1입니다.

  • 파일 헤더와 내용을 인쇄되지 않는 ASCII 001 문자로 구분합니다. ASCII 001을 사용할 수 없는 경우 헤더와 데이터를 탭 구분 기호로 구분합니다. 이는 인쇄되지 않는 문자이므로 위의 구문 예제는 표시 목적으로만 파이프 "|" 를 보여 줍니다.

필드 레이블

아래 표는 데이터 파일에 대한 열 머리글을 나열하고 설명합니다. 헤더는 대소문자를 구분하며 표에 순서가 지정된 대로 표시되어야 합니다. 모든 데이터 유형은 별도로 명시되지 않는 한 정수(INT)입니다.

레이블 설명

타임스탬프

노출, 클릭 또는 전환 이벤트의 UTC 날짜 및 시간입니다. 형식을 yyyy-MM-dd HH:mm:ss 사용합니다.

사용자 ID

데이터 공급자 고유 사용자 ID 또는 DPUUID라고도 하는 사이트 방문자 ID입니다.

광고주 ID

광고주의 데이터 소스 ID 또는 통합 코드.

BU-ID

비즈니스 단위 ID.

캠페인 ID

캠페인 ID.

Creative-ID

광고 ID.

사이트 ID

사이트 ID.

배치-ID

광고 서버의 숫자 배치 ID.

삽입-순서-ID

삽입 순서 ID.

Testic-ID

전술 ID.

세로 ID

업계 수직 또는 카테고리의 ID.

수량

전환 이벤트에서 판매되는 항목 수입니다.

전환 데이터 파일만 해당합니다.

수입

구매 또는 기타 전환 금액 데이터 유형:부동.

전환 데이터 파일만 해당합니다.

기타 데이터

전환 랜딩 페이지의 URL. 데이터 유형: 문자열.

전환 데이터 파일만 해당합니다.

이벤트 유형

전환 유형. 전환과 일치하는지 여부를 나타냅니다. 옵션은 다음과 같습니다.

  • 0: 노출 횟수
  • 1: 클릭
  • -1:특성 없음 또는 알 수 없음

전환 데이터 파일만 해당합니다.

버전

노출, 클릭 또는 전환 데이터 파일의 모든 행 끝에 나타나는 필수 버전 번호입니다. 현재 버전은 1.1입니다.

Delivery Methods for Data Files

노출, 클릭 또는 전환 데이터 파일을 Audience Manager 계정에 대한 Amazon S3 디렉토리로 업로드합니다. 배달/디렉토리 경로, 파일 처리 시간 및 업데이트에 대한 자세한 내용은 이 섹션을 참조하십시오.

중요

Audience Manager 컨설턴트나 고객 지원 센터에 문의하여 데이터 파일에 대한 Amazon S3 디렉토리를 설정하십시오.

배달 경로 구문 및 예

데이터는 Amazon S3 디렉토리의 각 고객에 대한 별도의 네임스페이스에 저장됩니다. 파일 경로는 아래에 표시된 구문을 따릅니다. Note, italics indicates a variable placeholder. 다른 요소는 상수 또는 키이며 변경되지 않습니다.

구문:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ file type_yyyymmdd

다음 표에서는 파일 배달 경로에서 이러한 각 요소를 정의합니다.

파일 매개 변수 설명

.../log_ingestion/

디렉토리 저장소 경로의 시작입니다. 모든 것이 설정되면 전체 경로를 받게 됩니다.

pid=AAM ID

이 키-값 쌍에는 Audience Manager 고객 ID가 포함되어 있습니다.

dpid=d_src

이 키-값 쌍은 이벤트 호출에서 전달된 데이터 소스 ID를 포함합니다. 이 데이터는 해당 기관의 데이터를 식별하고 지원 메타데이터 파일에 연결합니다.

logs

데이터 파일에 대한 상위 수준 디렉토리

file type_yyyymmdd

포함된 데이터 유형과 배달 타임스탬프를 나타내는 파일 형식 이름입니다.

샘플 업로드 경로 및 파일 이름

파일을 업로드할 때 경로는 다음과 비슷합니다.

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

파일 처리 시간 및 업데이트

데이터 파일은 정기적으로 하루에 4번 처리됩니다.

데이터를 업데이트하려면 특정 날짜에 대한 모든 노출, 클릭 또는 전환이 포함된 파일을 전송합니다. 이 경우 한 날은 한 자정부터 다음 자정까지 24시간 기간입니다. UTC 시간을 사용하여 날짜 간격을 정의하는 것이 좋습니다.

다음 단계

메타데이터 파일 이름 지정 및 만들기에 대한 요구 사항을 검토하십시오. 시작하려면 메타데이터 파일에 대한 개요 및 매핑을 참조하십시오.

이 페이지에서는