Création de plannings de prélecture

La procédure suivante explique comment créer un planning de prélecture à l'aide de la MediaTailor console. Pour plus d'informations sur la création et la gestion des plannings de prélecture par programmation à l'aide du MediaTailor API, voir dans PrefetchSchedulesAWS Elemental MediaTailor APIRéférence.

Note

Si vous souhaitez utiliser des critères de correspondance de disponibilité dans un calendrier, assurez-vous d'abord de configurer le ADS URL modèle de votre configuration de lecture avec des variables dynamiques, sinon les critères de correspondance de disponibilité n'auront aucun effet. Pour plus d'informations sur l'utilisation de variables dynamiques, consultez Étape 3 : Configuration de la ADS demande URL et des paramètres de requête la rubrique Commencer à insérer des MediaTailor annonces.

Pour créer un nouveau calendrier de prélecture à l'aide de la console

1. Ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.

2. Dans le volet de navigation, sélectionnez Configurations. Sélectionnez la configuration de lecture pour laquelle vous souhaitez créer un calendrier de prélecture.

3. Dans l'onglet Programmes de prélecture, choisissez Ajouter un calendrier de prélecture.

4. Dans le volet des détails du planning Prefetch, procédez comme suit :

   • Dans Nom, entrez un identifiant pour votre calendrier de prélecture, tel que. my-prefetch-schedule

   • Pour Stream ID, entrez éventuellement un identifiant unique. Si votre source contient plusieurs flux de lecture, vous pouvez utiliser cet identifiant pour demander de MediaTailor placer des publicités dans un flux spécifique. Par exemple, si votre source propose une diffusion sportive et une diffusion d'émission de télévision, vous pouvez utiliser l'identifiant de diffusion pour créer des programmes de prélecture afin d'insérer des publicités ciblées pour la diffusion sportive. Vous transmettez la valeur de l'ID de flux MediaTailor lors de l'initialisation de la session ou de la demande de manifeste de votre client. Pour plus d'informations, consultez l'exemple suivant.

     • Pour le suivi côté serveur, incluez le paramètre et la valeur de la ?aws.streamId requête dans la GET HTTP demande envoyée par votre client à votre MediaTailor point de terminaison. Pour des informations générales sur le suivi côté serveur, voir. Suivi des publicités côté serveur Une demande de manifeste adressée à un HLS point de terminaison qui inclut un identifiant de flux se présente comme suit, où se myStreamId trouve le nom de votre identifiant de flux :

       GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

     • Pour le suivi côté client, incluez la streamId clé et la valeur dans le corps de la demande d'initialisation de POST HTTP session de votre client au point de terminaison /v1/session. MediaTailor Pour des informations générales sur le suivi côté client, voir. Suivi des publicités côté client Une demande d'initialisation de session qui inclut un identifiant de flux se présente comme suit, où se myStreamId trouve le nom de votre identifiant de flux :

       POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
       {
           'streamId': 'myStreamId'
       }

     Afficher plusAfficher moins

5. Dans le volet Extraction, spécifiez les paramètres de récupération que vous souhaitez utiliser. Ces paramètres déterminent à quel moment MediaTailor les publicités sont extraites du. ADS Ils déterminent également les variables dynamiques à inclure dans la demandeADS, le cas échéant.

   • Dans le champ Heure de début, entrez l'heure à laquelle les extractions par prélecture MediaTailor peuvent commencer pour cette pause publicitaire. MediaTailor tentera de prévisualiser les publicités pour les demandes manifestes faites par votre client à cette date ou après cette date. La valeur par défaut est l'heure actuelle. Si vous ne spécifiez aucune valeur, le service lance la récupération par prélecture dès que possible.

   • Dans Heure de fin, entrez l'heure à laquelle vous MediaTailor souhaitez arrêter de prélire les publicités pour cette pause publicitaire. MediaTailor tentera de prévisualiser les publicités pour les demandes manifestes qui se produisent à cette heure ou avant. La fenêtre de récupération peut se chevaucher avec la fenêtre de consommation.

   • Dans la section Variables dynamiques, entrez jusqu'à 100 variables dynamiques. MediaTailor utilise ces variables à des fins de substitution dans les requêtes de prélecture qu'il envoie au. ADS Si vous n'entrez aucune variable dynamique, MediaTailor faites de votre mieux pour interpoler les valeurs des variables dynamiques contenues dans votre ADSURL.

     • Sélectionnez Ajouter une variable dynamique.

     • Pour Clé, entrez une clé de variable dynamique, telle quescte.event_id. Vous pouvez utiliser n'importe quelle variable dynamique qui MediaTailor prend en charge. Pour plus d'informations sur les variables dynamiques, consultezUtilisation de variables publicitaires dynamiques dans MediaTailor.

     • Pour Valeur, entrez une valeur de variable dynamique, telle que my-event.

     • Pour ajouter une autre variable dynamique, choisissez Sélectionner Ajouter une variable dynamique.

6. Dans le volet Consommation, spécifiez les paramètres que vous souhaitez utiliser pour la fenêtre de consommation. Ces paramètres déterminent à quel moment MediaTailor les annonces sont placées dans le break publicitaire. Ils déterminent également les critères de correspondance de disponibilité que vous souhaitez utiliser.

   • Pour Heure de début, entrez l'heure à laquelle vous souhaitez commencer MediaTailor à placer des annonces prélues dans le break publicitaire. La valeur par défaut est l'heure actuelle. Si vous ne spécifiez pas d'heure, le service démarre la consommation de prélecture dès que possible.

   • Pour Heure de fin, entrez l'heure à laquelle vous MediaTailor souhaitez arrêter de placer les publicités prélues dans le break publicitaire. MediaTailor tentera de prévisualiser les publicités pour les demandes manifestes de votre client qui se produisent à cette heure ou avant. L'heure de fin doit être postérieure à l'heure de début, et dans moins d'un jour. La fenêtre de consommation peut se chevaucher avec la fenêtre de récupération.

   • Dans la section Critères de correspondance de disponibilité, sélectionnez Ajouter des critères de disponibilité et ajoutez jusqu'à cinq critères de correspondance de disponibilité à votre calendrier. Ensuite, sous Clé variable dynamique, ajoutez une clé variable dynamique, telle quescte.event_id. MediaTailor placera les annonces prélues dans le break publicitaire uniquement si elles répondent aux critères définis par les valeurs des variables dynamiques que votre client transmet ou MediaTailor déduites à MediaTailor partir d'informations telles que les données de session. Pour plus d'informations, reportez-vous à la section précédenteavail-matching-criteria.

7. Sélectionnez Ajouter des critères de disponibilité.

Les programmes Prefetch expirent automatiquement après la fin de la fenêtre de consommation. À des fins de diagnostic, ils restent visibles pendant au moins 7 jours, après quoi ils MediaTailor sont automatiquement supprimés. Vous pouvez également supprimer manuellement un planning de prélecture à tout moment. Pour plus d'informations sur la suppression manuelle d'un planning de prélecture, consultez la section suivanteSupprimer des plannings de prélecture.

Déterminer la fréquence à laquelle votre client doit appeler CreatePrefetchSchedule API

Votre client peut l'appeler CreatePrefetchScheduleAPIune fois par jour par programme pour configurer la récupération et la consommation si vous savez exactement quand se produiront les interruptions publicitaires. Votre client peut également les appeler API plusieurs fois au cours de la journée pour définir le mode de récupération et de consommation. Lorsque vous choisissez une fréquence d'APIappel, tenez compte MediaTailor du nombre maximum de programmes de prélecture actifs et de la probabilité que votre calendrier de pause publicitaire change une fois que vous aurez créé votre ou vos programmes de prélecture. S'il est probable que le calendrier des pauses publicitaires change une fois que vous avez créé vos programmes de prélecture, vous pouvez les appeler API plus fréquemment.