Prérequis Étape 1 : Accès MediaTailor Étape 2 : préparer un stream Étape 3 : Configuration de la ADS demande URL 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 utiliser AWS Elemental MediaTailor, vous avez besoin d'un Compte AWS et les autorisations d'accès, de visualisation et de modification MediaTailor des configurations. 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 HLS ou vos flux DASH de contenu
Configuration d'un modèle de serveur de décision publicitaire (ADS) URL
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 la ADS demande URL 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 (optionnelle) : Moniteur AWS Elemental MediaTailor activity
É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 IAM informations d'identification, 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 compatibles avec AWS Elemental MediaTailor.

Préparer un HLS stream

HLSles manifestes doivent satisfaire aux exigences suivantes :

Les manifestes doivent être accessibles sur l'Internet public.
Les manifestes doivent être en direct ou en vidéo à la demande (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. Cela est facultatif pour le VOD contenu, qui peut utiliser des VMAP décalages temporels à la place.

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 des durées comme indiqué 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 MediaTailor publicités.
HLSLes manifestes principaux doivent respecter les HLS spécifications documentées lors de la diffusion en HTTP direct : balises de playlist principales. En particulier, #EXT-X-STREAM-INF doit inclure les champs RESOLUTION, BANDWIDTH et CODEC.

Après avoir configuré le flux, notez le URL préfixe d'origine du contenu pour le manifeste principal. Vous en avez besoin pour créer la configuration dans AWS Elemental MediaTailor, plus loin dans ce didacticiel.

Préparer un DASH stream

DASHles manifestes doivent satisfaire aux exigences suivantes :

Les manifestes doivent être accessibles sur l'Internet public.
Les manifestes doivent être en direct ou en vidéo à la demande (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 publicitaires en clair XML ou en binaire codé 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é à l'intérieur de la segmentationUPID, doit être une valeur de sortie reconnue par AWS Elemental MediaTailor. La publicité commence au début de l'événement et dure pendant toute la durée de l'événement, si elle est spécifiée, ou jusqu'au début de l'événement suivant.

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 publicités doivent avoir les mêmes Representation paramètres AdaptationSet et paramètres que les flux de contenu. AWS Elemental MediaTailor utilise ces paramètres pour transcoder les publicités en fonction du flux de contenu, afin de passer facilement de l'un à l'autre.

Après avoir configuré le flux, notez le URL préfixe d'origine du contenu pour le DASH manifeste. Vous en avez besoin pour créer la configuration dans AWS Elemental MediaTailor, plus loin dans ce didacticiel.

Étape 3 : Configuration de la ADS demande URL et des paramètres de requête

Pour déterminer les paramètres de requête ADS requis, générez un tag publicitaire URL à partir duADS. Il URL sert de modèle pour les demandes adressées àADS, et comprend les éléments suivants :

Valeurs statiques
Valeurs générées par AWS Elemental MediaTailor (indiqué 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 Tag publicitaire URL provenant d'un 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 du joueur et entraîne une VAST demande différente URL pour chaque session.
cust_params sont des valeurs dynamiques fournies par le lecteur

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

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

Test

Vous pouvez utiliser une VAST réponse statique de votre part à ADS des fins de test. Idéalement, la VAST réponse renvoie un MP4 rendu de qualité mezzanine qui AWS Elemental MediaTailor peut transcoder. Si la réponse du ADS contient plusieurs rendus de lecture, MediaTailor sélectionne le MP4 rendu de qualité et de résolution les plus élevées et l'envoie au transcodeur.

Étape 4 : créer une configuration

Le AWS Elemental MediaTailor la configuration contient des informations de mappage pour le serveur d'origine etADS.

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 Source de contenu vidéo, entrez le URL préfixe du manifeste HLS principal ou du DASH manifeste de ce flux, moins l'ID de la ressource. Par exemple, si le manifeste principal URL esthttp://origin-server.com/a/master.m3u8, vous devez entrerhttp://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 l'utiliseHTTPS, son certificat doit provenir d'une autorité de certification connue. (Ce ne peut pas être un certificat auto-signé.) Dans le cas contraire, 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 Ad Decision Server, entrez le URL pour votreADS. Il s'agit soit de la variable URL avec comme décrit dansÉtape 3 : Configuration de la ADS demande URL et des paramètres de requête, soit de la statique VAST URL que vous utilisez à des fins de test. La longueur maximale est de 25 000 caractères.

Note
Si vous ADS l'HTTPSutilisez, 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é sur la mezzanine URLs renvoyée par leADS. Sinon, MediaTailor ne parvient pas à récupérer et à intégrer les publicités dans les manifestes à partir de l'origine du contenu.
(Facultatif selon les besoinsDASH) Pour Location, choisissez DISABLEDsi vous avez défini des règles de CDN routage pour accéder aux MediaTailor manifestes et si vous utilisez des rapports côté client ou si vos joueurs acceptent les redirections persistantes. HTTP

Pour en savoir plus sur la fonction Location, consultez DASHfonction de localisation.
(Facultatif) Si votre serveur d'origine produit des DASH manifestes à période unique, choisissez le type d'origine du manifeste DASH mpd, puis choisissez SINGLE _. PERIOD Par défaut, MediaTailor gère les DASH manifestes sous forme de 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

Après avoir enregistré la configuration, testez le flux URL à l'aide d'un format adapté à votre protocole de diffusion :

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-endpointest le point de terminaison de lecture unique qui AWS Elemental MediaTailor généré lors de la création de la configuration.

Exemple
```
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
```
hashed-account-idest votre Compte AWS IDENTIFIANT.

Exemple
```
AKIAIOSFODNN7EXAMPLE
```
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://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8

Exemple : DASH


https://bdaaeb4bd9114c088964e4063f849065.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 indiqué dans l'exemple précédent, entrez le URL dans un lecteur autonome.

Testez le flux dans votre propre environnement de lecteur.

Étape 6 : envoyer la demande de lecture à AWS Elemental MediaTailor

Configurer le lecteur en aval ou CDN envoyer des demandes de lecture au point de terminaison de lecture de la configuration fourni par AWS Elemental MediaTailor. Toutes les variables dynamiques définies par le joueur que vous avez utilisées dans la ADS demande URL Étape 3 : Configuration de la ADS demande URL et des paramètres de requête doivent être définies dans la demande de manifeste du joueur.

Exemple

Supposons que votre modèle ADS URL soit le suivant.


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

La demande du joueur URL est une variante de ce qui suit HLS et DASH des exemples.


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo

Lorsque AWS Elemental MediaTailor reçoit la demande du joueur, il définit les variables du joueur en fonction des informations contenues dans la demande. La ADS demande qui en résulte en URL est une variante.


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 auADS, consultez. Utilisation de variables publicitaires dynamiques dans MediaTailor

Étape 7 (optionnelle) : Moniteur AWS Elemental MediaTailor activity

Utilisez Amazon CloudWatch et Amazon CloudWatch Logs pour effectuer le suivi AWS Elemental MediaTailor activité, telle que le nombre de demandes, d'erreurs et de résultats publicitaires remplis.

Si c'est la première fois que vous utilisez CloudWatch avec AWS Elemental MediaTailor, créez un AWS Identity and Access Management (IAM) rôle pour permettre la communication entre les services.

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

Ouvrez la IAM console à l'adresse https://console.aws.amazon.com/iam/.
Dans le volet de navigation de la IAM console, sélectionnez Rôles, puis sélectionnez Créer un rôle.
Choisissez l'autre Compte AWStype de rôle.
Pour le numéro 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é.
Sélectionnez Next: Permissions (Étape suivante : 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 politique, remplacez le principal par AWS Elemental MediaTailor service. 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 le AWS Elemental MediaTailor Sur la page 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