클라이언트 측 광고 추적 스키마 및 속성 - AWS Elemental MediaTailor
스키마속성

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

클라이언트 측 광고 추적 스키마 및 속성

MediaTailor 클라이언트 측 광고 추적 기능을 사용하면 자세한 클라이언트 측 광고 추적 데이터를 플레이어 환경에 통합할 수 있습니다. 다음 섹션에서는 전체 광고 추적 스키마와 스키마를 구성하는 특정 속성 및 값을 다룹니다.

스키마

다음 JSON 구조는 MediaTailor 클라이언트 측 광고 추적 스키마를 보여줍니다. 이 표현은 여러 부분 간의 관계를 이해하는 데 도움이 되는 스키마의 중첩 구조를 보여줍니다.

각 속성에 대한 자세한 내용은 섹션을 참조하세요속성.

{
  "avails": [
    {
      "ads": [
        {
          "adID": "string",
          "adParameters": "string",
          "adSystem": "string",
          "adTitle": "string",
          "adVerifications": [
            {
              "executableResource": [
                {
                  "apiFramework": "string",
                  "type": "string",
                  "uri": "string",
                  "language": "string"
                }
              ],
              "javaScriptResource": [
                {
                  "apiFramework": "string",
                  "browserOptional": "string",
                  "uri": "string"
                }
              ],
              "trackingEvents": [
                {
                  "event": "string",
                  "uri": "string"
                }
              ],
              "vendor": "string",
              "verificationParameters": "string"
            }
          ],
          "companionAds": [
            {
              "adParameters": "string",
              "altText": "string",
              "attributes": {
                "adSlotId": "string",
                "apiFramework": "string",
                "assetHeight": "string",
                "assetWidth": "string",
                "expandedHeight": "string",
                "expandedWidth": "string",
                "height": "string",
                "id": "string",
                "pxratio": "string",
                "renderingMode": "string",
                "width": "string"
              },
              "companionClickThrough": "string",
              "companionClickTracking": "string",
              "htmlResource": "string",
              "iFrameResource": "string",
              "sequence": "string",
              "staticResource": "string",
              "trackingEvents": [
                {
                  "event": "string",
                  "uri": "string"
                }
              ]
            }
          ],
          "creativeId": "string",
          "creativeSequence": "string",
          "duration": "string",
          "durationInSeconds": number,
          "extensions": [
            {
              "type": "string",
              "content": "string"
            }
          ],
          "icons": [
            {
              "attributes": {
                "apiFramework": "string",
                "duration": "string",
                "height": "string",
                "offset": "string",
                "program": "string",
                "pxratio": "string",
                "width": "string",
                "xPosition": "string",
                "yPosition": "string"
              },
              "htmlResource": "string",
              "iconClicks": {
                "iconClickThrough": "string",
                "iconClickTracking": {
                  "id": "string"
                },
                "iconClickFallbackImages": [
                  {
                    "altText": "string",
                    "height": "string",
                    "width": "string",
                    "staticResource": {
                      "creativeType": "string",
                      "uri": "string"
                    }
                  }
                ]
              },
              "iconViewTracking": "string",
              "iFrameResource": "string",
              "staticResource": {
                "creativeType": "string",
                "uri": "string"
              }
            }
          ],
          "mediaFiles": {
            "adParameters": "string",
            "duration": "string",
            "durationInSeconds": number,
            "mediaFilesList": [
              {
                "apiFramework": "string",
                "delivery": "string",
                "height": "string",
                "maintainAspectRatio": "string",
                "mediaFileUri": "string",
                "mediaType": "string",
                "scalable": "string",
                "width": "string",
                "bitrate": "string"
              }
            ],
            "mezzanine": "string",
            "startTime": "string",
            "startTimeInSeconds": number,
            "trackingEvents": [
              {
                "beaconUrls": ["string"],
                "duration": "string",
                "durationInSeconds": number,
                "dateTime": "string",
                "eventId": "string",
                "eventType": "string",
                "startTime": "string",
                "startTimeInSeconds": number
              }
            ]
          },
          "startTime": "string",
          "startTimeInSeconds": number,
          "dateTime": "string",
          "adBreakTrackingEvents": [...],
          "vastAdId": "string"
        }
      ],
      "adType": "string",
      "availID": "string",
      "duration": "string",
      "durationInSeconds": number,
      "startTime": "string",
      "startTimeInSeconds": number,
      "dateTime": "string",
      "adMarkerDuration": "string",
      "adProgramDateTime": "string",
      "dashAvailabilityStartTime": "string",
      "hlsAnchorMediaSequenceNumber": "string"
    }
  ],
  "nonLinearAvails": [
    {
      "nonLinearAds": [...],
      "nonLinearAdsList": [...]
    }
  ],
  "nextToken": "string",
  "meta": {}
}

속성

다음 표에는 클라이언트 측 추적 API의 속성, 정의, 값 유형 및 예제가 나열되어 있습니다.

속성 정의 값 유형 예제
adID

  • HLS - 광고 시작과 연결된 시퀀스 번호

  • DASH - 광고의 기간 ID

경로: /avails/ads/adId

VAST 매핑: 없음

 문자열 10
adBreakTrackingEvents

VAST 응답에서 VMAP 추적 이벤트를 전달하는 배열입니다. 자세한 내용은 VMAP 1.0 사양의 섹션 2.3.3을 참조하세요.

경로: /avails/ads/adBreakTrackingEvents

 Array []
adMarkerDuration

매니페스트의 광고 마커에서 관찰된 가용 기간입니다.

 문자열 30
adParameters

MediaTailor가 플레이어에게 전달하는 VAST VPAID의 광고 파라미터 문자열입니다.

경로: /avails/ads/adParameters

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters

 문자열
adProgramDateTime

  • HLS - 광고의 첫 번째 미디어 시퀀스를 나타내는 ISO/IEC 8601:2004 형식의 날짜입니다.

  • DASH - [지정되지 않음]

 문자열
ads

가능 구간을 구성하는 광고 객체가 포함된 배열입니다. 광고는 매니페스트에 나타나는 순서대로 나열됩니다.

경로: /avails/ads

 Array []
adSystem

광고를 제공하는 시스템의 이름입니다.

중요

값을 제공해야 합니다. 값을 제공하지 않으면 문제가 발생할 수 있습니다.

 문자열 myADS
adTitle

광고의 제목입니다.

 문자열 ad1
adVerifications

크리에이티브 재생을 확인하기 위해 타사 측정 코드를 실행하는 데 필요한 리소스와 메타데이터를 포함합니다. 이 속성에 대한 자세한 내용은 VAST 4.2 사양의 섹션 3.16을 참조하세요.

MediaTailor는 VAST 3 확장 노드adVerifications로를 지원합니다.

경로: /avails/ads/adVerifications

VAST 매핑: VAST/Ad/InLine/AdVerifications

 Array []
altText

컴패니언 광고 이미지의 대체 텍스트입니다. 이 텍스트를 사용하면 시각 장애가 있는 플레이어가 이미지에 대한 설명을 다시 읽을 수 있습니다.

경로: /avails/ads/companionAds/altText

 문자열 video sequence advertising sneakers
apiFramework

플레이어에게이 광고가 VPAID 광고임을 알리VPAID려면 로 설정합니다.

스키마의 여러 위치에 나타날 수 있습니다.

 문자열 VPAID
availID

  • HLS - 광고 시간의 시작과 연결된 시퀀스 번호입니다.

  • DASH - 광고 시간의 기간 ID로, 일반적으로 광고로 대체할 콘텐츠의 기간 ID입니다.

경로: /avails/availID

 문자열

  • 34

  • PT34S_1

avails

활성 매니페스트 창에 표시되는 광고 중단 객체 또는 가능 구간을 포함하는 배열입니다. 가용 구간은 매니페스트에 나타나는 순서대로 나열됩니다.

경로: /avails

 Array []
adType

광고의 유형입니다.

경로: /avails/adType 및 /avails/ads/adType

 문자열
dateTime

광고 가능성 또는 광고 시작을 위한 ISO 8601초 형식의 프로그램 날짜 시간입니다.

경로: /avails/dateTime 및 /avails/ads/dateTime

 문자열
duration

ISO 8601초 형식의 길이입니다. 응답에는 전체 광고 시간 및 각 광고 및 비컨에 대한 지속 시간이 포함되지만 비컨 지속 시간은 항상 0입니다.

경로: /avails/duration 및 /avails/ads/duration

 문자열 15.015
durationInSeconds

초 형식의 길이입니다.

경로: /avails/durationInSeconds 및 /avails/ads/durationInSeconds

 숫자
extensions

광고 서버에서 사용하는 VAST의 사용자 지정 확장입니다. 확장에 대한 자세한 내용은 VAST 4.2 사양의 섹션 3.18을 참조하세요.

경로: /avails/ads/extensions

VAST 매핑: VAST/Ad/InLine/Extensions

 Array []
icons

광고의 아이콘 요소입니다.

경로: /avails/ads/icons

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/Linear/Icons

 Array
mediaFiles

플레이어가 광고 시간에 필요한 비디오 및 기타 자산입니다.

경로: /avails/ads/mediaFiles

 객체
nonLinearAvails

비선형 광고 가능 객체 배열입니다.

경로: /nonLinearAvails

 Array
executableResource

확인을 위한 실행 가능한 리소스입니다.

경로: /avails/ads/adVerifications/executableResource

VAST 매핑: VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource

 Array
javaScriptResource

확인을 위한 JavaScript 리소스입니다.

경로: /avails/ads/adVerifications/javaScriptResource

VAST 매핑: VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource

 Array
trackingEvents

확인 또는 컴패니언 광고를 위한 이벤트 추적.

경로: /avails/ads/adVerifications/trackingEvents 또는 /avails/ads/companionAds/trackingEvents

 Array
vendor

확인 공급업체.

경로: /avails/ads/adVerifications/vendor

VAST 매핑: VAST/Ad/InLine/AdVerifications/Verification/@vendor

 문자열
uri

실행 파일 자산, 비디오 자산 또는 추적 엔드포인트를 가리키는 URI입니다.

경로: 스키마의 다양한 위치

VAST 매핑: VAST의 다양한 CDATA 요소

 문자열 https://tracking.example.com/impression
verificationParameters

확인 파라미터입니다.

경로: /avails/ads/adVerifications/verificationParameters

VAST 매핑: VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters

 문자열
attributes

차원 및 렌더링 모드와 같은 컴패니언 광고 속성.

경로: /avails/ads/companionAds/attributes

 객체
companionClickThrough

최종 사용자가 컴패니언 광고를 클릭할 때 미디어 플레이어가 여는 광고자 페이지의 URL입니다.

경로: /avails/ads/companionAds/companionClickThrough

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough

 문자열 https://aws.amazon.com/
companionClickTracking

companionClickThrough 속성의 추적 URL입니다.

경로: /avails/ads/companionAds/companionClickTracking

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking

 문자열 https://myads.com/beaconing/event=clicktracking
htmlResource

스트리밍 공급자의 HTML 페이지 내에 직접 삽입되는 CDATA 인코딩 HTML입니다.

경로: /avails/ads/companionAds/htmlResource

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource

 문자열 <![CDATA[<!doctype html><html><head><meta name=\"viewport\" content=\"width=1, initial-scale=1.0, minimum-scale=1.0,...]]>
iFrameResource

스트리밍 공급자가 iframe에 로드하는 HTML 리소스 파일의 URL입니다.

경로: /avails/ads/companionAds/iFrameResource

VAST 매핑: VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource

 문자열
sequence

VAST 응답에서 크리에이티브에 대해 지정된 시퀀스 값입니다.

경로: /avails/ads/companionAds/sequence

 문자열 1
startTime

ISO 8601초 형식의 시간 위치입니다. HLS의 경우 재생 세션의 시작을 기준으로 합니다. DASH의 경우 이는 매니페스트의 AST(가용성 시작 시간)를 기준으로 합니다. 응답에는 전체 광고 시간과 각 광고 및 비콘에 대한 시작 시간이 포함됩니다.

경로: /avails/startTime 및 /avails/ads/startTime

 문자열 PT18.581355S
startTimeInSeconds

초 형식의 시간 위치입니다. HLS의 경우 재생 세션의 시작을 기준으로 합니다. DASH의 경우 이는 매니페스트의 AST(가용성 시작 시간)를 기준으로 합니다. 응답에는 전체 광고 시간과 각 광고 및 비콘에 대한 시작 시간이 포함됩니다.

경로: /avails/startTimeInSeconds 및 /avails/ads/startTimeInSeconds

 숫자 18.581
eventId

  • HLS - 비컨과 연결된 시퀀스 번호입니다.

  • DASH - 광고 ptsTime 시작의 입니다.

 문자열
event

추적 이벤트의 이름입니다.

경로: /avails/ads/adVerifications/trackingEvents/event 또는 /avails/ads/companionAds/trackingEvents/event

 문자열 impression, start, firstQuartile, midpoint, thirdQuartile, complete
beaconUrls

MediaTailor가 광고 비컨을 전송하는 URL입니다.

경로: /avails/ads/mediaFiles/trackingEvents/beaconUrls

 Array
bitrate

비디오 자산의 비트레이트입니다. 이 속성은 일반적으로 실행 가능 자산에 포함되지 않습니다.

 문자열 2048
companionAds

각각 사용할 리소스 파일을 지정하는 하나 이상의 컴패니언 광고 콘텐츠 사양입니다. 컴패니언 광고는 광고 시간과 함께 제공되며 광고 주변의 프레임 또는 배너와 같은 콘텐츠를 제공하여 비디오 근처에 표시합니다.

경로: /avails/ads/companionAds

 Array []
creativeId

광고에 대한 Creative 태그의 Id 속성 값입니다.

 문자열 creative-1
creativeSequence

VAST 응답의 Ad@id 값에 따라 광고가 재생되어야 하는 시퀀스입니다.

 문자열 1
dashAvailabilityStartTime

라이브/동적 DASH의 경우 오리진 매니페스트MPD@availabilityStartTime의 입니다.

 문자열 2022-10-05T19:38:39.263Z
delivery

progressive 또는 streaming 프로토콜이 사용 중인지 여부를 나타냅니다.

 문자열 progressive
eventType

비컨의 유형입니다.

경로: /avails/ads/mediaFiles/trackingEvents/eventType

 문자열 impression
height

비디오 자산의 픽셀 단위 높이입니다.

 문자열 360
hlsAnchorMediaSequenceNumber

HLS 오리진 매니페스트에 표시되는 첫 번째/가장 오래된 미디어 시퀀스의 미디어 시퀀스 번호입니다.

 문자열 77
maintainAspectRatio

조정 중에 비디오의 종횡비를 유지할지 여부를 나타냅니다.

 불린(Boolean) true
mediaFilesList

플레이어가 광고 시간에 필요한 비디오 및 기타 자산을 지정합니다.

경로: /avails/ads/mediaFiles/mediaFilesList

 Array []
mediaFileUri

실행 파일 자산 또는 비디오 자산을 가리키는 URI입니다.

 문자열 https://myad.com/ad/ad134/vpaid.js
mediaType

크리에이티브 또는 컴패니언 자산의 MIME 유형입니다.

 문자열 video/mp4
meta

광고에 대한 추가 메타데이터입니다.

 객체
mezzanine

VPAID 광고에 포함된 경우 지정된 메자닌 MP4 자산의 URL입니다.

경로: /avails/ads/mediaFiles/mezzanine

 문자열 https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
nextToken

해당 값이 존재할 때 결과의 다음 페이지를 가리키는 토큰의 값입니다.

 문자열 UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
nonLinearAds

비디오 콘텐츠와 함께 표시되는 비선형 광고입니다.

 Array []
nonLinearAdsList

비선형 광고 목록입니다.

 Array []
scalable

비디오를 다른 차원으로 조정할지 여부를 나타냅니다.

 불린(Boolean) true
skipOffset

플레이어가 사용자가 건너뛰기 제어를 사용할 수 있도록 하는 시기를 식별하는 시간 값입니다.

 문자열 00:00:05
staticResource

광고 구성 요소에 사용되는 정적 크리에이티브 파일의 URL입니다.

경로: /avails/ads/companionAds/staticResource

 문자열 https://very-interactive-ads.com/campaign1/file.json?c=1019113602
vastAdId

Ad 태그의 Id 속성 값입니다.

 문자열 ad1
width

비디오 자산의 픽셀 단위 너비입니다.

 문자열 640
xPosition

비디오 플레이어 내 아이콘의 가로 위치입니다. 특정 픽셀 값 또는 "왼쪽" 또는 "오른쪽"과 같은 위치일 수 있습니다.

경로: /avails/ads/icons/attributes/xPosition

 문자열 left 또는 10
yPosition

비디오 플레이어 내 아이콘의 세로 위치입니다. 특정 픽셀 값 또는 "상단" 또는 "하단"과 같은 위치일 수 있습니다.

경로: /avails/ads/icons/attributes/yPosition

 문자열 top 또는 10
iconClicks

아이콘에 대한 클릭 및 추적 정보가 포함되어 있습니다.

경로: /avails/ads/icons/iconClicks

 객체
iconClickThrough

최종 사용자가 아이콘을 클릭할 때 미디어 플레이어가 여는 광고자 페이지의 URL입니다.

경로: /avails/ads/icons/iconClicks/iconClickThrough

 문자열 https://advertiser.com/landing-page
iconClickTracking

iconClickThrough 속성의 추적 URL입니다.

경로: /avails/ads/icons/iconClicks/iconClickTracking

 객체
iconClickFallbackImages

아이콘을 표시할 수 없는 경우 표시할 폴백 이미지 배열입니다.

경로: /avails/ads/icons/iconClicks/iconClickFallbackImages

 Array
iconViewTracking

아이콘이 표시될 때 추적하기 위한 URL입니다.

경로: /avails/ads/icons/iconViewTracking

 문자열 https://tracking.example.com/icon-view
offset

광고 재생 중에 아이콘이 나타나는 시간의 시간 오프셋입니다.

경로: /avails/ads/icons/attributes/offset

 문자열 00:00:05
program

“AdChoices”와 같은 아이콘과 연결된 프로그램 또는 이니셔티브입니다.

경로: /avails/ads/icons/attributes/program

 문자열 AdChoices
pxratio

높은 DPI 디스플레이에 사용되는 아이콘 또는 컴패니언 광고의 픽셀 비율입니다.

경로: /avails/ads/icons/attributes/pxratio 또는 /avails/ads/companionAds/attributes/pxratio

 문자열 1 또는 2
type

리소스 또는 확장의 유형입니다.

경로: /avails/ads/extensions/type 또는 /avails/ads/adVerifications/executableResource/type

 문자열 text/javascript
content

확장의 콘텐츠입니다.

경로: /avails/ads/extensions/content

 문자열
language

실행 리소스의 프로그래밍 언어입니다.

경로: /avails/ads/adVerifications/executableResource/language

 문자열 javascript
browserOptional

JavaScript 리소스에 브라우저 지원이 필요한지 여부를 나타냅니다.

경로: /avails/ads/adVerifications/javaScriptResource/browserOptional

 문자열 true 또는 false
id

스키마의 다양한 요소에 대한 식별자입니다.

경로: /avails/ads/companionAds/attributes/id 또는 /avails/ads/icons/iconClicks/iconClickTracking/id

 문자열 companion-1
assetHeight

컴패니언 광고 자산의 높이입니다.

경로: /avails/ads/companionAds/attributes/assetHeight

 문자열 250
assetWidth

컴패니언 광고 자산의 너비입니다.

경로: /avails/ads/companionAds/attributes/assetWidth

 문자열 300
expandedHeight

확장 시 컴패니언 광고의 높이입니다.

경로: /avails/ads/companionAds/attributes/expandedHeight

 문자열 600
expandedWidth

확장 시 컴패니언 광고의 너비입니다.

경로: /avails/ads/companionAds/attributes/expandedWidth

 문자열 600
renderingMode

컴패니언 광고의 렌더링 모드입니다.

경로: /avails/ads/companionAds/attributes/renderingMode

 문자열 default 또는 transparent
adSlotId

컴패니언 광고를 표시해야 하는 광고 슬롯의 ID입니다.

경로: /avails/ads/companionAds/attributes/adSlotId

 문자열 banner-1
creativeType

크리에이티브 자산의 MIME 유형입니다.

경로: /avails/ads/icons/staticResource/creativeType

 문자열 image/png