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.
# Publicités de prélecture
Utilisez la prélecture des AWS Elemental MediaTailor annonces pour les diffusions en direct afin de réduire la charge maximale sur les serveurs de décision publicitaire (ADS) et de réduire le temps de latence de diffusion des manifestes au début de chaque pause publicitaire. Lorsque vous définissez un calendrier de prélecture, suivez le MediaTailor calendrier pour récupérer les publicités de l'ADS et les préparer à l'insertion avant qu'elles ne soient nécessaires pour une pause publicitaire. Pendant les diffusions en direct, le préchargement peut contribuer à atténuer la baisse du taux de remplissage des publicités et les opportunités de monétisation manquées en raison des délais d'attente des demandes publicitaires et du transcodage ou d'autres retards sur le réseau.
**Note**
La prélecture des annonces ne fonctionne pas avec les méthodes d'insertion de publicités guidées par le serveur (SGAI), notamment les méthodes traditionnelles guidées par le serveur et les interstitiels HLS. Les méthodes SGAI ne nécessitent pas de prélecture, car les joueurs ne récupèrent que les publicités auxquelles ils vont jouer, et les manifestes peuvent être diffusés CDNs sans MediaTailor voir les demandes de session individuelles.
Pour configurer le préchargement des publicités, vous devez créer un ou plusieurs programmes de *prélecture dans votre configuration de diffusion*. Un calendrier de prélecture indique MediaTailor comment et quand récupérer et préparer les publicités pour une prochaine pause publicitaire.
+ Si un événement présente des disponibilités publicitaires selon un calendrier prévisible, utilisez un *seul calendrier de prélecture.* Chaque calendrier de prélecture définit un ensemble unique d'annonces MediaTailor à placer dans un seul et même catalogue publicitaire. Pour prévisualiser des annonces pour plusieurs mises à disposition lorsque vous utilisez des programmes de prélecture uniques, vous devez créer plusieurs programmes de prélecture (jusqu'à 24 heures avant la publication de l'annonce) qui correspondent à chaque disponibilité publicitaire.
+ Si un événement présente des disponibilités publicitaires qui ne sont pas prévues selon un calendrier prévisible, utilisez un calendrier de *prélecture récurrent*. Un planning de prélecture récurrent crée automatiquement un calendrier et prévisualise les annonces avant chaque pause publicitaire d'un événement. Le programme de prélecture récurrent permet de récupérer les annonces pour chaque annonce publiée dans un délai défini (jusqu'à 24 heures avant la fin de l'événement). Vous n'avez pas besoin de créer un calendrier pour chaque publication publicitaire, mais vous perdez une partie du contrôle du temps qu'offre le préchargement unique.
Les rubriques suivantes fournissent des informations supplémentaires sur le préchargement des annonces.
**Topics**
+ [Comment fonctionne le préchargement](understanding-prefetching.md)
+ [Création de plannings de prélecture](creating-prefetch-schedules.md)
+ [Gestion du trafic basée sur le TPS](tps-traffic-shaping.md)
+ [Supprimer des plannings de prélecture](deleting-prefetch-schedules.md)
# Comment fonctionne le préchargement
Lorsque votre client envoie une demande de manifeste à MediaTailor, le service évalue tous les programmes de prélecture associés à la configuration de lecture. S'il MediaTailor ne trouve aucun calendrier de prélecture correspondant, le service revient à l'insertion normale des annonces et ne précharge pas les annonces.
S'il MediaTailor trouve un calendrier de prélecture correspondant, le service évalue le calendrier en fonction de deux éléments : l'extraction et la consommation. La configuration de chaque composant varie entre des programmes de prélecture uniques et des programmes de prélecture récurrents, comme décrit dans les sections suivantes.
## Flux de planification de prélecture unique
**Récupération**
Cela définit la *fenêtre de récupération*, qui est la plage de temps pendant laquelle les publicités sont MediaTailor prélues depuis l'ADS. Assurez-vous de planifier cette fenêtre avant la pause publicitaire. Vous trouverez ci-dessous un aperçu de la manière dont un MediaTailor seul planning de prélecture est traité.
Pour savoir comment créer un calendrier de prélecture unique dans la console, consultez. [Création de plannings de prélecture](creating-prefetch-schedules.md) Pour les instructions relatives à l'API, reportez-vous [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)à la *référence des AWS Elemental MediaTailor API*.
Au cours de la période de *récupération spécifiée,* MediaTailor envoie des demandes à l'ADS pour récupérer et préparer les publicités en vue de leur insertion ultérieure dans les sessions de diffusion.
+ MediaTailor utilise éventuellement le formatage du trafic pour limiter le nombre de demandes adressées à l'ADS à la fois. Vous pouvez choisir entre deux approches :
*Mise en forme du trafic par fenêtre temporelle* : MediaTailor répartit les demandes sur le nombre de secondes spécifié au lieu d'envoyer des demandes pour toutes les sessions en une seule fois. Cette répartition du trafic dispersé permet d'éviter que l'ADS ne soit submergé, ce qui entraîne des temps morts et de faibles taux de remplissage des publicités.
*Mise en forme du trafic basée sur* le TPS : MediaTailor limite les demandes en fonction des transactions par seconde (TPS) et des utilisateurs simultanés. Cette approche fournit une configuration plus intuitive basée sur les limites de capacité de votre ADS. Pour de plus amples informations, veuillez consulter [Gestion du trafic basée sur le TPS](tps-traffic-shaping.md).
+ Si vous configurez des *variables dynamiques*, MediaTailor incluez ces variables dans les demandes adressées à l'ADS. MediaTailor utilise ces variables pour faire correspondre les disponibilités publicitaires afin de prévisualiser les plannings pendant la fenêtre de consommation. Consultez la section *Consommation* suivante pour plus d'informations.
**Example**
Un événement en direct dure de 7 h 45 à 10 h, avec une pause publicitaire à 8 h 15. Vous configurez MediaTailor pour récupérer les publicités entre 7 h 45 et 8 h, avec une fenêtre de régulation du trafic de 60 secondes. Avec 500 000 utilisateurs simultanés, MediaTailor distribue les demandes ADS pour atteindre un taux moyen d'environ 8 333 transactions par seconde pendant 60 secondes (500 000 utilisateurs/60 secondes = 8 333 demandes par seconde), au lieu d'envoyer toutes les demandes simultanément.
La configuration de récupération inclut la clé `scte.event` et la valeur `1234` de la variable dynamique. MediaTailor inclut cette variable dans les demandes adressées à l'ADS, qui peuvent ensuite être utilisées pour cibler des annonceurs spécifiques en fonction de l'ID d'événement 1234.
**Consommation**
Lorsqu'il MediaTailor rencontre des marqueurs de coupure de publicité SCTE-35 pendant la fenêtre de consommation, les publicités prélues sont placées dans un break publicitaire.
+ Si vous n'avez pas défini de critères de correspondance, MediaTailor insère des annonces dès le premier intervalle de la fenêtre de consommation.
+ *Si vous avez défini une *clé de variable dynamique* pour utiliser les *critères* de *correspondance*, MediaTailor évalue ces critères par rapport aux variables dynamiques que vous avez définies dans la fenêtre de récupération.* Un break publicitaire ne peut être inséré dans une annonce prélue que si les critères de disponibilité sont remplis. MediaTailor insère des annonces dans la première pause qui répond aux critères.
Pour obtenir la liste des critères de disponibilité pris en charge, consultez la colonne *Disponible pour la prélecture des annonces dans le* tableau ci-dessous. [MediaTailor variables de session pour les requêtes ADS](variables-session.md)
**Example a continué**
Vous définissez l'heure de début de la consommation à 8 h 15 et l'heure de fin à 8 h 17. Vous incluez `scte.event_id` la clé dans les critères de correspondance disponibles.
Pour chaque pause publicitaire entre 8 MediaTailor h 15 et 8 h 17, il évalue l'identifiant de l'SCTEévénement pour chaque pause publicitaire. À chaque session de diffusion, MediaTailor insère les publicités prélues dans le premier break publicitaire dont l'identifiant d'événement est 1234 (tel que défini dans les variables dynamiques de récupération). Pour les pauses publicitaires qui ne contiennent pas le bon identifiant d'événement, MediaTailor effectue une insertion publicitaire standard.
## Flux de planification de prélecture récurrent
**Récupération**
Cela définit la *fenêtre de récupération récurrente*, c'est-à-dire la plage de temps pendant laquelle les publicités sont MediaTailor prélues et insérées pour un événement en direct (jusqu'à 24 heures). Vous trouverez ci-dessous un aperçu de la manière dont MediaTailor les plannings de prélecture récurrents sont traités.
Pour savoir comment créer un calendrier de prélecture récurrent dans la console, consultez. [Création de plannings de prélecture](creating-prefetch-schedules.md) Pour les instructions relatives à l'API, reportez-vous [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)à la *référence des AWS Elemental MediaTailor API*.
Pendant la période de prélecture récurrente spécifiée, MediaTailor récupère et insère des publicités pour un événement en direct d'une durée maximale de 24 heures. Après chaque pause publicitaire dans la fenêtre, récupère MediaTailor automatiquement les annonces pour la pause publicitaire suivante.
+ Si vous définissez le *délai après la fin de la* période d' MediaTailor utilisation, attendez le temps spécifié avant de récupérer le prochain ensemble d'annonces pour le prochain break publicitaire.
+ MediaTailor utilise éventuellement le formatage du trafic pour limiter le nombre de demandes adressées à l'ADS à la fois. Vous pouvez choisir entre deux approches :
*Mise en forme du trafic par fenêtre temporelle* : MediaTailor répartit les demandes sur le nombre de secondes spécifié au lieu d'envoyer des demandes pour toutes les sessions en une seule fois. Cette répartition du trafic dispersé permet d'éviter que l'ADS ne soit submergé, ce qui entraîne des temps morts et de faibles taux de remplissage des publicités.
*Mise en forme du trafic basée sur* le TPS : MediaTailor limite les demandes en fonction des transactions par seconde (TPS) et des utilisateurs simultanés. Cette approche fournit une configuration plus intuitive basée sur les limites de capacité de votre ADS. Pour de plus amples informations, veuillez consulter [Gestion du trafic basée sur le TPS](tps-traffic-shaping.md).
+ Si vous configurez des *variables dynamiques*, MediaTailor incluez ces variables dans les demandes adressées à l'ADS. MediaTailor utilise ces variables pour faire correspondre les disponibilités publicitaires afin de prévisualiser les plannings pendant la fenêtre de consommation. Consultez la section *Consommation* suivante pour plus d'informations.
**Example**
Un événement en direct dure de 19 h à 20 h 45, avec quatre pauses publicitaires pendant cette période. Les pauses publicitaires ne se déroulent pas selon un calendrier prévisible. Vous configurez le prefetch récurrent de 19 h 00 à 20 h 45, avec un délai de 10 minutes et une fenêtre de régulation du trafic de 60 secondes. Après chaque utilisation, MediaTailor récupère les publicités pour la prochaine pause publicitaire. Dix minutes après la fin de l'utilisation, MediaTailor commence à envoyer des demandes de récupération à l'ADS. Avec une fenêtre de régulation du trafic de 60 secondes et 500 000 utilisateurs simultanés, MediaTailor distribue les requêtes ADS pour atteindre un taux moyen d'environ 8 333 transactions par seconde pendant 60 secondes (500 000 utilisateurs/60 secondes = 8 333 demandes par seconde), au lieu d'envoyer toutes les demandes simultanément.
La configuration de récupération inclut la clé `scte.event` et la valeur `1234` de la variable dynamique. MediaTailor inclut cette variable dans les demandes adressées à l'ADS, qui peuvent ensuite être utilisées pour cibler des annonceurs spécifiques en fonction de l'ID d'événement 1234.
**Consommation**
Lorsqu'il MediaTailor rencontre des marqueurs de coupure de publicité SCTE-35, il place les publicités prélues dans un break publicitaire.
+ Si vous définissez la *date d'expiration des annonces récupérées*, les annonces prélues peuvent être insérées jusqu'à la date d'expiration spécifiée.
+ Si vous n'avez pas défini de critères de correspondance, MediaTailor insère des annonces dès le premier intervalle de la fenêtre de consommation.
+ *Si vous avez défini une *clé de variable dynamique* pour utiliser les *critères* de *correspondance*, MediaTailor évalue ces critères par rapport aux variables dynamiques que vous avez définies dans la fenêtre de récupération.* Un break publicitaire ne peut être inséré dans une annonce prélue que si les critères de disponibilité sont remplis. MediaTailor insère des annonces dans la première pause qui répond aux critères.
Pour obtenir la liste des critères de disponibilité pris en charge, consultez la colonne *Disponible pour la prélecture des annonces dans le* tableau ci-dessous. [MediaTailor variables de session pour les requêtes ADS](variables-session.md)
**Example a continué**
Dans la consommation, vous incluez `scte.event_id` la clé dans les critères de correspondance disponibles.
Pour chaque pause publicitaire MediaTailor rencontrée, il évalue l'identifiant de l'SCTEévénement correspondant à chaque interruption publicitaire. À chaque session de diffusion, MediaTailor insère les publicités prélues dans chaque pause publicitaire dont l'identifiant d'événement est 1234 (tel que défini dans les variables dynamiques de récupération). Pour les pauses publicitaires qui ne contiennent pas le bon identifiant d'événement, MediaTailor effectue une insertion publicitaire standard.
Vous avez défini l'expiration des annonces à 2 700 secondes afin que les annonces récupérées puissent être insérées pendant 45 minutes.
Le graphique suivant illustre cet exemple, avec les petits carrés représentant les pauses publicitaires. Les paramètres du calendrier de prélecture récurrent sont illustrés le long de la chronologie de l'événement.
![\[Illustration graphique d'un événement en direct, y compris les configurations de planning de prélecture récurrentes.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/recurring_prefetch_timeline.png)
## Comprendre les coûts de prélecture
Les demandes de récupération de publicités sont gratuites. Toutefois, pour la récupération des publicités prélues, vous serez facturé au tarif de transcodage standard pour les publicités prélues qui transcodent. MediaTailor Pour la consommation de publicités prélues, vous serez facturée au tarif standard pour l'insertion d'annonces prélues placées dans des pauses publicitaires. MediaTailor Pour plus d'informations sur les coûts de transcodage et d'insertion de publicités, consultez la section [AWS Elemental MediaTailor Tarification](https://aws.amazon.com/mediatailor/pricing/).
# 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 de l' MediaTailor API, consultez la référence de [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)l'API.AWS Elemental MediaTailor *
**Note**
Lorsque vous configurez des programmes de prélecture dans MediaTailor, il est important de comprendre comment les différents types de variables sont gérés.
**Utiliser les critères de correspondance**
Si vous souhaitez utiliser des critères de correspondance de disponibilité dans un calendrier, assurez-vous d'abord de configurer le modèle d'URL ADS de votre configuration de lecture avec des [variables de session dynamiques](variables-session.md), sinon les critères de correspondance de disponibilité n'auront aucun effet. Pour plus d'informations sur l'utilisation de variables de session dynamiques, consultez [Étape 3 : Configuration de l'URL de demande ADS et des paramètres de requête](getting-started-ad-insertion.md#getting-started-configure-request) la rubrique Commencer à insérer des MediaTailor annonces.
**Variables relatives aux joueurs dans les plannings de prélecture**
Lorsque vous créez un calendrier de prélecture, ne définissez pas les variables du joueur en tant que variables dynamiques dans votre configuration de prélecture. Transmettez plutôt les variables du joueur comme vous le feriez normalement au début de la session. MediaTailor inclut automatiquement ces variables dans les demandes publicitaires de prélecture si les variables sont mappées dans l'URL du modèle ADS.
**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/](https://console.aws.amazon.com/mediatailor/).
1. 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.
1. Dans l'onglet Programmes de **prélecture, choisissez Ajouter un calendrier** **de prélecture**.
1. 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 configuration de diffusion comprend une diffusion sportive et une diffusion d'émission de télévision, vous pouvez utiliser l'ID 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. [MediaTailor suivi des publicités et rapports côté serveur](ad-reporting-server-side.md) Une demande de manifeste adressée à un point de terminaison HLS qui inclut un identifiant de flux se présente comme suit, où se `myStreamId` trouve le nom de votre identifiant de flux :
```
GET /v1/master///?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 envoyée au point de terminaison. **MediaTailor/v1/session** Pour des informations générales sur le suivi côté client, voir. [Suivi des publicités côté client](ad-reporting-client-side.md) 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 /v1/session///
{
'streamId': 'myStreamId',
'reportingMode': 'client'
}
```
1. Pour le **type Prefetch**, faites votre sélection et choisissez la section correspondante pour obtenir de l'aide sur les champs supplémentaires :
+ Choisissez **Single** si vous créez un calendrier de prélecture pour une pause publicitaire dans le cadre d'un événement.
+ Choisissez **Récurrent** si vous créez un calendrier qui prévisualise automatiquement les annonces avant chaque interruption publicitaire d'un événement.
## Programme de prélecture unique
Pour créer un calendrier prévisualisant les annonces avant qu'une annonce ne soit publiée dans le cadre d'un événement.
1. Dans le volet **Extraction**, spécifiez les paramètres de récupération que vous souhaitez utiliser. Ces paramètres déterminent à quel moment les publicités sont MediaTailor prélues depuis l'ADS. Ils déterminent également les variables de session dynamiques à inclure dans la demande adressée à l'ADS, 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.
+ Configurez éventuellement la mise en forme du trafic pour limiter le nombre de demandes adressées simultanément à l'ADS. Choisissez l'une des approches suivantes :
*Approche par fenêtre temporelle* : pour la **durée de la fenêtre de façonnage du trafic**, entrez le nombre de secondes pendant lesquelles les demandes MediaTailor doivent être distribuées à l'ADS. Pour plus d'informations, voir Explication de la [récupération du calendrier par prélecture unique](understanding-prefetching.md#avail-matching-criteria-retr).
*Approche basée sur* le **TPS : configurez les utilisateurs simultanés Peak TPS** **et Peak** pour limiter les demandes en fonction des transactions par seconde et des utilisateurs simultanés. Pour de plus amples informations, veuillez consulter [Gestion du trafic basée sur le TPS](tps-traffic-shaping.md).
+ Dans la section [**Variables dynamiques**](variables.md), entrez jusqu'à 100 variables de session dynamiques. MediaTailor utilise ces variables à des fins de substitution dans les demandes de prélecture qu'il envoie à l'ADS. Si vous ne saisissez aucune variable de session dynamique, MediaTailor essayez au mieux d'interpoler les valeurs des variables dynamiques contenues dans votre URL [ADS](configurations-create.md#configurations-create-main).
+ Sélectionnez **Ajouter une variable dynamique**.
+ Pour **Clé**, entrez une clé de variable de session dynamique, telle que`scte.event_id`. Vous pouvez utiliser n'importe quelle variable dynamique qui MediaTailor prend en charge. Pour plus d'informations sur les variables de session dynamiques, consultez[MediaTailor variables de session pour les requêtes ADS](variables-session.md).
+ 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**.
1. 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**](variables.md) 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 que`scte.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. Si un break publicitaire ne répond pas aux critères de correspondance spécifiés, MediaTailor ignore le préchargement correspondant à cet intervalle. Pour plus d'informations, consultez l'explication de la [consommation du programme de prélecture unique](understanding-prefetching.md#avail-matching-criteria).
1. 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 suivante[Supprimer des plannings de prélecture](deleting-prefetch-schedules.md).
### Déterminer la fréquence à laquelle votre client doit appeler l' CreatePrefetchSchedule API
Votre client peut appeler l'[CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html)API par programmation une fois par jour pour configurer la récupération et la consommation si vous savez exactement quand se produiront les interruptions publicitaires. Votre client peut également appeler l'API plusieurs fois au cours de la journée pour définir la récupération et la consommation. Lorsque vous choisissez la fréquence des appels d'API, tenez compte du [nombre maximum de programmes de prélecture actifs](quotas.md#prefetch-schedules-limit) 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 appeler l'API plus fréquemment.
## Programme de prélecture récurrent
Pour créer un calendrier prévisualisant les annonces avant que chaque annonce ne soit publiée dans le cadre d'un événement.
1. Dans le volet **Récupération récurrente**, spécifiez les paramètres de récupération que vous souhaitez utiliser. Ces paramètres déterminent à quel moment les publicités sont MediaTailor prélues depuis l'ADS. Ils déterminent également les variables de session dynamiques à inclure dans la demande adressée à l'ADS, le cas échéant.
+ Pour la **fenêtre de prélecture récurrente**, entrez l'heure à laquelle les extractions de 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 le **champ Délai après la fin d'utilisation**, entrez le nombre de secondes qui MediaTailor doivent s'écouler après la fin d'une utilisation avant de prévisualiser les publicités pour la prochaine utilisation. Si vous ne spécifiez aucune valeur, la valeur MediaTailor par défaut est « aucun délai ».
+ Configurez éventuellement la mise en forme du trafic pour limiter le nombre de demandes adressées simultanément à l'ADS. Choisissez l'une des approches suivantes :
*Approche par fenêtre temporelle* : pour la **durée de la fenêtre de façonnage du trafic**, entrez le nombre de secondes pendant lesquelles les demandes MediaTailor doivent être distribuées à l'ADS. Pour plus d'informations, voir Explication de la [récupération du calendrier de prélecture récurrent](understanding-prefetching.md#avail-matching-criteria-recurring-retr)
*Approche basée sur* le **TPS : configurez les utilisateurs simultanés Peak TPS** **et Peak** pour limiter les demandes en fonction des transactions par seconde et des utilisateurs simultanés. Pour de plus amples informations, veuillez consulter [Gestion du trafic basée sur le TPS](tps-traffic-shaping.md).
+ Dans la section [**Variables dynamiques**](variables.md), entrez jusqu'à 100 variables de session dynamiques. MediaTailor utilise ces variables à des fins de substitution dans les demandes de prélecture qu'il envoie à l'ADS. Si vous ne saisissez aucune variable de session dynamique, MediaTailor essayez au mieux d'interpoler les valeurs des variables dynamiques contenues dans votre URL [ADS](configurations-create.md#configurations-create-main).
+ Sélectionnez **Ajouter une variable dynamique**.
+ Pour **Clé**, entrez une clé de variable de session dynamique, telle que`scte.event_id`. Vous pouvez utiliser n'importe quelle variable dynamique qui MediaTailor prend en charge. Pour plus d'informations sur les variables de session dynamiques, consultez[MediaTailor variables de session pour les requêtes ADS](variables-session.md).
+ 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**.
1. 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 **Expiration des annonces récupérées**, indiquez combien de temps après la récupération les annonces peuvent être insérées.
+ Dans la section [**Critères de correspondance**](variables.md) 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 que`scte.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. Si un break publicitaire ne répond pas aux critères de correspondance spécifiés, MediaTailor ignore le préchargement correspondant à cet intervalle. Pour plus d'informations, consultez l'explication de la [consommation récurrente du programme de prélecture](understanding-prefetching.md#avail-matching-criteria-recur).
1. 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 suivante[Supprimer des plannings de prélecture](deleting-prefetch-schedules.md).
# Gestion du trafic basée sur le TPS
AWS Elemental MediaTailor propose deux approches facultatives de mise en forme du trafic pour limiter le nombre de demandes adressées à l'ADS à la fois. La mise en forme du trafic basée sur le TPS offre une alternative à la mise en forme du trafic basée sur les fenêtres temporelles pour les horaires de prélecture. Cette approche fournit une configuration plus intuitive en vous permettant de spécifier la capacité de votre serveur de décision publicitaire (ADS) en termes de transactions par seconde (TPS) et d'utilisateurs simultanés attendus, plutôt que de calculs de temps.
## Comment fonctionne le formatage du trafic basé sur le TPS
Au lieu de spécifier les durées des fenêtres de récupération, vous fournissez les paramètres suivants :
TPS de pointe
Le nombre maximum de demandes par seconde que votre ADS peut traiter. Ce paramètre n'a aucune valeur par défaut.
Nombre maximal d'utilisateurs simultanés
Le nombre maximal attendu de spectateurs simultanés pour votre contenu. Ce paramètre n'a aucune valeur par défaut.
MediaTailor distribue automatiquement les demandes de prélecture dans le temps afin de respecter la limite TPS spécifiée, quel que soit le nombre de sessions simultanées.
**Example Exemple de configuration basée sur le TPS**
Votre ADS peut gérer 500 TPS et vous vous attendez à 100 000 spectateurs simultanés aux heures de pointe. Vous configurez :
+ TPS de pointe : 500
+ Nombre maximal d'utilisateurs simultanés : 100 000
MediaTailor distribue automatiquement les demandes de prélecture dans le temps afin de respecter la limite TPS spécifiée, quel que soit le nombre de sessions simultanées.
# Supprimer des plannings de prélecture
La procédure suivante explique comment supprimer un planning de prélecture à l'aide de la MediaTailor console. *Pour plus d'informations sur la suppression des plannings de prélecture par programmation à l'aide de l' MediaTailorAPI, consultez la référence de [DeletePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePrefetchSchedule.html)l'API.AWS Elemental MediaTailor *
**Note**
La suppression ne s'effectue pas en temps réel. Il se peut que vous rencontriez un certain délai lors de la MediaTailor suppression du ou des programmes de prélecture, période pendant laquelle la récupération et la consommation du préchargement continueront de s'exécuter en arrière-plan.
**Pour supprimer un calendrier de prélecture à l'aide de la console**
1. Ouvrez la MediaTailor console à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, sélectionnez **Configurations**. Sélectionnez la configuration de lecture qui contient le ou les programmes de prélecture que vous souhaitez supprimer.
1. Dans l'onglet **Programmes de prélecture**, sélectionnez le calendrier de prélecture que vous souhaitez supprimer. Ensuite, choisissez **Supprimer**.