View a markdown version of this page

Création d'une configuration MediaTailor de lecture - AWS Elemental MediaTailor

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.

Création d'une configuration MediaTailor de lecture

Cette rubrique explique comment créer une configuration pour commencer à recevoir des flux de contenu AWS Elemental MediaTailor. Il montre également comment fournir un point d'accès aux périphériques de lecture en aval pour demander du contenu.

Vous pouvez utiliser la AWS Elemental MediaTailor console, le AWS Command Line Interface (AWS CLI) > ou l' MediaTailor API pour créer une configuration. Pour plus d'informations sur la création d'une configuration via l' MediaTailor API AWS CLI or, consultez la référence de l'AWS Elemental MediaTailor API .

Lorsque vous créez une configuration, ne saisissez pas d'informations d'identification sensibles dans des champs de forme libre tels que le champ Nom de la configuration. Les informations d'identification peuvent inclure des éléments tels que les numéros de compte client. En outre, n'utilisez pas d'informations d'identification lorsque vous travaillez dans la MediaTailor console, l'API REST AWS CLI, les kits de AWS développement logiciel (SDK). Toutes les données que vous saisissez MediaTailor peuvent être récupérées pour être incluses dans les journaux de diagnostic ou Amazon CloudWatch Events.

Pour ajouter une configuration (console)
  1. Ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.

  2. Sur la page Configurations, choisissez Create configuration (Créer une configuration).

  3. Renseignez les champs concernant la configuration, comme décrit dans les rubriques suivantes :

  4. Choisissez Créer une configuration.

    AWS Elemental MediaTailor affiche la nouvelle configuration dans le tableau de la page Configurations.

  5. (Recommandé) Configurez un CDN AWS Elemental MediaTailor pour les demandes de manifeste et de reporting. Vous pouvez utiliser les URL de lecture de la configuration pour la configuration du CDN. Pour plus d'informations sur la configuration d'un réseau de diffusion de contenu (CDN) pour les demandes de manifeste et de reporting, consultez Utilisation d'un CDN pour optimiser la personnalisation des MediaTailor publicités et la diffusion de contenu.

Réglages requis

Lorsque vous créez une configuration, vous devez inclure les paramètres obligatoires suivants.

Nom

Saisissez 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.

Source de contenu

Saisissez le préfixe d'URL pour le manifeste de ce flux, sans l'ID d'asset. La longueur maximale est de 512 caractères.

Par exemple, le préfixe d'URL http://origin-server.com/a/ est valide pour une URL de playlist multivariante HLS de http://origin-server.com/a/main.m3u8 et pour une URL DASH MPD de. http://origin-server.com/a/dash.mpd Vous pouvez également saisir un préfixe plus court tel que http://origin-server.com, mais le /a/ doit être inclus dans l'ID de ressource de la demande de contenu du lecteur.

Note

Si l'origine de votre contenu utilise HTTPS, son certificat doit provenir d'une autorité de certification reconnue. Il ne peut pas s'agir d'un certificat auto-signé. Si vous utilisez un certificat auto-signé, vous AWS Elemental MediaTailor ne parvenez pas à vous connecter à l'origine du contenu et ne pouvez pas diffuser de manifestes en réponse aux demandes des joueurs.

Serveur de décision publicitaire

Saisissez l'URL de votre serveur ADS. Il s'agit de l'URL avec les variables comme décrit dans Étape 3 : Configuration de l'URL de la demande ADS et des paramètres de requête 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. Il ne peut pas s'agir d'un certificat auto-signé. La même chose s'applique également aux URL des publicités au format mezzanine renvoyées par l'ADS. Si vous utilisez un certificat auto-signé, vous ne AWS Elemental MediaTailor pouvez pas récupérer et intégrer des publicités dans les manifestes à partir de l'origine du contenu.

Paramètres de configuration facultatifs

Vous pouvez éventuellement configurer des alias de configuration, des détails de personnalisation et des paramètres avancés dans la MediaTailor console, l' MediaTailor API ou le AWS Command Line Interface ()AWS CLI.

Alias de configuration

Vous trouverez ci-dessous des alias de configuration facultatifs que vous pouvez configurer dans la MediaTailor console ou à l'aide de l' MediaTailorAPI.

Variable de paramètre du joueur

Pour une configuration dynamique du domaine lors de l'initialisation de la session, ajoutez une ou plusieurs variables de paramètres de lecteur.

Pour plus d'informations sur l'utilisation des variables de paramètres du lecteur pour configurer dynamiquement des domaines, consultezMediaTailor variables de domaine pour plusieurs sources de contenu.

Configuration du journal

Les paramètres de configuration des journaux sont les suivants.

Pourcentage activé

Définit le pourcentage des journaux de session de configuration de lecture qui sont MediaTailor écrits dans les CloudWatch journaux. Par exemple, si votre configuration de lecture comporte 1 000 sessions et que vous définissez le pourcentage activé sur 60, MediaTailor écrit 600 journaux de session dans CloudWatch Logs.

Lorsque vous activez cette option, un rôle lié à un service est MediaTailor automatiquement créé qui permet d'écrire et MediaTailor de gérer les journaux de session dans votre compte CloudWatch Logs. Pour de plus amples informations, veuillez consulter Utilisation de rôles liés à des services pour MediaTailor.

Stratégies de journalisation

Indique la méthode utilisée pour collecter les journaux MediaTailor émis. Pour envoyer les journaux directement à CloudWatch Logs, choisissezLEGACY_CLOUDWATCH. Pour envoyer des CloudWatch journaux à Logs, qui les envoie ensuite à la destination de votre choix, choisissezVENDED_LOGS. Les destinations prises en charge sont un groupe de CloudWatch journaux Logs, un compartiment Amazon S3 et un flux Amazon Data Firehose.

Une configuration supplémentaire est requise pour les journaux vendus. Pour la configuration, voirUtilisation de journaux vendus.

Événements d'inscription au journal des interactions ADS

Indique qui MediaTailor émettra RAW_ADS_RESPONSE des journaux pour les sessions initialisées avec cette configuration.

L'événement de RAW_ADS_RESPONSE journal contient l'intégralité de la réponse VAST ou VMAP de l'ADS. En tant que tels, les journaux peuvent être volumineux et peuvent augmenter vos coûts d'enregistrement.

Exclusion d'événements dans le journal des interactions ADS

Indique que les événements sélectionnés MediaTailor n'apparaîtront pas dans les journaux qui décrivent les interactions avec l'ADS.

Pour une description des événements du journal ADS, consultezJournaux ADS.

Exclusion d'événements dans le journal des interactions du service Manifest

Indique que les événements sélectionnés MediaTailor n'apparaîtront pas dans les journaux qui décrivent les interactions avec le service de manifeste.

Pour une description des événements du journal de service du manifeste, consultezJournaux des manifestes.

Conditionnement publicitaire

Vous trouverez ci-dessous les mesures à prendre MediaTailor pour conditionner les publicités avant de les intégrer à un flux de contenu.

Conditionnement de fichiers multimédia en streaming

Détermine la logique MediaTailor à utiliser pour choisir les publicités à diffuser.

  • Lorsque le conditionnement des fichiers multimédia en streaming est réglé sur Transcoder, les fichiers multimédia MediaTailor sont transcodés lors de la progressive livraison et les insèrent dans le manifeste. S'il n'y a pas assez de publicités contenant des fichiers multimédia pour les diffuser, les MediaTailor transcode et les utilise avec progressive streaming diffusion.

  • Lorsque le conditionnement des fichiers multimédia en streaming est réglé sur Aucun, les MediaTailor publicités contenant des fichiers multimédia streaming de diffusion sont intégrées au manifeste sans les transcoder. S'il n'y a pas assez de publicités contenant des fichiers multimédia pour les diffuser, les MediaTailor transcode et les utilise avec streaming progressive diffusion.

Détails de personnalisation

Vous trouverez ci-dessous les détails de personnalisation que vous pouvez configurer dans la MediaTailor console ou à l'aide de l' MediaTailor API.

Slate ad (Liste de publicités)

Entrez l'URL d'une ressource MP4 de haute qualité MediaTailor utilisée pour remplir le temps d'affichage des annonces. La configuration de Slate est facultative pour la plupart des flux de travail, mais obligatoire pour les publicités VPAID. Pour des informations complètes sur le comportement de l'ardoise, les exigences de configuration et le moment où la ardoise est affichée, consultezMediaTailor ardoise et insertion.

Pare-chocs de démarrage

URL de l'emplacement de l'actif Start Bumper. Les bumpers sont de courts clips vidéo ou audio diffusés au début ou à la fin d'une pause publicitaire. Ils peuvent être stockés sur le S3 d'Amazon ou sur un autre service de stockage. Pour en savoir plus sur les pare-chocs, voirMediaTailor pare-chocs et insertion.

Pare-chocs d'extrémité

URL de l'emplacement de l'actif End Bumper. Les bumpers sont de courts clips vidéo ou audio diffusés au début ou à la fin d'une pause publicitaire. Ils peuvent être stockés sur le S3 d'Amazon ou sur un autre service de stockage. Pour en savoir plus sur les pare-chocs, voirMediaTailor pare-chocs et insertion.

Seuil de personnalisation

Ne s'applique que lorsqu'il est utilisé conjointement avec Slate Ad. Définit la durée maximale d'une annonce sous-remplie (en secondes) autorisée pendant une pause publicitaire avant l' MediaTailor abandon de la personnalisation et l'affichage du contenu sous-jacent. Cette fonctionnalité s'applique au remplacement de publicités dans les flux en direct et en VOD, plutôt qu'à l'insertion de publicités, car elle repose sur un flux de contenu sous-jacent. Pour des scénarios de comportement détaillés et des informations complètes, consultezComment fonctionne le seuil de personnalisation.

Serveur ADS de preroll en direct

Pour insérer des publicités au début d'un flux en direct avant que le contenu principal soit lancé, saisissez l'URL du preroll à partir du serveur ADS. Il s'agit de l'URL avec les variables comme décrit dans Étape 3 : Configuration de l'URL de la demande ADS et des paramètres de requête 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. Il ne peut pas s'agir d'un certificat auto-signé. La même chose s'applique également aux URL des publicités au format mezzanine renvoyées par l'ADS. Si vous utilisez un certificat auto-signé, vous ne AWS Elemental MediaTailor pouvez pas récupérer et intégrer des publicités dans les manifestes à partir de l'origine du contenu.

Pour plus d'informations sur le fonctionnement du pré-déploiement (preroll), consultez MediaTailor pré-enroulement et insertion.

Durée maximale autorisée pour la diffusion de preroll

Lorsque vous insérez des publicités au début d'un flux en direct, entrez la durée maximale autorisée pour la diffusion de publicités preroll. MediaTailor ne dépassera pas cette durée lors de l'insertion de publicités. Si la réponse de l'ADS contient plus d'annonces que ce qui correspond à cette durée, MediaTailor elle propose autant d'annonces que possible, sans dépasser la durée. Pour plus de détails sur la façon dont MediaTailor les remplissages sont disponibles, consultezComportement d'assemblage des publicités en direct.

Utiliser le mode de suppression

Définit le mode de suppression de la diffusion, également connu sous le nom de suppression des publicités. Par défaut, la suppression des publicités est désactivée et MediaTailor toutes sont remplies d'annonces ou de listes. Lorsque le mode est défini surBEHIND_LIVE_EDGE, la suppression des publicités est active et MediaTailor ne remplit pas les pauses publicitaires avant ou après la valeur de suppression disponible dans la fenêtre de visualisation du manifeste. Lorsque le mode est réglé surAFTER_LIVE_EDGE, la suppression des publicités est active. MediaTailorne remplit pas les interruptions de publicité pendant ou après la période de suppression, qui est le Live Edge plus la valeur de suppression disponible plus la durée de la mémoire tampon.

Valeur de suppression disponible

La valeur de suppression disponible est une durée de décalage de bord en HH:MM:SS temps réel. MediaTailor ne remplira pas les pauses publicitaires à cette heure-ci dans la fenêtre rétrospective du manifeste.

Mode d'insertion

Le mode Insertion contrôle si les joueurs peuvent utiliser l'insertion d'annonces cousue ou guidée. La valeur par défautSTITCHED_ONLY, force toutes les sessions de jeu à utiliser l'insertion d'annonces Stitched (côté serveur). Paramètre PLAYER_SELECT permettant InsertionMode aux joueurs de sélectionner l'insertion d'annonces cousues ou guidées au moment de l'initialisation de la session. La valeur par défaut pour les joueurs qui ne spécifient pas de mode d'insertion est Stitched.

Réglages avancés

Les paramètres avancés facultatifs sont les suivants. Vous pouvez les configurer dans la MediaTailor console, à l'aide du AWS Command Line Interface (AWS CLI) ou à l'aide de l' MediaTailor API.

CDN content segment prefix (Préfixe du segment de contenu CDN)

Permet AWS Elemental MediaTailor de créer des manifestes contenant des URL vers votre chemin CDN pour les segments de contenu. Avant d'effectuer cette étape, configurez une règle dans votre réseau de diffusion de contenu (CDN) pour extraire les segments à partir de votre serveur d'origine. Pour Préfixe du segment du contenu CDN, saisissez le chemin du préfixe CDN.

Pour plus d'informations sur l'intégration MediaTailor à un CDN, consultezUtilisation d'un CDN pour optimiser la personnalisation des MediaTailor publicités et la diffusion de contenu.

CDN ad segment prefix (Préfixe du segment publicitaire CDN)

Permet AWS Elemental MediaTailor de créer des manifestes contenant des URL vers votre propre chemin CDN pour les segments publicitaires. Par défaut, MediaTailor diffuse des segments d'annonces provenant d'une CloudFront distribution Amazon interne avec des paramètres de cache par défaut. Avant de pouvoir compléter le champ CDN ad segment prefix (Préfixe du segment publicitaire du CDN), vous devez configurer une règle de votre CDN pour extraire les segments publicitaires de l'origine suivante, comme dans l'exemple suivant.

https://segments.mediatailor.<region>.amazonaws.com

Dans CDN ad segment prefix (Préfixe du segment publicitaire CDN), entrez le nom de votre préfixe CDN dans la configuration.

Pour plus d'informations sur l'intégration MediaTailor à un CDN, consultezUtilisation d'un CDN pour optimiser la personnalisation des MediaTailor publicités et la diffusion de contenu.

DASH origin manifest type (Type du manifeste d'origine DASH)

Si votre serveur d'origine produit des manifestes DASH à période unique, ouvrez la liste déroulante et choisissez SINGLE_PERIOD (PÉRIODE UNIQUE). Par défaut, MediaTailor gère les manifestes DASH comme des manifestes à plusieurs périodes. Pour de plus amples informations, veuillez consulter Intégrer une MPEG-DASH source.

DASH mpd location (Emplacement mdp DASH)

(Facultatif si nécessaire pour DASH) Emplacement de la description de la présentation multimédia (mpd). Choisissez DÉSACTIVÉ pour la situation suivante :

  • Vous configurez des règles de routage CDN pour accéder aux MediaTailor manifestes.

  • Vous utilisez les rapports côté client ou votre lecteur prend en charge les redirections HTTP persistantes.

Pour en savoir plus sur la fonction Location, consultez Fonction de localisation DASH.

Nom du profil de transcodage

Nom qui associe cette configuration à un profil de transcodage personnalisé. Ce nom remplace les valeurs par défaut du transcodage dynamique de. MediaTailor Remplissez ce champ uniquement si vous avez déjà configuré des profils personnalisés à l'aide d'AWS Support.

Passthrough des marqueurs publicitaires

Pour HLS, active ou désactive la transmission des marqueurs publicitaires. Lorsque la transmission des marqueurs publicitaires est activée, les marqueurs publicitaires MediaTailor passent EXT-X-CUE-INEXT-X-CUE-OUT, et les marqueurs EXT-X-SPLICEPOINT-SCTE35 publicitaires passent du manifeste d'origine au manifeste MediaTailor personnalisé. Aucune logique n'est appliquée aux valeurs des marqueurs publicitaires ; elles sont transmises du manifeste d'origine au manifeste personnalisé telles quelles. Par exemple, si la valeur EXT-X-CUE-OUT est égale 60 à dans le manifeste d'origine, mais qu'aucune annonce n'est diffusée, la valeur ne MediaTailor sera pas modifiée pour qu'elle 0 apparaisse dans le manifeste personnalisé.

Délai d'expiration des requêtes ADS individuelles

Durée maximale, en millisecondes, d' MediaTailor attente d'une seule réponse HTTP lors de la résolution d'une décision publicitaire pendant la diffusion en direct ou en VOD. Valeur par défaut : 3000. Plage valide : 2506000.

Pour plus d'informations sur la gestion de MediaTailor l'assemblage des publicités dans les flux de travail en direct et en VOD, consultez Comportement d'assemblage des publicités en direct et. Comportement d'assemblage publicitaire pour la VOD

Ce réglage correspond au AdsRequestTimeoutMilliseconds membre du PutPlaybackConfiguration AdsPersonalizationTimeouts paramètre.

Nombre maximal de demandes ADS simultanées

Le nombre de requêtes simultanées que MediaTailor vous pouvez adresser à l'ADS. Valeur par défaut : 1. Plage valide : 1100.

Ce réglage correspond au MaxConcurrentAdsRequests membre du PutPlaybackConfiguration AdsPersonalizationConcurrency paramètre.

Durée maximale de personnalisation des ADS en direct

Budget temporel total, en millisecondes, pour toutes les activités ADS lors de la personnalisation du manifeste en direct. Ce budget est partagé entre toutes les pauses publicitaires dans une seule demande manifeste. Valeur par défaut : 10000. Plage valide : 25010000.

Pour plus d'informations sur le comportement d'assemblage des publicités en direct, consultezComportement d'assemblage des publicités en direct.

Ce réglage correspond au LiveMaximumAdsPersonalizationTimeMilliseconds membre du PutPlaybackConfiguration AdsPersonalizationTimeouts paramètre.

Durée maximale de personnalisation des ADS en VOD

Budget temporel total, en millisecondes, pour toutes les activités ADS lors de la personnalisation du manifeste VOD. Ce budget est partagé entre toutes les pauses publicitaires dans une seule demande manifeste. Valeur par défaut : 10000. Plage valide : 25010000.

Pour plus d'informations sur le comportement d'assemblage des publicités VOD, consultez. Comportement d'assemblage publicitaire pour la VOD

Ce réglage correspond au VodMaximumAdsPersonalizationTimeMilliseconds membre du PutPlaybackConfiguration AdsPersonalizationTimeouts paramètre.

Activer la parallélisation VOD VAST

Lorsque vous activez ce paramètre, MediaTailor traite les demandes ADS en parallèle pour les flux de travail VOD qui renvoient des réponses VAST. Ce paramètre s'applique uniquement aux flux de travail VOD. MediaTailor désactive ce paramètre par défaut. Pour prendre effet, définissez le nombre maximum de requêtes ADS simultanées sur une valeur supérieure à1.

Plafonnement de fréquence avec demandes simultanées

Lorsque vous activez la parallélisation VAST, certains serveurs publicitaires peuvent ne pas appliquer de limites de fréquence pour les demandes d'annonces simultanées. Vérifiez auprès de votre fournisseur de serveur publicitaire si le plafonnement de fréquence est pris en charge dans des conditions de demande parallèle. Si votre serveur publicitaire ne prend pas en charge les limites de fréquence pour les demandes simultanées, envisagez de passer à VMAP, qui gère correctement le plafonnement de fréquence pour les demandes d'annonces parallèles.

Ce réglage correspond au EnableVodVastParallelization membre du PutPlaybackConfiguration AdsPersonalizationConcurrency paramètre.

Délai d'expiration de la requête ADS Prefetch

Durée maximale, en millisecondes, d' MediaTailor attente d'une seule réponse HTTP lors de la résolution d'une décision publicitaire lors de la récupération préalable. Par défaut : valeur du délai d'expiration de la requête ADS individuelle. Plage valide : 25010000.

Pour plus d'informations sur le préchargement, consultez. Publicités de prélecture

Ce réglage correspond au PrefetchAdsRequestTimeoutMilliseconds membre du PutPlaybackConfiguration AdsPersonalizationTimeouts paramètre.

Temps de personnalisation ADS maximal par Prefetch

Budget temporel total, en millisecondes, pour toutes les activités ADS lors de la récupération préalable. Par défaut, ce délai n'a pas de limite supérieure. Plage valide : 25010000.

Pour plus d'informations sur le préchargement, consultez. Publicités de prélecture

Ce réglage correspond au PrefetchMaximumAdsPersonalizationTimeMilliseconds membre du PutPlaybackConfiguration AdsPersonalizationTimeouts paramètre.

Régler les délais d'attente ensemble

Pour chaque flux de travail, vous devez définir ensemble le délai d'attente individuel et le budget de temps total. Le délai d'attente individuel ne peut pas dépasser le budget total. Les flux de travail en direct et en VOD partagent un seul délai d'expiration des requêtes ADS individuelles. Définissez ce délai d'attente avec les budgets de temps totaux en direct et en VOD. De même, définissez simultanément le délai d'expiration de la requête Prefetch ADS et le délai de personnalisation ADS maximal de Prefetch. Vous ne pouvez pas définir l'un sans l'autre.