Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Cómo empezar a usar anuncios superpuestos con MediaTailor
En esta sección se explica cómo empezar a utilizar la función de anuncios superpuestos de. MediaTailor Configurará la señalización del SCTE-35, configurará las respuestas del Ad Decision Server (ADS) y configurará el control a nivel de sesión.
**Topics**
+ [Habilitar anuncios superpuestos](overlay-ads-getting-started-enabling.md)
+ [Seguimiento de anuncios superpuestos con metadatos del lado del cliente](overlay-ads-client-side-tracking-metadata.md)
# Habilitar anuncios superpuestos
MediaTailor La compatibilidad con anuncios superpuestos está habilitada de forma predeterminada. Un tipo de marcador publicitario SCTE-35 específico del manifiesto activa la inserción de un anuncio superpuesto. Como es posible que algunos reproductores no admitan la representación de anuncios superpuestos en el lado del cliente, puedes deshabilitar esta función a nivel de sesión.
**Para inhabilitar la compatibilidad con anuncios superpuestos mediante prefijos de reproducción HLS o DASH:**
+ Desde el reproductor, inicia una nueva sesión de MediaTailor reproducción mediante una solicitud en uno de los siguientes formatos, según tu protocolo:
+ Ejemplo: formato HLS
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
+ Ejemplo: formato DASH
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
**Para inhabilitar la compatibilidad con los anuncios superpuestos mediante el prefijo de inicialización de la sesión:**
+ En el reproductor, crea un cuerpo de mensaje JSON para la solicitud de inicialización de la sesión con el fin de: MediaTailor
+ Para inhabilitar la superposición de anuncios, añade un `overlays` objeto como clave de nivel superior con un valor de. `off` El valor por defecto `overlays` es. `on`
+ (Opcional) Proporcione los parámetros que MediaTailor luego se transfieran al ADS dentro de un `adsParams` objeto. Estos parámetros corresponden a la configuración `[player_params.param]` en la URL de la plantilla ADS de la configuración de MediaTailor.
**Example HLS:**
```
POST master.m3u8
{
"adsParams": {
"deviceType": "ipad"
},
"overlayAvails": "off"
}
```
**Example DASH:**
```
POST manifest.mpd
{
"adsParams": {
"deviceType": "androidmobile"
},
"overlayAvails": "off"
}
```
# Señalización manifiesta
MediaTailor activa la compatibilidad con anuncios superpuestos cuando ve un marcador SCTE-35 específico en el manifiesto. La señal requerida es un comando de empalme tipo 6, o señal horaria, es decir, una señal de inicio de publicidad superpuesta por un proveedor. Esta señal tiene un identificador de tipo de segmentación de `0x38`
El siguiente ejemplo muestra el marcador `0x38` SCTE-35 en un objeto JSON.
```
{
"tableId": 252,
"selectionSyntaxIndicator": false,
"privateIndicator": false,
"sectionLength": 53,
"protocolVersion": 0,
"encryptedPacket": false,
"encryptedAlgorithm": 0,
"ptsAdjustment": 0,
"cwIndex": 0,
"tier": 4095,
"spliceCommandLength": 5,
"spliceCommandType": 6,
"spliceCommand": {
"specified": true,
"pts": 1800392
},
"descriptorLoopLength": 31,
"descriptors": [
{
"spliceDescriptorTag": 2,
"descriptorLength": 29,
"indentifier": "CUEI",
"segmentationEventId": 158389361,
"segmentationEventCancelIndicator": false,
"programSegmentationFlag": true,
"segmentationDurationFlag": true,
"deliveryNotRestrictedFlag": false,
"webDeliveryAllowedFlag": true,
"noRegionalBlackoutFlag": true,
"archiveAllowedFlag": true,
"deviceResctrictions": 3,
"segmentationDuration": 1350000,
"segmentationUpidType": 9,
"segmentationUpidLength": 7,
"segmentationUpid": {
"0": 111,
"1": 118,
"2": 101,
"3": 114,
"4": 108,
"5": 97,
"6": 121
},
"segmentationTypeId": 56,
"segmentNum": 1,
"segmentsExpected": 0
}
],
"crc": 2510422713
}
```
El siguiente ejemplo muestra la señal SCTE-35 representada como un valor binario (base 32/hexadecimal):
```
0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
```
Los siguientes ejemplos muestran el marcador SCTE-35 en los manifiestos HLS y DASH.
**Example : Manifiesto HLS**
```
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:419
#EXT-X-DISCONTINUITY-SEQUENCE:3
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:09.231Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:15.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:21.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00002.ts
#EXT-X-DISCONTINUITY
#EXT-X-DATERANGE:ID="1692073825251-30-1",START-DATE="2023-08-15T04:30:25.251Z",DURATION=10.0,PLANNED-DURATION=10.0,SCTE35-OUT=0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:25.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00003.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:27.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00004.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:33.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00005.ts
#EXT-X-DISCONTINUITY
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:35.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00006.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:39.251Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
```
**Example : Manifiesto DASH**
```
https://aws.cloudfront.net/out/v1/abc/123/def/63736f7665726c6179
```
# Respuesta del Ad Decision Server (ADS)
La respuesta de ADS debe contener un evento de seguimiento válido. Como mínimo, el evento de seguimiento puede ser un evento `Impression` de seguimiento. El evento de seguimiento debe contener al menos un `NonLinear` anuncio. Este anuncio es un anuncio superpuesto y adopta la forma de un recurso estático, HTML o iFrame.
```
2.02
```
**Example 1: fuente del manifiesto de DASH para MediaTailor**
```
...
SCTE35-binary
...
...
```
**Example 2: manifiesto DASH MediaTailor personalizado que contiene una decoración con un identificador de anuncio**
```
...
...
...
```
# Seguimiento de anuncios superpuestos con metadatos del lado del cliente
MediaTailor coloca los anuncios superpuestos en el estado `nonLinearAdsList` de disponibilidad. La API de seguimiento MediaTailor del lado del cliente tiene dos objetos raíz, denominados y. `avails` `nonLinearAvails` Si la respuesta VAST es un VMAP con o`nonlinear`, `breakType` los metadatos disponibles se encuentran dentro del objeto raíz. `nonLinearAvails` Si la respuesta VAST es un VMAP con un `breakType` de `linear` o es una respuesta VAST simple sin VMAP, los metadatos de disponibilidad se encuentran dentro del objeto raíz. `avails`
Para obtener más información sobre el seguimiento del lado del cliente, consulte. [Seguimiento de anuncios del lado del cliente](ad-reporting-client-side.md)
El siguiente ejemplo muestra una respuesta VAST simple o una respuesta VMAP con un `breakType` valor de. `linear`
```
{
"avails": [
{
"adBreakTrackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=breakstartimpression"
],
"eventType": "breakStart"
},
{
"beaconUrls": [
"https://adserver.com/beacon=breakendimpression"
],
"eventType": "breakEnd"
}
],
"adMarkerDuration": null,
"ads": [],
"availId": "828",
"availProgramDateTime": null,
"duration": "PT0S",
"durationInSeconds": 0,
"meta": null,
"nonLinearAdsList": [
{
"extensions": null,
"nonLinearAdList": [
{
"adId": "",
"adParameters": null,
"adSystem": "2.0",
"adTitle": "2",
"apiFramework": null,
"clickThrough": null,
"clickTracking": null,
"clickTrackingId": null,
"creativeAdId": "",
"creativeId": "18",
"creativeSequence": "",
"duration": null,
"durationInSeconds": 0,
"expandedHeight": null,
"expandedWidth": null,
"height": "360",
"htmlResource": null,
"iFrameResource": null,
"maintainAspectRatio": false,
"minSuggestedDuration": null,
"scalable": false,
"staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
"staticResourceCreativeType": "text/js_ref",
"width": "640"
}
],
"trackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=impression"
],
"duration": null,
"durationInSeconds": 0,
"eventId": null,
"eventProgramDateTime": null,
"eventType": "impression",
"startTime": null,
"startTimeInSeconds": 0
}
]
}
],
"startTime": "PT1M46.08S",
"startTimeInSeconds": 106.08
}
],
"dashAvailabilityStartTime": null,
"hlsAnchorMediaSequenceNumber": null,
"nextToken": null,
"nonLinearAvails": []
}
```
El siguiente ejemplo muestra una respuesta de VMAP simple con un `breakType` valor de. `nonlinear`
```
{
"avails": [],
"dashAvailabilityStartTime": null,
"hlsAnchorMediaSequenceNumber": null,
"nextToken": null,
"nonLinearAvails": [
{
"adBreakTrackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=breakstartimpression"
],
"eventType": "breakStart"
},
{
"beaconUrls": [
"https://adserver.com/beacon=breakendimpression"
],
"eventType": "breakEnd"
}
],
"adMarkerDuration": null,
"ads": [],
"availId": "828",
"availProgramDateTime": null,
"duration": "PT0S",
"durationInSeconds": 0,
"meta": null,
"nonLinearAdsList": [
{
"extensions": null,
"nonLinearAdList": [
{
"adId": "",
"adParameters": null,
"adSystem": "2.0",
"adTitle": "2",
"apiFramework": null,
"clickThrough": null,
"clickTracking": null,
"clickTrackingId": null,
"creativeAdId": "",
"creativeId": "18",
"creativeSequence": "",
"duration": null,
"durationInSeconds": 0,
"expandedHeight": null,
"expandedWidth": null,
"height": "360",
"htmlResource": null,
"iFrameResource": null,
"maintainAspectRatio": false,
"minSuggestedDuration": null,
"scalable": false,
"staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
"staticResourceCreativeType": "text/js_ref",
"width": "640"
}
],
"trackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=impression"
],
"duration": null,
"durationInSeconds": 0,
"eventId": null,
"eventProgramDateTime": null,
"eventType": "impression",
"startTime": null,
"startTimeInSeconds": 0
}
]
}
],
"startTime": "PT1M46.08S",
"startTimeInSeconds": 106.08
}
]
}
```