설명서Audience ManagerAudience Manager 사용 안내서

Audience Optimization 보고서 및 실행 가능 로그 파일을 위한 데이터 파일 data-files-for-audience-optimization-reports

Last update: Sun May 21 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

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

개요 overview

이름이 적절하고 형식이 지정된 데이터 파일을 사용하면 노출, 클릭 또는 변환 데이터를 Audience Optimization 보고서. 이 기능은 와 통합되지 않은 파트너와 작업할 때 유용합니다. Audience Manager 그리고 해당 보고서 세트에서 해당 데이터를 사용하여 작업할 수 있습니다. 이 프로세스에는 노출, 클릭 및 전환 데이터에 대해 별도의 파일이 필요합니다. 이러한 이벤트를 단일 파일에서 혼합하지 마십시오.

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

데이터 파일에 대한 이름 지정 규칙 naming-conventions

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

구문:

이벤트 유형_yyyymmdd

파일 이름:

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

이러한 요구 사항이 주어지면 다음과 같이 해당 콘텐츠를 기반으로 데이터 파일의 이름을 지정합니다.

  • 노출 데이터: 
    노출 횟수_yyyymmdd.gz
  • 데이터 클릭: 
    클릭수_yyyymmdd.gz
  • 전환 데이터: 
    전환_yyyymmdd.gz

데이터 파일에 대한 컨텐츠 형식 content-format

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

구문:

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

파일 내용:

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

  • 특정 열에 대한 데이터가 없는 경우 해당 필드를 -1.

  • 파일 필수 버전 번호로 종료합니다. 현재 버전은 1.1입니다.

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

필드 레이블

아래 표에는 데이터 파일의 열 헤더가 나열되고 설명되어 있습니다. 헤더는 대/소문자를 구분하므로 표에 정렬된 대로 표시되어야 합니다. 달리 지정하지 않는 한 모든 데이터 유형은 정수(INT)입니다.

레이블
설명
타임스탬프
노출, 클릭 또는 전환 이벤트에 대한 UTC 날짜 및 시간입니다. 사용 yyyy-MM-dd HH:mm:ss 포맷.
User-ID
사이트 방문자에 대한 ID(이라고도 함) 데이터 공급자 고유 사용자 ID 또는 DPUUID
광고주 ID
광고주용 데이터 소스 ID 또는 통합 코드.
BU-ID
사업부 ID.
캠페인 ID
캠페인 ID.
크리에이티브 ID
광고 ID.
Site-ID
사이트 ID.
Placement-ID
광고 서버의 숫자 배치 ID.
Insertion-Order-ID
삽입 순서 ID.
Tactic-ID
전술 ID.
세로 ID
업계 카테고리 또는 카테고리에 대한 ID.
수량

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

변환 데이터 파일에만 사용할 수 있습니다.

수입

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

변환 데이터 파일에만 사용할 수 있습니다.

기타 데이터

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

변환 데이터 파일에만 사용할 수 있습니다.

Event-Type

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

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

변환 데이터 파일에만 사용할 수 있습니다.

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

데이터 파일에 대한 전달 방법 delivery-methods

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

IMPORTANT
을(를) 시작하고 설정하려면 Audience Manager 컨설턴트나 고객 지원에 문의하십시오. Amazon S3 데이터 파일에 대한 디렉터리입니다.

게재 경로 구문 및 예

데이터는 의 각 고객을 위한 별도의 네임스페이스에 저장됩니다. Amazon S3 디렉토리. 파일 경로는 아래에 표시된 구문을 따릅니다. 참고, 기울임체 변수 자리 표시자를 나타냅니다. 다른 요소는 상수 또는 키이며 변경되지 않습니다.

구문:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 파일 유형_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

파일 처리 시간 및 업데이트

데이터 파일은 하루에 네 번 일정한 간격으로 처리됩니다.

데이터를 업데이트하려면 특정 날짜의 모든 노출 횟수, 클릭 수 또는 변환 수가 포함된 파일을 보내십시오. 이 경우 하루는 자정부터 다음 시간까지 24시간 동안 지속됩니다. 가장 좋은 방법은 UTC 시간을 사용하여 일 간격을 정의하는 것입니다.

다음 단계 next-steps

메타데이터 파일 이름 지정 및 생성에 대한 요구 사항을 검토합니다. 시작하려면 다음을 참조하십시오. 메타데이터 파일에 대한 개요 및 매핑.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695