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. # Commencer à insérer MediaTailor des publicités Pour l'utiliser AWS Elemental MediaTailor, vous devez disposer d'une autorisation Compte AWS et pour accéder aux MediaTailor configurations, les visualiser et les modifier. Pour plus d’informations sur la procédure à utiliser, consultez [Con AWS Elemental MediaTailor figuration](setting-up.md). Ce didacticiel de mise en route vous explique comment effectuer les tâches suivantes : + Préparez vos flux de contenu HLS ou DASH + Configurer l'URL d'un modèle de serveur de décision publicitaire (ADS) + Création d'une MediaTailor configuration contenant un point de terminaison de lecture + Utilisez votre lecteur ou votre réseau de diffusion de contenu (CDN) pour envoyer une demande de lecture à MediaTailor Pour une configuration avancée de l'URL ADS à l'aide de variables dynamiques et de paramètres du lecteur, voir[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). Pour plus d'informations sur le transfert de paramètres CDNs, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). Lorsque vous aurez terminé, vous pourrez envoyer une demande de diffusion MediaTailor pour que le contenu publicitaire soit personnalisé dans votre stream. **Topics** + [Conditions préalables](#prerequisites) + [Étape 1 : Accès AWS Elemental MediaTailor](#access-emt) + [Étape 2 : préparer un stream](#getting-started-prep-stream) + [Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête](#getting-started-configure-request) + [Étape 4 : créer une configuration](#getting-started-add-mapping) + [Étape 5 : tester la configuration](#getting-started-test-config) + [Étape 6 : envoyer la demande de lecture à AWS Elemental MediaTailor](#send-request-to-mediatailor) + [Étape 7 (facultatif) : Surveiller AWS Elemental MediaTailor l'activité](#monitor-step) + [Étape 8 : nettoyer](#clean-up) ## Conditions préalables Avant de commencer, assurez-vous d’avoir terminé les étapes de [Con AWS Elemental MediaTailor figuration](setting-up.md). ## Étape 1 : Accès AWS Elemental MediaTailor À l'aide de vos informations d'identification IAM, connectez-vous à la MediaTailor console à l'adresse**https://console.aws.amazon.com/mediatailor/home**. ## Étape 2 : préparer un stream Configurez votre serveur d'origine pour produire des manifestes pour HLS ou DASH qui sont compatibles avec AWS Elemental MediaTailor. Votre serveur d'origine doit utiliser des ports HTTP standard (port 80) ou HTTPS (port 443). MediaTailor ne prend pas en charge les ports personnalisés pour les communications avec le serveur d'origine. ### Préparer un flux HLS Les manifestes HLS doivent satisfaire aux exigences suivantes : + Les manifestes doivent être accessibles sur l'Internet public. + Les manifestes doivent être en direct ou VOD. + Les manifestes doivent avoir un `EXT-X-VERSION` égal ou supérieur à `3`. + Pour le contenu en direct, les manifestes doivent contenir des marqueurs pour délimiter les diffusions de publicités. Cette option est facultative pour le contenu VOD, qui peut utiliser à la place les décalages VMAP. Le fichier manifeste doit avoir les emplacements publicitaires marqués avec l'une des actions suivantes : + **\$1EXT-X-CUE-OUT /\$1EXT -X-CUE-IN** (plus courant) avec des durées comme indiqué dans l'exemple suivant. ``` #EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN ``` + **\$1EXT-X-DATERANGE** (moins courant) avec les durées comme illustré dans l'exemple suivant. ``` #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF ``` Tous les champs affichés pour `#EXT-X-DATERANGE` sont obligatoires. La façon dont vous configurez les marqueurs de publicité dans le manifeste influence si les publicités sont insérées dans un flux ou remplacent d'autres fragments dans le flux. Pour de plus amples informations, veuillez consulter [Comprendre le comportement d'insertion des AWS Elemental MediaTailor publicités](ad-behavior.md). + Les listes de lecture multivariantes HLS doivent respecter les spécifications HLS décrites dans [HTTP live streaming : Master](https://tools.ietf.org/html/draft-pantos-http-live-streaming-21#section-4.3.4) playlist tags. En particulier, `#EXT-X-STREAM-INF` doit inclure les champs `RESOLUTION`, `BANDWIDTH` et `CODEC`. Après avoir configuré le stream, notez le préfixe de l'URL d'origine du contenu pour la playlist multivariante. Vous en aurez besoin pour créer la configuration dans AWS Elemental MediaTailor, plus loin dans ce didacticiel. ### Préparer un flux DASH Les manifestes DASH doivent satisfaire aux exigences suivantes : + Les manifestes doivent être accessibles sur l'Internet public. + Les manifestes doivent être en direct ou VOD. + Les manifestes doivent marquer les événements comme des diffusions de publicités à l'aide de marqueurs d'insertion de jointure ou marqueurs de signal temporel. Vous pouvez fournir les marqueurs de publicité en XML clair ou en binaire encodé en base64. Pour l'insertion par épissure, l' out-of-networkindicateur doit être activé. Pour les marqueurs de signal temporel, l'ID du type de segmentation, situé dans l'UPID de segmentation, doit être une valeur de sortie reconnue par. AWS Elemental MediaTailor La diffusion de publicités commence au début de l'événement et dure pendant la durée de l'évènement, si elle est spécifiée, ou jusqu'à ce que le prochain événement démarre. L'exemple suivant illustre un événement désigné comme une diffusion de publicités à l'aide de marqueurs d'insertion de jointure. La durée de cette diffusion de publicités correspond la durée de l'événement. ``` ``` + Les diffusions de publicités doivent avoir les mêmes paramètres `AdaptationSet` et `Representation` que les flux de contenu. AWS Elemental MediaTailor utilise ces paramètres pour transcoder les publicités pour correspondre aux flux de contenu, pour une bascule en douceur entre les deux. Une fois que vous avez configuré le flux, notez le préfixe d'URL de l'origine du contenu du manifeste DASH. Vous en aurez besoin pour créer la configuration dans AWS Elemental MediaTailor, plus loin dans ce didacticiel. ## Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête Pour déterminer les paramètres de requête dont ADS a besoin, générez une URL de balise publicitaire à partir d'ADS. Cette URL fonctionne comme modèle pour les demandes adressées à ADS et se compose des éléments suivants : + Valeurs statiques + Valeurs générées par AWS Elemental MediaTailor (indiquées par `session` ou paramètres de `avail` requête) + Les valeurs générées par les lecteurs, obtenues à partir de l'application cliente (indiquées par les paramètres de requête `player_params.`) **Example URL de balise publicitaire provenant d'un serveur ADS** ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` Où : + **output** et **content\$1id** sont des valeurs statiques + **PlayerSession= [session.id]** est une valeur dynamique fournie par. AWS Elemental MediaTailor La valeur de **[session.id]** change pour chaque session de lecteur et génère une autre URL pour la demande VAST de chaque session. + **cust\$1params** sont des valeurs dynamiques fournies par le lecteur La demande de playlist multivariante du lecteur doit fournir des paires clé-valeur correspondant aux paramètres de `player_params.` requête contenus dans l'URL de demande ADS. Pour plus d'informations sur la configuration des paires clé-valeur dans la demande à AWS Elemental MediaTailor, consultez. [MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md) Entrez l'URL du « modèle » configuré lorsque vous créez le server/ADS mappage d'origine dans MediaTailor, dans[Étape 4 : créer une configuration](#getting-started-add-mapping). **Test** Vous pouvez utiliser une réponse VAST statique à partir de votre ADS à des fins de test. Idéalement, la réponse VAST renvoie un MP4 rendu de qualité mezzanine qui AWS Elemental MediaTailor peut être transcodé. Si la réponse de l'ADS contient plusieurs rendus de lecture, MediaTailor sélectionne le MP4 rendu de la plus haute qualité et de la meilleure résolution et l'envoie au transcodeur. ## Étape 4 : créer une configuration La AWS Elemental MediaTailor configuration contient des informations de mappage pour le serveur d'origine et ADS. **Pour créer une configuration (console)** 1. Ouvrez la MediaTailor console à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Sur la page **Configurations**, choisissez **Create configuration (Créer une configuration)**. 1. Dans la section **Configuration** en bas de la page, pour **Configuration name (Nom de configuration)**, entrez un nom unique qui décrit la configuration. Le nom est l'identifiant principal de la configuration. La longueur maximale autorisée est de 512 caractères. 1. Pour **Source de contenu vidéo**, entrez le préfixe URL de la playlist multivariante HLS ou le manifeste DASH de ce flux, moins l'ID de la ressource. Par exemple, si l'URL de la playlist multivariante est`http://origin-server.com/a/master.m3u8`, vous devez entrer`http://origin-server.com/a/`. Vous pouvez également saisir un préfixe plus court tel que `http://origin-server.com`, mais le `/a/` doit alors être inclus dans l'ID de ressource de la demande de contenu du lecteur. La longueur maximale est de 512 caractères. **Note** Si l'origine de votre contenu utilise HTTPS, son certificat doit provenir d'une autorité de certification reconnue. (Ce ne peut pas être un certificat auto-signé.) Dans le cas contraire, il AWS Elemental MediaTailor ne parvient pas à se connecter à l'origine du contenu et ne peut pas diffuser de manifestes en réponse aux demandes des joueurs. 1. Pour le **serveur de décision publicitaire**, entrez l'URL de votre ADS. Il s'agit de l'URL avec les variables comme décrit dans [Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête](#getting-started-configure-request) ou l'URL VAST statique que vous utilisez à des fins de test. La longueur maximale est de 25 000 caractères. **Note** Si votre ADS utilise HTTPS, son certificat doit provenir d'une autorité de certification reconnue. (Ce ne peut pas être un certificat auto-signé.) Il en va de même pour la publicité en mezzanine URLs renvoyée par l'ADS. Dans le cas contraire, MediaTailor ne peut pas récupérer et réassocier les publicités dans les manifestes à partir de l'origine du contenu. 1. (Facultatif si nécessaire pour DASH) Dans **Location**, choisissez **DISABLED** si vous avez défini des règles de routage CDN pour accéder aux MediaTailor manifestes et que vous utilisez des rapports côté client ou si vos joueurs acceptent les redirections HTTP persistantes. Pour en savoir plus sur la fonction **Location**, consultez [Fonction de localisation DASH](dash-location-feature.md). 1. (Facultatif) Si votre serveur d'origine produit des manifestes DASH à période unique, choisissez **DASH mpd manifest origin type (Type de manifeste d'origine DASH mpd)**, puis **SINGLE\$1PERIOD**. Par défaut, MediaTailor gère les manifestes DASH comme des manifestes sur plusieurs périodes. Pour de plus amples informations, veuillez consulter [Intégration d'une source MPEG-DASH](manifest-dash.md). 1. Choisissez **Créer une configuration**. AWS Elemental MediaTailor affiche la nouvelle configuration sur la page **Configurations**. ## Étape 5 : tester la configuration Une fois que vous avez enregistré la configuration, testez le flux à l'aide d'une URL au format approprié pour votre protocole de streaming : + Exemple : HLS ``` playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8 ``` + Exemple : DASH ``` playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd ``` Où : + `playback-endpoint` est le point de terminaison de lecture unique généré par AWS Elemental MediaTailor lorsque la configuration a été créée. Exemple ``` https://777788889999.mediatailor.us-east-1.amazonaws.com ``` + `hashed-account-id`est votre Compte AWS identifiant. Exemple ``` 777788889999 ``` + `origin-id` est le nom que vous avez attribué lors de la création de la configuration. Exemple ``` myOrigin ``` + `master.m3u8` ou `manifest.mpd` est le nom du fichier manifeste du flux de test, ainsi que son extension de fichier. Définissez ceci afin que vous obteniez un manifeste entièrement identifié lorsque vous l'ajoutez à la source du contenu vidéo que vous avez configuré dans [Étape 4 : créer une configuration](#getting-started-add-mapping). En utilisant les valeurs des exemples précédents, les valeurs complètes URLs sont les suivantes. + Exemple : HLS ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8 ``` + Exemple : DASH ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd ``` Vous pouvez tester le flux à l'aide de l'une des méthodes suivantes. + Comme illustré dans l'exemple précédent, saisissez l'URL dans un lecteur autonome. + Testez le flux dans votre propre environnement de lecteur. ## Étape 6 : envoyer la demande de lecture à AWS Elemental MediaTailor Configurez le lecteur en aval ou le réseau de diffusion de contenu (CDN) pour envoyer les demandes de lecture au point de terminaison de lecture de la configuration, fourni à partir de AWS Elemental MediaTailor. Toutes les variables dynamiques définies par le lecteur que vous avez utilisées dans l'URL de la demande ADS [Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête](#getting-started-configure-request) doivent être définies dans la demande de manifeste du lecteur. **Example** Supposons que l'URL ADS de votre modèle est la suivante. ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` Définissez ensuite `[player_params.cust_params]` dans la demande du joueur en préfacant la paire clé-valeur par. `ads.` AWS Elemental MediaTailor transmet les paramètres qui ne sont pas précédés `ads.` au serveur d'origine au lieu de l'ADS. L'URL de la demande du lecteur est une variante des exemples HLS et DASH suivants. ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo ``` ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo ``` Lorsqu'il AWS Elemental MediaTailor reçoit la demande du joueur, il définit les variables du joueur en fonction des informations contenues dans la demande. L'URL de la demande ADS résultante est une variante de ce qui suit. ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=&cust_params=viewerinfo ``` Pour plus d'informations sur la configuration des paires clé-valeur à transmettre au serveur ADS, consultez [MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). ## Étape 7 (facultatif) : Surveiller AWS Elemental MediaTailor l'activité Utilisez Amazon CloudWatch et Amazon CloudWatch Logs pour suivre les AWS Elemental MediaTailor activités, telles que le nombre de demandes, d'erreurs et d'annonces enregistrées. Si c'est la première fois que vous utilisez CloudWatch with AWS Elemental MediaTailor, créez un rôle Gestion des identités et des accès AWS (IAM) pour permettre la communication entre les services. **Pour autoriser AWS Elemental MediaTailor l'accès à CloudWatch (console)** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le volet de navigation de la console IAM, sélectionnez **Roles** (Rôles), puis **Create role** (Créer un rôle). 1. Choisissez **un autre** type de Compte AWS rôle. 1. Pour **ID de compte**, entrez votre Compte AWS identifiant. 1. Sélectionnez **Demander un ID externe** et entrez **midas**. Cette option ajoute automatiquement une condition à la stratégie d'approbation qui permet au service d'assumer le rôle uniquement si la demande inclut l'élément `sts:ExternalID` approprié. 1. Choisissez **Suivant : Autorisations**. 1. Ajoutez une stratégie d'autorisations qui spécifie les actions que ce rôle peut effectuer. Sélectionnez l'une des options suivantes, puis choisissez **Next : Review** : + **CloudWatchLogsFullAccess**pour fournir un accès complet à Amazon CloudWatch Logs + **CloudWatchFullAccess**pour fournir un accès complet à Amazon CloudWatch 1. Pour **Nom du rôle**, saisissez **MediaTailorLogger**, puis choisissez **Créer un rôle**. 1. Sur la page **Rôles**, sélectionnez le rôle que vous venez de créer. 1. Modifiez la relation d'approbation pour mettre à jour le mandataire : 1. Sur la page **Récapitulatif** du rôle, choisissez l'onglet **Relation d'approbation**. 1. Choisissez **Modifier la relation d’approbation**. 1. Dans le document de stratégie, remplacez le mandataire par le service AWS Elemental MediaTailor . Il doit ressembler à ce qui suit. ``` "Principal": { "Service": "mediatailor.amazonaws.com" }, ``` L'ensemble de la stratégie doit se présenter comme suit. 1. Choisissez **Mettre à jour la politique d'approbation**. ## Étape 8 : nettoyer Pour éviter des frais externes, supprimez toutes les configurations superflues. **Pour supprimer une configuration (console)** 1. Sur la page AWS Elemental MediaTailor **Configurations**, effectuez l'une des opérations suivantes : + Choisissez le **Nom de configuration** correspondant à la configuration que vous souhaitez supprimer. + Dans la colonne **Configuration name (Nom de configuration)**, cochez la case d'option, puis choisissez **Delete (Supprimer)**. 1. Dans la zone de confirmation **Delete configuration (Supprimer la configuration)**, entrez **Delete**, puis choisissez à nouveau **Delete (Supprimer)**. AWS Elemental MediaTailor supprime la configuration.