클라이언트 측 광고 추적 스키마 및 속성 - 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 매핑: 없음

 String 10
adBreakTrackingEvents

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

경로: /avails/ads/adBreakTrackingEvents

 Array []
adMarkerDuration

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

 String 30
adParameters

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

경로: /avails/ads/adParameters

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

 String
adProgramDateTime

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

  • DASH - [지정되지 않음]

 String
ads

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

경로: /avails/ads

 Array []
adSystem

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

중요

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

 String myADS
adTitle

광고의 제목입니다.

 String 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

 String video sequence advertising sneakers
apiFramework

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

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

 String VPAID
availID

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

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

경로: /avails/availID

 String

  • 34

  • PT34S_1

avails

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

경로: /avails

 Array []
adType

광고의 유형입니다.

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

 String
dateTime

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

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

 String
duration

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

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

 String 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

 String
uri

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

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

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

 String https://tracking.example.com/impression
verificationParameters

확인 파라미터입니다.

경로: /avails/ads/adVerifications/verificationParameters

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

 String
attributes

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

경로: /avails/ads/companionAds/attributes

 객체
companionClickThrough

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

경로: /avails/ads/companionAds/companionClickThrough

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

 String https://aws.amazon.com/
companionClickTracking

companionClickThrough 속성의 추적 URL입니다.

경로: /avails/ads/companionAds/companionClickTracking

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

 String https://myads.com/beaconing/event=clicktracking
htmlResource

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

경로: /avails/ads/companionAds/htmlResource

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

 String <![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

 String
sequence

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

경로: /avails/ads/companionAds/sequence

 String 1
startTime

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

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

 String PT18.581355S
startTimeInSeconds

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

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

 숫자 18.581
eventId

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

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

 String
event

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

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

 String impression, start, firstQuartile, midpoint, thirdQuartile, complete
beaconUrls

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

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

 Array
bitrate

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

 String 2048
companionAds

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

경로: /avails/ads/companionAds

 Array []
creativeId

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

 String creative-1
creativeSequence

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

 String 1
dashAvailabilityStartTime

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

 String 2022-10-05T19:38:39.263Z
delivery

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

 String progressive
eventType

비컨의 유형입니다.

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

 String impression
height

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

 String 360
hlsAnchorMediaSequenceNumber

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

 String 77
maintainAspectRatio

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

 불 true
mediaFilesList

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

경로: /avails/ads/mediaFiles/mediaFilesList

 Array []
mediaFileUri

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

 String https://myad.com/ad/ad134/vpaid.js
mediaType

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

 String video/mp4
meta

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

 객체
mezzanine

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

경로: /avails/ads/mediaFiles/mezzanine

 String https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
nextToken

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

 String UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
nonLinearAds

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

 Array []
nonLinearAdsList

비선형 광고 목록입니다.

 Array []
scalable

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

 불 true
skipOffset

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

 String 00:00:05
staticResource

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

경로: /avails/ads/companionAds/staticResource

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

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

 String ad1
width

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

 String 640
xPosition

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

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

 String left 또는 10
yPosition

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

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

 String top 또는 10
iconClicks

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

경로: /avails/ads/icons/iconClicks

 객체
iconClickThrough

광고자 페이지의 URL로, 최종 사용자가 아이콘을 클릭하면 미디어 플레이어가 열립니다.

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

 String 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

 String https://tracking.example.com/icon-view
offset

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

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

 String 00:00:05
program

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

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

 String AdChoices
pxratio

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

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

 String 1 또는 2
type

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

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

 String text/javascript
content

확장의 콘텐츠입니다.

경로: /avails/ads/extensions/content

 String
language

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

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

 String javascript
browserOptional

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

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

 String true 또는 false
id

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

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

 String companion-1
assetHeight

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

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

 String 250
assetWidth

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

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

 String 300
expandedHeight

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

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

 String 600
expandedWidth

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

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

 String 600
renderingMode

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

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

 String default 또는 transparent
adSlotId

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

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

 String banner-1
creativeType

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

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

 String image/png