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