Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Superposer des publicités Pour les flux de diffusion en direct dans lesquels vous souhaitez augmenter la monétisation sans interrompre l'expérience de visionnage avec des publicités intermédiaires, vous pouvez tirer parti de votre AWS Elemental MediaTailor intégration actuelle pour définir un format publicitaire rendu côté client. Ce type de publicité est connu sous le nom de *publicités superposées*. Les publicités superposées sont des publicités vidéo non linéaires qui apparaissent sous la forme de « publicités en bande L », de « publicités vidéo non linéaires », de « publicités », de « superpositions animées », de « picture-in-picture publicités intégrées au contenu » ou de « publicités encadrées ». MediaTailor détecte un marqueur SCTE-35 avec un type de segmentation en `id=0x38` tant que signal intra-bande pour une opportunité d'insertion publicitaire en superposition. Le marqueur SCTE-35 envoie une demande MediaTailor au serveur de décision publicitaire (ADS), qui répond ensuite avec une charge utile publicitaire non linéaire dans la réponse VAST. MediaTailor analyse la réponse VAST afin de prendre en charge l'insertion d'annonces par superposition. MediaTailor n'assemble pas de publicités linéaires, mais indique au joueur qu'une publicité non linéaire est disponible pour être diffusée. Cette signalisation permet au joueur de récupérer et de corréler les publicités non linéaires à diffuser à partir du point de suivi côté client. Le joueur gère ensuite l'affichage, les rapports et les autres tâches liées à ces publicités. Par exemple, le développeur du lecteur peut utiliser un SDK pour appareil fourni par un fournisseur qui prend en charge les formats publicitaires superposés. Pour plus d'informations sur les intégrations de suivi côté client, consultez. [Intégrations de suivi publicitaire côté client](ad-reporting-client-side-ad-tracking-integrations.md) ![\[L'image montre une chronologie des différents types d'annonces affichées à côté d'une vidéo de contenu. Les publicités linéaires sont diffusées avant et après le contenu vidéo. L'annonce qui précède le contenu vidéo est appelée publicité pré-roll. L'annonce qui suit le contenu vidéo est appelée publicité post-roll. Une publicité non linéaire recouvre une partie du contenu vidéo lui-même. L'annonce non linéaire est appelée publicité superposée.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/client-side-overlays.png) **Topics** + [Conditions préalables à l'utilisation d'annonces incrustées avec MediaTailor](overlay-ads-prerequisites.md) + [Commencer à utiliser les publicités incrustées avec MediaTailor](overlay-ads-getting-started.md) + [Enregistrement et statistiques pour les annonces incrustées dans MediaTailor](overlay-ads-logging-and-metrics.md) + [Facturation des publicités incrustées dans MediaTailor](overlay-ads-billing.md) # Conditions préalables à l'utilisation d'annonces incrustées avec MediaTailor Les conditions préalables suivantes s'appliquent lors de l'utilisation d'annonces en incrustation avec : MediaTailor + Le flux de travail doit être en direct et non en vidéo à la demande (VOD). + La réponse du serveur ADS (Ad Decision Server) doit être configurée pour renvoyer uniquement des publicités non linéaires dans la réponse VAST. MediaTailor ignore les publicités linéaires aux fins de l'assemblage des publicités. + Le manifeste doit utiliser un message de signal temporel SCTE-35 de type segmentation `id=0x38` pour invoquer la fonctionnalité de superposition. + Le fournisseur de streaming doit contrôler l'application client-appareil et être intégré à l'API de suivi côté MediaTailor client. # Commencer à utiliser les publicités incrustées avec MediaTailor Cette section explique comment commencer à utiliser la fonctionnalité de superposition de. MediaTailor Vous allez configurer la signalisation SCTE-35, configurer les réponses du serveur ADS (Ad Decision Server) et configurer le contrôle au niveau de la session. **Topics** + [Activation des publicités superposées](overlay-ads-getting-started-enabling.md) + [Suivi des publicités superposées à l'aide de métadonnées côté client](overlay-ads-client-side-tracking-metadata.md) # Activation des publicités superposées MediaTailor la prise en charge des annonces incrustées est activée par défaut. Un type de marqueur publicitaire SCTE-35 spécifique dans le manifeste déclenche l'insertion d'une publicité superposée. Certains joueurs étant susceptibles de ne pas prendre en charge le rendu des publicités incrustées côté client, vous pouvez désactiver cette fonctionnalité au niveau de la session. **Pour désactiver la prise en charge des publicités en superposition à l'aide des préfixes de lecture HLS ou DASH :** + Depuis le lecteur, initialisez une nouvelle session de MediaTailor lecture à l'aide d'une requête dans l'un des formats suivants, conformément à votre protocole : + Exemple : format HLS ``` GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off ``` + Exemple : format DASH ``` GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off ``` **Pour désactiver la prise en charge des publicités superposées à l'aide du préfixe d'initialisation de session :** + Sur le lecteur, créez un corps de message JSON pour la demande d'initialisation de session afin de MediaTailor : + Pour désactiver la prise en charge de la superposition de publicités, ajoutez un `overlays` objet en tant que clé de niveau supérieur avec une valeur de. `off` La `overlays` valeur par défaut est`on`. + (Facultatif) Fournissez tous les paramètres qui sont MediaTailor ensuite transmis à l'ADS à l'intérieur d'un `adsParams` objet. Ces paramètres correspondent aux paramètres `[player_params.param]` dans l'URL modèle d'ADS de la configuration de MediaTailor. **Example HLS :** ``` POST master.m3u8 { "adsParams": { "deviceType": "ipad" }, "overlayAvails": "off" } ``` **Example DASH :** ``` POST manifest.mpd { "adsParams": { "deviceType": "androidmobile" }, "overlayAvails": "off" } ``` # Signalisation manifeste MediaTailor trigger overlay-ads support lorsqu'il voit un marqueur SCTE-35 spécifique dans le manifeste. Le signal requis est une commande d'épissage de type 6, ou signal horaire, qui est un signal Provider Overlay Advertisement Start. Ce signal possède un identifiant de type de segmentation de `0x38` L'exemple suivant montre le marqueur `0x38` SCTE-35 dans un objet 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 } ``` L'exemple suivant montre le signal SCTE-35 représenté sous forme de valeur binaire (base 32/hexadécimal) : ``` 0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f ``` Les exemples suivants montrent le marqueur SCTE-35 dans les manifestes HLS et DASH. **Example : manifeste 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 : manifeste DASH** ``` https://aws.cloudfront.net/out/v1/abc/123/def/ 63736f7665726c6179 ~~Alternate Audio~~ ``` # Réponse du serveur ADS (Ad Decision Server) La réponse ADS doit contenir un événement de suivi valide. Au minimum, l'événement de suivi peut être un événement `Impression` de suivi. L'événement de suivi doit contenir au moins une `NonLinear` annonce. Cette annonce est une publicité superposée, qui prend la forme d'une ressource statique, HTML ou iFrame. ``` 2.0 2 ``` **Example 1 : source du manifeste DASH pour MediaTailor** ``` ... SCTE35-binary ... ... ``` **Example 2 : manifeste DASH MediaTailor personnalisé contenant une décoration d'identifiant publicitaire** ``` ... ... ... ``` # Suivi des publicités superposées à l'aide de métadonnées côté client MediaTailor place les publicités superposées dans `nonLinearAdsList` le catalogue. L'API de suivi MediaTailor côté client possède deux objets racines, appelés `avails` et. `nonLinearAvails` Si la réponse VAST est un VMAP avec ou `breakType``nonlinear`, les métadonnées Avail se trouvent dans l'objet `nonLinearAvails` racine. Si la réponse VAST est une réponse VMAP avec un `breakType` de`linear`, ou une réponse VAST simple sans VMAP, les métadonnées Avail se trouvent dans l'`avails`objet racine. Pour plus d'informations sur le suivi côté client, consultez. [Suivi des publicités côté client](ad-reporting-client-side.md) L'exemple suivant montre une réponse VAST simple ou une réponse VMAP avec une `breakType` valeur 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": [] } ``` L'exemple suivant montre une réponse VMAP simple avec une `breakType` valeur 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 } ] } ``` # Enregistrement et statistiques pour les annonces incrustées dans MediaTailor Cette section explique la journalisation et les statistiques relatives aux annonces incrustées. MediaTailor Pour plus d'informations sur la configuration de la journalisation, consultez[Ressources de surveillance et de balisage AWS Elemental MediaTailor](monitoring.md). **Topics** + [CloudWatch journaux](#overlay-ads-logging-and-metrics-cloudwatch) + [CloudWatch métriques](#overlay-ads-logging-and-metrics-cloudwatch-metrics) ## CloudWatch journaux CloudWatch collecte les informations de journal suivantes concernant les publicités incrustées : + `VAST_RESPONSE`- Affiche des informations sur la liste d'annonces non linéaires. + `FILLED_PROVIDER_OVERLAY`- Affiche des informations sur les publicités non linéaires. **Note** `RAW_ADS_RESPONSE`Il s'agit d'un événement facultatif qui montre la réponse initiale de l'ADS. L'utilisation de cet événement est particulièrement utile dans un environnement de préparation et de test. Pour activer cet événement sur une configuration ou un compte, envoyez un ticket au AWS Support. ## CloudWatch métriques MediaTailor collecte les statistiques relatives aux annonces superposées séparément des autres statistiques ADS. MediaTailorcollecte ces statistiques après avoir récupéré avec succès les publicités de l'ADS. Il n'est pas nécessaire d'interroger l'`GetTracking`API pour collecter les métriques. Le tableau suivant décrit les CloudWatch statistiques relatives aux annonces incrustées : | Métrique | Description | | --- | --- | | AdDecisionServer.OverlayAds | Le nombre d'annonces incrustées incluses dans les réponses ADS au cours de la CloudWatch période que vous avez spécifiée. | | AdDecisionServer.OverlayErrors | Le nombre de réponses par code d'`200`état autres que HTTP, de réponses vides et de réponses périmées MediaTailor reçues de l'ADS au cours de la CloudWatch période que vous avez spécifiée. | | AdDecisionServer.OverlayFilled | Le nombre d'offres qui ont été remplies avec succès avec au moins une annonce superposée : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/overlay-ads-logging-and-metrics.html) `SampleCount`suit le nombre de fichiers disponibles. `Sum`suit le nombre de versions de superposition remplies avec succès. | | AdDecisionServer.OverlayMinSuggestedDuration | Somme des `minSuggestedDuration` durées, en millisecondes, de toutes les publicités MediaTailor reçues de l'ADS pendant la CloudWatch période que vous avez spécifiée. Si `minSuggestedDuration` ce n'est pas spécifié, la durée affichée est la durée planifiée. | | AdDecisionServer.OverlayLatency | Le temps de réponse, en millisecondes, pour les demandes adressées à l' MediaTailor ADS. | | AdDecisionServer.OverlayTimeouts | Le nombre de demandes d'expiration adressées à l'ADS au cours de la CloudWatch période que vous avez spécifiée. | | AdsBilled | Pour plus d'informations sur les publicités facturées, consultez[Facturation des publicités incrustées dans MediaTailor](overlay-ads-billing.md). | | Avail.\$1 | Parce qu' MediaTailor il ne planifie pas les publicités incrustées et CloudWatch n'affiche aucun indicateur`Avail.X`. | | SkippedReason.\$1 | Parce qu' MediaTailor il ne planifie pas les publicités incrustées et CloudWatch n'affiche aucun indicateur`SkippedReason.X`. | # Facturation des publicités incrustées dans MediaTailor MediaTailor facture les clients en fonction du nombre d'annonces non linéaires figurant dans la réponse ADS. Ce chiffre inclut les publicités non linéaires qui s'étendent au-delà de la durée de la pause. Une fois le fichier MediaTailor rempli, il facture les annonces qu'il a publiées. Pour les flux de travail de prélecture, MediaTailor ne facture pas les publicités lors de la récupération du préchargement, mais plutôt lorsqu'une publicité compatible apparaît dans la fenêtre de consommation de cette session. Pour des informations de facturation supplémentaires, consultez[https://aws.amazon.com/mediatailor/pricing/](https://aws.amazon.com/mediatailor/pricing/).