클라이언트측 추적 활성화 광고 서버 매개변수 오리진 인터랙션 쿼리 파라미터 세션 구성 기능 클라이언트측 추적 모범 사례

클라이언트측 추적

AWS Elemental MediaTailor클라이언트측 추적 API를 사용하면 광고 중단 시 스트리밍 워크플로에 플레이어 컨트롤을 통합할 수 있습니다. 클라이언트 측 추적에서 플레이어 또는 클라이언트는 광고 의사 결정 서버 (ADS) 및 기타 광고 검증 엔티티에 노출 및 사분위수 광고 비코닝과 같은 추적 이벤트를 내보냅니다. 노출 및 사분위수 광고 비코닝에 대한 자세한 내용은 을 참조하십시오. 클라이언트측 비코닝 ADS 및 기타 광고 검증 기관에 대한 자세한 내용은 을 참조하십시오. 클라이언트측 광고 추적 통합

클라이언트 측 추적을 통해 다음과 같은 기능을 사용할 수 있습니다.

광고 브레이크 카운트다운 타이머 - 자세한 내용은 을 참조하십시오. 광고 카운트다운 타이머
광고 클릭스루 - 자세한 내용은 을 참조하십시오. 광고 클릭스루
컴패니언 광고 표시 - 자세한 내용은 을 참조하십시오. 컴패니언 광고
건너뛸 수 있는 광고 - 자세한 내용은 을 참조하십시오. 건너뛸 수 있는 광고
개인 정보 보호 규정 준수를 위한 VAST 아이콘 표시 - 자세한 내용은 을 참조하십시오. 구글 Why This Ad (Wta) 아이콘
광고 도중 플레이어 스크러빙 제어 - 자세한 내용은 을 참조하십시오. 스크러빙

MediaTailor 클라이언트측 추적 API를 사용하면 재생 기기로 메타데이터를 전송하여 클라이언트 측 추적 외에도 기능을 활성화할 수 있습니다.

주제

클라이언트 측 추적 활성화

각 세션에 대해 클라이언트측 추적을 활성화합니다. 플레이어가 MediaTailor 구성의 세션 초기화 접두사 POST 엔드포인트로 HTTP를 전송합니다. 선택적으로 플레이어는 광고 호출을 하고, 매니페스트를 MediaTailor 위해 오리진을 호출하고, 세션 수준에서 기능을 호출하거나 비활성화할 때 사용할 추가 메타데이터를 전송할 수 있습니다. MediaTailor

다음 예시는 JSON 메타데이터의 구조를 보여줍니다.


{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

MediaTailor 콘솔 또는 API를 사용하여 ADS 요청 템플릿 URL이 이러한 매개변수를 참조하도록 구성합니다. 다음 예제에서 player_params.param1 는 의 플레이어 param1 player_params.param2 매개변수이고 는 의 플레이어 매개변수입니다param2.


https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

광고 서버 파라미터

JSON 구조의 최상위 수준에는 JSON 객체가 있습니다. adsParams 이 개체 안에는 모든 세션 요청에서 광고 서버로 읽고 전송할 MediaTailor 수 있는 키/값 쌍이 있습니다. MediaTailor 지원되는 광고 서버는 다음과 같습니다.

구글 애드 매니저
SpringServe
FreeWheel
퍼블리카

오리진 인터랙션 쿼리 파라미터

,, adParamsavailSuppression, 등 JSON 구조의 최상위 수준 내에 있는 예약된 키/값 쌍은 원본 요청 URL에 쿼리 매개변수 형태로 추가되지 않습니다. overlayAvails 오리진에 보내는 모든 세션 매니페스트 요청에는 이러한 MediaTailor 쿼리 파라미터가 포함됩니다. 오리진은 관련 없는 쿼리 파라미터를 무시합니다. 예를 들어, 키/값 쌍을 사용하여 오리진에 액세스 토큰을 보낼 MediaTailor 수 있습니다.

세션 구성 기능

세션 초기화 JSON 구조를 사용하여,, 등의 기능을 활성화, 비활성화 또는 재정의할 수 있습니다. MediaTailor overlayAvails availSuppression adSignaling 세션 초기화 중에 전달된 모든 기능 구성은 구성 수준에서 설정을 재정의합니다. MediaTailor

참고

세션 초기화 MediaTailor 시 제출된 메타데이터는 변경할 수 없으며 세션 기간 동안 추가 메타데이터를 추가할 수 없습니다. SCTE-35 마커를 사용하여 세션 중에 변경되는 데이터를 전달할 수 있습니다. 자세히 알아보려면 세션 변수 사용의 내용을 참조하세요.

예 : HLS를 위한 클라이언트 측 광고 추적 수행


POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

예 : DASH에 대한 클라이언트 측 광고 추적 수행


POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

응답 본문이 200 있는 HTTP가 성공적인 응답입니다. 본문에는 A와 trackingUrl 키가 있는 manifestUrl JSON 객체가 들어 있습니다. 값은 플레이어가 재생 및 광고 이벤트 추적 목적으로 모두 사용할 수 있는 상대 URL입니다.


{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

클라이언트측 추적 스키마에 대한 자세한 내용은 을 참조하십시오. 클라이언트측 광고 추적 스키마

클라이언트측 추적 모범 사례

이 섹션에서는 라이브 및 VOD 워크플로 모두에 MediaTailor 대한 클라이언트 측 트래킹의 모범 사례를 간략하게 설명합니다.

라이브 워크플로

항상 최신 광고 추적 메타데이터를 유지하려면 HLS의 모든 대상 기간 또는 DASH의 최소 업데이트 기간과 일치하는 간격으로 추적 엔드포인트를 폴링합니다. 이 간격을 맞추는 것은 크리에이티브가 인터랙티브 또는 오버레이 요소를 포함할 수 있는 워크플로우에서 특히 중요합니다.

참고

일부 플레이어는 설문조사 대신 사용할 수 있는 이벤트 리스너를 지원합니다. 예를 들어 각 세션마다 MediaTailor 광고 ID 장식 기능을 활성화해야 합니다. 자세히 알아보려면 광고 ID 장식의 내용을 참조하세요. 이 기능을 사용하면 각 광고에 날짜 범위 (HLS) 또는 이벤트 요소 (DASH) 식별자를 사용할 수 있습니다. 플레이어는 이러한 매니페스트 태그를 세션의 MediaTailor 추적 엔드포인트를 호출하는 프롬프트로 사용할 수 있습니다.

VOD 워크플로

세션이 성공적으로 초기화되고 미디어가 포함된 첫 번째 매니페스트를 MediaTailor 수신한 후에는 추적 엔드포인트를 한 번만 호출하면 됩니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

서버측 트래킹

광고 추적 스키마