Show Menu
화제×

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

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

개요

적절한 이름 및 형식 지정된 데이터 파일을 사용하면 노출, 클릭 또는 전환 데이터를 대상 최적화 보고서로 가져올 수 있습니다 . 이 기능은 통합되지 않은 파트너와 함께 작업하고 해당 보고서 세트에서 해당 데이터 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/ 
				


				파일 유형_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 시간을 사용하여 날짜 간격을 정의하는 것이 좋습니다.

다음 단계

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