DAI 스트림 데이터를 실시간으로 내보내기

이 기능은 알파 기능이며 일부 네트워크에서는 사용하지 못할 수도 있습니다.

이 페이지의 내용

• 로그 전송
• 매니페스트 전송 로그
• 게재된 시점 로그
  • 게재된 시점 로그 구조
    • 광고 상태
    • 슬레이트 상태
• 광고 서버 상호작용 로그
   

동적 광고 삽입(DAI)용 실시간 로그를 사용하면 스트림 수준 데이터를 거의 실시간으로 내보내 게재 문제를 모니터링하고 해결할 수 있습니다. 이 도움말에서는 로그 파일 전송의 사양, 특정 필드, 알려진 문제를 설명합니다.

로그 전송

로그 파일은 약 5분마다 Google Cloud의 게시자별 스토리지 버킷으로 전송됩니다.

버킷 이름: gs://gdai-[NETWORK_CODE]

팁: Google Cloud Storage 버킷에 액세스하는 데 도움이 필요하면 계정팀에 문의하세요. 회사에서 내부적으로 관리하는 Google Workspace의 그룹을 공유하거나 제공되는 그룹을 관리할 수 있는 회사 내 사용자를 지정할 수 있도록 준비하세요.

파일 이름의 형식은 다음과 같습니다.

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

위치:

• Log Type: DAIAdServerInteraction 또는 DAIManifest 또는 DAIServedBreak
• Network Code: Ad Manager 네트워크 코드
• Stream Type: VOD 또는 Linear
• Content ID: VOD용 콘텐츠 소스 ID, 라이브용 애셋 키
• YYMMDD, HHMMSS: 로그 생성 시간(UTC)
• Random Number : 난수

파일이 gzip으로 압축되고 RFC4180을 준수하는 큰따옴표 및 쉼표로 구분된 값으로 데이터가 파일에 포함됩니다. '각 필드를 큰따옴표로 묶을 수도 있고 묶지 않을 수도 있음'을 명시하는 RFC4180의 섹션 2, 포인트 5와 관련하여 로그 파일의 모든 데이터는 큰따옴표로 묶여 있습니다.

파일은 7일 동안 버킷에 남아 있으며 7일이 지나면 삭제됩니다.

참고: 새 출시에 따라 필드가 변경될 수 있습니다. 새 필드가 추가되거나 이전 필드가 삭제되는 경우 클라이언트는 항상 헤더를 기반으로 CSV 파일을 파싱해야 합니다.

매니페스트 전송 로그

이 로그는 동영상 스트림 전송에 대한 정보를 제공합니다. 다음과 같은 필드가 있습니다.

필드**	설명
timestamp INTEGER	요청의 UTC 타임스탬프(Unix 시간 단위)
entry_id STRING	로그 항목의 고유 ID 현재 Google 시스템에는 로그 항목이 두 번 이상 표시될 수 있다는 제한이 있습니다. 이 ID는 항목의 중복을 제거하는 데 사용할 수 있습니다.
stream_id STRING	모든 스트림에 할당된 고유 ID(SAM ID라고도 함)
network_code INTEGER	게시자의 네트워크 코드
콘텐츠 INTEGER	콘텐츠 소스 ID
vid STRING	동영상 ID
asset_key STRING	라이브 스트림의 애셋 키
manifest_type STRING	동영상 매니페스트 유형: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	스트림 유형: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	요청 유형: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA(ID3 이벤트)
beaconing_type STRING	스트림의 광고 비커닝 유형: BEACONING_TYPE_SERVER_TRIGGERED: 서버 측 BEACONING_TYPE_CLIENT_TRIGGERED: 클라이언트 측(IMA SDK) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: 클라이언트 측(DAI API 및 IMA SDK(곧 제공 예정))
http_method STRING	HTTP 요청에 사용된 메서드
user_agent STRING	기기의 사용자 에이전트
response_code INTEGER	HTTP 응답 코드
response_time DOUBLE	요청 지연 시간(초)

게재된 시점 로그

이 로그는 DAI 클라이언트에 게재된 광고 시점에 관한 정보를 제공합니다. 정보가 로그에 표시되는 방식에 대한 자세한 내용 및 예는 게시된 시점 로그 구조를 참고하세요. 

필드**	설명
timestamp INTEGER	요청의 UTC 타임스탬프(Unix 시간 단위)
entry_id STRING	로그 항목의 고유 ID 현재 Google 시스템에는 로그 항목이 두 번 이상 표시될 수 있다는 제한이 있습니다. 이 ID는 항목의 중복을 제거하는 데 사용할 수 있습니다.
stream_id STRING	모든 스트림에 할당된 고유 ID(SAM ID라고도 함)
network_code STRING	게시자의 네트워크 코드
콘텐츠 INTEGER	콘텐츠 소스 ID
vid STRING	동영상 ID
asset_key STRING	라이브 스트림의 애셋 키
break_id STRING	이 게재된 광고 시점의 ID VOD의 경우 VMAP 시점 ID입니다. 예: 'preroll-1', 'midroll-2' 라이브의 경우 DAI에서 이 광고 시점에 할당한 순차적인 시점 번호입니다. 예: '0000000001', '0000000024'
expected_break_duration DOUBLE	DAI의 시점에 대한 예상 지속 시간을 기준으로 DAI가 광고를 요청한 시간입니다.
actual_break_duration DOUBLE	DAI가 콘텐츠를 채운 시간입니다. 이는 광고, 슬레이트 그리고 DAI가 광고 시점에 채워 넣은 기존 콘텐츠의 총 합계 시간입니다.
ads_duration DOUBLE	광고 시점의 광고 미디어 시간입니다. VOD의 경우 광고 시점의 실제 시간도 표시됩니다.
slate_duration DOUBLE	광고 시점의 슬레이트 미디어 시간입니다.
ads_status STRING	광고 시점의 광고 삽입 상태입니다. 자세한 내용은 게시된 시점 로그 구조를 참고하세요.
slate_status STRING	광고 시점의 슬레이트 삽입 상태입니다. 자세한 내용은 게시된 시점 로그 구조를 참고하세요.
완료 부울	광고 모음의 완료 여부를 나타냅니다. HLS 스트림의 경우 DAI가 광고 모음의 끝을 알리기 위해 큐 인 마커에 삽입되었음을 의미합니다. DASH 스트림의 경우 광고 기간이 종료되었음을 의미합니다.

게재된 시점 로그 구조

DAI 게재 시점 로그는 DAI가 클라이언트에 광고 시점을 게재하는 방법에 관한 정보를 제공합니다. 다음 광고 상태 및 슬레이트 상태 표에는 다양한 광고 병합 시나리오의 DAI 로그 정보가 나와 있습니다. 라이브 스트림의 게재된 시점 로그에 대해 자세히 알아보세요.

광고 상태

다음은 광고 상태와 그 의미를 나타내는 목록입니다.

광고 상태	설명
ADS_STATUS_INSERTED	광고가 삽입되었습니다.
ADS_STATUS_DROPPED_UNKNOWN	알 수 없는 이유로 광고 모음이 삭제되었습니다.
ADS_STATUS_ALL_ADS_MISSING	광고 모음의 모든 광고가 누락되어 광고 모음이 삭제되었습니다.
ADS_STATUS_TOO_MANY_MIDROLLS	광고 서버에서 반환되는 미드롤 광고 모음이 삽입할 광고 시점보다 많아서 광고 모음이 삭제되었습니다.
ADS_STATUS_OUT_OF_WINDOW	광고 시점은 요청 시 병합 창 외부에 부분적으로 또는 전체적으로 표시되며 광고 대신 기본 콘텐츠가 병합됩니다.
ADS_STATUS_DISABLED	이 스트림에서 광고가 사용 중지되었습니다.
ADS_STATUS_DROPPED_FOR_PREROLL	이 미드롤 광고 모음은 진행 중인 프리롤 광고 시점으로 인해 삭제되었습니다.
ADS_STATUS_EXPIRED	광고 요청이 콘텐츠에 병합될 시간 내에 완료되지 않아 광고 모음이 만료되었습니다.
ADS_STATUS_HOLIDAY	광고 동적 삽입 방지 진행으로 광고 모음이 삭제되었습니다.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	슬레이트에 발생한 오류로 인해 광고가 삭제되었습니다. 슬레이트 상태를 확인하세요.
ADS_STATUS_INTERNAL_ERROR	DAI가 광고를 요청 또는 병합하는 중에 오류가 발생했습니다.
ADS_STATUS_INVALID_POD_REQUEST	잘못된 광고 모음 요청으로 인해 광고 모음이 삭제되었습니다.
ADS_STATUS_DROPPED_FOR_MIDROLL	요청된 프리롤 광고 시점이 미드롤 광고 시점과 겹칩니다.
ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION	광고 모음 필러가 너무 많이 필요합니다(게재된 광고가 충분하지 않음).
ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT	광고 시점의 길이가 너무 짧아 광고를 요청할 수 없습니다.
ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK	광고 시점이 종료된 후 생성된 스트림입니다.
ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE	광고를 병합하는 데 필요한 콘텐츠 스트림에 관한 정보가 누락되었거나 사용할 수 없습니다.
ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE	요청 기한 전에 사용할 수 있는 광고가 없습니다.

슬레이트 상태

다음은 슬레이트 상태와 그 의미를 나타내는 목록입니다.

슬레이트 상태	설명
SLATE_STATUS_INSERTED	슬레이트가 삽입되었습니다.
SLATE_STATUS_SKIPPED	라이브 스트림 이벤트 구성으로 인해 슬레이트 삽입을 건너뛰었습니다(사용 중지됨, 비어 있는 경우 건너뛰기).
SLATE_STATUS_DROPPED_UNKNOWN	알 수 없는 이유로 이 광고 시점에 슬레이트가 삽입되지 않았습니다.
SLATE_STATUS_MINIMUM_INSERTED	광고 시점의 나머지는 기본 콘텐츠와 함께 병합되었으며, 광고와 콘텐츠의 간격을 메우기 위해 소량의 슬레이트가 포함되었습니다.

광고 서버 상호작용 로그

이 로그는 광고를 가져오기 위한 광고 서버와의 상호작용에 관한 정보를 제공합니다. 정보가 로그에 표시되는 방식에 대한 자세한 내용 및 예는 광고 서버 상호작용 로그 구조를 참조하세요.

필드**	설명
timestamp INTEGER	요청의 UTC 타임스탬프(Unix 시간 단위)
entry_id STRING	로그 항목의 고유 ID 현재 Google 시스템에는 로그 항목이 두 번 이상 표시될 수 있다는 제한이 있습니다. 이 ID는 항목의 중복을 제거하는 데 사용할 수 있습니다.
stream_id STRING	모든 스트림에 할당된 고유 ID(SAM ID라고도 함)
network_code INTEGER	Ad Manager 네트워크 코드
콘텐츠 INTEGER	콘텐츠 소스 ID
vid STRING	동영상 ID
asset_key STRING	라이브 스트림의 애셋 키
pod_id INTEGER	광고 시점의 ID: VOD의 경우 VMAP의 광고 시간 ID입니다. 라이브의 경우 순차적인 광고 시점 번호입니다.
ad_server_host_name STRING	광고 서버의 도메인 이름
response_time DOUBLE	요청 지연 시간(초)
response_type STRING	답장 방법: VAST VMAP UNKNOWN: 잘못된 응답을 수신하거나 응답 시간이 초과되었을 때 설정
response_code INTEGER	HTTP 응답 코드
row_type STRING	로그 파일 항목 유형: PRIMARY_REQUEST AD_POD WRAPPER INLINE 각 로그 파일 형식이 포함된 VMAP 응답 예시를 참고하세요.
vast_error_code STRING	VAST 오류 코드
prefetch_stage STRING	미리 가져오기 단계(미리 가져오기가 사용 설정된 경우)
ad_position STRING	광고 모음에서 결정된 광고 게재순위 선택한 광고의 값이 1부터 시작합니다. 사용하지 않는 광고 뷔페 광고 및 삭제된 광고의 경우 이 필드가 비어 있습니다.
ad_id STRING	광고 ID*
ad_system STRING	광고 시스템*
ad_title STRING	광고 제목*
creative_id STRING	광고 소재 ID*
creative_ad_id STRING	광고 소재 광고 ID*
universal_ad_id_registry STRING	범용 광고 ID 레지스트리*
universal_ad_id_value STRING	범용 광고 ID 값*
creative_duration DOUBLE	광고 소재 재생 시간
mezzanine_uri STRING	Mezzanine URI* RFC3986에서 예약되지 않은 것으로 지정된 문자를 제외하고 URI의 모든 항목이 이스케이프 처리됩니다.
media_uri STRING	MediaFiles 노드 내에서 발견된 첫 번째 요소입니다. * RFC3986에서 예약되지 않은 것으로 지정된 문자를 제외하고 URI의 모든 항목이 이스케이프 처리됩니다.
break_start_uri STRING	광고 시점의 시작을 추적하는 데 사용되는 추적 요소입니다. 이 데이터는 VMAP 응답을 바탕으로 합니다. RFC3986에서 예약되지 않은 것으로 지정된 문자를 제외하고 URI의 모든 항목이 이스케이프 처리됩니다.
google_video_id STRING	이 광고와 연결된 광고 소재의 고유 식별자입니다.

  * VAST에서 가져온 값입니다.

** 특정 행에 적용할 수 없는 경우 일부 필드는 비어 있을 수 있습니다.