기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 클라이언트 측 광고 추적 스키마 및 속성
MediaTailor 클라이언트 측 광고 추적 기능을 사용하면 자세한 클라이언트 측 광고 추적 데이터를 플레이어 환경에 통합할 수 있습니다. 다음 섹션에서는 전체 광고 추적 스키마와 스키마를 구성하는 특정 속성 및 값을 다룹니다.
## 스키마
다음 JSON 구조는 MediaTailor 클라이언트 측 광고 추적 스키마를 보여줍니다. 이 표현은 여러 부분 간의 관계를 이해하는 데 도움이 되는 스키마의 중첩 구조를 보여줍니다.
각 속성에 대한 자세한 내용은 섹션을 참조하세요[속성](#ad-reporting-client-side-ad-tracking-schema-properties).
```
{
"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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) 경로: `/avails/ads/adId` VAST 매핑: 없음 | 문자열 | 10 |
| adBreakTrackingEvents | VAST 응답에서 VMAP 추적 이벤트를 전달하는 배열입니다. 자세한 내용은 [VMAP 1.0 사양의 섹션 2.3.](https://www.iab.com/guidelines/vmap/)3을 참조하세요. 경로: `/avails/ads/adBreakTrackingEvents` | 배열 | [] |
| adMarkerDuration | 매니페스트의 광고 마커에서 관찰된 가용 기간입니다. | 문자열 | 30 |
| adParameters | MediaTailor가 플레이어에게 전달하는 VAST VPAID의 광고 파라미터 문자열입니다. 경로: `/avails/ads/adParameters` VAST 매핑: `VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters` | 문자열 | |
| adProgramDateTime | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) | 문자열 | |
| ads | 가능 구간을 구성하는 광고 객체가 포함된 배열입니다. 광고는 매니페스트에 나타나는 순서대로 나열됩니다. 경로: `/avails/ads` | 배열 | [] |
| adSystem | 광고를 제공하는 시스템의 이름입니다. 값을 제공해야 합니다. 값을 제공하지 않으면 문제가 발생할 수 있습니다. | 문자열 | myADS |
| adTitle | 광고의 제목입니다. | 문자열 | ad1 |
| adVerifications | 크리에이티브 재생을 확인하기 위해 타사 측정 코드를 실행하는 데 필요한 리소스와 메타데이터를 포함합니다. 이 속성에 대한 자세한 내용은 [VAST 4.2 사양의 섹션 3.](https://iabtechlab.com/standards/vast/)16을 참조하세요. MediaTailor는 VAST 3 확장 노드`adVerifications`로를 지원합니다. 경로: `/avails/ads/adVerifications` VAST 매핑: `VAST/Ad/InLine/AdVerifications` | 배열 | [] |
| altText | 컴패니언 광고 이미지의 대체 텍스트입니다. 이 텍스트를 사용하면 시각 장애가 있는 플레이어가 이미지에 대한 설명을 다시 읽을 수 있습니다. 경로: `/avails/ads/companionAds/altText` | 문자열 | video sequence advertising sneakers |
| apiFramework | 이 광고가 VPAID 광고임을 플레이어에게 알리`VPAID`려면 로 설정합니다. 스키마의 여러 위치에 나타날 수 있습니다. | 문자열 | VPAID |
| availID | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) 경로: `/avails/availID` | 문자열 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) |
| avails | 활성 매니페스트 창에 표시되는 광고 발생 객체 또는 *가능 구간*을 포함하는 배열입니다. 가용 구간은 매니페스트에 나타나는 순서대로 나열됩니다. 경로: `/avails` | 배열 | [] |
| 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.](https://iabtechlab.com/standards/vast/)18을 참조하세요. 경로: `/avails/ads/extensions` VAST 매핑: `VAST/Ad/InLine/Extensions` | 배열 | [] |
| icons | 광고의 아이콘 요소입니다. 경로: `/avails/ads/icons` VAST 매핑: `VAST/Ad/InLine/Creatives/Creative/Linear/Icons` | 배열 | |
| mediaFiles | 플레이어가 광고 시간에 필요한 비디오 및 기타 자산. 경로: `/avails/ads/mediaFiles` | 객체 | |
| nonLinearAvails | 비선형 광고 가능 객체 배열입니다. 경로: `/nonLinearAvails` | 배열 | |
| executableResource | 확인을 위한 실행 가능한 리소스입니다. 경로: `/avails/ads/adVerifications/executableResource` VAST 매핑: `VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource` | 배열 | |
| javaScriptResource | 확인을 위한 JavaScript 리소스입니다. 경로: `/avails/ads/adVerifications/javaScriptResource` VAST 매핑: `VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource` | 배열 | |
| trackingEvents | 확인 또는 컴패니언 광고를 위한 이벤트 추적. 경로: `/avails/ads/adVerifications/trackingEvents` 또는 `/avails/ads/companionAds/trackingEvents` | 배열 | |
| 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` | 문자열 | <\$1[CDATA[<\$1doctype html> |
| 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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediatailor/latest/ug/ad-reporting-client-side-ad-tracking-schema.html) | 문자열 | |
| 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` | 배열 | |
| bitrate | 비디오 자산의 비트레이트입니다. 이 속성은 일반적으로 실행 가능 자산에 포함되지 않습니다. | 문자열 | 2048 |
| companionAds | 각각 사용할 리소스 파일을 지정하는 하나 이상의 컴패니언 광고 콘텐츠 사양입니다. 컴패니언 광고는 광고 시간과 함께 제공되며 광고 주변의 프레임 또는 배너와 같은 콘텐츠를 제공하여 비디오 근처에 표시합니다. 경로: `/avails/ads/companionAds` | 배열 | [] |
| 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 | 크기 조정 중에 비디오의 종횡비를 유지할지 여부를 나타냅니다. | 부울 | true |
| mediaFilesList | 플레이어가 광고 시간에 필요한 비디오 및 기타 자산을 지정합니다. 경로: `/avails/ads/mediaFiles/mediaFilesList` | 배열 | [] |
| 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 | 비디오 콘텐츠와 함께 표시되는 비선형 광고입니다. | 배열 | [] |
| nonLinearAdsList | 비선형 광고 목록입니다. | 배열 | [] |
| scalable | 비디오를 다른 차원으로 조정할지 여부를 나타냅니다. | 부울 | 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` | 배열 | |
| 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 |