Prérequis Étape 1 : Accès MediaTailor Étape 2 : préparer un stream Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête Étape 4 : créer une configuration Étape 5 : tester la configuration Étape 6 : envoyer la demande de lecture à MediaTailor (Facultatif) Étape 7 : Surveiller l'activité Étape 8 : nettoyer

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 Configuration AWS Elemental MediaTailor.

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

Lorsque vous aurez terminé, vous pourrez envoyer une demande de diffusion MediaTailor pour que le contenu publicitaire soit personnalisé dans votre stream.

Rubriques

Prérequis
Étape 1 : Accès AWS Elemental MediaTailor
Étape 2 : préparer un stream
Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête
Étape 4 : créer une configuration
Étape 5 : tester la configuration
Étape 6 : envoyer la demande de lecture à AWS Elemental MediaTailor
Étape 7 (facultatif) : Surveiller AWS Elemental MediaTailor l'activité
Étape 8 : nettoyer

Prérequis

Avant de commencer, assurez-vous d’avoir terminé les étapes de Configuration AWS Elemental MediaTailor.

Étape 1 : Accès AWS Elemental MediaTailor

À l'aide de vos informations d'identification IAM, connectez-vous à la MediaTailor console à l'adressehttps://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.

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 :
- #EXT-X-CUE-OUT /#EXT -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
```
- #EXT-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.
Les manifestes principaux HLS doivent respecter les spécifications HLS documentées sur HTTP live streaming : Master playlist tags. En particulier, #EXT-X-STREAM-INF doit inclure les champs RESOLUTION, BANDWIDTH et CODEC.

Une fois que vous avez configuré le flux, notez le préfixe d'URL de l'origine du contenu du manifeste principal. 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 horaire, 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.
```
  <Period start="PT444806.040S" id="123586" duration="PT15.000S">
    <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml">
      <Event duration="1350000">
        <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095">
          <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1">
            <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program>
            <scte35:BreakDuration autoReturn="true" duration="1350000"/>
          </scte35:SpliceInsert>
        </scte35:SpliceInfoSection>
      </Event>
    </EventStream>
    <AdaptationSet mimeType="video/mp4"
        ...
    </AdaptationSet>
  </Period>
```

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

Exemple 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_id 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_params sont des valeurs dynamiques fournies par le lecteur

La demande de manifeste principal provenant du lecteur doit fournir les paires clé-valeur qui correspondent aux paramètres de requête player_params. de l'URL de la demande ADS. Pour plus d'informations sur la configuration des paires clé-valeur de la demande adressée à AWS Elemental MediaTailor, consultez Utilisation de variables publicitaires dynamiques dans MediaTailor.

Entrez l'URL « modèle » configurée lorsque vous créez le mappage du serveur d'origine/ADS dans MediaTailor, dans. Étape 4 : créer une configuration

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)

Ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.
Sur la page Configurations, choisissez Create configuration (Créer une configuration).
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.
Pour Video content source (Source de contenu vidéo), entrez le préfixe d'URL du manifeste principal HLS ou du manifeste DASH pour ce flux, moins l'ID de la ressource. Par exemple, si l'URL du manifeste principal est http://origin-server.com/a/master.m3u8, vous saisirez 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.
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 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.
(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 DASHfonction de localisation.
(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_PERIOD. Par défaut, MediaTailor gère les manifestes DASH comme des manifestes multipériodes. Pour de plus amples informations, veuillez consulter Intégrer une MPEG DASH source.
Choisissez Create configuration (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-idest 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.

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 doivent être définies dans la demande de manifeste du lecteur.

Exemple

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=<filled_in_session_id>&cust_params=viewerinfo

Pour plus d'informations sur la configuration des paires clé-valeur à transmettre au serveur ADS, consultez Utilisation de variables publicitaires dynamiques dans MediaTailor.

É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 AWS Identity and Access Management (IAM) pour permettre la communication entre les services.

Pour autoriser AWS Elemental MediaTailor l'accès à CloudWatch (console)

Ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/.
Dans le volet de navigation de la console IAM, sélectionnez Roles (Rôles), puis Create role (Créer un rôle).
Choisissez un autre type de Compte AWS rôle.
Pour ID de compte, entrez votre Compte AWS identifiant.
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é.
Choisissez Suivant : Autorisations.
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 :
- CloudWatchLogsFullAccesspour fournir un accès complet à Amazon CloudWatch Logs
- CloudWatchFullAccesspour fournir un accès complet à Amazon CloudWatch
Pour Nom du rôle, saisissez MediaTailorLogger, puis choisissez Créer un rôle.
Sur la page Rôles, sélectionnez le rôle que vous venez de créer.

Modifiez la relation d'approbation pour mettre à jour le mandataire :

Sur la page Récapitulatif du rôle, choisissez l'onglet Relation d'approbation.
Choisissez Modifier la relation d’approbation.

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.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "mediatailor.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "Midas"
        }
      }
    }
  ]
}

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)

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).
Dans la zone de confirmation Delete configuration (Supprimer la configuration), entrez Delete, puis choisissez à nouveau Delete (Supprimer).

AWS Elemental MediaTailor supprime la configuration.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Commencer avec MediaTailor

Commencer à assembler des MediaTailor canaux