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. # Anuncios superpuestos En el caso de los flujos de trabajo de retransmisión en directo en los que quieres aumentar la monetización sin interrumpir la experiencia de visualización de los anuncios de media tirada, puedes aprovechar tu AWS Elemental MediaTailor integración actual para orientar un formato de publicidad orientado al cliente. *Este tipo de publicidad se conoce como anuncios superpuestos.* Los anuncios superpuestos son anuncios de vídeo no lineales que aparecen en forma de «anuncios en banda L», «anuncios de vídeo no lineales», «anuncios», «superposiciones de movimiento», «publicidad integrada en el contenido» o «picture-in-picture anuncios con marcos». MediaTailor detecta un marcador SCTE-35 con un tipo de segmentación como señal dentro de la banda para detectar una oportunidad de inserción de anuncios superpuestos. `id=0x38` El marcador SCTE-35 hace MediaTailor que se envíe una solicitud al Ad Decision Server (ADS), que luego responde con una carga de anuncios no lineal en la respuesta VAST. MediaTailor analiza la respuesta de VAST para permitir la inserción de anuncios superpuestos. MediaTailor no combina anuncios lineales, sino que indica al jugador que hay un anuncio superpuesto no lineal disponible para reproducir. Esta señalización permite al jugador buscar y correlacionar los anuncios no lineales que desea reproducir desde el punto de seguimiento del lado del cliente. A continuación, el reproductor se encarga de la visualización, los informes y otras tareas relacionadas con esos anuncios. Por ejemplo, el desarrollador del reproductor puede usar un SDK de dispositivo de un proveedor que admita formatos de anuncios superpuestos. Para obtener más información sobre las integraciones de seguimiento del lado del cliente, consulte. [Integraciones de seguimiento de anuncios del lado del cliente](ad-reporting-client-side-ad-tracking-integrations.md) ![\[La imagen muestra una cronología de varios tipos de anuncios que se muestran junto a un vídeo de contenido. Los anuncios lineales se reproducen antes y después del contenido del vídeo. El anuncio que aparece antes del vídeo de contenido se denomina anuncio previo a la reproducción. El anuncio que sigue al vídeo de contenido se denomina anuncio postroll. Un anuncio no lineal se superpone a una parte del contenido del vídeo en sí. El anuncio no lineal se denomina anuncio superpuesto.\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/images/client-side-overlays.png) **Topics** + [Requisitos previos para usar anuncios superpuestos con MediaTailor](overlay-ads-prerequisites.md) + [Cómo empezar a usar anuncios superpuestos con MediaTailor](overlay-ads-getting-started.md) + [Registro y métricas para anuncios superpuestos en MediaTailor](overlay-ads-logging-and-metrics.md) + [Facturación de anuncios superpuestos en MediaTailor](overlay-ads-billing.md) # Requisitos previos para usar anuncios superpuestos con MediaTailor Cuando se utilizan anuncios superpuestos con: MediaTailor + El flujo de trabajo debe ser en directo, no de vídeo bajo demanda (VOD). + La respuesta del Ad Decision Server (ADS) debe configurarse para que muestre solo anuncios no lineales en la respuesta VAST. MediaTailor ignora los anuncios lineales a los efectos de crear una combinación de anuncios. + El manifiesto debe usar un mensaje de señal horaria SCTE-35 con un tipo de segmentación para `id=0x38` invocar la función de anuncios superpuestos. + El proveedor de streaming debe tener el control de la aplicación del dispositivo cliente y estar integrado con la API de seguimiento del lado del cliente. MediaTailor # 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 ~~Alternate Audio~~ ``` # 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.0 2 ``` **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 } ] } ``` # Registro y métricas para anuncios superpuestos en MediaTailor En esta sección, se explican el registro y las métricas de los anuncios superpuestos. MediaTailor Para obtener más información sobre cómo configurar el registro, consulte[Supervisar y etiquetar los recursos AWS Elemental MediaTailor](monitoring.md). **Topics** + [CloudWatch registros](#overlay-ads-logging-and-metrics-cloudwatch) + [CloudWatch métricas](#overlay-ads-logging-and-metrics-cloudwatch-metrics) ## CloudWatch registros CloudWatch recopila la siguiente información de registro sobre los anuncios superpuestos: + `VAST_RESPONSE`- Muestra información sobre la lista de anuncios no lineales. + `FILLED_PROVIDER_OVERLAY`- Muestra información sobre los anuncios no lineales. **nota** `RAW_ADS_RESPONSE`Es un evento opcional que muestra la respuesta original del ADS. El uso de este evento es especialmente útil en un entorno de preparación y pruebas. Para habilitar este evento en una configuración o cuenta, envía un ticket a AWS Support. ## CloudWatch métricas MediaTailor recopila las métricas de anuncios superpuestos por separado de otras métricas de ADS. MediaTailorrecopila estas métricas después de obtener correctamente los anuncios del ADS. No tienes que sondear la `GetTracking` API para recopilar las métricas. En la siguiente tabla se describen CloudWatch las métricas de los anuncios superpuestos: | Métrica | Description (Descripción) | | --- | --- | | AdDecisionServer.OverlayAds | El número de anuncios superpuestos incluidos en las respuestas de ADS en el período de CloudWatch tiempo que especificaste. | | AdDecisionServer.OverlayErrors | El número de respuestas con código de `200` estado no HTTP, respuestas vacías y respuestas agotadas que se MediaTailor recibieron del ADS en el período de CloudWatch tiempo que especificó. | | AdDecisionServer.OverlayFilled | El número de solicitudes disponibles que se rellenaron correctamente con al menos un anuncio superpuesto: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/mediatailor/latest/ug/overlay-ads-logging-and-metrics.html) `SampleCount`registra el número de vacíos rellenados. `Sum`registra el número de superposiciones disponibles que se han rellenado correctamente. | | AdDecisionServer.OverlayMinSuggestedDuration | La suma de `minSuggestedDuration` las duraciones, en milisegundos, de todos los anuncios que se MediaTailor recibieron del ADS en el período de CloudWatch tiempo que especificó. Si `minSuggestedDuration` no se especifica, la duración que se muestra es la duración planificada. | | AdDecisionServer.OverlayLatency | El tiempo de respuesta, en milisegundos, de las solicitudes que MediaTailor se realizan al ADS. | | AdDecisionServer.OverlayTimeouts | El número de solicitudes enviadas al ADS que se agotó el tiempo de espera en el período de CloudWatch tiempo que especificó. | | AdsBilled | Para obtener más información sobre los anuncios facturados, consulte. [Facturación de anuncios superpuestos en MediaTailor](overlay-ads-billing.md) | | Avail.\$1 | Como MediaTailor no planifica los anuncios superpuestos, CloudWatch no muestra ninguna `Avail.X` métrica. | | SkippedReason.\$1 | Como MediaTailor no planifica los anuncios superpuestos, CloudWatch no muestra ninguna `SkippedReason.X` métrica. | # Facturación de anuncios superpuestos en MediaTailor MediaTailor factura a los clientes en función del número de anuncios no lineales que aparecen en la respuesta de ADS. Este número incluye los anuncios no lineales que se extienden más allá de la duración de la pausa. Después de MediaTailor llenar el espacio disponible, factura los anuncios que rellenó. En el caso de los flujos de trabajo de captura previa, MediaTailor no factura los anuncios cuando los recupera, sino cuando ve que hay un anuncio compatible disponible en la ventana de consumo de esa sesión. Para obtener información de facturación adicional, consulte. [https://aws.amazon.com/mediatailor/pricing/](https://aws.amazon.com/mediatailor/pricing/)