

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.

# Utilisation d'un CDN pour optimiser la personnalisation des MediaTailor publicités et la diffusion de contenu
<a name="integrating-cdn"></a>

AWS Elemental MediaTailor fonctionne efficacement en tant que service autonome, mais son intégration à un réseau de diffusion de contenu (CDN), tel qu'Amazon CloudFront ou un autre tiers CDNs, peut considérablement améliorer vos flux de travail de streaming. L'intégration d'un CDN est particulièrement utile lorsque vous devez diffuser du contenu à un large public géographiquement réparti ou lorsque vous souhaitez garantir une diffusion publicitaire cohérente dans différentes AWS régions.

Sans CDN, vos spectateurs se connectent directement à MediaTailor des manifestes et à des segments publicitaires personnalisés, ce qui peut entraîner une latence accrue, en particulier pour les spectateurs situés loin de la AWS région où votre MediaTailor configuration est déployée. En outre, lors d'événements à fort trafic, les connexions directes MediaTailor peuvent être soumises à une charge accrue, ce qui peut affecter les performances.

Pour plus d'informations sur les MediaTailor concepts et les flux de travail, consultez[Qu'est-ce que c'est AWS Elemental MediaTailor ?](what-is.md).

Lors de l'intégration d'un CDN MediaTailor, il est important de configurer une gestion CORS (Cross-Origin Resource Sharing) appropriée afin d'éviter les problèmes susceptibles de provoquer des échecs de lecture sur les lecteurs Web. Une configuration CORS appropriée est essentielle pour les segments publicitaires et les segments de contenu. Bien que les segments publicitaires soient plus sensibles aux problèmes de CORS, l'application d'une gestion cohérente du CORS à tous les types de segments garantit une expérience de lecture des plus fiables. Pour obtenir des instructions détaillées sur la configuration des comportements de routage des CDN avec une gestion CORS appropriée, consultez. [Configuration prête pour la production CloudFront pour MediaTailor](cf-comprehensive-configuration.md)

L'intégration du CDN permet également des fonctionnalités avancées de transmission de paramètres et de routage dynamique. Pour plus d'informations sur la transmission de paramètres de requête à CDNs des fins d'autorisation et de routage, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). Pour un serveur publicitaire dynamique et un routage d'origine à l'aide d'alias de configuration, consultez[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md).

Le fait de placer un CDN entre vos spectateurs MediaTailor offre les avantages suivants :
+ Réduisez la latence en diffusant du contenu depuis des emplacements périphériques plus proches des spectateurs
+ Améliorez l'évolutivité en répartissant la charge sur l'infrastructure mondiale du CDN
+ Améliorez la fiabilité grâce à des voies de livraison redondantes
+ Optimisez les coûts en réduisant le trafic d'origine
+ Implémentez des fonctionnalités avancées telles que le routage adapté à la qualité des médias (MQAR) pour améliorer la qualité du streaming

**Topics**
+ [Sélection de CDN](cdn-selection-guidance.md)
+ [Planifier l'intégration du CDN](planning-cdn-integration.md)
+ [Configurer l'intégration du CDN](cdn-configuration.md)
+ [Insertion d'annonces avec CDN](ssai-cdn-workflow.md)
+ [Assemblage de canaux avec CDN](ca-cdn-wflw.md)
+ [MediaPackage Intégration au CDN](mediapackage-integration.md)
+ [intégration d’CloudFront](cloudfront-specific-recommendations.md)
+ [Configuration d'un CDN tiers](cdn-provider-specific.md)
+ [Optimisation des performances du CDN](cdn-optimization.md)
+ [Surveillance du CDN](cdn-monitoring.md)
+ [Test d'intégration au CDN](cdn-integration-testing.md)
+ [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md)
+ [Référence d'analyse du journal d'intégration du CDN](cdn-log-error-reference.md)
+ [CloudFormation  Automatisation](automating-cdn-integration.md)
+ [CloudFrontConfiguration de production](cf-comprehensive-configuration.md)
+ [Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md)

# Sélectionnez le CDN adapté à vos besoins
<a name="cdn-selection-guidance"></a>

Le choix du bon fournisseur de réseau de diffusion de contenu (CDN) est une décision importante qui peut avoir un impact sur les performances de diffusion de contenu, les coûts et l'expérience des AWS Elemental MediaTailor utilisateurs. Tenez compte des facteurs suivants lors de la sélection d'un CDN pour votre MediaTailor implémentation :

**Couverture géographique**  
Choisissez un CDN fortement présent dans les régions où se trouve votre public. Les différents fournisseurs de CDN ont des points forts différents selon les régions géographiques.

**Intégration avec les AWS services**  
Amazon CloudFront propose l'intégration la plus étroite avec MediaTailor les autres AWS services, ce qui peut simplifier la configuration et la gestion. Les tiers CDNs peuvent offrir d'autres avantages, tels que des fonctionnalités de diffusion vidéo spécialisées ou une présence accrue dans des régions spécifiques.

**Fonctionnalités spécifiques à la vidéo**  
Recherchez CDNs cette offre de fonctionnalités spécialement conçues pour la diffusion vidéo, telles que l'optimisation adaptative du débit, la compression vidéo et les analyses axées sur l'expérience du spectateur.

**Structure des coûts**  
Comparez les modèles de tarification des différents fournisseurs, en tenant compte de facteurs tels que le volume de trafic, la distribution géographique et les exigences en matière de fonctionnalités. Certains CDNs proposent des remises sur volume ou des remises d'utilisation engagées qui peuvent correspondre à vos habitudes d'utilisation.

**Support pour les fonctionnalités avancées**  
Vérifiez que le CDN que vous avez choisi prend en charge les fonctionnalités dont vous avez besoin, telles que l'authentification par jeton, la géo-restriction, le regroupement des demandes et le transfert d'en-tête approprié.

Pour plus d'informations sur les fournisseurs de CDN spécifiques et leur intégration avec ceux-ci MediaTailor, consultez les ressources suivantes.
+ [intégration d’CloudFront](cloudfront-specific-recommendations.md)pour Amazon CloudFront
+ [Configuration d'un CDN tiers](cdn-provider-specific.md)pour les fournisseurs de CDN tiers

Les rubriques suivantes fournissent des conseils complets sur la configuration à l' MediaTailor aide d'un CDN pour des performances optimales.

# Planifiez votre intégration au CDN pour AWS Elemental MediaTailor
<a name="planning-cdn-integration"></a>

Vous pouvez améliorer l'expérience des spectateurs et réduire la latence grâce à une intégration CDN pour AWS Elemental MediaTailor. Lorsque vous implémentez un réseau de diffusion de contenu (CDN), vous pouvez diffuser du contenu depuis des emplacements plus proches de vos spectateurs. Cela garantit des temps de chargement plus rapides, une meilleure évolutivité et une diffusion publicitaire cohérente dans les différentes régions géographiques.

Vous avez besoin d'une bonne planification avant de mettre en œuvre un CDN avec AWS Elemental MediaTailor. Cette section vous guide à travers les principaux domaines de planification. Vous abordez ces domaines avant de commencer la configuration proprement dite. Ces étapes vous aident à créer une expérience de visionnage optimale pour votre public.

Une fois votre planification terminée, consultez la section [Intégration d'un CDN MediaTailor pour les instructions de](https://docs.aws.amazon.com/mediatailor/latest/ug/cdn-integration.html) step-by-step mise en œuvre.

Pour plus d'informations sur MediaTailor les quotas susceptibles d'affecter la planification de votre CDN, consultez[Quotas dans AWS Elemental MediaTailor](quotas.md). Pour plus d'informations sur CloudFront les quotas, consultez la section [Quotas](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) dans le guide du CloudFront développeur.

Avant de commencer à planifier, déterminez comment MediaTailor interagit avec un CDN :

1. Les spectateurs demandent du contenu via votre CDN plutôt que directement auprès de MediaTailor

1. Le CDN transmet les demandes de manifeste à des MediaTailor fins de personnalisation.

1. Le CDN met en cache et diffuse des segments de contenu et des segments publicitaires à partir d'emplacements périphériques.

Cette architecture réduit la charge de travail MediaTailor tout en garantissant que les spectateurs reçoivent des publicités personnalisées avec une latence minimale.

La compréhension de la terminologie du manifeste vous permet de configurer correctement votre CDN. Les différents protocoles de streaming utilisent des structures de manifeste spécifiques qui affectent la façon dont vous configurez la mise en cache et le routage :
+ *Manifestes HLS* - Lorsque vous travaillez avec des flux HLS, vous gérez :
  + Liste de *lecture multivariée* : configurez votre CDN pour qu'il achemine ces manifestes de haut niveau vers des fins de MediaTailor personnalisation.
  + Liste de *lecture multimédia* : définissez des règles de mise en cache appropriées pour ces manifestes contenant des liens vers des segments de contenu.
+ *Manifestes DASH* - Lorsque vous travaillez avec des flux DASH, vous gérez :
  + *MPD (Media Presentation Description)* : configurez votre CDN pour gérer ces manifestes conformément à vos exigences de personnalisation.

Le processus de planification du CDN comprend les étapes clés suivantes, chacune étant axée sur une tâche spécifique :
+ [Estimation des besoins en trafic pour le CDN et les intégrations MediaTailor](estimate-traffic.md): calculez le nombre de spectateurs que vous attendez et les besoins en bande passante.
+ [Configurer des stratégies d'optimisation pour le CDN et MediaTailor les intégrations](optimize-cdn-config.md): configurez votre CDN pour une diffusion de contenu et une personnalisation des publicités optimales.
+ [Personnalisez la planification pour le CDN et les intégrations MediaTailor](plan-for-workflow.md): ajustez votre stratégie CDN en fonction de votre MediaTailor flux de travail spécifique.
+ [Configuration de la surveillance et de la mise à l'échelle pour le CDN et les intégrations MediaTailor](setup-monitoring.md): Mettez en œuvre des stratégies de surveillance et de mise à l'échelle pour des performances fiables.
+ [Optimisez les coûts du CDN et MediaTailor des intégrations](optimize-costs.md): Équilibrez les performances avec la rentabilité.
+ [Testez votre implémentation pour le CDN et les intégrations MediaTailor](test-implementation.md): testez minutieusement votre intégration au CDN avant le déploiement en production.

# Estimation des besoins en trafic pour le CDN et les intégrations MediaTailor
<a name="estimate-traffic"></a>

Pour dimensionner avec précision l'intégration de votre réseau de diffusion de contenu (CDN) avec AWS Elemental MediaTailor :

1. Calculez le nombre de spectateurs attendus à l'aide de données historiques ou d'événements similaires. Prévoyez une capacité supplémentaire au-delà de votre base de référence pour faire face à des pics inattendus. Pour connaître les recommandations de dimensionnement actuelles, consultez l'équipe chargée de votre AWS compte. Vous pouvez également consulter [Quotas dans AWS Elemental MediaTailor](quotas.md).

1. Identifiez les modèles de trafic de pointe et les pics potentiels dans votre calendrier de contenu. Tenez compte de facteurs tels que :
   + Événements sportifs en direct ou avant-premières de saison
   + Campagnes marketing ou événements promotionnels
   + Différences de fuseaux horaires pour le public mondial
   + Schémas d'observation pendant les fêtes ou les saisons

1. Déterminez vos besoins en bande passante en multipliant le nombre de spectateurs par le débit des flux. Collaborez avec votre fournisseur de CDN pour calculer la capacité appropriée. Basez ce calcul sur vos débits de contenu spécifiques et sur la taille d'audience attendue. Ajoutez des frais supplémentaires pour les segments publicitaires et les demandes de manifeste, comme le recommande votre fournisseur.

1. Travaillez avec votre fournisseur de CDN pour garantir une capacité périphérique suffisante dans vos régions cibles.

Assurez-vous que votre capacité d'insertion publicitaire répond à la demande des internautes en prenant les mesures spécifiques suivantes :

1. Vérifiez votre quota actuel de demandes d'insertion d'annonces dans la [console Service Quotas](https://console.aws.amazon.com/servicequotas/home/services/mediatailor/quotas). Passez en revue les limites de service actuelles pour savoir combien de spectateurs simultanés votre configuration peut prendre en charge.

1. Pour les événements à fort trafic, demandez un quota accru via la [console Service Quotas.](https://console.aws.amazon.com/servicequotas/home/services/mediatailor/quotas)

1. Si vous attendez plus de 500 000 spectateurs simultanés, contactez [AWS Support](https://aws.amazon.com/premiumsupport/) au moins 2 semaines avant votre événement. Cela permet de AWS garantir une capacité suffisante pour répondre à vos besoins de personnalisation des annonces.

Pour plus d'informations sur la mise en œuvre de la planification des capacités dans votre flux de travail, voir [Utilisation de la planification par prélecture pour](https://docs.aws.amazon.com/mediatailor/latest/ug/prefetch.html) optimiser la diffusion des annonces lors d'événements à fort trafic.

# Configurer des stratégies d'optimisation pour le CDN et MediaTailor les intégrations
<a name="optimize-cdn-config"></a>

Lorsque vous avez terminé l'estimation du trafic, configurez votre réseau de diffusion de contenu (CDN) pour optimiser la diffusion de contenu et la personnalisation des publicités avec. AWS Elemental MediaTailor Ces optimisations permettent de garantir une lecture fluide tout en maintenant une publicité ciblée.

Implémentez les optimisations spécifiques du CDN suivantes :

1. Configurez les fonctionnalités d'Origin Shield dans votre CDN afin de réduire la charge MediaTailor et d'améliorer l'efficacité de la mise en cache. Origin Shield agit comme une couche de mise en cache intermédiaire qui :
   + Regroupez les demandes de plusieurs utilisateurs en une seule demande d'origine
   + Réduisez le nombre de demandes redondantes pour MediaTailor
   + Améliorez les temps de réponse pour le contenu mis en cache

   Pour plus de détails sur la mise en œuvre de la configuration d'Origin Shield avec CloudFront, consultez la section [Utilisation d'Origin Shield](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html) dans le manuel du CloudFront développeur.

1. Définissez les valeurs TTL (Time To Live) appropriées pour les différents types de contenu. Le TTL détermine la durée de mise en cache du contenu du CDN. Passé ce délai, le CDN demande une nouvelle copie à l'origine :
   + Manifestes : 
     + 0 secondes pour l'insertion de l'annonce
     + 5 à 10 secondes pour l'assemblage du canal

     Lors de l'insertion d'annonces, MediaTailor fournit des manifestes contenant des publicités personnalisées pour le spectateur. Si une playlist ou un MPD est mis en cache et diffusé sur le mauvais appareil de lecture, celui-ci peut rencontrer des problèmes de lecture ou de suivi.
   + Segments de contenu : 24 heures ou plus (ils changent rarement et vous pouvez les mettre en cache de manière agressive pour réduire la charge d'origine)
   + Segments publicitaires : 24 heures ou plus (le contenu publicitaire est généralement réutilisé par les internautes et vous pouvez le mettre en cache pendant de longues périodes)

   Pour des recommandations TTL complètes et des stratégies d'optimisation de la mise en cache pour tous les MediaTailor flux de travail, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

   Pour obtenir des instructions détaillées sur la configuration des comportements du cache dans CloudFront, consultez la section [Paramètres du comportement du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior) dans le Guide du CloudFront développeur.

1. Déployez des nœuds périphériques du CDN à proximité de vos populations de spectateurs. Collaborez avec votre fournisseur de CDN pour :
   + Identifiez les emplacements optimaux des nœuds périphériques en fonction de la démographie des spectateurs
   + Garantir une capacité suffisante dans chaque région
   + Surveillez les performances de pointe et ajustez-les selon les besoins

   Pour obtenir des conseils de mise en œuvre, consultez la section [Emplacements CloudFront périphériques](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/LocationsOfEdgeServers.html) afin d'identifier les emplacements périphériques disponibles pour les régions de votre audience.

1. Pour un public mondial, envisagez de mettre en œuvre une stratégie multi-CDN. Cette approche :
   + Utilise plusieurs fournisseurs de CDN pour améliorer la fiabilité
   + Oriente les spectateurs vers le CDN le plus performant pour leur localisation
   + Fournit des options de basculement en cas de panne du CDN
   + Peut optimiser les coûts en tirant parti de différents modèles de tarification

   Pour plus de détails sur la mise en œuvre, consultez la section [Stratégies multi-CDN](https://aws.amazon.com/blogs/networking-and-content-delivery/multi-cdn-strategies/) sur le blog AWS Networking & Content Delivery.

# Personnalisez la planification pour le CDN et les intégrations MediaTailor
<a name="plan-for-workflow"></a>

Les différents AWS Elemental MediaTailor flux de travail ont des exigences uniques qui affectent la planification du réseau de diffusion de contenu (CDN). Pour obtenir des conseils spécifiques au flux de travail, consultez la section [Utilisation](https://docs.aws.amazon.com/mediatailor/latest/ug/configurations.html) des configurations.

Ajustez votre plan de capacité en fonction de votre MediaTailor flux de travail spécifique :

## Pour les flux de travail d'insertion de MediaTailor publicités
<a name="plan-ad-insertion"></a>

1. Configurez votre CDN pour gérer des manifestes personnalisés sans aucune mise en cache. Cela garantit que chaque spectateur reçoit des publicités uniques et ciblées. Les publicités sont basées sur leur profil et leur contexte de visionnage.

1. Dimensionnez votre serveur de décision publicitaire (ADS) pour gérer les pics de demandes. Pour obtenir des conseils sur la configuration d'ADS, consultez la section [Insertion d'annonces avec MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-insertion.html). Tenez compte de :
   + Temps de réponse requis pour votre cas d'utilisation
   + Capacité de visionnage simultanée attendue
   + Exigences en matière de redondance et de basculement
   + Besoins de distribution géographique

1. Implémentez le regroupement des demandes au niveau du CDN pour gérer les demandes d'interruption de publicité synchronisées. Le regroupement des demandes combine plusieurs demandes identiques en une seule demande d'origine. Cela est crucial lors de :
   + Événements sportifs en direct lorsque de nombreux spectateurs font des pauses publicitaires simultanément
   + Émissions de télévision populaires diffusées en avant-première avec des pauses publicitaires synchronisées
   + Des événements d'actualité qui attirent des pics soudains d'audience

   Pour plus de détails sur la mise en œuvre, consultez [Origin Failover](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html) pour configurer le traitement des demandes pendant les pics de charge.

## Pour les flux de travail d'assemblage de MediaTailor canaux
<a name="plan-channel-assembly"></a>

1. Calculez les besoins en capacité en fonction du nombre de canaux et de leurs débits. Pour obtenir des conseils sur la planification de la capacité d'assemblage des canaux, voir [Assemblage des canaux dans MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly.html). Tenez compte de :
   + Nombre total de canaux
   + Exigences en matière de débit par canal
   + Charge de visionnage simultanée attendue
   + Besoins de distribution géographique

1. Configurez votre CDN pour gérer des modèles de trafic prévisibles en fonction des plannings publiés. L'assemblage des chaînes présente généralement des modèles plus prévisibles que l'insertion de publicités pour les raisons suivantes :
   + Les horaires de programmation sont connus à l'avance
   + Le comportement du spectateur suit des modèles établis
   + Le contenu ne change pas de manière dynamique par spectateur

1. Assurez-vous que votre origine dispose d'une bande passante suffisante pour maintenir une sortie de canal cohérente. Mettre en œuvre :
   + Serveurs d'origine redondants pour des canaux à haute disponibilité
   + Basculement automatique entre l'origine principale et l'origine de sauvegarde
   + Surveillance pour détecter les problèmes de performance liés à l'origine

   Pour obtenir des conseils de mise en œuvre, voir [Configuration de la redondance d'origine](https://docs.aws.amazon.com/mediapackage/latest/ug/cloudfront-origin-failover.html) pour créer une infrastructure d'origine résiliente.

## Pour des MediaTailor flux de travail combinés
<a name="plan-combined-workflow"></a>

1. Dimensionnez votre infrastructure pour gérer les modèles de trafic combinés des deux services. Pour obtenir des conseils sur les flux de travail combinés, voir[Utilisation AWS Elemental MediaTailor pour insérer des publicités](configurations.md). Tenez compte de :
   + Exigences de base relatives à l'assemblage des canaux
   + Frais généraux d'insertion d'annonces
   + Modèles de trafic de pointe
   + Besoins en matière de redondance

1. Configurez des comportements CDN distincts pour la diffusion de contenu linéaire et l'insertion dynamique de publicités. Cette séparation vous permet de :
   + Optimisez les politiques de mise en cache pour chaque type de contenu indépendamment
   + Acheminer les demandes vers les origines appropriées en fonction du type de contenu
   + Surveillez les indicateurs de performance séparément pour chaque flux de travail

1. Configurez un routage approprié entre la périphérie et l'origine CDNs pour maintenir des performances optimales. Pensez à utiliser :
   + Différents chemins d'origine pour les segments de contenu (/content/\$1) et les segments publicitaires (/ads/\$1)
   + Comportements de cache distincts pour les manifestes et les segments
   + Routage géographique pour optimiser le temps de latence pour les différentes régions

   Pour plus de détails sur l'implémentation, consultez [la section Configuration des comportements du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior) pour configurer des règles de routage et de mise en cache basées sur le chemin.

# Configuration de la surveillance et de la mise à l'échelle pour le CDN et les intégrations MediaTailor
<a name="setup-monitoring"></a>

Des stratégies de surveillance et de mise à l'échelle efficaces sont essentielles pour maintenir des performances et une expérience utilisateur optimales grâce à l'intégration de votre réseau de diffusion de AWS Elemental MediaTailor contenu (CDN). Mettez en œuvre ces approches pour garantir que votre intégration CDN fonctionne de manière fiable à grande échelle.

Mettez en œuvre les stratégies de surveillance et de mise à l'échelle suivantes :

1. Configurez la surveillance pour ces indicateurs clés. Pour obtenir des conseils sur les valeurs cibles appropriées, consultez [Monitoring MediaTailor with Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-cloudwatch-metrics.html) et consultez les meilleures pratiques de votre fournisseur de CDN :
   + Taux de réussite du cache CDN (établissez des indicateurs et des cibles de référence en fonction de votre type de contenu et de vos habitudes de diffusion)
   + Volumes de demandes d'origine (surveillez les modèles pendant le fonctionnement normal afin d'établir des bases de référence pour la détection des anomalies)
   + Taux d'erreur par type d'erreur (définissez des seuils en fonction de vos objectifs de niveau de service et des MediaTailor meilleures pratiques)
   + Temps de réponse (définissez des objectifs de latence appropriés en fonction de vos exigences en matière d'expérience utilisateur et de votre répartition géographique)

   Pour obtenir des instructions de mise en œuvre détaillées, consultez [la section Création de CloudWatch tableaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) de bord pour visualiser vos indicateurs MediaTailor et ceux du CDN ensemble.

1. Configurez des alertes en cas de modèles de trafic inattendus ou de dégradation des performances. Configurez les seuils en fonction de vos indicateurs de référence et de vos objectifs de niveau de service. Pour obtenir des conseils sur la configuration des alertes, consultez la section [Création d' CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Envisagez de surveiller :
   + Écarts importants par rapport aux taux d'accès au cache de référence (alerte généralement en cas de baisse de 85 à 90 %)
   + Augmentations soudaines du volume de demandes d'origine (alerte en cas d'augmentation de 30 % ou plus par rapport à la valeur de référence)
   + Les pics de taux d'erreur dépassent les seuils que vous avez définis (généralement 1 à 2 % pour les erreurs 4xx, 0,5 % pour les erreurs 5xx)
   + Dégradation du temps de réponse au-delà des niveaux acceptables (généralement > 500 ms pour les manifestes, > 200 ms pour les segments)

   Pour des exemples de mise en œuvre, consultez [CloudWatch les concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) de création de tableaux de bord et d'alertes de surveillance efficaces.

1. Créez des plans de mise à l'échelle pour les événements prévisibles à fort trafic. Vos plans doivent inclure les éléments clés suivants :
   + Augmentations de capacité avant l'événement (24 à 48 heures avant le début de l'événement)
   + Horaires d'augmentation progressive du nombre de spectateurs (généralement 10 à 20 % de l'audience attendue par intervalle de 5 minutes)
   + Répartition des capacités régionales en fonction de l'audience (attribuer la capacité proportionnellement à l'audience régionale attendue)
   + Procédures de dimensionnement après l'événement (maintien de la capacité maximale pendant 30 à 60 minutes après la fin de l'événement)

   Pour obtenir des conseils de mise en œuvre sur la mise à l'échelle en cas d'événements à fort trafic, consultez la section [Configuration d'un flux de travail end-to-end en direct résilient](https://aws.amazon.com/blogs/media/part-1-how-to-set-up-a-resilient-end-to-end-live-workflow/) sur le blog AWS des médias.

1. Mettez en œuvre des mesures de basculement et de redondance pour les flux critiques, notamment :
   + Déploiements de CDN multirégionaux (au moins deux régions pour le contenu critique)
   + Serveurs d'origine de sauvegarde (configurés avec des contrôles de santé automatisés toutes les 30 secondes)
   + Déclenchements de basculement automatisés basés sur des tests de santé (généralement après 2 ou 3 vérifications infructueuses)
   + Procédures de restauration pour différents scénarios de défaillance (documentées avec des objectifs de temps de réponse spécifiques)

   Pour connaître les étapes de mise en œuvre détaillées, voir [Optimisation de la haute disponibilité avec le basculement CloudFront d'origine](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html).

# Optimisez les coûts du CDN et MediaTailor des intégrations
<a name="optimize-costs"></a>

Les coûts des réseaux de diffusion de contenu (CDN) peuvent varier considérablement en fonction des modèles de trafic, de la distribution géographique et de l'utilisation des AWS Elemental MediaTailor fonctionnalités. Pour obtenir des informations sur les prix actuels, consultez la section [CloudFront sur les prix](https://aws.amazon.com/cloudfront/pricing/). Vous pouvez également consulter la documentation de votre fournisseur de CDN.

Équilibrez les performances avec le rapport coût-efficacité en utilisant les stratégies suivantes :

1. Analysez les modèles de trafic de votre CDN pour sélectionner le niveau de tarification le plus rentable. Passez en revue les facteurs suivants avec votre fournisseur de CDN :
   + Volumes de transfert de données par région et par période
   + Modèles de demande pour les manifestes et les segments
   + Exigences relatives à la distribution géographique
   + Modes d'utilisation de pointe par rapport à la moyenne

   Pour vous aider à analyser les coûts, utilisez le [calculateur de AWS prix](https://calculator.aws/#/) pour estimer vos CloudFront coûts en fonction de vos habitudes d'utilisation spécifiques.

1. Pour des charges de travail prévisibles, évaluez les accords de capacité réservée avec votre fournisseur de CDN. Ces accords peuvent offrir des avantages tels que :
   + Tarifs réduits pour les volumes d'utilisation engagés
   + Coûts mensuels prévisibles pour la budgétisation
   + Soutien prioritaire et allocation de capacités

   Consultez votre fournisseur de CDN pour déterminer si la capacité réservée est adaptée à vos habitudes d'utilisation. Pour CloudFront, voir les [fonctionnalités CloudFront premium](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-premium-features.html). Cela fournit des informations sur les options de capacité réservée.

1. Optimisez les coûts de sortie en équilibrant le trafic entre MediaTailor et votre fournisseur de CDN. Les stratégies incluent :
   + Maximisez les taux de réussite du cache pour réduire les demandes d'origine
   + Utiliser Origin Shield pour consolider les demandes
   + Implémenter la compression pour réduire les volumes de transfert de données
   + Choisissez les régions du CDN qui correspondent à AWS la tarification régionale

   Pour obtenir des conseils d'implémentation sur la compression, consultez la section [Servir des fichiers compressés](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/ServingCompressedFiles.html) dans le manuel du CloudFront développeur.

1. Mettez en œuvre des stratégies de mise en cache appropriées pour les différents types de contenu afin de réduire les demandes d'origine. Pour obtenir des conseils sur l'optimisation du cache, consultez [la section Amélioration des taux de réussite du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html). Concentrez-vous sur :
   + Segments de contenu (vous pouvez les mettre en cache pendant de longues périodes)
   + Segments publicitaires (généralement réutilisés par les utilisateurs)
   + Ressources statiques telles que les fichiers de lecteur et les images

   L'amélioration des taux d'accès au cache réduit considérablement les coûts d'origine. Collaborez avec votre fournisseur de CDN pour optimiser les configurations de cache en fonction de vos modèles de contenu spécifiques. Pour connaître les étapes de mise en œuvre détaillées, consultez [la section Configuration des comportements du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/ConfiguringCaching.html).

# Testez votre implémentation pour le CDN et les intégrations MediaTailor
<a name="test-implementation"></a>

Garantissez une expérience utilisateur fiable en testant minutieusement l'intégration de votre réseau de diffusion de AWS Elemental MediaTailor contenu (CDN) avant le déploiement en production. Des tests appropriés permettent d'identifier et de résoudre les problèmes avant qu'ils n'affectent votre public. Pour obtenir des conseils sur les méthodologies de test, voir [Tester CloudFront les distributions](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-testing.html). Vous pouvez également consulter la documentation de test de votre fournisseur de CDN.

Suivez ces étapes de test pour valider votre intégration au CDN :

1. Créez un environnement de test qui reflète votre configuration de production. Inclure :
   + Paramètres CDN et comportements de cache identiques
   + Incluez du contenu représentatif avec différents débits et formats
   + Configuration d'un serveur de test et de décision publicitaire avec des exemples de réponses publicitaires
   + Configuration des configurations de surveillance et d'alerte

   Pour obtenir des conseils de step-by-step mise en œuvre, consultez [la section Création d'une distribution intermédiaire](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-testing.html) dans le Guide du CloudFront développeur.

1. Effectuez des tests de charge pour vérifier vos estimations de capacité. Pour obtenir des conseils sur les tests de charge, consultez [la section Surveillance MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring-service.html). Les scénarios de test doivent inclure :
   + Augmentation progressive du nombre de spectateurs (généralement 10 à 20 % du pic attendu toutes les 5 minutes)
   + Des pics de trafic soudains en fonction de vos pics de charge attendus (simulez 50 % du pic d'audience rejoignant le site dans les 60 secondes)
   + Périodes de pointe prolongées (maintien de la charge maximale pendant au moins 30 à 60 minutes)
   + Distribution géographique correspondant à votre audience (répartissez le trafic de test en fonction de la localisation attendue des spectateurs)

   Vérifiez que les temps de réponse restent inférieurs aux seuils cibles. Cela signifie généralement moins de 500 ms pour les manifestes et moins de 200 ms pour les segments. Le taux d'erreur doit rester inférieur à 1 %. Pour plus de détails sur la mise en œuvre des outils et méthodologies de test de [charge, consultez la section relative aux tests](https://aws.amazon.com/blogs/networking-and-content-delivery/load-testing-with-cloudfront/) de charge CloudFront sur le blog AWS Networking & Content Delivery.

1. Testez des scénarios de basculement pour garantir la fiabilité. Simulez :
   + Défaillances du serveur d'origine (scénarios de panne complète et de dégradation partielle)
   + Interruptions des sites périphériques du CDN (test avec routage du trafic vers des sites de sauvegarde)
   + Indisponibilité du serveur Ad Decision (test avec des délais d'expiration de 5 à 10 secondes)
   + Problèmes de connectivité réseau (simulation de la perte de paquets et de l'augmentation de la latence)

   Travaillez avec votre fournisseur de CDN pour établir des objectifs de temps de réponse en cas de basculement adaptés à votre cas d'utilisation. Généralement, cela signifie moins de 3 secondes pour terminer le basculement. Pour obtenir des conseils d'implémentation sur les tests de basculement, voir [Origin failover](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html) dans le guide du CloudFront développeur.

1. Pour les événements majeurs, mettez en œuvre des stratégies de montée en puissance progressive basées sur les directives relatives aux [tests AWS de charge](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/load-testing.html) :
   + Étalez les heures de début en fonction des différents segments d'audience. Par exemple, autorisez d'abord les abonnés premium avec des intervalles de 15 minutes entre les groupes d'audience.
   + Utilisez des techniques de préchauffage pour augmenter progressivement la charge. Le préchauffage implique :
     + Remplir les caches du CDN avec du contenu populaire 2 à 4 heures avant l'événement
     + Augmenter progressivement le trafic synthétique jusqu'à 20 à 30 % du pic prévu pour réchauffer les systèmes
     + Testez tous les composants dans des conditions de charge réalistes avec le contenu réel
   + Surveillez les performances du système tout au long de la période de mise en service, en suivant :
     + Taux d'accès au cache et temps de réponse (objectif : taux de réussite supérieur à 90 %, réponse inférieure à 500 ms)
     + Taux d'erreur et charge d'origine (maintien des taux d'erreur inférieurs à 1 %, processeur d'origine < 70 %)
     + Taux de réussite de la personnalisation des publicités (objectif > 98 % de personnalisation réussie)
     + Mesures relatives à l'expérience utilisateur (délai de démarrage cible inférieur à 2 secondes, délai de rebufférisation inférieur à 0,5 %)
   + Établissez un plan d'urgence en cas de surtension imprévue. Votre plan doit inclure les éléments essentiels suivants :
     + Procédures de mise à l'échelle des capacités d'urgence avec étapes documentées pour augmenter la capacité de 50 à 100 % en 15 minutes
     + Protocoles d'activation du CDN de sauvegarde avec possibilité de transférer 20 à 50 % du trafic vers le CDN secondaire
     + Solution de repli simplifiée pour l'insertion d'annonces afin de réduire les paramètres de ciblage de 10 ou plus à 3 à 5 paramètres essentiels
     + Plans de communication pour les parties prenantes avec des modèles de notification et des listes de contacts prédéfinis

   Une fois vos tests terminés, passez à la section [Implémentation de votre intégration CDN](https://docs.aws.amazon.com/mediatailor/latest/ug/cdn-integration.html) pour les étapes de déploiement en production.

# Résoudre les problèmes courants liés au CDN et aux intégrations MediaTailor
<a name="troubleshooting-cdn"></a>

Relevez les problèmes courants d'intégration des réseaux de diffusion de contenu (CDN) AWS Elemental MediaTailor avant qu'ils n'aient un impact sur vos spectateurs. Cette section vous aide à identifier et à résoudre les problèmes typiques qui se produisent lors de l'intégration du CDN avec AWS Elemental MediaTailor.

Pour obtenir des conseils de dépannage complets, consultez la section [Résolution des problèmes MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html) et [ CloudFront distributions de résolution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/troubleshooting.html) des problèmes.

## Résolution des problèmes de livraison de MediaTailor manifestes
<a name="manifest-issues"></a>

Si les spectateurs rencontrent des problèmes de lecture ou voient des publicités incorrectes, vérifiez les problèmes courants liés aux manifestes suivants :
+ **Paramètres de mise en cache incorrects** : si votre CDN met en cache des manifestes personnalisés, les spectateurs peuvent voir des publicités destinées à d'autres utilisateurs.

  Solution : configurez votre CDN avec un TTL de cache de 0 pour les demandes de manifeste adressées à. MediaTailor
+ **Échec des demandes d'origine** : si votre CDN ne parvient pas à atteindre MediaTailor, les demandes de manifeste échoueront.

  Solution : Vérifiez la connectivité réseau entre votre CDN et MediaTailor. Vérifiez que votre CDN transmet correctement les en-têtes corrects.
+ **Problèmes liés aux paramètres de session : des** paramètres de session manquants ou incorrects peuvent entraîner des échecs de personnalisation.

  Solution : assurez-vous que votre joueur ajoute correctement tous les paramètres de session requis aux demandes de manifeste.

## Résoudre les problèmes de diffusion des MediaTailor segments
<a name="segment-issues"></a>

Si le contenu ou les segments publicitaires ne se chargent pas correctement, examinez les problèmes courants suivants :
+ **Réécriture du chemin du segment** : une configuration CDN incorrecte peut réécrire le segment de manière incorrecte. URLs 

  Solution : Vérifiez que votre CDN gère correctement le segment URLs. Assurez-vous qu'il ne modifie pas les chemins d'une manière qui rompe les références.
+ **Configuration CORS** : des en-têtes CORS manquants ou incorrects peuvent empêcher les navigateurs de charger des segments.

  Solution : configurez votre CDN pour transmettre les en-têtes CORS appropriés aux demandes de segment.
+ **Tempêtes d'erreurs de cache** : lors d'événements à fort trafic, plusieurs défaillances de cache peuvent submerger les serveurs d'origine.

  Solution : implémentez des fonctionnalités de réduction des demandes et de protection des origines afin de réduire la charge d'origine lors des pics de trafic.

## Résolution des problèmes de performance MediaTailor du CDN
<a name="performance-issues"></a>

Si les spectateurs sont confrontés à une mise en mémoire tampon ou à un chargement lent, vérifiez les problèmes de performances suivants :
+ **Faible taux de réussite du cache** : si votre CDN demande fréquemment du contenu depuis l'origine, les performances en pâtiront.

  Solution : Analysez les taux d'accès au cache par type de contenu et ajustez les paramètres TTL pour améliorer l'efficacité de la mise en cache.
+ **Distribution géographique** : les spectateurs éloignés des emplacements périphériques du CDN peuvent être confrontés à une latence accrue.

  Solution : passez en revue la distribution des emplacements périphériques de votre CDN. Augmentez la capacité dans les régions à forte concentration de spectateurs.
+ **Limitations de capacité d'origine** : si vos serveurs d'origine sont surchargés, les temps de réponse augmenteront.

  Solution : implémentez la limitation des demandes d'origine. Vous pouvez également augmenter la capacité d'origine ou améliorer la mise en cache pour réduire la charge d'origine.

Pour obtenir une assistance supplémentaire en matière de dépannage, consultez la section [Dépannage MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html) ou contactez AWS le Support. Pour obtenir des conseils de mise en œuvre sur la résolution des problèmes courants liés au CDN, consultez la section [Débogage de votre réseau de diffusion de contenu](https://aws.amazon.com/blogs/media/debugging-your-content-delivery-network/) sur le blog des AWS médias.

# Configurer l'intégration du CDN avec MediaTailor
<a name="cdn-configuration"></a>

Cette section fournit des conseils sur l'intégration AWS Elemental MediaTailor à un réseau de diffusion de contenu (CDN). 

L'intégration efficace du CDN MediaTailor est essentielle pour proposer des expériences de streaming de haute qualité avec des publicités personnalisées à grande échelle. Ce guide explique le processus complet de configuration, de configuration et d'optimisation de votre intégration au CDN.

Pour plus d'informations, consultez les liens suivants :
+ Pour plus d'informations sur la transmission de paramètres de requête à CDNs des fins d'autorisation et de ciblage publicitaire, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). 
+ Pour un routage avancé utilisant des variables dynamiques et des alias de configuration, consultez[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md).
+ Pour plus d'informations sur la création de MediaTailor configurations, consultez[Utilisation AWS Elemental MediaTailor pour insérer des publicités](configurations.md). 
+ Pour plus d'informations sur la création d'une CloudFront distribution, consultez [la section Création d'une distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le Guide du CloudFront développeur.

Pour garantir la clarté de ce guide, la terminologie suivante est utilisée pour décrire les différents types de manifestes :
+ **Manifestes HLS :**
  + Liste de *lecture multivariée* : manifeste de niveau supérieur contenant des liens vers des listes de lecture multimédia
  + Liste de *lecture multimédia* : le manifeste de deuxième niveau contenant des liens vers des segments de contenu
+ **DASH manifeste** :
  + *MPD (Media Presentation Description)* : terme standard pour les manifestes DASH

L'intégration MediaTailor à un CDN offre les avantages suivants :
+ Latence réduite pour les spectateurs
+ Évolutivité améliorée pour les événements à fort trafic
+ Fiabilité accrue grâce à des voies de livraison redondantes
+ Coûts optimisés en réduisant le trafic d'origine
+ Meilleure protection contre les attaques DDo S

## Composants et exigences d'intégration du CDN
<a name="cdn-integration-components"></a>

Une intégration CDN réussie MediaTailor implique de configurer les composants clés suivants :

**Comportements de routage du CDN**  
Règles qui déterminent la manière dont les différents types de demandes (manifestes, segments de contenu, segments publicitaires) sont acheminés via votre CDN.

**Mappage du CDN dans MediaTailor**  
Configuration garantissant MediaTailor que les manifestes font référence à votre domaine CDN au lieu de référencer directement les serveurs d'origine.

**Paramètres de sécurité**  
Des configurations qui protègent votre contenu et votre infrastructure, notamment en matière de sécurité du transport, de contrôle d'accès et de surveillance.

**Tests et validation**  
Procédures permettant de vérifier que votre intégration CDN fonctionne correctement avant le déploiement en production.

## Conditions préalables à l'intégration du CDN
<a name="prerequisites"></a>

Avant de configurer votre intégration au CDN, assurez-vous de disposer des éléments suivants :

1. Une MediaTailor configuration avec les paramètres suivants :
   + L'origine de votre contenu en tant que **source de contenu**
   + Votre ADS en tant que **serveur de décision publicitaire**

   Vous avez également besoin de l'origine et de l'ADS URLs dans les étapes d'intégration du CDN.

1. Accès à l'interface de configuration de votre CDN

1. Compréhension de la terminologie spécifique de votre CDN pour les comportements, les règles et les paramètres de cache

1. Connaissance de la structure de votre contenu, y compris des extensions de fichier utilisées pour les segments (telles que .ts, .mp4 ou .m4s)

## Étapes de configuration de l'intégration du CDN
<a name="cdn-integration-workflow"></a>

Le processus d'intégration MediaTailor à un CDN suit les étapes de haut niveau suivantes :

1. **Configurer les comportements de routage du CDN** : configurez votre CDN pour acheminer les différents types de demandes de manière appropriée.

1. **Configurez le mappage du CDN dans MediaTailor** - Mettez à jour votre MediaTailor configuration pour utiliser vos noms de domaine CDN.

1. **Mettez en œuvre les meilleures pratiques** de sécurité : configurez les paramètres de sécurité pour protéger votre contenu et votre infrastructure.

1. **Testez votre intégration** : vérifiez que l'intégration de votre CDN fonctionne correctement.

## En-têtes requis pour l'intégration du MediaTailor CDN
<a name="cdn-required-headers"></a>

 MediaTailor Pour fonctionner correctement avec votre CDN, vous devez configurer votre CDN pour transférer des en-têtes HTTP spécifiques. Ces en-têtes sont essentiels au bon fonctionnement, notamment pour la compression, la détection des appareils, la personnalisation des publicités et le ciblage géographique.

Configurez votre CDN pour transférer les en-têtes suivants vers : MediaTailor

**`Accept-Encoding`**  
**Objectif** : Nécessaire pour la fonctionnalité de compression  
**Détails** : Cet en-tête indique MediaTailor les méthodes de compression prises en charge par le client. MediaTailor utilise ces informations pour compresser les manifestes lorsque cela est possible, afin de réduire l'utilisation de la bande passante et d'améliorer les performances. Les anciens appareils qui ne prennent pas en charge la compression n'enverront pas cet en-tête et MediaTailor renverront des manifestes non compressés.

**`User-Agent`**  
**Objectif** : Nécessaire pour la détection des appareils et la personnalisation des publicités  
**Détails** : MediaTailor analyse l'en-tête User-Agent pour identifier le type d'appareil client, le navigateur et les fonctionnalités. Ces informations sont utilisées pour le ciblage publicitaire, les optimisations spécifiques à l'appareil et pour garantir la compatibilité avec les différents clients de lecture.

**`Host`**  
**Objectif** : Nécessaire pour le bon acheminement des demandes  
**Détails** : L'`Host`en-tête garantit que les demandes sont acheminées vers le point de MediaTailor terminaison approprié. Cela est particulièrement important dans les environnements à locataires multiples et lors de l'utilisation de configurations de domaine personnalisées.  
Beaucoup CDNs, y compris Amazon CloudFront, ne transmettent pas l'`Host`en-tête par défaut. Pour CloudFront les utilisateurs : voir [Configuration des comportements du cache](cloudfront-basic-setup.md#cf-cache-behaviors) les instructions de configuration.

**`X-Forwarded-For`**  
**Objectif : Nécessaire** pour la détection de l'adresse IP des clients et le ciblage géographique  
**Détails** : Cet en-tête préserve l'adresse IP d'origine du client lorsque les demandes transitent par votre CDN. MediaTailor utilise ces informations à des fins de ciblage publicitaire géographique, d'analyse et de conformité aux restrictions de contenu régionales.

**Important**  
Les quatre en-têtes sont nécessaires pour une MediaTailor fonctionnalité complète. L'absence de l'un de ces en-têtes peut entraîner une réduction des fonctionnalités, notamment :  
Impossible de compresser les manifestes (Accept-Encoding manquant)
Mauvais ciblage publicitaire et problèmes de compatibilité des appareils (agent utilisateur manquant)
Défaillances du routage des demandes (hôte manquant)
Ciblage géographique et analyses inexacts (manquants) X-Forwarded-For

Pour obtenir des instructions de configuration spécifiques au CDN, consultez les sections sur les comportements de routage et la mise en cache qui font référence à cette liste d'en-têtes.

Les rubriques suivantes fournissent des instructions détaillées pour chaque aspect de l'intégration du CDN.

**Topics**
+ [Composants et exigences d'intégration du CDN](#cdn-integration-components)
+ [Conditions préalables à l'intégration du CDN](#prerequisites)
+ [Étapes de configuration de l'intégration du CDN](#cdn-integration-workflow)
+ [En-têtes requis pour l'intégration du MediaTailor CDN](#cdn-required-headers)
+ [Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md)
+ [Configurer le mappage du CDN dans MediaTailor](cdn-mapping-mediatailor.md)
+ [Bonnes pratiques de sécurité de l'intégration CDN pour MediaTailor](cdn-security-best-practices.md)

# Configurer les comportements de routage du CDN pour MediaTailor
<a name="cdn-routing-behaviors"></a>

Cette section explique comment configurer votre réseau de diffusion de contenu (CDN) pour acheminer différents types de demandes de manière appropriée à des fins d' AWS Elemental MediaTailor intégration. Une configuration de routage appropriée garantit que les demandes de manifeste, les segments de contenu et les segments publicitaires sont traités correctement.

La configuration des comportements de routage des CDN est une étape essentielle pour créer un pipeline de diffusion de contenu efficace. En définissant des règles de routage spécifiques pour différents types de contenu, vous pouvez optimiser la mise en cache, améliorer les performances de diffusion et garantir le bon fonctionnement de l'insertion d'annonces personnalisées.

Pour les scénarios de routage avancés utilisant des variables dynamiques et des alias de configuration, consultez[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). Pour plus d'informations sur la préservation des paramètres de requête sur le routage du CDN, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

**Important**  
Le fait de ne pas inclure les en-têtes CORS dans l'objet mis en cache ou dans la réponse du CDN aux spectateurs peut entraîner des échecs de lecture. 

## Configuration du comportement de routage du CDN
<a name="cdn-routing-configuration"></a>

Configurez votre CDN pour acheminer les différents types de demandes de manière appropriée.

### Routage des segments de contenu
<a name="content-segment-routing"></a>

Le routage des segments de contenu dirige les demandes relatives à vos segments de contenu réels vers votre serveur d'origine. Tout comme le routage des segments publicitaires, le routage des segments de contenu nécessite également une configuration CORS appropriée pour garantir une lecture fluide sur les lecteurs Web.

Pour obtenir des conseils de configuration détaillés, consultez l' CloudFront exemple sur[Priorité 4 : Comportement du chemin d'origine du contenu](cf-comprehensive-configuration.md#cf-default-behavior). Cet exemple fournit des paramètres spécifiques que vous devez suivre CloudFront ou adapter pour d'autres CDNs.

Les principales exigences de configuration pour le routage des segments de contenu sont les suivantes :
+ Utilisez des modèles de chemin qui correspondent aux extensions de fichiers de votre segment de contenu (comme `*.ts``*.mp4`, ou`*.m4s`)
+ Acheminez les demandes vers l'origine de votre contenu (tel qu'un compartiment ou un point de MediaPackage terminaison Amazon S3)
+ Pour un ratio cache-accès optimal, incluez uniquement les paramètres de chaîne de requête qui obligent votre origine à modifier la réponse dans la clé de cache et à transférer la demande d'origine 
+ Appliquez une politique de cache appropriée avec des valeurs TTL supérieures à 24 heures
+ Incluez les en-têtes de réponse CORS à vos spectateurs

### Routage des segments publicitaires
<a name="ad-segment-routing"></a>

Le routage des segments publicitaires est essentiel pour proposer des publicités personnalisées aux spectateurs. Lorsque vous configurez le routage des segments publicitaires, vous devez implémenter une gestion CORS (Cross-Origin Resource Sharing) appropriée afin d'éviter les problèmes susceptibles d'entraîner des échecs de lecture sur les lecteurs Web.

Pour obtenir des conseils de configuration détaillés, consultez l' CloudFront exemple sur[Priorité 0 : comportement du chemin des segments publicitaires](cf-comprehensive-configuration.md#cf-transcode-manage-behavior). Cet exemple fournit des paramètres spécifiques que vous devez suivre CloudFront ou adapter pour d'autres CDNs.

Les principales exigences de configuration pour le routage des segments publicitaires sont les suivantes :
+ Utilisez le modèle de chemin `/tm/*` spécifiquement pour les segments MediaTailor publicitaires
+ Acheminer les demandes vers `segments.mediatailor.region.amazonaws.com`
+ Pour un ratio cache/accès optimal, n'incluez aucun en-tête de demande d'affichage, aucun cookie ou paramètre de chaîne de requête dans la clé de cache ou dans la demande d'origine
+ Appliquez une politique de cache appropriée avec des valeurs TTL supérieures à 24 heures
+ Incluez les en-têtes de réponse CORS à vos spectateurs

### Routage des demandes de manifeste
<a name="manifest-routing"></a>

Pour acheminer les demandes de liste de lecture multivariante, de liste de lecture multimédia et de MPD vers MediaTailor, utilisez les paramètres généraux suivants. Pour CloudFront la configuration, voir[Configuration du comportement du cache du manifeste](cloudfront-basic-setup.md#cf-manifest-behavior).

1. Dans votre interface de configuration CDN, créez des comportements pour différents types de manifestes.

1. Définissez des modèles de chemin correspondant aux extensions de fichiers de playlist et de playlist multimédia multivariantes (`*.m3u8`pour HLS) et aux extensions de fichier MPD (`*.mpd`pour DASH).

1. Configurez le paramètre d'origine dans votre CDN pour qu'il pointe vers votre point de terminaison MediaTailor de configuration.

1. Pour l'insertion d'annonces, désactivez la mise en cache des playlists multivariantes personnalisées, des playlists multimédias et. MPDs Étant donné que l'insertion d'annonces fournit des manifestes personnalisés, votre CDN ne doit pas les mettre en cache. Si un appareil de lecture différent de celui prévu reçoit une playlist ou un MPD mis en cache, cela peut entraîner des problèmes de lecture ou de suivi. Pour obtenir des conseils complets sur la mise en cache, y compris des recommandations TTL pour tous les types de contenu, consultez. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

1. Configurez le transfert d'en-têtes pour tous les en-têtes. Pour les exigences minimales, voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers).

1. Activez le transfert de chaînes de requêtes pour transmettre les paramètres de ciblage publicitaire.

------
#### [ HLS multivariant playlist ]

Les demandes de playlist multivariantes HLS suivent les formats suivants :

```
https://<playback-endpoint>/v1/index/<hashed-account-id>/<origin-id>/<index>.m3u8
```

Exemple :

```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/a1bc06b59e9a570b3b6b886a763d15814a86f0bb/Demo/assetId.m3u8
```

------
#### [ HLS media playlist ]

Les demandes de playlist multimédia HLS suivent les formats suivants :

```
https://<playback-endpoint>/v1/manifest/<hashed-account-id>/<session-id>/<manifestNumber>.m3u8
```

Les demandes du joueur `https://CDN_Hostname/some/path/asset.m3u8` sont acheminées vers le MediaTailor chemin en `https://mediatailor.us-west-2.amazonaws.com/v1/session/configuration/endpoint` fonction du mot clé contenu `*.m3u8` dans la demande.

Exemple :

```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/manifest/a1bc06b59e9a570b3b6b886a763d15814a86f0bb/c240ea66-9b07-4770-8ef9-7d16d916b407/0.m3u8
```

------
#### [ DASH MPD ]

Les demandes DASH MPD suivent les formats suivants :

```
https://<playback-endpoint>/v1/dash/<hashed-account-id>/<origin-id>/<assetName>.mpd
```

Les demandes du joueur `https://CDN_Hostname/some/path/asset.mpd` sont acheminées vers le MediaTailor chemin en `https://mediatailor.us-west-2.amazonaws.com/v1/dash/configuration/endpoint` fonction du mot clé contenu `*.mpd` dans la demande.

Exemple :

```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/a1bc06b59e9a570b3b6b886a763d15814a86f0bb/Demo/0.mpd
```

------

## Bonnes pratiques de routage CDN
<a name="cdn-routing-best-practices"></a>

Lorsque vous configurez les comportements de routage du CDN, suivez les meilleures pratiques suivantes pour garantir des performances et une fiabilité optimales :

**Utiliser des modèles de trajectoire spécifiques**  
Créez des modèles de chemin spécifiques qui correspondent exactement à la structure de votre contenu afin de garantir un routage correct.

**Prioriser l'ordre des comportements**  
Dans la plupart des CDNs cas, les comportements sont évalués dans l'ordre. Placez les comportements plus spécifiques avant les comportements plus généraux.

**Modèles de comportement de test**  
Vérifiez que vos modèles de chemin correspondent correctement aux demandes attendues avant le déploiement en production.

**Documentez votre configuration**  
Conservez la documentation de vos comportements de routage CDN pour faciliter le dépannage et les futures mises à jour.

## Étapes suivantes
<a name="cdn-routing-next-steps"></a>

Après avoir configuré les comportements de routage de votre CDN, l'étape suivante consiste à configurer le mappage du CDN dans. MediaTailor Pour obtenir des instructions, consultez [Configurer le mappage du CDN dans MediaTailor](cdn-mapping-mediatailor.md).

# Configurer le mappage du CDN dans MediaTailor
<a name="cdn-mapping-mediatailor"></a>

Cette section explique comment configurer l'utilisation des noms AWS Elemental MediaTailor de domaine de votre réseau de diffusion de contenu (CDN). Après avoir configuré vos comportements de routage CDN, vous devez mettre à jour votre MediaTailor configuration pour vous assurer que les manifestes font référence à votre domaine CDN au lieu de faire directement référence aux serveurs d'origine.

La configuration du mappage du CDN MediaTailor garantit que tous les contenus et segments URLs publicitaires de vos manifestes pointent vers votre CDN plutôt que directement vers les serveurs d'origine. Cette étape est essentielle pour créer une chaîne de distribution CDN complète et optimiser les avantages de votre intégration CDN.

## Configuration du mappage CDN dans MediaTailor
<a name="mediatailor-configuration"></a>

Après avoir configuré vos comportements de routage CDN, configurez MediaTailor pour utiliser vos noms de domaine CDN :

1. Ouvrez la [MediaTailor console](https://console.aws.amazon.com/mediatailor/home).

1. Sélectionnez la configuration que vous souhaitez mettre à jour.

1. Dans les **paramètres avancés** de la section **Configuration du CDN**, entrez votre nom de domaine CDN dans le champ du préfixe du **segment de contenu CDN**.

1. Si vous utilisez un domaine CDN distinct pour les segments publicitaires, saisissez-le dans le champ de **préfixe du segment publicitaire CDN**.

1. Enregistrez vos modifications.

Cette configuration garantit la génération MediaTailor de manifestes pointant vers votre CDN plutôt URLs que directement vers le stockage d'origine ou de segment publicitaire.

### Comprendre le comportement des URL de base
<a name="base-url-behavior"></a>

MediaTailor détermine la base URLs dans les manifestes en fonction de la configuration de votre préfixe CDN :
+ **Préfixe de segment publicitaire CDN configuré** : les segments publicitaires utilisent le préfixe CDN comme URL de base.
+ Le **préfixe du segment publicitaire CDN n'est pas configuré** : les segments publicitaires utilisent l' MediaTailor emplacement direct comme URL de base.
+ **Préfixe de segment de contenu CDN configuré** : les segments de contenu utilisent le préfixe CDN comme URL de base.
+ Le **préfixe du segment de contenu CDN n'est pas configuré** : les segments de contenu font référence à l'origine du contenu d'origine.

#### Gestion des URL DASH BaseURL
<a name="dash-baseurl-handling"></a>

Pour les manifestes DASH, MediaTailor gère `BaseURL` les paramètres différemment pour le contenu et les segments publicitaires :

**Segments de contenu :**
+ **Avec le préfixe de segment de contenu CDN** : MediaTailor définit exactement un `BaseURL` au `MPD` niveau en utilisant le préfixe que vous avez spécifié.
+ **Sans préfixe de segment de contenu CDN : MediaTailor préserve** `BaseURL` les paramètres existants du manifeste d'origine ou en ajoute un en fonction de l'`MPD`URL d'origine s'il n'en existe aucun.

**Segments publicitaires :**
+ **Avec le préfixe de segment publicitaire CDN** : chaque période d'annonce obtient exactement une `BaseURL` en utilisant le préfixe configuré.
+ **Sans préfixe de segment publicitaire CDN** : chaque période publicitaire reçoit exactement un préfixe `BaseURL` pointant vers le serveur de contenu MediaTailor publicitaire.

**Example Exemple de mappage CDN**  
Si l'origine de votre contenu est `http://origin.com/contentpath/` et le préfixe de segment de contenu de votre CDN l'est`https://cdn.example.com/`, alors un segment de contenu qui devrait normalement être référencé tel qu'il `http://origin.com/contentpath/subdir/content.ts` apparaîtra dans le manifeste sous la forme. `https://cdn.example.com/subdir/content.ts`

## Considérations importantes
<a name="cdn-mapping-considerations"></a>

Lorsque vous configurez le mappage du CDN dans MediaTailor, gardez à l'esprit les considérations importantes suivantes :

**Utiliser le protocole HTTPS pour les préfixes du CDN**  
Utilisez toujours le protocole HTTPS URLs pour vos préfixes de CDN afin de garantir une diffusion de contenu sécurisée.

**Faites correspondre les chemins de comportement du CDN**  
Assurez-vous que les préfixes de CDN que vous configurez MediaTailor correspondent aux modèles de chemin que vous avez configurés dans vos comportements de CDN.

**Tenez compte du régional CDNs**  
Si vous utilisez différents domaines CDN pour différentes régions, vous devrez créer des MediaTailor configurations distinctes pour chaque région.

**Vérifier la propriété du domaine**  
Assurez-vous de contrôler les domaines CDN dans lesquels vous configurez. MediaTailor

## Vérifier la configuration du mappage du CDN
<a name="cdn-mapping-verification"></a>

Après avoir configuré le mappage du CDN dans MediaTailor, vérifiez que votre configuration fonctionne correctement :

1. Demandez un manifeste via votre CDN.

1. Examinez le contenu du manifeste pour vérifier que le segment fait URLs référence à votre domaine CDN.

1. Vérifiez que le segment URLs de contenu du manifeste pointe vers votre domaine CDN.

1. Vérifiez que le segment URLs publicitaire du manifeste pointe vers votre domaine CDN.

Pour des procédures complètes de test et de validation, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md).

## Étapes suivantes
<a name="cdn-mapping-next-steps"></a>

Après avoir configuré le mappage du CDN MediaTailor, l'étape suivante consiste à mettre en œuvre les meilleures pratiques de sécurité pour votre intégration du CDN. Pour obtenir des instructions, consultez [Bonnes pratiques de sécurité de l'intégration CDN pour MediaTailor](cdn-security-best-practices.md).

# Bonnes pratiques de sécurité de l'intégration CDN pour MediaTailor
<a name="cdn-security-best-practices"></a>

Cette section explique comment mettre en œuvre les meilleures pratiques de sécurité pour l'intégration de votre réseau de diffusion de AWS Elemental MediaTailor contenu (CDN). Une configuration de sécurité appropriée permet de protéger votre contenu et votre infrastructure contre les accès non autorisés et les menaces potentielles.

La sécurisation de votre intégration CDN est essentielle pour protéger votre contenu, empêcher les accès non autorisés et garantir le respect des exigences de sécurité. La mise en œuvre de ces meilleures pratiques permet de créer une posture de sécurité robuste pour votre flux de travail de streaming.

## Configuration de sécurité du CDN
<a name="cdn-security-settings"></a>

Avant de configurer les paramètres de routage et de cache de votre CDN, mettez en œuvre les meilleures pratiques de sécurité suivantes pour protéger votre contenu et votre infrastructure :

### Sûreté des transports
<a name="transport-security"></a>

MediaTailor utilise uniquement le protocole HTTPS pour toutes les communications et n'autorise pas les connexions HTTP. Pour garantir une communication sécurisée entre tous les composants de votre flux de travail de streaming, procédez comme suit :

1. Configurez le protocole HTTPS pour toutes les communications entre votre CDN et les points de MediaTailor terminaison. MediaTailor nécessite le protocole HTTPS et n'accepte pas les connexions HTTP.

1. Utilisez le protocole TLS 1.2 ou version ultérieure pour toutes les connexions HTTPS.

1. Configurez votre CDN pour appliquer les connexions HTTPS uniquement aux spectateurs.

### Contrôle d’accès
<a name="access-control"></a>

Pour protéger votre contenu et votre infrastructure contre tout accès non autorisé, mettez en œuvre les contrôles d'accès suivants :

1. Configurez les paramètres de géo-restriction si vous devez limiter l'accès au contenu à des régions spécifiques.

1. Implémentez des cookies signés URLs ou signés pour le contenu qui nécessite l'authentification du spectateur.

1. Configurez des listes d'autorisation basées sur l'adresse IP pour l'accès administratif à la configuration du CDN.

### Surveillance de la sécurité
<a name="security-monitoring"></a>

Pour détecter les événements de sécurité et y répondre efficacement, mettez en œuvre les pratiques de surveillance suivantes :

1. Activez la journalisation des accès pour votre distribution CDN.

1. Configurez des alertes en cas de modèles de trafic inhabituels ou de tentatives d'accès.

1. Passez régulièrement en revue les configurations de sécurité et mettez-les à jour si nécessaire.

## Fonctionnalités de sécurité avancées
<a name="advanced-security-features"></a>

Les fonctionnalités de sécurité avancées suivantes fournissent une protection améliorée pour votre intégration au CDN :

**Pare-feu d'application Web (WAF)**  
Si votre CDN prend en charge la fonctionnalité WAF, configurez-le pour le protéger contre les vulnérabilités et attaques Web courantes.

**DDoProtection S**  
Activez DDo les fonctionnalités de protection S fournies par votre CDN pour atténuer les denial-of-service attaques distribuées.

**Contrôle d'accès à l'origine**  
Configurez vos serveurs d'origine pour accepter uniquement les demandes provenant de votre CDN afin d'empêcher les tentatives d'accès direct.

**Chiffrement du contenu**  
Pour les contenus très sensibles, envisagez de mettre en œuvre des mécanismes de chiffrement supplémentaires au-delà de la sécurité du transport.

## Étapes suivantes
<a name="security-best-practices-next-steps"></a>

Après avoir mis en œuvre les meilleures pratiques de sécurité, l'étape suivante consiste à tester et à résoudre les problèmes liés à votre intégration au CDN. Consultez [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md) les instructions complètes de test et de dépannage.

# Configurez SSAI avec un CDN pour une publicité vidéo personnalisée
<a name="ssai-cdn-workflow"></a>

Cette section fournit des conseils complets sur l'intégration de l'insertion publicitaire AWS Elemental MediaTailor côté serveur (SSAI) à un réseau de diffusion de contenu (CDN). Suivez ces étapes pour configurer, configurer et optimiser votre intégration SSAI CDN.

L'insertion de publicités côté serveur (SSAI) est une technologie qui insère de manière fluide des publicités personnalisées dans les flux vidéo au niveau du serveur plutôt qu'au niveau du client. Associé à un CDN, vous créez une solution robuste et évolutive pour diffuser des publicités personnalisées à un public mondial avec une latence minimale.

Dans cette rubrique, nous utilisons le terme *manifestes* pour désigner collectivement les listes de lecture multivariantes, les listes de lecture multimédia et MPDs.

## Ce dont vous aurez besoin
<a name="ssai-cdn-what-you-need"></a>

Avant de configurer l'insertion d' MediaTailor annonces avec un CDN, rassemblez les ressources requises suivantes :

**AWS compte et autorisations**  
Un AWS compte doté des autorisations appropriées pour créer et gérer MediaTailor des ressources  
Autorisations IAM pour MediaTailor, CloudFront (si vous en utilisez), et les services connexes  
Pour connaître les exigences détaillées en matière d'autorisation, voir[Sécurité dans AWS Elemental MediaTailor](security.md).

**Services requis**  
AWS Elemental MediaTailor configuré et en cours d'exécution  
Un compte de réseau de diffusion de contenu (CDN) (Amazon CloudFront ou CDN tiers)  
Serveur d'origine pour votre contenu (HLS ou DASH)  
Serveur de décision publicitaire (ADS) compatible avec VAST ou VMAP

**Exigences relatives au contenu**  
Contenu correctement encodé et emballé au format HLS ou DASH  
Des marqueurs de coupure de publicité dans votre contenu (pour la VOD) ou des marqueurs SCTE-35 (pour le direct)

## Avant de commencer
<a name="ssai-cdn-before-you-begin"></a>

Effectuez les tâches de configuration suivantes avant de mettre en œuvre l'insertion de MediaTailor publicités avec un CDN :

1. Configurer la connectivité réseau entre votre CDN et MediaTailor les serveurs d'origine

1. Configurer le protocole HTTPS pour une diffusion de contenu sécurisée

1. Configurer les paramètres DNS pour votre domaine CDN

1. Pour la MediaTailor configuration de base, suivez les étapes décrites dans [Configuration](setting-up.md) et[Commencer à insérer MediaTailor des publicités](getting-started-ad-insertion.md).

### Connaissances requises
<a name="ssai-cdn-knowledge-prerequisites"></a>

Pour implémenter cette solution avec succès, vous devez disposer des éléments suivants :
+ Compréhension des protocoles de streaming (HLS/DASH)
+ Connaissances de base des principes de configuration du CDN
+ Connaissance des concepts d'insertion de publicités

## Avantages de l'intégration du CDN
<a name="ssai-cdn-benefits"></a>

L'intégration de SSAI à un CDN offre les principaux avantages suivants :

**Expérience utilisateur améliorée**  
Une configuration correcte CDNs réduit la mise en mémoire tampon, les temps de démarrage et les erreurs de lecture lors des transitions publicitaires. Cela se traduit par un engagement et une satisfaction accrus des spectateurs.

**Réduction des coûts**  
Des stratégies de mise en cache efficaces minimisent les demandes d'origine. Cela réduit les coûts de transfert de données et la charge du serveur d'origine, ce qui est particulièrement important pour les gros volumes de contenu financé par la publicité.

**Capacité de mise à l’échelle**  
Les configurations CDN optimisées permettent de gérer les pics de trafic lors d'événements populaires sans dégrader les performances, garantissant ainsi la diffusion de vos publicités personnalisées même aux heures de pointe.

**Portée mondiale**  
Configuré correctement, CDNs diffusez du contenu avec une faible latence aux spectateurs du monde entier, où qu'ils se trouvent, élargissant ainsi votre audience potentielle.

**Transitions publicitaires fluides**  
La configuration optimisée du CDN garantit des transitions fluides entre le contenu et les publicités, créant ainsi une expérience de visionnage de qualité télévisuelle.

Les rubriques suivantes fournissent des conseils complets sur la configuration à l' MediaTailor aide d'un CDN pour des performances optimales.

**Topics**
+ [Ce dont vous aurez besoin](#ssai-cdn-what-you-need)
+ [Avant de commencer](#ssai-cdn-before-you-begin)
+ [Avantages de l'intégration du CDN](#ssai-cdn-benefits)
+ [Comprendre l'architecture du CDN](ssai-cdn-architecture-overview.md)
+ [Configurer l'insertion de publicité de base](configuring-ssai-cdn.md)
+ [SSAI avec assemblage de canaux](ssai-ca-integration.md)
+ [Optimisez les performances du CDN](ssai-cdn-performance.md)
+ [Surveillez les opérations du CDN](ssai-cdn-monitor.md)
+ [Résoudre les problèmes d'insertion de publicités avec CDNs](troubleshooting-ssai-cdn.md)

# Comprendre l'architecture d'insertion publicitaire pour le CDN et les intégrations MediaTailor
<a name="ssai-cdn-architecture-overview"></a>

Cette section explique les concepts et l'architecture de l'insertion de publicités côté serveur (SSAI) avec des réseaux de diffusion de contenu (CDNs) pour. AWS Elemental MediaTailor Vous découvrirez comment l'insertion dynamique d'annonces et la manipulation de manifestes fonctionnent ensemble pour permettre une monétisation vidéo efficace.

L'insertion de publicités côté serveur (SSAI) MediaTailor vous permet de :
+ Insérez de la publicité personnalisée dans vos flux vidéo à des points de rupture publicitaires définis
+ Cibler les publicités avec précision en fonction des données des spectateurs
+ Éliminez le besoin d'une technologie d'insertion publicitaire côté client

Associés à un CDN, vous pouvez diffuser ces flux personnalisés aux spectateurs avec des performances et une évolutivité améliorées, améliorant ainsi votre stratégie de monétisation vidéo.

L'architecture recommandée pour l'insertion d'annonces avec un CDN positionne le CDN entre les spectateurs et l'insertion d'annonces, l'insertion d'annonces accédant au contenu directement depuis votre origine. Cette architecture offre les avantages suivants en termes de diffusion de contenu et de monétisation vidéo :
+ Mise en cache efficace du contenu et des segments publicitaires
+ Charge de demande réduite sur MediaTailor
+ Vitesse de diffusion améliorée pour les spectateurs
+ Gestion simplifiée des URL
+ Diffusion cohérente de publicités personnalisées sur tous les appareils

Dans cette architecture recommandée :

1. Les spectateurs demandent des manifestes au CDN

1. Le CDN transmet les demandes à l'insertion d'annonces

1. Les demandes d'insertion d'annonces (contenu, manifestes) dès l'origine

1. L'insertion d'annonces demande des publicités au serveur de décision publicitaire (ADS)

1. L'insertion d'annonces personnalise les manifestes en remplaçant les marqueurs publicitaires (du manifeste d'origine) par ceux URLs qui pointent vers des segments publicitaires ciblés pour un internaute spécifique (issus de l'ADS)

1. L'insertion d'annonces renvoie les manifestes personnalisés contenant le segment publicitaire URLs au CDN, qui les transmet aux spectateurs

1. Les spectateurs demandent des segments via le CDN

1. Le CDN achemine les demandes de segment en fonction du type de segment : 
   + Les demandes de segment de contenu sont dirigées vers l'origine du contenu
   + Les demandes de segments publicitaires sont envoyées à MediaTailor 

Cette architecture garantit des performances optimales tout en conservant les avantages de sécurité et de flexibilité liés à l'utilisation d'un CDN.

![\[Schéma montrant le positionnement du CDN entre les joueurs clients et l'insertion d' AWS Elemental MediaTailor annonces\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/cdn-recommended-positioning.png)


**Note**  
Ce flux varie légèrement entre la VOD et le contenu en direct. Pour la VOD, les manifestes peuvent être mis en cache plus longtemps, tandis que le contenu en direct nécessite des mises à jour plus fréquentes des manifestes pour assurer la continuité des flux.

La principale différence entre la VOD et la mise en cache de contenu en direct :

Contenu VOD  
Définissez des valeurs TTL plus longues (minutes à heures) pour les manifestes, car elles ne changent pas fréquemment

Contenu en direct  
Définissez des valeurs TTL plus courtes (secondes) pour les manifestes afin de garantir que les spectateurs reçoivent les segments de diffusion les plus récents

Nous vous déconseillons de placer un CDN entre l'origine de votre contenu et AWS Elemental MediaTailor. Cela peut entraîner plusieurs défis techniques :

Collisions entre clés de cache  
Configurez votre CDN pour qu'il gère correctement les paramètres de requête. Cela permet MediaTailor d'éviter de recevoir des manifestes incorrects lorsque vous demandez le même manifeste avec des paramètres de requête différents.

Problèmes de compression Gzip  
Si vous rencontrez des erreurs d'analyse de manifestes, assurez-vous que votre CDN fournit des manifestes correctement formatés à. MediaTailor Certains CDNs peuvent fournir des charges utiles gzip corrompues susceptibles de provoquer des échecs d'analyse. Dans ce cas, vous devrez peut-être désactiver la compression entre votre CDN et MediaTailor tout en maintenant la compression afin de réaliser des économies à d'autres étapes de votre flux de travail.

Fraîcheur manifeste  
Pour les diffusions en direct, configurez votre CDN pour qu'il envoie les manifestes actuels à MediaTailor. Cela permet d'éviter les problèmes de synchronisation entre le contenu et les publicités.

Optimisation des performances  
Minimisez les sauts sur le réseau et les pertes de cache potentielles afin de réduire les temps de démarrage de la lecture.

Gestion du cache  
Mettez en œuvre des stratégies simplifiées d'invalidation du cache, en particulier pour le contenu en direct où les manifestes sont fréquemment mis à jour.

Dans cette architecture sous-optimale :

1. Les spectateurs demandent des playlists multivariantes, des playlists multimédias ou MPDs directement auprès de AWS Elemental MediaTailor.

1. MediaTailor demande des manifestes de contenu (listes de lecture multivariantes, listes de lecture multimédia ou MPDs) via le CDN.

1. Le CDN transmet les demandes au serveur d'origine.

1. Le serveur d'origine renvoie des listes de lecture multivariantes, des listes de lecture multimédia ou MPDs vers le CDN.

1. Le CDN transmet des listes de lecture multivariantes, des listes de lecture multimédia ou MPDs vers. MediaTailor

1. MediaTailor demande des publicités au serveur de décision publicitaire (ADS).

1. MediaTailor personnalise les manifestes en insérant des publicités dans des playlists multivariantes, des playlists multimédias ou MPDs en les diffusant directement aux spectateurs.

1. Cette architecture introduit une latence supplémentaire, des problèmes potentiels de mise en cache et complique le dépannage.

![\[Schéma montrant le CDN positionné entre l'origine du contenu et MediaTailor\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/cdn-not-recommended-positioning.png)


## Flux de demandes et de réponses
<a name="understand-request-flow"></a>

Lorsque vous implémentez l'insertion dynamique d'annonces avec un CDN, configurez votre système pour prendre en charge ce flux de demandes et de réponses :

1. Configurez votre lecteur pour qu'il demande des playlists multivariantes (HLS) ou MPDs (DASH) depuis votre CDN avec MediaTailor comme origine manifeste.

1. Configurez votre CDN pour qu'il transfère toutes les demandes de playlist multivariante, de playlist multimédia et de MPD MediaTailor, y compris tous les paramètres de requête et les en-têtes.

1. Assurez-vous de MediaTailor pouvoir communiquer avec votre serveur de décision publicitaire (ADS) en lui transmettant les paramètres de requête et les en-têtes.

1. Configurez votre ADS pour utiliser les paramètres de requête afin de déterminer les annonces à insérer.

1. Configurez le préfixe CDN dans la configuration de MediaTailor lecture afin de MediaTailor pouvoir remplacer les noms de domaine du CDN par des préfixes d'URL de contenu et de segment publicitaire.

1. Configurez votre CDN pour transférer des listes de lecture multivariantes personnalisées, des listes de lecture multimédia et MPDs depuis MediaTailor le lecteur demandeur.

1. Configurez votre CDN pour traduire le segment URLs, en transférant les demandes de segment de contenu vers le serveur d'origine et les demandes publicitaires vers le compartiment Amazon S3 où sont stockées MediaTailor les publicités transcodées.

### Terminologie CDN pour l'insertion de publicités
<a name="ssai-cdn-terminology"></a>

La compréhension de ces termes clés vous aidera à implémenter et à résoudre les problèmes liés à l'intégration de votre CDN d'insertion publicitaire :

CDN d'origine et CDN Edge  
**CDN d'origine** : un CDN positionné entre MediaTailor et l'origine de votre contenu. Il met en cache les segments de contenu afin de réduire la charge sur vos serveurs d'origine. Dans une architecture multi-CDN, il s'agit de la première couche CDN qui s'interface directement avec l'origine.  
**Edge CDN** : un CDN positionné entre les spectateurs et. MediaTailor Il fournit des manifestes et du contenu personnalisés aux spectateurs. Dans une architecture multi-CDN, il s'agit de la couche CDN la plus externe qui s'interface directement avec les spectateurs.

Termes de configuration du CDN  
**Comportement du cache** : règles qui déterminent la manière dont un CDN gère les différents types de demandes. Ces règles incluent :  
+ Paramètres de durée de mise en cache
+ Configurations de routage d'origine
+ Paramètres de traitement des demandes
**TTL (Time To Live)** : durée pendant laquelle le contenu reste valide dans un cache CDN avant de devoir être actualisé depuis son origine.  
**Clé de cache** : identifiant unique utilisé par un CDN pour stocker et récupérer le contenu mis en cache. Il inclut généralement :  
+ chemin de l'URL
+ Paramètres Query (Requête)
+ En-têtes sélectionnés
**Origin Shield** : couche de mise en cache intermédiaire entre les emplacements périphériques du CDN et votre serveur d'origine. Cela réduit le nombre de demandes adressées à votre origine.  
**Réduction des demandes** : fonctionnalité CDN qui combine plusieurs demandes simultanées pour le même contenu en une seule demande d'origine.

MediaTailor-termes spécifiques au CDN  
**Préfixe de segment de contenu CDN** : nom de domaine CDN AWS Elemental MediaTailor utilisé lors de la génération de segments de contenu dans URLs des manifestes.  
**Préfixe de segment publicitaire CDN** : nom de domaine CDN MediaTailor utilisé lors de la génération de segments publicitaires dans URLs les manifestes.

Pour plus d'informations sur la configuration du CDN avec MediaTailor, consultez[Configurer l'intégration du CDN](cdn-configuration.md).

**Note**  
Ces termes sont cohérents avec ceux utilisés dans la documentation d'assemblage des canaux. Pour la terminologie de l'assemblage des canaux, voir[Terminologie CDN pour l'assemblage de canaux](channel-assembly-cdn-architecture.md#cdn-terminology).

# Configurez un MediaTailor SSAI de base avec un CDN pour une diffusion publicitaire optimale
<a name="configuring-ssai-cdn"></a>

Cette section fournit des step-by-step instructions pour configurer l'insertion AWS Elemental MediaTailor dynamique de publicités avec un réseau de diffusion de contenu (CDN) afin d'optimiser votre flux de monétisation vidéo.

Pour une configuration avancée du serveur publicitaire à l'aide de variables dynamiques, voir[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). Pour plus d'informations sur le transfert de paramètres CDNs pour le ciblage publicitaire, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

Pour des informations conceptuelles sur le SSAI avec CDNs, voir[Comprendre l'architecture d'insertion publicitaire pour le CDN et les intégrations MediaTailor](ssai-cdn-architecture-overview.md).

## Conditions préalables
<a name="prerequisites-ad-insertion-cdn"></a>

Avant de configurer l'insertion d'annonces avec un CDN, assurez-vous de disposer des éléments suivants :
+ Une AWS Elemental MediaTailor configuration active
+ Un serveur d'origine de contenu diffusant du contenu HLS ou DASH avec des marqueurs publicitaires appropriés

  Pour plus d'informations sur les marqueurs publicitaires, consultez[Comprendre le comportement d'insertion des publicités](ad-behavior.md).
+ Un serveur de décision publicitaire (ADS) compatible avec VAST ou VMAP pour le ciblage publicitaire
+ Un compte CDN (tel qu'Amazon CloudFront ou un autre fournisseur de CDN)
+ Connaissances de base de la manipulation des manifestes et des concepts d'insertion dynamique de publicités

## Étape 1 : configurer la mise en cache du CDN pour une diffusion publicitaire optimale
<a name="configure-cdn-caching"></a>

Une configuration correcte de la mise en cache du CDN est essentielle pour optimiser les performances de votre flux de travail de monétisation vidéo. Les exigences de mise en cache diffèrent entre l'insertion publicitaire côté serveur (SSAI) et l'insertion publicitaire guidée par le serveur (SGAI). Utilisez ces paramètres recommandés pour garantir une diffusion efficace du contenu et de la publicité personnalisée :

### Paramètres de mise en cache SSAI CDN
<a name="ssai-caching-settings"></a>

Pour les flux de travail d'insertion de publicités côté serveur, une configuration de mise en cache appropriée est essentielle pour des performances optimales. Le SSAI nécessite des valeurs TTL spécifiques et des paramètres de clé de cache pour garantir que les manifestes personnalisés ne sont pas mis en cache alors que les segments sont mis en cache efficacement.

Pour connaître les paramètres de mise en cache SSAI détaillés, notamment les valeurs TTL, les modèles de chemin et les configurations des clés de cache, consultez le guide d'[Mise en cache d'insertion de publicités côté serveur (SSAI)](cdn-optimize-caching.md#ssai-caching-optimization)optimisation du CDN.

Principaux principes de mise en cache pour le SSAI :
+ **Manifestes** : définissez le TTL sur 0 seconde pour empêcher la mise en cache du contenu personnalisé
+ **Segments** : mise en cache agressive (plus de 24 heures) pour réduire la charge d'origine
+ **Clés de cache** : inclure tous les paramètres de requête pour les manifestes, le chemin d'URL uniquement pour les segments

### Paramètres de mise en cache du CDN SGAI
<a name="sgai-caching-settings"></a>

Pour les flux de travail d'insertion de publicités guidés par le serveur, les exigences de mise en cache diffèrent de celles du SSAI, car les manifestes SGAI peuvent être mis en cache pendant de courtes périodes tout en proposant des expériences publicitaires personnalisées.

Pour connaître les paramètres complets de mise en cache SGAI, y compris les valeurs VOD et TTL en direct, consultez les tableaux de mise en cache du guide d'optimisation. Le SGAI permet une meilleure efficacité du cache que le SSAI tout en conservant les fonctionnalités de personnalisation des publicités.

Principales différences de mise en cache SGAI :
+ **Manifestes** : peuvent être mis en cache pendant de courtes périodes (5 à 30 minutes pour la VOD, 2 à 10 secondes pour le live)
+ **Segments** : mettez en cache de manière agressive, comme SSAI (plus de 24 heures pour la plupart des contenus)
+ **Avantage en termes de performances** : meilleurs ratios d'accès au cache que le SSAI grâce aux manifestes pouvant être mis en cache

Pour Amazon CloudFront, vous pouvez implémenter ces paramètres en utilisant des comportements de cache avec différentes valeurs TTL et politiques relatives aux clés de cache. Pour les autres CDNs, reportez-vous à leur documentation spécifique pour implémenter des règles de mise en cache similaires.

## Étape 2 : Mettre en œuvre des approches hybrides (si nécessaire)
<a name="implement-hybrid-approach"></a>

Si votre architecture nécessite une approche hybride avec un CDN ou une couche de mise en cache distinct entre l'origine du contenu et : MediaTailor

1. Mettez en place une séparation claire des préoccupations dans la configuration de votre CDN.

1. Configurez des paramètres CDN spécifiques pour éviter les problèmes techniques décrits dans la section précédente.

1. Testez soigneusement votre configuration pour vérifier que la personnalisation du manifeste fonctionne correctement.

1. Surveillez les indicateurs de performance pour garantir une diffusion optimale des playlists multivariantes, des playlists multimédias et des segments. MPDs

Lors de la mise en œuvre d'une approche hybride, tenez compte des configurations spécifiques suivantes :
+ Pour le CDN entre l'origine du contenu et MediaTailor :
  + Configurer le transfert de compression pour les fichiers manifestes afin de préserver l'état de compression d'origine
  + Inclure tous les paramètres de requête dans la clé de cache
  + Définissez des valeurs TTL courtes pour les manifestes de contenu en direct
+ Pour le CDN entre utilisateurs MediaTailor et spectateurs :
  + Configurez des temps de cache plus longs pour les segments publicitaires
  + Set approprié TTLs pour les manifestes personnalisés
  + Mettez en œuvre un routage d'origine approprié pour le contenu par rapport aux segments publicitaires

## Étape 3 : terminer la configuration de votre CDN
<a name="complete-cdn-setup"></a>

Après avoir choisi votre architecture et compris le flux de demandes, terminez votre configuration en suivant les étapes de configuration détaillées décrites dans[Configurer l'intégration du CDN](cdn-configuration.md).

Pour les fournisseurs de CDN spécifiques, consultez ces ressources supplémentaires :
+ Amazon CloudFront : voir [intégration d’CloudFront](cloudfront-specific-recommendations.md) pour les CloudFront étapes de configuration spécifiques
+ Autre CDNs : appliquez les principes généraux décrits dans ce guide, en les adaptant aux options de configuration spécifiques de votre CDN

## Étape 4 : Vérifiez votre configuration
<a name="verification-steps"></a>

Après avoir terminé la configuration de votre CDN, vérifiez que votre flux de travail d'insertion d'annonces dynamique fonctionne correctement :

1. Testez la lecture via votre CDN avec un lecteur d'échantillons

1. Vérifiez que la publicité personnalisée est correctement insérée aux points de rupture publicitaires désignés

1. Vérifiez les journaux du CDN pour confirmer le bon routage des demandes

1. Surveillez les taux de réussite du cache pour garantir des performances optimales à la fois pour le contenu et les segments publicitaires

1. Vérifiez que les paramètres de ciblage publicitaire sont correctement transmis dans le flux de travail

Pour des procédures complètes de test et de validation, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md). Pour des informations détaillées sur le suivi de la mise en œuvre de votre SSAI, consultez[Surveillez les opérations pour le CDN et MediaTailor les intégrations](ssai-cdn-monitor.md). Pour optimiser les performances, voir[Optimisez les performances du CDN et MediaTailor des intégrations](ssai-cdn-performance.md).

# Intégrez le MediaTailor SSAI à l'assemblage des canaux pour les canaux linéaires monétisés
<a name="ssai-ca-integration"></a>

Cette rubrique explique comment associer l'insertion publicitaire AWS Elemental MediaTailor côté serveur à l'assemblage de canaux et à l'intégration d'un réseau de diffusion de contenu (CDN). Cette intégration vous permet de :
+ Créez des canaux linéaires monétisés avec de la publicité personnalisée
+ Diffusez des publicités ciblées auprès de différents spectateurs qui regardent le même contenu
+ Préservez des expériences de visionnage de qualité audiovisuelle

## Avantages de la combinaison du SSAI avec l'assemblage de canaux
<a name="ssai-ca-integration-benefits"></a>

L'intégration du SSAI à l'assemblage des canaux offre plusieurs avantages clés :

Monétisation des canaux linéaires  
Insérez des publicités personnalisées dans vos canaux linéaires pour générer des revenus à partir de votre bibliothèque de contenu. Vous pouvez monétiser le contenu en direct et le contenu VOD au sein d'un seul flux linéaire.

Publicité personnalisée  
Diffusez différentes publicités à différents spectateurs qui regardent le même contenu de chaîne. Cette approche ciblée augmente la pertinence des publicités et les revenus potentiels par rapport à la publicité diffusée traditionnelle.

Gestion simplifiée des interruptions publicitaires  
Définissez les points de rupture des publicités dans vos programmes d'assemblage de chaînes sans avoir à conditionner le contenu à l'aide de marqueurs SCTE-35. Il est ainsi plus facile d'insérer des publicités aux points de rupture naturels de votre contenu.

Une expérience de qualité audiovisuelle  
MediaTailor garantit une expérience de visionnage de haute qualité grâce à des transitions fluides entre le contenu et les publicités. L'insertion de publicités côté serveur élimine de nombreux problèmes courants tels que :  
+ Mise en mémoire tampon pendant les transitions publicitaires
+ Des bloqueurs de publicités empêchant la monétisation
+ Qualité de lecture incohérente

Livraison évolutive  
Associée à un CDN, cette intégration peut être étendue à des millions de spectateurs simultanés sans dégradation des performances ou des capacités de personnalisation.

## Présentation de l’architecture
<a name="ssai-ca-integration-architecture"></a>

L'architecture permettant de combiner le SSAI avec l'assemblage de canaux implique généralement les composants suivants :
+ Assemblage de chaînes : crée des chaînes linéaires à partir de VOD et de contenu en direct, et insère du contenu en ardoise qui crée des marqueurs publicitaires dans le manifeste généré
+ Insertion d'annonces : reconnaît les points de rupture des annonces et insère des éléments URLs pointant vers des segments publicitaires personnalisés dans le manifeste
+ Serveur de décision publicitaire (ADS) : détermine les publicités à insérer pour chaque spectateur
+ Réseau de diffusion de contenu (CDN) : fournit le contenu assemblé et les segments publicitaires aux spectateurs
+ Serveur d'origine : stocke les segments de VOD et de contenu en direct

Dans cette architecture :

1. L'assemblage des chaînes crée une chaîne linéaire à partir de votre contenu VOD et en direct, et insère du contenu en ardoise qui crée les marqueurs publicitaires dans le manifeste généré

1. Lorsqu'un internaute demande la chaîne, l'insertion d'annonces reconnaît les pauses publicitaires insérées dans la chaîne linéaire

1. L'insertion d'annonces appelle l'ADS pour recevoir la liste des publicités, les transcode et les insère URLs pointant vers les segments d'annonces transcodés dans le manifeste personnalisé

1. Le CDN fournit le flux personnalisé au spectateur

Le schéma suivant illustre ce flux de travail :

![\[Schéma illustrant l'intégration du CDN à la fois à l'assemblage des canaux et à l'insertion de publicités\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/ca-ssai-comb-cdn.png)


## Configuration de l'intégration
<a name="ssai-ca-integration-setup"></a>

Pour configurer le SSAI avec assemblage de canaux :

1. Configurez votre CDN Edge pour accepter les demandes de manifeste des spectateurs et les transférer vers l'insertion AWS Elemental MediaTailor publicitaire.

1. Configurez l'insertion d' MediaTailor annonces pour transférer les demandes vers votre CDN d'origine.

1. Configurez votre CDN d'origine pour transmettre les demandes à l'assemblage des MediaTailor canaux.

1. Configurez l'assemblage des MediaTailor canaux pour générer des manifestes dynamiques en fonction du calendrier actuel.

1. Configurez votre CDN d'origine pour transférer les manifestes assemblés vers l'insertion MediaTailor publicitaire.

1. Configurez l'insertion d' MediaTailor annonces pour demander des décisions publicitaires à votre serveur de décision publicitaire aux points de rupture des publicités.

1. Configurez l'insertion d' MediaTailor annonces pour personnaliser les manifestes en remplaçant les marqueurs publicitaires (issus de l'assemblage des chaînes) par des URLs signaux pointant vers des segments publicitaires ciblés (issus de l'ADS).

1. Configurez votre CDN Edge pour fournir des manifestes personnalisés aux spectateurs.

1. Configurez votre architecture CDN pour gérer efficacement les demandes de contenu et de segments publicitaires.

## Définition des pauses publicitaires dans l'assemblage des chaînes
<a name="ssai-ca-integration-adbreaks"></a>

Lorsque vous créez des programmes dans le cadre de l'assemblage de chaînes, vous pouvez définir les pauses publicitaires de plusieurs manières :

Transitions entre programmes  
Insérez des publicités entre les programmes dans le calendrier de vos chaînes. Il s'agit de l'approche la plus simple qui garantit que les publicités n'interrompent pas le contenu du programme.

Marqueurs SCTE-35  
Si votre contenu VOD contient des marqueurs SCTE-35, l'assemblage des chaînes peut préserver ces marqueurs, et l'insertion de publicités peut les utiliser comme points de rupture publicitaire.

Insertion basée sur le temps  
Définissez des pauses publicitaires à des moments précis au sein des programmes. Cela vous permet d'insérer des publicités à des points de rupture naturels dans votre contenu.

Pour obtenir des informations détaillées sur la création de programmes comportant des interruptions publicitaires, consultez la section [Utilisation des programmes](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-programs.html).

## Considérations relatives à la mise en cache du CDN
<a name="ssai-ca-integration-caching"></a>

Pour des performances optimales lorsque vous combinez l'assemblage de canaux et le SSAI avec un CDN :
+ Configurer des comportements de cache qui font la distinction entre l'assemblage de canaux et les demandes SSAI
+ Définissez les valeurs TTL appropriées pour les manifestes et les segments, comme recommandé dans [Étape 1 : configurer la mise en cache du CDN pour une diffusion publicitaire optimale](configuring-ssai-cdn.md#configure-cdn-caching)
+ Garantissez un routage correct entre l'assemblage des chaînes, l'insertion de publicités et les origines de votre CDN
+ Surveillez les indicateurs de performance pour les composants d'assemblage des chaînes et d'insertion de publicités


**Paramètres de mise en cache recommandés pour une mise en œuvre combinée**  

| Type de contenu | TTL | Éléments clés du cache | 
| --- | --- | --- | 
| Manifestes d'assemblage des canaux | 0 secondes | Chemin d'URL et paramètres de requête | 
| Manifestes personnalisés SSAI | 0 secondes | Chemin d'URL \$1 tous les paramètres de requête | 
| Segments de contenu | 24 heures et plus | Chemin d'URL uniquement | 
| Segments publicitaires | 24 heures et plus | Chemin d'URL uniquement | 

## Surveillance de la solution intégrée
<a name="ssai-ca-integration-monitoring"></a>

Pour vous assurer que votre solution intégrée fonctionne de manière optimale, surveillez ces indicateurs clés :

Métriques d'assemblage des canaux  
Surveillez le temps de génération du manifeste, les transitions entre les programmes et les éventuelles erreurs dans le processus d'assemblage des canaux.

Mesures d'insertion de publicités  
Suivez le taux de remplissage des annonces, les temps de réponse du serveur de décision publicitaire et les erreurs d'insertion d'annonces.

Métriques du CDN  
Surveillez les taux d'accès au cache, le volume des demandes d'origine et la latence de réponse pour le contenu et les segments publicitaires.

Mesures relatives à l'expérience des spectateurs  
Suivez les événements de rebuffering, les heures de démarrage et l'engagement des spectateurs, en particulier lors des transitions publicitaires.

Pour des informations détaillées sur la surveillance, reportez-vous [Surveillez les opérations pour le CDN et MediaTailor les intégrations](ssai-cdn-monitor.md) aux sections et[Surveillez les MediaTailor opérations d'assemblage des canaux CDN](ca-cdn-monitor.md).

## Dépannage des problèmes courants
<a name="ssai-ca-integration-troubleshooting"></a>

Lorsque vous résolvez des problèmes liés à la solution intégrée, tenez compte des problèmes courants suivants :

Problèmes de synchronisation des pauses publicitaires  
Si les annonces ne s'affichent pas aux points de rupture attendus, vérifiez que les définitions des interruptions publicitaires dans vos programmes d'assemblage de chaînes sont correctement configurées et que l'insertion des publicités identifie correctement ces points de rupture.

Erreurs de livraison manifestes  
Si les spectateurs rencontrent des problèmes de lecture, vérifiez que le CDN transmet correctement les demandes de manifeste entre l'assemblage des chaînes et l'insertion des publicités, et que les paramètres de cache sont adaptés à la nature dynamique de ces manifestes.

Problèmes de routage des segments  
Si le contenu ou les segments publicitaires ne se chargent pas, vérifiez que le CDN achemine correctement les demandes de segment vers les origines appropriées et que le segment URLs des manifestes est correctement formaté.

Dégradation des performances  
Si les utilisateurs sont confrontés à une mise en mémoire tampon ou à une latence élevée, vérifiez les taux de réussite du cache du CDN et le volume des demandes d'origine afin d'identifier les éventuels goulots d'étranglement dans le pipeline de diffusion.

Pour plus d'informations sur le dépannage, consultez[Résoudre les problèmes liés à MediaTailor SSAI CDNs pour une diffusion ininterrompue des publicités](troubleshooting-ssai-cdn.md).

## Bonnes pratiques
<a name="ssai-ca-integration-best-practices"></a>

Suivez ces bonnes pratiques pour une intégration réussie du SSAI à l'assemblage des canaux :
+ **Testez de manière approfondie** : testez la solution intégrée avec différents types de contenu, scénarios publicitaires et conditions d'audience avant de la déployer en production.
+ **Surveillance continue** : configurez une surveillance et des alertes complètes pour identifier et résoudre rapidement les problèmes éventuels.
+ **Optimisez la mise en cache** : passez régulièrement en revue et ajustez vos paramètres de mise en cache du CDN en fonction des modèles d'utilisation réels et des indicateurs de performance.
+ **Planifiez l'évolutivité** : concevez votre architecture de manière à gérer les pics de trafic, en particulier pour les chaînes ou les événements populaires.
+ **Envisagez la redondance** : implémentez la redondance dans les composants critiques afin de garantir la haute disponibilité de vos canaux linéaires.
+ **Optimisez les transitions entre les annonces** : assurez des transitions fluides entre le contenu et les publicités en utilisant des profils de codage et des durées de segment cohérents.

## Informations connexes
<a name="ssai-ca-integration-related"></a>

Pour plus d'informations sur l'intégration du SSAI à l'assemblage des canaux, voir :

Documentation d'assemblage des canaux  
[Utilisation AWS Elemental MediaTailor pour créer des flux assemblés linéaires](channel-assembly.md)- Découvrez les concepts d'assemblage de canaux  
[Assemblage de canaux avec CDN](ca-cdn-wflw.md)- Configurer l'assemblage des canaux avec un CDN

Documentation SSAI  
[Insertion d'annonces avec CDN](ssai-cdn-workflow.md)- Configurer l'insertion d'annonces avec un CDN  
[Comprendre l'architecture d'insertion publicitaire pour le CDN et les intégrations MediaTailor](ssai-cdn-architecture-overview.md)- Comprendre l'architecture du CDN d'insertion publicitaire

Configuration du CDN  
[Configurer l'intégration du CDN](cdn-configuration.md)- Conseils généraux de configuration du CDN  
[intégration d’CloudFront](cloudfront-specific-recommendations.md)- configuration CloudFront spécifique

# Optimisez les performances du CDN et MediaTailor des intégrations
<a name="ssai-cdn-performance"></a>

Optimisez les performances de votre mise en œuvre d'insertion d' AWS Elemental MediaTailor annonces en optimisant la configuration de votre réseau de diffusion de contenu (CDN). Ces paramètres garantissent une diffusion de contenu efficace et une expérience utilisateur optimale.

Pour obtenir des conseils détaillés sur la mise en cache et l'optimisation du routage spécifiques aux implémentations de SSAI, consultez. [Optimisation des performances du CDN](cdn-optimization.md) Le guide d'optimisation consolidé fournit des paramètres de mise en cache complets, une configuration du routage des demandes et des tests de performance qui s'appliquent à toutes les intégrations de MediaTailor CDN.

## Défis de performance courants
<a name="ssai-cdn-performance-challenges"></a>

Les implémentations de SSAI avec CDNs peuvent se heurter à plusieurs problèmes de performance :

Frais généraux de manipulation des manifestes  
MediaTailor effectue une manipulation du manifeste en temps réel, ce qui peut introduire de la latence si elle n'est pas optimisée correctement. Les éléments suivants peuvent introduire de la latence :  
+ Temps de traitement des demandes du serveur de décision publicitaire (ADS)
+ Temps nécessaire pour modifier les manifestes contenant des références à des segments publicitaires
+ Traitement supplémentaire pour la personnalisation

Problèmes d'efficacité du cache  
Les manifestes personnalisés peuvent réduire l'efficacité du cache du CDN pour les raisons suivantes :  
+ Chaque téléspectateur peut recevoir un manifeste unique
+ Les paramètres de session peuvent fragmenter le cache
+ Le contenu dynamique nécessite une configuration soigneuse du cache

pics de charge d'origine  
Une mise en cache incorrecte peut entraîner des pics de charge d'origine pendant :  
+ Événements à fort trafic
+ Actualisations du cache
+ Changements de configuration du CDN

Problèmes de lecture liés à la publicité  
L'insertion de publicités peut perturber la lecture, par exemple :  
+ Mise en mémoire tampon pendant les transitions publicitaires
+ Différences de qualité entre le contenu et les publicités
+ Échec de lecture lorsque les publicités ne peuvent pas être récupérées

Pour obtenir des conseils complets sur l'optimisation des performances, notamment les stratégies de mise en cache, le routage des demandes, les tests de performance et les techniques d'optimisation avancées, voir[Optimisation des performances du CDN](cdn-optimization.md). Le guide d'optimisation consolidé fournit des paramètres détaillés et des benchmarks qui s'appliquent à toutes les intégrations MediaTailor CDN, y compris les implémentations SSAI.

## Résumé des meilleures pratiques
<a name="ssai-cdn-performance-best-practices"></a>

Suivez ces bonnes pratiques pour garantir des performances SSAI optimales avec CDNs :

Bonnes pratiques en matière d'architecture  
+ Choisissez le modèle architectural adapté à votre échelle et à vos exigences
+ Déployez des services à proximité pour minimiser le temps de latence
+ Mettre en œuvre la redondance pour les composants critiques

Bonnes pratiques en matière de mise en cache  
+ Utiliser différentes stratégies de mise en cache pour différents types de contenu
+ Optimisez les clés de cache pour équilibrer personnalisation et efficacité
+ Définissez les paramètres appropriés TTLs en fonction du type de contenu et de la fréquence de mise à jour. Pour des recommandations TTL détaillées, voir[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).

Bonnes pratiques en matière de diffusion publicitaire  
+ Optimisez les interactions ADS avec des délais d'expiration et des solutions de secours
+ Préparez les publicités en fonction des spécifications du contenu
+ Mettez en œuvre une diffusion efficace des segments publicitaires

Surveillance des meilleures pratiques  
+ Surveillez tous les composants de votre mise en œuvre du SSAI
+ Configurer des alertes en cas de dégradation des performances
+ Vérifiez et optimisez régulièrement votre configuration

## Conseils d'optimisation complets
<a name="ssai-optimization-reference"></a>

Pour obtenir des conseils complets sur l'optimisation du CDN, notamment des stratégies de mise en cache détaillées, la configuration du routage des demandes, des tests de performance et des techniques d'optimisation avancées, consultez. [Optimisation des performances du CDN](cdn-optimization.md) Le guide d'optimisation consolidé fournit des paramètres complets et des benchmarks qui s'appliquent à toutes les intégrations MediaTailor CDN, y compris les implémentations SSAI.

# Surveillez les opérations pour le CDN et MediaTailor les intégrations
<a name="ssai-cdn-monitor"></a>

AWS Elemental MediaTailor fournit des fonctionnalités d'analyse robustes qui, combinées aux indicateurs du réseau de diffusion de contenu (CDN), offrent des informations complètes sur la mise en œuvre de votre SSAI. La présente rubrique couvre :

Pour obtenir des conseils complets sur la surveillance du CDN, y compris les indicateurs essentiels, la configuration des outils de surveillance, la configuration des alertes et les stratégies de dépannage applicables à toutes les MediaTailor implémentations, consultez. [Surveillance du CDN](cdn-monitoring.md) Cette rubrique se concentre sur les exigences de surveillance spécifiques à la SSAI et sur les analyses d'insertion de publicités.
+ Stratégies de surveillance pour l'intégration du SSAI et du CDN
+ Outils d'analyse et méthodes de collecte de données
+ Techniques d'optimisation basées sur les données

## Indicateurs clés pour le SSAI avec CDNs
<a name="ssai-cdn-monitor-metrics"></a>

Pour suivre efficacement la mise en œuvre de votre SSAI avec CDNs, suivez ces indicateurs essentiels :

Mesures d'insertion de publicités  
**Taux de remplissage des annonces** : pourcentage d'opportunités publicitaires qui ont été saisies avec succès par des annonces.  
**Taux d'erreur publicitaire** : pourcentage de demandes d'annonces ayant entraîné des erreurs.  
**Temps de réponse aux annonces : temps** nécessaire au serveur de décision publicitaire pour répondre aux demandes publicitaires.  
**Précision de la durée des annonces** : dans quelle mesure la durée réelle des annonces insérées correspond à la durée attendue.

Mesures relatives à l'expérience des spectateurs  
Taux **de mise en mémoire tampon : pourcentage** du temps de visionnage consacré à la mise en mémoire tampon.  
**Temps de démarrage : temps** nécessaire pour que la lecture vidéo commence.  
**Fluidité de la transition** entre les publicités : la fluidité avec laquelle le lecteur passe du contenu aux publicités.  
**Durée de la session : durée** pendant laquelle les spectateurs regardent le stream avant d'abandonner le stream.

## Outils d'analyse et intégration
<a name="ssai-cdn-monitor-tools"></a>

Combinez ces outils pour créer une solution d'analyse complète pour votre mise en œuvre du SSAI :

AWS Elemental MediaTailor métriques côté serveur  
MediaTailor fournit des statistiques intégrées via Amazon CloudWatch qui permettent de suivre les demandes publicitaires, les réponses et les erreurs. Ces statistiques peuvent être consultées dans la CloudWatch console ou intégrées dans des tableaux de bord personnalisés.  
Les MediaTailor indicateurs clés incluent :  
+ `AdDecisionServer.Ads`: le nombre d'annonces renvoyées par le serveur de décision publicitaire.
+ `AdDecisionServer.Duration`: durée totale des annonces renvoyées par le serveur de décision publicitaire.
+ `AdDecisionServer.Errors`: le nombre d'erreurs renvoyées par le serveur de décision publicitaire.
+ `AdDecisionServer.Latency`: temps de réponse du serveur de décision publicitaire.
Pour une liste complète des MediaTailor statistiques, consultez la section [Surveillance MediaTailor avec Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-cloudwatch.html).

Analyses CDN  
Les fournisseurs de CDN proposent des analyses détaillées des performances de diffusion de contenu. Pour Amazon CloudFront, utilisez CloudWatch les métriques et les journaux CloudFront d'accès Amazon pour analyser les modèles de livraison.  
Indicateurs CDN importants à surveiller :  
+ Nombre de demandes par type de contenu (manifestes ou segments)
+ Taux de réussite du cache pour différents types de contenu
+ Répartition géographique des spectateurs
+ Taux d'erreur par code d'erreur

Suivi côté client  
Mettez en œuvre le suivi côté client pour recueillir des indicateurs d'expérience utilisateur qui ne sont pas disponibles côté serveur :  
+ Événements relatifs aux joueurs (play, pause, search, buffer)
+ Taux d'achèvement des affichages publicitaires
+ Indicateurs de qualité de service (changements de résolution, débit)
+ Modèles d'engagement des spectateurs
Envisagez d'utiliser le suivi MediaTailor côté client pour collecter et communiquer ces indicateurs.

Tableaux de bord intégrés  
Créez des tableaux de bord complets qui combinent des indicateurs provenant de plusieurs sources :  
+ Utilisez des CloudWatch tableaux de bord pour combiner MediaTailor et mesurer CloudFront 
+ Envisagez des plateformes d'analyse tierces pour une visualisation plus avancée
+ Configurez une corrélation entre services pour identifier les relations entre les métriques

## Mettre en œuvre une stratégie de surveillance
<a name="ssai-cdn-monitor-implementation"></a>

Suivez ces étapes pour mettre en œuvre une stratégie de surveillance complète pour votre SSAI avec mise en œuvre du CDN :

1. **Configuration de la surveillance de base**
   + Activez CloudWatch les métriques pour MediaTailor
   + Configurer la journalisation du CDN et la collecte de métriques
   + Implémentez le suivi côté client dans votre lecteur vidéo

1. **Création de tableaux de bord personnalisés**
   + Créez un CloudWatch tableau de bord qui combine les indicateurs clés
   + Incluez des visualisations relatives au taux de remplissage des publicités, aux performances du CDN et à l'expérience des spectateurs
   + Ajouter des annotations pour les événements importants (modifications de configuration, diffusions majeures)

1. **Configuration des alertes**
   + Configurez des CloudWatch alarmes pour les mesures critiques
   + Créez des alarmes composites qui se déclenchent dans plusieurs conditions connexes
   + Configuration des canaux de notification (e-mail, SMS, Amazon SNS)

1. **Mettre en œuvre des réponses automatisées**
   + Utilisez CloudWatch les événements pour déclencher des réponses automatisées aux problèmes courants
   + Créez des runbooks pour une intervention manuelle en cas de besoin
   + Documenter les procédures de dépannage pour différents scénarios d'alerte

**Example Création d'un tableau de bord complet de surveillance SSAI**  
Cet exemple montre comment créer un CloudWatch tableau de bord qui combine MediaTailor des CloudFront indicateurs :  

```
{
  "widgets": [
    {
      "type": "metric",
      "properties": {
        "metrics": [
          [ "AWS/MediaTailor", "AdDecisionServer.Ads", "Configuration", "your-config-name" ],
          [ ".", "AdDecisionServer.Errors", ".", "." ]
        ],
        "period": 300,
        "stat": "Sum",
        "region": "us-west-2",
        "title": "Ad Decision Server Performance"
      }
    },
    {
      "type": "metric",
      "properties": {
        "metrics": [
          [ "AWS/CloudFront", "Requests", "DistributionId", "your-distribution-id" ],
          [ ".", "4xxErrorRate", ".", "." ],
          [ ".", "5xxErrorRate", ".", "." ]
        ],
        "period": 300,
        "stat": "Average",
        "region": "us-east-1",
        "title": "CDN Performance"
      }
    }
  ]
}
```

## Optimisation axée sur les données
<a name="ssai-cdn-monitor-optimization"></a>

Utilisez les données d'analyse que vous collectez pour optimiser la mise en œuvre de votre SSAI :

Optimisation du cache CDN  
Analysez les taux de réussite du cache pour identifier les opportunités d'amélioration :  
+ Ajustez les paramètres TTL en fonction du type de contenu et de la fréquence de mise à jour. Pour des recommandations TTL détaillées, voir[Étape 1 : configurer la mise en cache du CDN pour une diffusion publicitaire optimale](configuring-ssai-cdn.md#configure-cdn-caching).
+ Optimisation des paramètres clés du cache pour améliorer l'efficacité du cache
+ Envisagez d'implémenter Origin Shield pour la mise en cache multicouche

Optimisation de la diffusion des publicités  
Utilisez les indicateurs de performance des publicités pour améliorer la diffusion des annonces :  
+ Identifiez et corrigez les erreurs courantes d'insertion d'annonces
+ Optimisez les temps de réponse des serveurs de décision publicitaire
+ Ajustez les paramètres de ciblage publicitaire en fonction de l'analyse du taux de remplissage

Optimisation de l'expérience utilisateur  
Améliorez l'expérience des spectateurs en fonction des indicateurs côté client :  
+ Analysez les modèles de baisse pendant les pauses publicitaires
+ Optimisez les points de transition des annonces pour une lecture plus fluide
+ Ajustez la fréquence et la durée des publicités en fonction des données d'engagement des spectateurs

Optimisation des coûts  
Équilibrez les considérations relatives aux performances et aux coûts :  
+ Analysez les modèles d'utilisation de la bande passante pour optimiser les coûts du CDN
+ Envisagez des ajustements de classe de prix pour les CloudFront distributions
+ Évaluez le rapport coût-avantage des différentes stratégies de mise en cache

## Bonnes pratiques
<a name="ssai-cdn-monitor-best-practices"></a>

Suivez les meilleures pratiques suivantes pour une surveillance et une analyse efficaces du SSAI :
+ **Établir des bases de référence** : collectez des métriques pendant le fonctionnement normal afin d'établir des bases de performance qui peuvent être utilisées à des fins de comparaison lors du dépannage.
+ **Mettez en œuvre une surveillance à plusieurs niveaux** : surveillez à différents niveaux de votre architecture (origine, CDN, lecteur) pour obtenir une image complète des performances.
+ **Corrélez les indicateurs entre les services** : recherchez les relations entre les indicateurs des différents services afin d'identifier les causes profondes des problèmes.
+ **Utilisez la détection des anomalies** : mettez en œuvre la détection des CloudWatch anomalies pour identifier automatiquement les modèles inhabituels dans vos indicateurs.
+ **Révisez et affinez régulièrement** : planifiez des révisions régulières de votre stratégie de surveillance et ajustez-la en fonction de l'évolution des exigences et des nouvelles informations.
+ **Documenter les résultats et les actions** : Tenir un registre des efforts d'optimisation et de leurs résultats pour renforcer les connaissances institutionnelles.

## Informations connexes
<a name="ssai-cdn-monitor-related"></a>

Pour plus d'informations sur la surveillance et l'analyse du SSAI avec CDNs, voir :
+ [Optimisez les performances du CDN et MediaTailor des intégrations](ssai-cdn-performance.md)pour les techniques d'optimisation des performances
+ [Résoudre les problèmes liés à MediaTailor SSAI CDNs pour une diffusion ininterrompue des publicités](troubleshooting-ssai-cdn.md)pour résoudre les problèmes courants
+ [Surveillance MediaTailor avec Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-cloudwatch.html) pour obtenir des informations détaillées sur MediaTailor les métriques
+ [Affichage CloudFront des métriques et des fonctions Edge](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/viewing-cloudfront-metrics.html) pour obtenir des informations sur CloudFront les métriques

# Résoudre les problèmes liés à MediaTailor SSAI CDNs pour une diffusion ininterrompue des publicités
<a name="troubleshooting-ssai-cdn"></a>

Cette section fournit des solutions aux problèmes courants liés à l'utilisation de l'insertion AWS Elemental MediaTailor dynamique d'annonces avec un réseau de diffusion de contenu (CDN). Ces solutions vous aideront à résoudre les problèmes liés à la monétisation de vos vidéos grâce à des publicités personnalisées.

Pour obtenir des conseils complets sur le dépannage du CDN, notamment sur les problèmes de performances du cache, la résolution des erreurs HTTP, les procédures de test et les techniques de diagnostic applicables à toutes les MediaTailor implémentations, consultez. [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md) Cette section se concentre sur les exigences de dépannage spécifiques à la SSAI et les problèmes d'insertion de publicités.

Si vous rencontrez des problèmes avec la configuration de votre CDN et de votre SSAI, vérifiez les problèmes courants suivants :

La publicité personnalisée n'apparaît pas dans le stream  
Vérifiez que votre ADS répond correctement et qu'il AWS Elemental MediaTailor communique avec lui. Vérifiez les problèmes potentiels suivants :  
+ Les paramètres de requête de ciblage publicitaire ne sont pas correctement transmis via votre CDN
+ Les points de rupture des publicités sont mal définis dans votre contenu
+ Problèmes de connectivité ou de réponse ADS

Erreurs de lecture aux points de rupture des publicités  
Assurez-vous que les segments publicitaires sont correctement transcodés pour correspondre aux débits et résolutions de votre contenu. Vérifiez les problèmes courants suivants :  
+ Le CDN achemine incorrectement les demandes de segments publicitaires
+ Erreurs de manipulation manifestes aux points de transition
+ Profils d'encodage incompatibles entre le contenu et les publicités

Manifestes périmés  
Pour le contenu en direct, vérifiez que les paramètres TTL de votre cache CDN sont appropriés. Pour les manifestes personnalisés, utilisez un TTL de 0 seconde. Envisagez de mettre en œuvre l'invalidation du cache pour les manifestes qui changent rapidement. Pour des conseils complets sur le TTL, voir[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).

Latence élevée  
Vérifiez la configuration de votre CDN pour un routage optimal. Assurez-vous que votre CDN dispose d'emplacements périphériques proches de vos spectateurs pour de meilleures performances.

## Dépannage avancé
<a name="advanced-troubleshooting"></a>

Pour les problèmes plus complexes, essayez les techniques de résolution avancées suivantes :

Comportement de ciblage publicitaire incohérent  
Vérifiez les incohérences des paramètres de requête entre les demandes des joueurs et les demandes ADS. Assurez-vous que tous les paramètres de ciblage requis sont correctement transmis via le CDN.

Incohérences du cache du CDN  
Vérifiez les configurations des clés de cache pour garantir une différenciation correcte du contenu. Envisagez d'implémenter la purge du cache pour les mises à jour critiques des manifestes.

Défaillances du suivi des publicités  
Vérifiez que les balises URLs sont correctement transmises et qu'elles ne sont pas bloquées par le CDN. Vérifiez que les joueurs clients peuvent accéder aux points de suivi.

## Optimisation des performances
<a name="performance-optimization"></a>

Pour optimiser les performances de votre flux de travail dynamique d'insertion publicitaire et de monétisation vidéo :
+ Ajustez les paramètres TTL en fonction du type de contenu et des modèles de visionnage. Pour des recommandations TTL détaillées, voir[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).
+ Mettez en œuvre le routage géographique afin de minimiser le temps de latence pour le public mondial
+ Envisagez d'en utiliser plusieurs CDNs pour une redondance et des performances optimales
+ Surveillez les taux d'accès au cache et ajustez les configurations en conséquence
+ Optimisez les processus de manipulation des manifestes afin de réduire le temps de traitement aux points de rupture des publicités
+ Pré-transcodez les publicités pour qu'elles correspondent aux profils de contenu courants pour une insertion publicitaire personnalisée et fluide

### Critères de performance
<a name="performance-benchmarks"></a>

Lorsque vous optimisez l'intégration de votre CDN d'insertion d' AWS Elemental MediaTailor annonces, visez les critères de performance suivants :

Objectifs en matière de taux de réussite du cache  
Segments de contenu : taux d'accès au cache supérieur à 95 %  
Segments publicitaires : taux de réussite du cache supérieur à 90 %  
Manifestes : Non applicable (ne doivent pas être mis en cache pour l'insertion d'annonces personnalisées)

Repères de latence  
Latence des demandes de manifeste : moins de 100 ms (P95)  
Diffusion du segment de contenu : moins de 50 ms (P95)  
Diffusion du segment publicitaire : moins de 75 ms (P95)  
End-to-end temps de démarrage : moins de 2 secondes

Métriques de charge d'origine  
Demandes d'origine par téléspectateur : moins de 0,1 demande par minute et par téléspectateur  
Bande passante d'origine par spectateur : moins de 5 % de la bande passante totale du spectateur

Objectifs en matière de taux d'erreur  
Erreurs manifestes : moins de 0,1 %  
Erreurs de segment : moins de 0,01 %  
Rebuffering déclaré par le joueur : moins de 1 %

Benchmarks d'évolutivité  
Support d'un trafic 10 fois supérieur à la normale pendant les périodes de pointe, sans dégradation  
Capacité à traiter plus de 1 000 demandes par seconde et par canal

Utilisez CloudWatch les métriques Amazon pour suivre ces indicateurs de performance. Pour des instructions de surveillance détaillées, voir[Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md).

## Informations connexes
<a name="ssai-cdn-related"></a>

Pour plus d'informations sur l'insertion d'annonces avec CDNs, voir :

Documentation d'insertion d'annonces  
[Commencer à insérer MediaTailor des publicités](getting-started-ad-insertion.md)- En savoir plus sur les concepts d'insertion de publicités  
[Configuration](setting-up.md)- Commencez par insérer des publicités

Intégration au CDN  
[Configurer l'intégration du CDN](cdn-configuration.md)- Conseils généraux de configuration du CDN  
[intégration d’CloudFront](cloudfront-specific-recommendations.md)- configuration CloudFront spécifique

Intégration de l'assemblage des canaux  
[Assemblage de canaux avec CDN](ca-cdn-wflw.md)- En savoir plus sur l'assemblage des canaux avec CDNs  
[Mettre en œuvre l'insertion de publicités](ca-cdn-setup-advanced.md)- Implémenter l'insertion de publicités avec l'assemblage des chaînes

Surveillance et optimisation  
[Surveillez les opérations pour le CDN et MediaTailor les intégrations](ssai-cdn-monitor.md)- Surveillance et analyse complètes  
[Optimisez les performances du CDN et MediaTailor des intégrations](ssai-cdn-performance.md)- Guide d'optimisation des performances  
[Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md)- CloudWatch métriques pour MediaTailor

# Créez des canaux MediaTailor linéaires avec assemblage de canaux et CDN
<a name="ca-cdn-wflw"></a>

Cette section fournit des conseils complets pour intégrer l'assemblage de AWS Elemental MediaTailor canaux à un réseau de diffusion de contenu (CDN). Suivez ces étapes pour configurer, configurer et optimiser l'intégration de votre CDN d'assemblage de canaux.

Vous pouvez également combiner l'assemblage des chaînes avec l'insertion de publicités côté serveur (SSAI) pour créer des chaînes linéaires monétisées avec une publicité personnalisée. Cette puissante intégration vous permet de diffuser des publicités ciblées à différents spectateurs qui regardent le contenu d'une même chaîne, augmentant ainsi vos opportunités de revenus tout en garantissant une expérience de visionnage de qualité. Pour plus d'informations sur le SSAI avec CDNs, voir[Insertion d'annonces avec CDN](ssai-cdn-workflow.md).

Dans cette rubrique, nous utilisons le terme *manifestes* pour désigner collectivement les listes de lecture multivariantes, les listes de lecture multimédia et MPDs.

Pour plus d'informations sur l'assemblage des MediaTailor canaux, consultez[Utilisation AWS Elemental MediaTailor pour créer des flux assemblés linéaires](channel-assembly.md). 

## Ce dont vous aurez besoin
<a name="ca-cdn-what-you-need"></a>

Avant de configurer l'assemblage de MediaTailor canaux avec un CDN, rassemblez les ressources requises suivantes :

**AWS compte et autorisations**  
Un AWS compte doté des autorisations appropriées pour créer et gérer MediaTailor des ressources  
Autorisations IAM pour MediaTailor, CloudFront (si vous en utilisez), et les services connexes  
Pour connaître les exigences détaillées en matière d'autorisation, voir[Sécurité dans AWS Elemental MediaTailor](security.md).

**Services requis**  
Un MediaTailor canal d'assemblage de canaux en cours d'exécution (pas simplement une configuration SSAI)  
Un compte de réseau de diffusion de contenu (CDN) (Amazon CloudFront ou CDN tiers)  
Stockage d'origine pour votre contenu VOD (Amazon S3 ou autre serveur d'origine) MediaPackage

**Exigences relatives au contenu**  
Les sources VOD sont correctement encodées et emballées au format HLS ou DASH. Pour plus d'informations sur l'utilisation des emplacements de source et des sources de VOD, consultez[Utilisation des emplacements sources](channel-assembly-source-locations.md).  
Contenu avec des durées de segment cohérentes (minimum recommandé : 1 seconde)  
Contenu de la liste d'annonces pour les pauses publicitaires (si vous implémentez l'insertion d'annonces). Pour plus d'informations sur la configuration de Slate, consultez[MediaTailor ardoise et insertion](slate-management.md).

## Avant de commencer
<a name="ca-cdn-before-you-begin"></a>

**Important**  
Ce flux de travail nécessite un canal d'assemblage de MediaTailor canaux en cours d'exécution. Le fait de n'avoir qu'une configuration MediaTailor SSAI n'est pas suffisant pour cette intégration. Un canal d'assemblage de canaux actif doit être configuré et opérationnel avant de procéder à l'intégration du CDN.

Effectuez les tâches de configuration suivantes avant de mettre en œuvre l'assemblage de MediaTailor canaux avec un CDN :

1. Configurer la connectivité réseau entre votre CDN et MediaTailor les serveurs d'origine

1. Configurer le protocole HTTPS pour une diffusion de contenu sécurisée

1. Configurer les paramètres DNS pour votre domaine CDN

### Connaissances requises
<a name="ca-cdn-knowledge-prerequisites"></a>

Pour implémenter cette solution avec succès, vous devez disposer des éléments suivants :
+ Compréhension des protocoles de streaming (HLS/DASH)
+ Connaissances de base des principes de configuration du CDN
+ Connaissance des concepts d'assemblage de MediaTailor canaux

Pour la MediaTailor configuration de base, reportez-vous à [Configuration](setting-up.md) et[Commencer à assembler des MediaTailor canaux](channel-assembly-getting-started.md). Pour plus d'informations sur l'utilisation des emplacements de source et des sources de VOD, consultez[Utilisation des emplacements sources](channel-assembly-source-locations.md). Pour plus d'informations sur la configuration de Slate, consultez[MediaTailor ardoise et insertion](slate-management.md).

## Avantages de l'intégration du CDN
<a name="ca-cdn-benefits"></a>

L'intégration de l'assemblage de canaux à un CDN offre ces principaux avantages.

**Expérience utilisateur améliorée**  
Une configuration correcte CDNs réduit la mise en mémoire tampon, les temps de démarrage et les erreurs de lecture pour les canaux linéaires. Cela se traduit par un engagement et une satisfaction accrus des spectateurs.

**Réduction des coûts**  
Des stratégies de mise en cache efficaces minimisent les demandes d'origine. Cela réduit les coûts de transfert de données et la charge du serveur d'origine, ce qui est particulièrement important pour les canaux linéaires à haut volume.

**Capacité de mise à l’échelle**  
Les configurations CDN optimisées gèrent les pics de trafic lors d'événements populaires sans dégrader les performances, garantissant ainsi la disponibilité de vos canaux linéaires même pendant les heures de pointe.

**Portée mondiale**  
Configuré correctement, CDNs diffusez du contenu avec une faible latence aux spectateurs du monde entier, où qu'ils se trouvent, élargissant ainsi votre audience potentielle.

**Transitions de programme fluides**  
La configuration optimisée du CDN garantit des transitions fluides entre les programmes de votre chaîne linéaire, créant ainsi une expérience de visionnage de qualité télévisuelle.

**Topics**
+ [Ce dont vous aurez besoin](#ca-cdn-what-you-need)
+ [Avant de commencer](#ca-cdn-before-you-begin)
+ [Avantages de l'intégration du CDN](#ca-cdn-benefits)
+ [Comprendre l'architecture du CDN](channel-assembly-cdn-architecture.md)
+ [Configuration de base](ca-cdn-setup-basic.md)
+ [Configurer la base URLs](channel-assembly-cdn-baseurl.md)
+ [Mettre en œuvre l'insertion de publicités](ca-cdn-setup-advanced.md)
+ [Configuration de l'affichage décalé dans le temps](channel-assembly-cdn-timeshift.md)
+ [Surveillez les opérations du CDN](ca-cdn-monitor.md)
+ [Guide d'optimisation complet](ca-cdn-optimize-reference.md)

# Comprendre l'architecture CDN d'assemblage de MediaTailor canaux
<a name="channel-assembly-cdn-architecture"></a>

AWS Elemental MediaTailor l'assemblage des canaux s'intègre aux réseaux de diffusion de contenu (CDNs) pour diffuser des chaînes de streaming linéaires avec des performances améliorées et une portée mondiale. L'architecture recommandée place le CDN entre les spectateurs et l'assemblage des chaînes, l'assemblage des chaînes accédant au contenu directement depuis votre origine. Cette rubrique décrit les principaux composants de l'architecture et explique comment ils fonctionnent ensemble pour diffuser votre contenu.

1. Les spectateurs demandent des manifestes au CDN

1. Le CDN transmet les demandes à l'assemblage des canaux

1. L'assemblage des canaux assemble les manifestes à partir de sources VOD

1. L'assemblage des chaînes renvoie les manifestes au CDN, qui les transmet aux spectateurs

1. Les spectateurs demandent des segments via le CDN

1. Le CDN achemine les demandes de segment vers l'origine appropriée

Cette architecture garantit des performances optimales tout en conservant les avantages de sécurité et de flexibilité liés à l'utilisation d'un CDN.

![\[Schéma montrant le positionnement du CDN entre les joueurs clients et l'assemblage des MediaTailor canaux\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/ca-cdn.png)


## Terminologie CDN pour l'assemblage de canaux
<a name="cdn-terminology"></a>

La compréhension de ces termes clés vous aidera à implémenter et à résoudre les problèmes liés à l'intégration de votre CDN d'assemblage de canaux :

CDN d'origine et CDN Edge  
**CDN d'origine** : un CDN positionné entre MediaTailor et l'origine de votre contenu. Il met en cache les segments de contenu afin de réduire la charge sur vos serveurs d'origine. Dans une architecture multi-CDN, il s'agit de la première couche CDN qui s'interface directement avec l'origine.  
**Edge CDN** : un CDN positionné entre les spectateurs et. MediaTailor Il fournit des manifestes et du contenu personnalisés aux spectateurs. Dans une architecture multi-CDN, il s'agit de la couche CDN la plus externe qui s'interface directement avec les spectateurs.

Termes de configuration du CDN  
**Comportement du cache** : règles qui déterminent la manière dont un CDN gère différents types de demandes, notamment la durée de mise en cache et le routage d'origine.  
**TTL (Time To Live)** : durée pendant laquelle le contenu reste valide dans un cache CDN avant de devoir être actualisé depuis son origine. Pour des recommandations TTL détaillées, voir[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).  
**Clé de cache** : identifiant unique utilisé par un CDN pour stocker et récupérer le contenu mis en cache, notamment le chemin d'URL, les paramètres de requête et les en-têtes.  
**Origin Shield** : couche de mise en cache intermédiaire entre les emplacements périphériques du CDN et votre serveur d'origine qui réduit le nombre de demandes adressées à votre origine.  
**Réduction des demandes** : fonctionnalité CDN qui combine plusieurs demandes simultanées pour le même contenu en une seule demande d'origine.

MediaTailor-termes spécifiques au CDN  
**Préfixe de segment de contenu CDN** : nom de domaine CDN MediaTailor utilisé lors de la génération de segments de contenu dans URLs des manifestes.  
**Préfixe de segment publicitaire CDN** : nom de domaine CDN MediaTailor utilisé lors de la génération de segments publicitaires dans URLs les manifestes.

Pour plus d'informations sur la configuration du CDN avec MediaTailor, consultez[Configurer l'intégration du CDN](cdn-configuration.md).

# Configurer l'assemblage de MediaTailor canaux de base avec un CDN
<a name="ca-cdn-setup-basic"></a>

AWS Elemental MediaTailor L'assemblage des chaînes vous permet de configurer une intégration de base avec votre réseau de diffusion de contenu (CDN) pour une diffusion efficace des chaînes de streaming linéaires à vos spectateurs. Suivez ces étapes pour configurer l'intégration entre l'assemblage des canaux et votre CDN.

1. Configurez votre CDN pour qu'il accepte les manifestes des spectateurs et les transmette à l'assemblage des MediaTailor chaînes.

1. Configurez l'assemblage des MediaTailor chaînes pour accéder au calendrier de vos chaînes et déterminer la programmation en cours.

1. Configurez l'assemblage des MediaTailor chaînes pour demander des segments de contenu à votre serveur d'origine en fonction du calendrier.

1. Assurez-vous que l'origine de votre contenu peut fournir les segments demandés à l'assemblage des MediaTailor chaînes.

1. Configurez l'assemblage des MediaTailor canaux pour générer des manifestes dynamiques en fonction du calendrier actuel.

1. Configurez votre CDN pour diffuser les playlists multivariantes assemblées, les playlists multimédias et les diffuser MPDs aux spectateurs.

1. Configurez votre CDN pour traiter les demandes de segment des utilisateurs, avec les paramètres de cache appropriés.

1. Configurez votre CDN pour transférer les erreurs de cache à l'assemblage des MediaTailor canaux.

1. Configurez l'assemblage des MediaTailor chaînes pour récupérer les segments demandés à partir de l'origine de votre contenu.

1. Configurez votre CDN pour diffuser des segments de contenu aux spectateurs pour qu'ils puissent les lire.

# Configurer la base URLs pour le CDN d'assemblage de MediaTailor canaux
<a name="channel-assembly-cdn-baseurl"></a>

AWS Elemental MediaTailor l'assemblage des canaux nécessite une configuration d'URL de base appropriée pour garantir le bon fonctionnement du routage du contenu via votre réseau de diffusion de contenu (CDN). Configurez les paramètres d'URL de base dans l'assemblage des chaînes pour permettre la diffusion réussie du contenu aux spectateurs.

## Configuration de l'URL du segment de contenu
<a name="channel-assembly-cdn-content-segment"></a>

Dans la configuration de votre canal d'assemblage de canaux, définissez l'**URL de base** de votre domaine CDN. Cela garantit que tous les segments URLs du manifeste assemblé pointent vers votre CDN plutôt que directement vers votre serveur d'origine.

Par exemple, si votre contenu d'origine se trouve à `http://origin.example.com/content/` et que votre domaine CDN l'est`https://cdn.example.com/`, définissez l'URL de base sur`https://cdn.example.com/content/`.

## Configuration des restrictions d'accès
<a name="channel-assembly-cdn-access-restriction"></a>

Pour améliorer la sécurité, configurez votre CDN pour restreindre l'accès direct à votre serveur d'origine :

1. Configurez les contrôles d'accès à l'origine dans votre CDN.

1. Configurez votre serveur d'origine pour qu'il accepte uniquement les demandes provenant de votre CDN.

1. Utilisez des cookies signés URLs ou des cookies pour authentifier les spectateurs si nécessaire.

Pour Amazon CloudFront, vous pouvez utiliser le contrôle d'accès à l'origine (OAC) pour sécuriser l'accès à votre origine. Pour plus d'informations sur la sécurisation de votre CloudFront intégration, consultez[intégration d’CloudFront](cloudfront-specific-recommendations.md).

# MediaTailor Implémenter l'insertion de publicités avec l'assemblage de chaînes
<a name="ca-cdn-setup-advanced"></a>

L'assemblage des chaînes AWS Elemental MediaTailor s'intègre parfaitement à l'insertion publicitaire côté serveur (SSAI) et aux réseaux de diffusion de contenu (CDNs) pour créer des canaux linéaires monétisés avec des publicités personnalisées.

Lorsque vous combinez l'assemblage de chaînes avec le SSAI, vous pouvez créer des chaînes linéaires qui diffusent des publicités personnalisées aux spectateurs tout en garantissant des expériences de qualité. Cette intégration vous permet d'effectuer les opérations suivantes :
+ Monétisez le contenu - Générez des revenus grâce à une publicité ciblée sur vos canaux linéaires
+ Personnalisez les expériences : diffusez différentes publicités aux spectateurs qui regardent la même chaîne en fonction de leur profil
+ Maintien de la qualité - Garantissez des transitions fluides entre le contenu et les publicités pour un visionnage de qualité
+ Évoluez efficacement - Support de millions de spectateurs simultanés grâce à la diffusion de CDN

Pour des informations détaillées sur le SSAI avec CDNs, voir[Insertion d'annonces avec CDN](ssai-cdn-workflow.md).

1. Configurez votre CDN Edge pour accepter les demandes de manifeste des spectateurs et les transférer vers l'insertion MediaTailor publicitaire.

1. Configurez l'insertion d' MediaTailor annonces pour transférer les demandes vers votre CDN d'origine.

1. Configurez votre CDN d'origine pour transmettre les demandes à l'assemblage des MediaTailor canaux.

1. Configurez l'assemblage des MediaTailor canaux pour générer des manifestes dynamiques en fonction du calendrier actuel.

1. Configurez votre CDN d'origine pour transférer les manifestes assemblés vers l'insertion MediaTailor publicitaire.

1. Configurez l'insertion d' MediaTailor annonces pour demander des décisions publicitaires à votre serveur de décision publicitaire aux points de rupture des publicités.

1. Configurez l'insertion de MediaTailor publicités pour personnaliser les manifestes à l'aide de marqueurs publicitaires.

1. Configurez votre CDN Edge pour fournir des manifestes personnalisés aux spectateurs.

1. Configurez votre architecture CDN pour gérer efficacement les demandes de contenu et de segments publicitaires.

Le schéma suivant illustre ce flux de travail combiné :

![\[Schéma illustrant l'intégration du CDN à la fois à l'assemblage des canaux et à l'insertion de publicités\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/ca-ssai-comb-cdn.png)


Pour des performances optimales lors de la combinaison de l'assemblage des canaux et du SSAI :
+ Configurer des comportements de cache qui font la distinction entre l'assemblage de canaux et les demandes SSAI
+ Définissez les valeurs TTL appropriées pour les manifestes et les segments, comme recommandé dans [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
+ Garantissez un routage correct entre l'assemblage des chaînes, l'insertion de publicités et les origines de votre CDN
+ Surveillez les indicateurs de performance pour les composants d'assemblage des chaînes et d'insertion de publicités

Pour des informations détaillées sur la configuration de SSAI avec CDNs, voir :
+ [Comprendre l'architecture d'insertion publicitaire pour le CDN et les intégrations MediaTailor](ssai-cdn-architecture-overview.md)- En savoir plus sur l'architecture et les concepts du SSAI
+ [Configurez un MediaTailor SSAI de base avec un CDN pour une diffusion publicitaire optimale](configuring-ssai-cdn.md)- Instructions Step-by-step de configuration SSAI
+ [Résoudre les problèmes liés à MediaTailor SSAI CDNs pour une diffusion ininterrompue des publicités](troubleshooting-ssai-cdn.md)- Résoudre les problèmes courants d'intégration SSAI

# Configuration de l'affichage décalé dans le temps pour l'assemblage des MediaTailor canaux
<a name="channel-assembly-cdn-timeshift"></a>

AWS Elemental MediaTailor l'assemblage des canaux prend en charge les fonctionnalités de visualisation décalées dans le temps qui permettent des fonctionnalités similaires à celles du DVR, telles que la pause, le retour en arrière et le redémarrage pour vos canaux linéaires. Activez ces fonctionnalités en configurant votre réseau de diffusion de contenu (CDN) pour prendre en charge le visionnage décalé dans le temps, ce qui permet aux spectateurs de contrôler leur expérience de visionnage.

## Comprendre le visionnage décalé dans le temps
<a name="channel-assembly-cdn-timeshift-overview"></a>

L'affichage décalé dans le temps permet des fonctionnalités similaires à celles d'un DVR pour les canaux linéaires, notamment :
+ **Redémarrage** : les spectateurs peuvent commencer à regarder une émission depuis le début, même s'ils la rejoignent après le début
+ **Pause et reprise** : les spectateurs peuvent suspendre le contenu et reprendre le visionnage plus tard
+ **Revenir en arrière et avancer rapidement** : les spectateurs peuvent naviguer en arrière et en avant dans le contenu disponible
+ **Visionnage différé** : les spectateurs peuvent regarder le contenu diffusé plus tôt dans le programme de la chaîne

L'affichage décalé dans le temps fonctionne en ajoutant un `start` paramètre à l'URL de diffusion de la chaîne. Le paramètre indique un décalage en secondes par rapport à l'heure actuelle :
+ Les valeurs négatives indiquent un moment dans le passé (par exemple, `start=-3600` cela signifie « commencer il y a 1 heure »)
+ Les valeurs positives indiquent une heure dans le futur (par exemple, `start=3600` cela signifie « commencer à partir d'une heure dans le futur »)

Exemple d'URL avec paramètre de décalage temporel :

```
https://example-cdn.com/out/v1/channel-name/index.m3u8?start=-3600
```

## Résolution du délai
<a name="channel-assembly-cdn-timeshift-delay"></a>

Pour prendre en charge le visionnage décalé dans le temps avec un CDN :

1. Configurez votre CDN pour transmettre le paramètre de `start` requête à l'assemblage des canaux.

1. Configurez des comportements de cache qui incluent le `start` paramètre dans la clé de cache.

1. Pour les manifestes avec des paramètres de décalage temporel, utilisez un TTL court ou aucune mise en cache.

Cela garantit que chaque téléspectateur reçoit le manifeste correspondant à la position temporelle demandée.

## Exigences du CDN pour le décalage horaire
<a name="channel-assembly-cdn-timeshift-requirements"></a>

Votre CDN doit répondre aux exigences suivantes pour prendre en charge le visionnage décalé dans le temps avec assemblage de canaux :
+ Transférez tous les paramètres de requête à l'assemblage des canaux.
+ Incluez le `start` paramètre dans la clé de cache.
+ Support d'une invalidation correcte du cache pour les manifestes décalés dans le temps.
+ Gérez différentes réponses au manifeste en fonction des paramètres de requête.

# Surveillez les MediaTailor opérations d'assemblage des canaux CDN
<a name="ca-cdn-monitor"></a>

AWS Elemental MediaTailor l'assemblage des canaux nécessite une surveillance efficace lorsqu'il est intégré à un réseau de diffusion de contenu (CDN) afin de garantir une diffusion de contenu fiable. Mettez en œuvre des stratégies de surveillance pour l'assemblage de vos chaînes et l'intégration du CDN afin de garantir une diffusion de contenu fiable et une résolution rapide des problèmes.

Pour obtenir des conseils complets sur la surveillance du CDN, y compris les indicateurs essentiels, la configuration des outils de surveillance, la configuration des alertes et les stratégies de dépannage applicables à toutes les MediaTailor implémentations, consultez. [Surveillance du CDN](cdn-monitoring.md) Cette section se concentre sur les exigences de surveillance spécifiques à l'assemblage des canaux.

Mettez en œuvre une surveillance spécifique pour l'assemblage de vos canaux et l'intégration du CDN :
+ Suivez les métriques de génération de manifestes lors de l'assemblage des canaux.
+ Surveillez les demandes de visionnage décalées dans le temps et leur impact sur les taux de réussite du cache CDN.
+ Configurez des alertes pour détecter des modèles inhabituels dans les demandes de manifeste.
+ Mettez en œuvre le suivi de la disponibilité des segments dans l'ensemble de vos sources de contenu.

Pour Amazon CloudFront, créez un tableau de bord qui intègre les métriques du CDN aux MediaTailor métriques afin de visualiser l'ensemble de votre pipeline de livraison à l'aide de [CloudWatchtableaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) de bord.

Si vous utilisez également le SSAI pour l'assemblage de vos chaînes, consultez [Surveillez les opérations du CDN](ssai-cdn-monitor.md) les recommandations de surveillance supplémentaires spécifiques à l'insertion de publicités.

# Optimisation complète de l'assemblage des canaux (CDN)
<a name="ca-cdn-optimize-reference"></a>

Pour obtenir des conseils détaillés sur l'optimisation du CDN spécifiques aux implémentations d'assemblages de canaux, y compris les stratégies de mise en cache, la configuration du routage des demandes, les tests de performance et les techniques d'optimisation avancées, voir. [Optimisation des performances du CDN](cdn-optimization.md)

Le guide d'optimisation consolidé fournit :
+ Paramètres de mise en cache spécifiques à l'assemblage de canaux avec valeurs TTL recommandées
+ Optimisation du routage des demandes pour la livraison de manifestes et de segments
+ Benchmarks et objectifs de performance pour toutes les MediaTailor implémentations
+ Techniques d'optimisation avancées, notamment Origin Shield et compression
+ Guidage du flux de travail combiné pour l'assemblage des canaux avec SSAI

# Intégration MediaTailor avec un MediaPackage CDN
<a name="mediapackage-integration"></a>

AWS Elemental MediaTailor s'intègre AWS Elemental MediaPackage pour diffuser des publicités vidéo personnalisées via un réseau de diffusion de contenu (CDN). MediaPackage est un service de packaging et de création just-in-time vidéo qui prépare et protège votre contenu vidéo en vue de sa diffusion sur Internet. Il prend votre contenu vidéo en direct ou à la demande et le regroupe dans des formats de streaming tels que HLS et DASH, le rendant prêt à être visionné sur différents appareils.

Lorsque vous MediaPackage MediaTailor associez un CDN à un CDN, vous créez un flux de diffusion complet qui diffuse des publicités personnalisées à grande échelle. Le CDN distribue votre contenu dans le monde entier, réduisant ainsi la latence et améliorant l'expérience des spectateurs, tout en MediaTailor insérant des publicités ciblées dans vos flux.

Cette rubrique se concentre sur les étapes d'intégration essentielles pour que votre CDN fonctionne ensemble. MediaTailor MediaPackage Pour les options de configuration avancées, le dépannage et les conseils de surveillance, consultez[Étapes suivantes](#emp-cdn-next-steps).

## Comprendre le flux de travail MediaPackage et le flux de travail du CDN
<a name="emp-cdn-overview"></a>

Avant de configurer votre intégration, il est important de comprendre comment MediaPackage et votre CDN fonctionnent ensemble : MediaTailor

1. **Préparation du contenu** : MediaPackage reçoit votre contenu vidéo en direct ou à la demande et le regroupe dans des formats de streaming (manifestes et segments HLS ou DASH).

1. **Insertion de publicités** : MediaTailor demande des manifestes MediaPackage, insère des publicités personnalisées et diffuse les manifestes modifiés aux spectateurs.

1. **Distribution mondiale** : votre CDN met en cache et distribue à la fois les segments de contenu (de MediaPackage) et les segments publicitaires (de MediaTailor) aux spectateurs du monde entier.

1. **Lecture par les spectateurs** : les lecteurs vidéo demandent des manifestes via le CDN, qui achemine les demandes de manière appropriée entre MediaTailor (pour les manifestes) et MediaPackage (pour les segments de contenu).

Cette architecture présente plusieurs avantages :
+ **Évolutivité** : le CDN gère une charge de visionnage élevée sans affecter vos serveurs d'origine
+ **Performances** : le contenu est diffusé à partir des sites périphériques les plus proches des spectateurs
+ **Rentabilité : réduction** des coûts de bande passante grâce à la mise en cache
+ **Fiabilité** : plusieurs emplacements périphériques assurent la redondance

## Conditions préalables
<a name="emp-cdn-prerequisites"></a>

Avant de commencer, assurez-vous que les composants suivants sont configurés :

1. MediaPackage point de **terminaison** : point de MediaPackage terminaison configuré qui reçoit et emballe votre contenu vidéo. Pour les instructions de configuration, voir [Getting started with MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html) dans le guide de MediaPackage l'utilisateur.

1. **MediaTailor configuration** : MediaTailor configuration qui utilise votre MediaPackage point de terminaison comme origine du contenu. Pour les instructions de configuration, voir[Intégration d'une source de contenu pour l'insertion d' MediaTailor annonces](integrating-origin.md).

1. Distribution **CDN : distribution** CDN (telle que CloudFront) configurée pour fonctionner avec le streaming multimédia. Pour les instructions de configuration, voir [Création d'une distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le guide du CloudFront développeur.

1. Serveur de **décision publicitaire : serveur** de décision publicitaire configuré qui renvoie des réponses VAST ou VMAP pour l'insertion d'annonces.

## Étape 1 : configurer les paramètres essentiels du CDN
<a name="mediapackage-best-practices"></a>

Une configuration CDN correcte est essentielle pour une MediaPackage intégration réussie. Des paramètres incorrects peuvent entraîner des échecs de lecture, de mauvaises performances du cache et une augmentation des coûts. Sans les bonnes politiques de cache et le transfert des paramètres de requête, votre CDN risque de ne pas fournir correctement les manifestes ou de contourner complètement la mise en cache, ce qui entraîne une charge de travail élevée sur le serveur d'origine et une dégradation de l'expérience utilisateur.

### Configuration des paramètres de base du cache
<a name="mediapackage-cache-control"></a>

La configuration de la mise en cache de base est essentielle car elle MediaPackage utilise des en-têtes de contrôle de cache spécifiques pour optimiser la diffusion du contenu. Sans paramètres de cache appropriés, votre CDN risque d'ignorer ces en-têtes, ce qui entraîne des demandes d'origine inutiles et une latence accrue. Procédez comme suit pour garantir un comportement de mise en cache optimal :

Pour configurer une mise en cache de base compatible avec MediaPackage :

1. Ouvrez vos paramètres CloudFront de distribution dans la CloudFront console.

1. Sélectionnez ou créez une politique de cache pour votre MediaPackage origine.

1. Activez l'option « Origin Cache-Control Headers ».

1. Permet de MediaPackage contrôler le comportement de mise en cache via ses en-têtes de contrôle du cache.

Cette configuration de base permet MediaPackage de définir automatiquement des durées de cache appropriées pour différents types de contenu. Pour implémenter une optimisation avancée du cache avec des valeurs TTL spécifiques et un réglage des performances, effectuez d'abord cette configuration de base, puis passez à[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).

### Configuration des paramètres de requête essentiels
<a name="mediapackage-query-strings"></a>

La configuration des paramètres de requête est cruciale pour MediaPackage la fonctionnalité. Votre CDN doit transmettre des paramètres de requête spécifiques pour activer des fonctionnalités telles que l'affichage décalé dans le temps et le streaming à faible latence. Des paramètres de requête incorrects peuvent empêcher ces fonctionnalités de fonctionner et je crains de réduire l'efficacité du cache. Pour configurer le transfert des paramètres de requête, procédez comme suit :

Pour vous assurer que votre CDN transmet les paramètres de requête requis à MediaPackage :

1. Dans vos paramètres CloudFront de distribution, sélectionnez ou créez une politique de cache pour les demandes de manifeste.

1. Sous « Paramètres des clés de cache », sélectionnez « Inclure les chaînes de requête spécifiées ».

1. Ajoutez les paramètres de requête essentiels suivants :
   + `start`et `end` - Pour une fonctionnalité de visualisation décalée dans le temps. Ces paramètres sont transmis pour définir des fenêtres de contenu spécifiques MediaPackage pour le visionnage initial et le visionnage de rattrapage.
   + `_HLS_msn`et `_HLS_part` - Pour prendre en charge les demandes de lecture LL-HLS
   + `m`- Pour capturer la modification ti/compame du point de terminaison. MediaPackage les réponses incluent toujours la `?m=###` balise pour capturer l'heure de modification du point de terminaison. Si le contenu est déjà mis en cache avec une valeur différente pour cette balise, CloudFront demande un nouveau manifeste au lieu de diffuser la version mise en cache
   + `aws.manifestfilter`- Pour la fonctionnalité de filtrage des manifestes. Si vous utilisez le filtrage des manifestes, ce paramètre doit être inclus pour configurer la distribution afin de transmettre la chaîne de `aws.manifestfilter` requête à l' MediaPackageorigine, ce qui est nécessaire pour que la fonctionnalité de filtrage des manifestes fonctionne

1. N'incluez que les chaînes de requête qui MediaPackage utilisent. L'inclusion de chaînes de requête inutiles réduit l'efficacité du cache en créant plusieurs variantes de cache pour le même contenu.

Ces paramètres activent les MediaPackage fonctionnalités de base de votre CDN. Si vous devez implémenter le filtrage du contenu pour différents niveaux d'abonnement ou types d'appareils, effectuez d'abord cette configuration de base des paramètres de requête, puis passez à[Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md).

Pour plus d'informations sur le mode MediaTailor de transmission des paramètres de requête tels que `start` et `end` via MediaPackage pour un affichage décalé dans le temps, voir [MediaTailor gestion des paramètres de requête pour les origines](origin-query-parameters.md) dans[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

### Configurer le délai de réponse pour LL-HLS
<a name="mediapackage-response-timeout"></a>

La configuration du délai d'expiration est essentielle pour le HLS à faible latence, car le LL-HLS utilise un mécanisme de « blocage des demandes » dans le cadre duquel le CDN attend de nouveaux segments de contenu. Si votre délai d'attente est trop court, les demandes échoueront avant de MediaPackage pouvoir répondre avec de nouveaux segments, ce qui entraînera des interruptions de lecture et une mauvaise expérience utilisateur. Configurez les délais d'expiration appropriés pour garantir une lecture fluide du format LL-HLS :

Si vous utilisez le HLS à faible latence, configurez les paramètres de délai d'expiration du CDN :

1. Dans les paramètres de votre CDN, recherchez la configuration du délai d'origine.

1. Définissez la valeur du délai de réponse à au moins trois fois la durée de vos pièces.

1. Par exemple, si la durée de vos pièces est de 0,3 seconde, réglez le délai d'attente à au moins 0,9 seconde.

Cela garantit que le CDN attend suffisamment longtemps pour MediaPackage répondre lorsqu'il utilise le mécanisme de blocage des demandes.

## Étape 2 : vérifier votre intégration
<a name="manifest-filtering-integration"></a>

Il est essentiel de tester votre intégration pour garantir que tous les composants fonctionnent correctement ensemble avant que vos utilisateurs ne rencontrent des problèmes. L'échec de l'intégration peut entraîner une lecture interrompue, des publicités manquantes ou des performances médiocres. Ce processus de vérification vous aide à identifier et à résoudre les problèmes dans un environnement contrôlé.

Après avoir configuré les paramètres de votre CDN, vérifiez que votre intégration fonctionne correctement en testant l'ensemble du flux de travail, de la demande de contenu à l'insertion de publicités.

### Étape 2.1 : tester la lecture de base
<a name="manifest-filtering-overview"></a>

Les tests de lecture de base vérifient que votre CDN gère correctement les demandes de manifeste et les transmet à. MediaTailor Ce test permet d'identifier les problèmes de configuration liés aux politiques de cache, au transfert des paramètres de requête et à la gestion des manifestes. Pour tester la livraison de manifeste de base, procédez comme suit :

Vérifiez que votre intégration de base fonctionne en demandant un manifeste via votre CDN :

1. Utilisez un navigateur Web ou un curl pour demander une URL de manifeste via votre CDN.

1. Vérifiez que le manifeste se charge correctement et qu'il contient à la fois du contenu et des segments publicitaires.

1. Vérifiez que le segment URLs de contenu du manifeste pointe vers votre domaine CDN.

1. Vérifiez que le segment publicitaire pointe URLs également vers votre domaine CDN.

Si le manifeste se charge correctement et contient les informations attendues URLs, votre intégration de base fonctionne. Pour des méthodologies de test complètes et des procédures de validation avancées, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md). Pour configurer une surveillance complète des performances et de l'état de votre intégration, consultez[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md).

### Étape 2.2 : tester la lecture vidéo
<a name="manifest-filtering-cdn-config"></a>

Les tests de lecture vidéo garantissent le bon fonctionnement de votre intégration complète end-to-end, y compris l'insertion de publicités et la diffusion de contenu via votre CDN. Ce test permet de vérifier que les segments de contenu et les segments publicitaires sont correctement mis en cache et diffusés, et que l'expérience utilisateur répond à vos normes de qualité. Pour tester toutes les fonctionnalités de lecture, procédez comme suit :

Vérifiez que la lecture vidéo fonctionne correctement avec les publicités insérées :

1. Utilisez un lecteur vidéo (tel que Video.js ou HLS.js) pour lire votre contenu via le CDN.

1. Vérifiez que la vidéo s'affiche correctement sans problème de mise en mémoire tampon.

1. Vérifiez que les publicités sont insérées aux heures prévues pendant la diffusion.

1. Vérifiez que le contenu et les segments publicitaires se chargent à partir de votre CDN (et non directement à partir des origines).

Si la lecture fonctionne correctement avec les publicités, votre intégration fonctionne correctement. Pour des méthodologies de test complètes et des procédures de validation avancées, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md). Si vous rencontrez des problèmes de lecture, de mise en mémoire tampon ou d'insertion de publicités, consultez[Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md).

## Étapes suivantes
<a name="emp-cdn-next-steps"></a>

Une fois l'intégration de base terminée, vous pouvez implémenter des fonctionnalités et des optimisations avancées :

**Optimisation avancée du CDN**  
Pour une optimisation détaillée du cache, la configuration TTL et le réglage des performances, consultez[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).

**Filtrage des manifestes**  
Pour implémenter le filtrage de contenu pour les services hiérarchisés, l'optimisation des appareils ou le contrôle d'accès, voir[Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md).

**Résolution des problèmes**  
Si vous rencontrez des problèmes lors de votre intégration, consultez[Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md).

**Surveillance des performances**  
Pour configurer une surveillance complète et comprendre les indicateurs de performance clés, voir[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md).

# Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN
<a name="cdn-emp-manifest-filtering"></a>

AWS Elemental MediaTailor utilise le filtrage des manifestes AWS Elemental MediaPackage pour personnaliser les flux audio et vidéo inclus dans les manifestes fournis aux différents spectateurs via un réseau de diffusion de contenu (CDN). Cela est particulièrement utile pour mettre en œuvre des offres de services à plusieurs niveaux, des optimisations spécifiques aux appareils ou des contrôles d'accès au contenu.

Cette rubrique se concentre spécifiquement sur la mise en œuvre des fonctionnalités de filtrage des manifestes. Avant de mettre en œuvre le filtrage des manifestes, vous devez terminer la configuration de base de l'intégration du réseau de diffusion de contenu. Si vous n'avez pas encore configuré votre intégration de base MediaPackage et votre réseau de diffusion de contenu, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md).

## Fonctionnalités de filtrage des manifestes
<a name="manifest-filtering-overview"></a>

Avant de mettre en œuvre le filtrage des manifestes, découvrez ce que vous pouvez accomplir grâce à cette fonctionnalité :

### Fonctionnalités de filtrage de base
<a name="filtering-capabilities"></a>

Le filtrage des manifestes fournit plusieurs fonctionnalités clés qui vous aident à contrôler la diffusion du contenu :
+ Restreindre l'accès des spectateurs au contenu premium (tel que le 4K HEVC)
+ Ciblez des types d'appareils spécifiques avec des flux appropriés
+ Filtrez le contenu en fonction des fréquences d'échantillonnage audio, des langues ou des codecs vidéo
+ Proposez différents niveaux de qualité à différents abonnés

### Cas d’utilisation courants
<a name="filtering-use-cases"></a>

Ces cas d'utilisation montrent comment le filtrage des manifestes peut répondre à des exigences commerciales spécifiques :

**Niveaux d’abonnement**  
Offrez aux abonnés de base des flux en basse résolution tout en offrant aux abonnés premium un accès au contenu 4K  
Exemple : le niveau de base est limité à 720p, le niveau Premium passe à 4K

**Optimisation de l'appareil**  
Diffusez automatiquement les flux appropriés en fonction des capacités de l'appareil  
Exemple : les appareils mobiles obtiennent des débits inférieurs, les appareils intelligents TVs obtiennent une meilleure qualité

**Gestion de la bande passante**  
Limitez la qualité des flux pendant les périodes de pointe pour gérer les coûts du réseau  
Exemple : réduire le débit maximal lors d'événements à fort trafic

**Contenu régional**  
Diffusez différentes langues audio ou variantes de contenu en fonction de la localisation du spectateur  
Exemple : filtrer automatiquement les pistes audio en langue locale

Pour plus d'informations sur les concepts de filtrage des manifestes, consultez la section [Filtrage des manifestes](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) dans le guide de AWS Elemental MediaPackage l'utilisateur.

## Configurez votre CDN pour le filtrage des manifestes
<a name="cdn-filtering-configuration"></a>

La configuration du CDN pour le filtrage des manifestes est essentielle car votre CDN doit transmettre le paramètre de `aws.manifestfilter` requête MediaPackage pour que le filtrage fonctionne. Sans un transfert de chaîne de requête approprié, les paramètres du filtre seront supprimés par le CDN, et tous les spectateurs recevront des manifestes non filtrés, quels que soient leur niveau d'abonnement ou les capacités de leur appareil. Cette configuration garantit que votre logique de filtrage atteint MediaPackage et fonctionne comme prévu.

Pour activer le filtrage des manifestes via votre CDN, vous devez configurer le transfert des chaînes de requête :

1. Dans votre CloudFront distribution, créez ou modifiez le comportement du cache pour les demandes de manifeste.

1. Pour la **politique de cache,** créez une nouvelle politique ou modifiez une politique existante.

1. Sous **Paramètres des clés de cache**, choisissez « Inclure les chaînes de requête spécifiées ».

1. Ajoutez `aws.manifestfilter` à la liste des chaînes de requête autorisées.

1. Si vous utilisez également d'autres MediaPackage fonctionnalités, ajoutez leurs paramètres de requête :
   + `start`et `end` - Pour une visualisation décalée dans le temps
   + `time_delay`- Pour la fonctionnalité de temporisation
   + `_HLS_msn`et `_HLS_part` - Pour LL-HLS

Pour plus d'informations sur la création de distributions, consultez la section [Créer une distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le guide du CloudFront développeur Amazon.

## Mettre en œuvre le filtrage côté client
<a name="client-side-filtering-implementation"></a>

L'implémentation côté client vous permet de définir la manière dont vos lecteurs vidéo et vos applications demandent le contenu filtré. Cette configuration détermine le contenu que chaque spectateur reçoit en fonction de son niveau d'abonnement, des capacités de l'appareil ou d'autres critères. Une mise en œuvre appropriée garantit que les utilisateurs ne reçoivent que le contenu auquel ils devraient avoir accès, tout en maintenant une efficacité optimale du cache du CDN.

Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo et applications, procédez comme suit :

### Comment fonctionne le filtrage
<a name="filtering-workflow"></a>

Le processus de filtrage fonctionne comme suit :

1. Votre lecteur vidéo ou votre application demande une URL de manifeste qui inclut les paramètres de filtre

1. Le CDN transmet la demande (y compris les paramètres de requête) à MediaTailor

1. MediaTailor transmet les paramètres du filtre MediaPackage lors de la demande du manifeste d'origine

1. MediaPackage applique les filtres et renvoie un manifeste personnalisé contenant uniquement les variantes correspondant à vos critères

1. MediaTailor traite le manifeste filtré pour l'insertion de publicités et le renvoie au lecteur

### Format d'URL pour le filtrage
<a name="filtering-url-format"></a>

Comprendre le format d'URL correct est essentiel pour une mise en œuvre réussie du filtrage. Un formatage d'URL incorrect entraînera l'ignorance des paramètres de filtrage ou provoquera des erreurs HTTP. La structure de l'URL doit inclure les paramètres de filtre sous forme de chaînes de requête vers MediaPackage lesquelles votre CDN transmet. Procédez comme suit pour implémenter un formatage d'URL approprié :

Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo, procédez comme suit :

1. Modifiez la demande de manifeste de votre joueur URLs pour inclure les paramètres de filtre appropriés.

1. Utilisez le format d'URL suivant avec les paramètres de requête :

   ```
   https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
   ```

1. Lorsque votre joueur demande cette URL, il MediaTailor transmet ces paramètres à MediaPackage, ce qui donne lieu à un manifeste filtré.

## Scénarios de filtrage courants
<a name="filtering-examples"></a>

Utilisez ces exemples pour implémenter des scénarios de filtrage courants :

**Diffusion de contenu spécifique à l'appareil**  
Pour filtrer en fonction des capacités de l'appareil, ajoutez ce paramètre à votre demande de manifeste :  

```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Cet exemple limite le contenu à la vidéo et à l'audio H.264 avec des fréquences d'échantillonnage allant jusqu'à 44,1 kHz, adaptées aux appareils mobiles.

**Restriction relative au contenu premium**  
Pour limiter l'accès au contenu à haut débit, ajoutez ce paramètre à votre demande de manifeste :  

```
aws.manifestfilter=video_bitrate:0-9000000
```
Cet exemple limite les débits vidéo à 9 Mbits/s ou moins, ce qui convient aux niveaux d'abonnement de base.

**Sélection de la langue**  
Pour filtrer des langues audio spécifiques, ajoutez ce paramètre à votre demande de manifeste :  

```
aws.manifestfilter=audio_language:fr,en-US,de
```
Cet exemple inclut uniquement les pistes audio en français, en anglais américain et en allemand.

**Ciblage par résolution**  
Pour filtrer en fonction de résolutions vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :  

```
aws.manifestfilter=video_height:240-360,720-1080
```
Cet exemple inclut les flux vidéo dont la hauteur est comprise entre 240 et 360 pixels et 720 à 1080 pixels, à l'exception des résolutions de milieu de gamme.

**Filtrage basé sur les codecs**  
Pour filtrer des codecs vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :  

```
aws.manifestfilter=video_codec:h264,h265
```
Cet exemple inclut uniquement les flux vidéo H.264 et H.265, à l'exclusion des autres codecs.

## Considérations et limites spéciales
<a name="filtering-considerations"></a>

Pour éviter les problèmes courants lors de la mise en œuvre du filtrage des manifestes :

### Limites techniques
<a name="technical-limitations"></a>
+ Pour les manifestes TS, utilisez des groupes de rendu audio pour éviter de supprimer les flux vidéo multiplexés avec des flux audio filtrés
+ Dans les manifestes TS et CMAF, le taux d'échantillonnage audio et le débit vidéo ne sont pas facilement visibles dans le manifeste à des fins de vérification
+ Les paramètres de demande ajoutés aux playlists ou aux segments multimédias entraîneront une erreur HTTP 400

### Conditions d'erreur
<a name="error-conditions"></a>
+ Si le filtrage aboutit à un manifeste vide (aucun flux ne répond aux critères du filtre), une erreur HTTP 400 MediaPackage sera renvoyée
+ Des configurations de filtre conflictuelles (filtres de point de terminaison et paramètres de requête) entraînent des erreurs HTTP 404
+ Une syntaxe de filtre non valide ou des types de filtres non pris en charge entraînent des erreurs HTTP 400

### Considérations sur les performances
<a name="performance-considerations"></a>
+ Chaque combinaison de filtres unique crée une entrée de cache distincte, ce qui peut réduire l'efficacité du cache
+ Des filtres complexes comportant de nombreux critères peuvent avoir un impact sur les performances de génération de manifestes
+ Envisagez d'utiliser des filtres au niveau du point de terminaison pour les scénarios de filtrage statique afin d'améliorer les performances du cache

## Testez votre implémentation de filtrage
<a name="filtering-testing"></a>

Il est essentiel de tester votre mise en œuvre du filtrage des manifestes pour garantir que les spectateurs reçoivent le contenu approprié en fonction de leur niveau d'accès et des capacités de leur appareil. L'échec du filtrage peut se traduire par des niveaux de qualité incorrects, des formats non pris en charge ou des contenus auxquels ils ne devraient pas avoir accès. Des tests complets permettent d'identifier et de résoudre ces problèmes avant qu'ils n'affectent vos spectateurs.

Pour vérifier que le filtrage des manifestes fonctionne correctement, procédez comme suit :

1. Demandez des manifestes avec différents paramètres de filtre et vérifiez les résultats

1. Vérifiez que les manifestes filtrés contiennent uniquement les flux attendus

1. Testez les cas extrêmes (résultats vides, filtres non valides) pour garantir une gestion appropriée des erreurs

1. Vérifiez que votre CDN transmet correctement les paramètres du filtre

1. Testez avec différents appareils et lecteurs pour garantir la compatibilité

Pour résoudre les problèmes de filtrage, consultez *Résoudre les problèmes d'intégration du MediaPackage CDN.*

Si vous rencontrez des erreurs HTTP 400, des manifestes vides ou des paramètres de filtrage qui ne fonctionnent pas comme prévu, consultez des conseils spécifiques de résolution [Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md) des problèmes liés au filtrage des manifestes.

# Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage
<a name="cdn-emp-caching"></a>

AWS Elemental MediaTailor nécessite une configuration de mise en cache appropriée du réseau de diffusion de contenu (CDN) pour des performances optimales lorsque vous l'utilisez AWS Elemental MediaPackage comme origine de contenu. MediaPackage fournit des en-têtes de contrôle de cache spécifiques qui indiquent à votre réseau de diffusion de contenu la durée pendant laquelle les différents types de contenu doivent être mis en cache. Le respect de ces recommandations garantit une lecture fluide et une diffusion efficace du contenu.

Cette rubrique se concentre spécifiquement sur l'optimisation du comportement de mise en cache afin d'optimiser les performances et de minimiser les coûts. Avant de mettre en œuvre l'optimisation avancée de la mise en cache, assurez-vous d'avoir terminé la configuration de base de l'intégration du réseau de diffusion de contenu. Si vous n'avez pas encore configuré votre intégration de base, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md).

## MediaPackage en-têtes de contrôle du cache
<a name="emp-cache-control-headers"></a>

MediaPackage définit des valeurs TTL spécifiques pour différents types de contenu afin d'optimiser le comportement de mise en cache :

**Listes de lecture multivariantes (HLS et LL-HLS)**  
TTL : la moitié de la durée des segments médiatiques  
Raison : ces playlists changent à mesure que de nouveaux segments sont disponibles. Elles nécessitent donc des mises à jour fréquentes

**Listes de lecture multimédia (HLS standard)**  
TTL : la moitié de la durée des segments médiatiques  
Raison : Comme les playlists multivariantes, elles sont mises à jour au fur et à mesure que le contenu progresse

**Listes de lecture multimédia (LL-HLS)**  
TTL : 1 seconde  
Raison : le streaming à faible latence nécessite des mises à jour très fréquentes

**Segments multimédias et segments d'initialisation TS**  
TTL : 1209600 secondes (14 jours)  
Raison : les segments multimédias ne changent pas une fois créés, ils peuvent donc être mis en cache pendant de longues périodes

**Segments multimédias et segments d'initialisation CMAF**  
TTL : 1209600 secondes (14 jours)  
Raison : comme les segments TS, ils sont immuables une fois créés

Pour obtenir des recommandations TTL complètes pour tous les MediaTailor flux de travail et des stratégies supplémentaires d'optimisation de la mise en cache, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

## Configurer les politiques de cache du CDN
<a name="cdn-cache-policy-configuration"></a>

Une configuration correcte des politiques de cache est essentielle pour des performances et une rentabilité optimales. Les différents types de contenu (manifestes, segments, fichiers d'initialisation) ont des exigences de mise en cache différentes. L'utilisation de comportements de cache distincts vous permet d'optimiser la mise en cache pour chaque type de contenu, d'améliorer les taux de réussite du cache et de réduire la charge d'origine. Sans politiques de cache appropriées, vous risquez de rencontrer des demandes d'origine inutiles, d'augmenter les coûts et de réduire les performances de lecture.

Pour respecter correctement les en-têtes de MediaPackage contrôle du cache et optimiser la mise en cache :

1. Ouvrez vos paramètres CloudFront de distribution dans la CloudFront console.

1. Créez des comportements de cache distincts pour les différents types de contenu :
   + Demandes de manifeste (\$1.m3u8, \$1.mpd)
   + Segments multimédias (\$1.ts, \$1.mp4, \$1.m4s)
   + Segments d'initialisation

1. Pour chaque comportement de cache, créez ou sélectionnez une politique de cache avec les paramètres suivants :
   + Activer l'option « Origin Cache-Control Headers »
   + Définissez la « politique de demande d'origine » pour transférer les en-têtes nécessaires
   + Configurer le transfert de chaîne de requête en fonction du type de contenu

### Comportement du cache du manifeste
<a name="manifest-cache-behavior"></a>

Pour les demandes de manifeste (\$1.m3u8, \$1.mpd) :
+ **Modèle de chemin** : \$1.m3u8 et\$1.mpd
+ **Politique de cache** : Honor Origin Cache-Control Headers
+ **Chaînes de requête** : Transférer des paramètres spécifiques (voir[Optimisation du transfert de chaînes de requêtes](#cdn-query-string-optimization))
+ **En-têtes** : Transférer tous les en-têtes (pour les exigences minimales, voir) [En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers)

### Comportement du cache des segments multimédias
<a name="segment-cache-behavior"></a>

Pour les segments multimédias (\$1.ts, \$1.mp4, \$1.m4s) :
+ **Modèle de chemin** : \$1.ts, \$1.mp4, \$1.m4s
+ **Politique de cache** : en-têtes de contrôle du cache Honor Origin (TTL de 14 jours)
+ **Chaînes de requête** : aucune (les segments n'utilisent pas les paramètres de requête)
+ **Compression** : activez pour améliorer les performances de diffusion

## Optimisation du transfert de chaînes de requêtes
<a name="cdn-query-string-optimization"></a>

L'optimisation des chaînes de requête est essentielle à l'efficacité du cache, car des paramètres de requête inutiles créent plusieurs variations de cache pour le même contenu. Chaque combinaison unique de paramètres de requête crée une entrée de cache distincte, ce qui réduit le taux de réussite du cache et augmente le nombre de demandes d'origine. En transférant uniquement les chaînes de requête MediaPackage réellement utilisées, vous optimisez l'efficacité du cache tout en conservant toutes les fonctionnalités.

Configurez votre CDN pour transférer uniquement les chaînes de requête MediaPackage utilisées, améliorant ainsi l'efficacité du cache :

**Chaînes de requête essentielles**  
`start`et `end` - Pour les fenêtres de visualisation décalées dans le temps  
`time_delay`- Pour appliquer un délai au contenu du manifeste  
`_HLS_msn`,`_HLS_m`, et `_HLS_part` - Pour les demandes de lecture LL-HLS

**Chaînes de requête spécifiques aux fonctionnalités**  
`aws.manifestfilter`- Pour le [filtrage des manifestes](cdn-emp-manifest-filtering.md)

**Important**  
N'incluez aucune autre chaîne de requête dans votre clé de cache. MediaPackage ignore les paramètres non reconnus et leur inclusion réduit l'efficacité du cache en créant des variations inutiles du cache.

## Techniques d'optimisation des performances
<a name="cache-performance-optimization"></a>

Ces optimisations sont configurées sur votre CDN (par exemple CloudFront), et non dans ou. MediaPackage MediaTailor Implémentez ces optimisations supplémentaires pour optimiser les performances du cache :

### Bouclier Origin
<a name="origin-shield-configuration"></a>

Origin Shield fournit une couche de mise en cache supplémentaire entre les emplacements périphériques et MediaPackage les points de terminaison de votre CDN. Cela permet de réduire le nombre de requêtes qui atteignent vos MediaPackage points de terminaison, ce qui peut améliorer les performances et réduire les coûts, en particulier lors de pics de trafic ou lorsque les taux d'accès au cache sont inférieurs aux niveaux optimaux. Origin Shield est particulièrement utile pour la diffusion en direct lorsque plusieurs sites périphériques peuvent demander le même contenu simultanément.

Activez Origin Shield pour réduire la charge sur vos MediaPackage terminaux :

1. Dans votre CloudFront distribution, activez Origin Shield pour votre MediaPackage origine.

1. Sélectionnez une région du bouclier d'origine proche de votre point de MediaPackage terminaison.

1. Cela crée une couche de mise en cache supplémentaire qui réduit les demandes à MediaPackage.

### Configuration de compression
<a name="compression-settings"></a>

Activez la compression pour les réponses textuelles :
+ Activer la compression pour les fichiers manifestes (\$1.m3u8, \$1.mpd)
+ Ne compressez pas les segments multimédia (déjà compressés)
+ Assurez-vous que tous les en-têtes sont transférés vers MediaPackage (pour les exigences minimales, voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers))

## Surveiller les performances du cache
<a name="cache-monitoring-metrics"></a>

Suivez ces indicateurs clés pour garantir des performances de cache optimales :

**Taux de réussite du cache**  
Objectif : 90 % ou plus pour les segments médiatiques, 70 % ou plus pour les manifestes  
De faibles ratios peuvent indiquer des paramètres TTL incorrects ou des paramètres de requête inutiles

**Volume de demandes d'origine**  
Surveillez les demandes qui atteignent les points de MediaPackage terminaison  
Des volumes élevés peuvent indiquer des problèmes de mise en cache

**Variations des clés du cache**  
Passez en revue les modèles de clés du cache pour identifier les variations inutiles  
Trop de variations réduisent l'efficacité du cache

Après avoir mis en œuvre ces optimisations du cache, configurez la surveillance pour suivre leur efficacité. Pour obtenir des conseils sur la surveillance des taux de réussite du cache, des modèles de demandes d'origine et d'autres indicateurs de performance clés, consultez[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md). Si vous observez des performances médiocres du cache ou des demandes d'origine inattendues, consultez [Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md) les étapes de résolution des problèmes.

# Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor
<a name="cdn-emp-monitoring"></a>

AWS Elemental MediaTailor nécessite une surveillance efficace pour maintenir des performances optimales de votre intégration AWS Elemental MediaPackage et de celle de votre réseau de diffusion de contenu (CDN). Cette rubrique fournit des conseils sur les indicateurs clés à suivre, les outils de surveillance à utiliser et la façon de configurer des alertes pour une détection proactive des problèmes.

Avant de configurer la surveillance, assurez-vous que votre intégration de base fonctionne correctement. Si vous n'avez pas terminé la configuration de base de l'intégration de votre réseau de diffusion de contenu, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md). Si vous devez résoudre les problèmes identifiés par le biais de la surveillance, consultez.. [Résolution des problèmes d'intégration au CDN](cdn-emp-troubleshooting.md)

## Indicateurs de performance clés
<a name="key-performance-metrics"></a>

Surveillez ces indicateurs essentiels pour garantir des performances optimales de votre intégration MediaPackage et de celle du CDN :

### Indicateurs de performance du CDN
<a name="cdn-metrics"></a>

Pour obtenir des indicateurs complets des performances du CDN, notamment les objectifs de taux de réussite du cache, la surveillance du volume des demandes d'origine et les tests de temps de réponse, consultez le [Benchmarks de performance pour le CDN et les intégrations MediaTailor](cdn-performance-benchmarks.md) guide d'optimisation du CDN.

Principales considérations spécifiques à l'EMP pour les métriques du CDN :

**En-têtes de contrôle du cache EMP**  
**Ce qu'il faut vérifier** : assurez-vous que votre CDN respecte les en-têtes de contrôle du cache d'EMP pour un comportement TTL optimal  
**Comportement attendu** : les différents types de contenu doivent avoir des durées de cache différentes en fonction des en-têtes de l'EMP  
Pour obtenir des instructions détaillées sur l'optimisation du cache EMP, consultez[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).

**Impact des paramètres de requête**  
**Éléments à surveiller : suivre l'**impact des paramètres de requête spécifiques à l'EMP sur l'efficacité du cache  
**Cible d'optimisation** : assurez-vous que seuls les paramètres de requête EMP nécessaires sont inclus dans les clés de cache

**Temps de réponse du CDN**  
**Éléments à surveiller** : suivez les temps de réponse pour les différents types de contenu (manifestes ou segments).  
**Valeurs cibles** :  
+ Contenu mis en cache : moins de 100 ms
+ Demandes d'origine : moins de 500 ms

### MediaPackage mesures de performance
<a name="emp-metrics"></a>

**Taux d'erreur**  
**Éléments à surveiller : surveillez** les taux d'erreur HTTP à la fois sur votre CDN et sur vos points de MediaPackage terminaison. Portez une attention particulière aux erreurs 4xx, qui peuvent indiquer des problèmes de configuration.  
**Codes d'erreur clés** :  
+ 400 erreurs : souvent liées à des problèmes de filtrage des manifestes
+ Erreurs 404 : cela peut indiquer des problèmes de routage ou de configuration
+ Erreurs 504 : problèmes de temporisation, en particulier avec LL-HLS

**Volume et modèles de demandes**  
**Éléments à surveiller** : suivez les modèles de demandes adressées aux MediaPackage terminaux afin d'identifier les tendances d'utilisation et les besoins en capacité.  
**Motifs à surveiller** :  
+ Heures de pointe d'utilisation
+ Répartition géographique des demandes
+ Distribution du type de contenu (en direct ou à la demande)

### Métriques de latence
<a name="latency-metrics"></a>

**End-to-end latence**  
**Éléments à surveiller** : pour les implémentations de LL-HLS, surveillez le temps de end-to-end latence entre l'ingestion du contenu et sa lecture par le lecteur. Une latence élevée peut indiquer des problèmes de configuration du CDN.  
**Valeurs cibles** :  
+ LL-HLS : moins de 3 secondes de latence glass-to-glass
+ HLS normal : moins de 30 secondes

**Heure de génération du manifeste**  
**Éléments à surveiller** : temps nécessaire MediaPackage à la génération des manifestes, en particulier lorsque le filtrage est appliqué.  
**Valeurs cibles** : moins de 200 ms pour la génération du manifeste

## Outils de surveillance et configuration
<a name="monitoring-tools"></a>

La mise en place d'outils de surveillance complets est essentielle pour maintenir des performances optimales et identifier rapidement les problèmes avant qu'ils n'affectent les spectateurs. Sans surveillance appropriée, la dégradation des performances, l'inefficacité du cache ou les problèmes d'intégration peuvent passer inaperçus jusqu'à ce que les spectateurs constatent une mauvaise qualité de lecture. La bonne configuration de surveillance offre une visibilité sur tous les aspects de votre intégration MediaPackage et de celle du CDN.

Utilisez ces services et outils AWS pour surveiller votre intégration MediaPackage et celle du CDN :

### Amazon CloudWatch
<a name="cloudwatch-monitoring"></a>

Amazon CloudWatch fournit la base pour surveiller votre intégration MediaPackage et celle du CDN en collectant et en stockant les métriques des deux services. Une CloudWatch configuration appropriée garantit que vous disposez des données nécessaires pour identifier les tendances en matière de performances, résoudre les problèmes et optimiser votre intégration. Sans CloudWatch indicateurs, vous manquerez de visibilité sur les performances du système et vous risquez de ne pas détecter les problèmes avant qu'ils ne deviennent critiques.

Configurez CloudWatch la surveillance pour une collecte complète de métriques :

1. **MediaPackage métriques** : activez CloudWatch les métriques pour vos MediaPackage terminaux afin de suivre les volumes de demandes, les taux d'erreur et les temps de réponse.

1. **Métriques du CDN** : configurez CloudWatch pour collecter des CloudFront métriques, notamment les taux de réussite du cache, le nombre de demandes d'origine et les taux d'erreur.

1. **Mesures personnalisées** : créez des statistiques personnalisées spécifiques à l'entreprise, KPIs telles que l'engagement des spectateurs ou la popularité du contenu.

### CloudWatch tableaux de bord
<a name="dashboard-setup"></a>

Créez des tableaux de bord complets pour visualiser vos indicateurs :

1. **Tableau de bord** général : indicateurs de haut niveau indiquant l'état général du système

1. Tableau de **bord des performances du CDN** : mesures détaillées du CDN, notamment les performances du cache et la distribution géographique

1. **MediaPackage tableau de bord des performances** : mesures MediaPackage spécifiques, notamment les modèles de demandes et les taux d'erreur

1. **Tableau de bord de End-to-end latence** : mesures de latence pour différents types de contenu et différentes régions

### Analyse du journal
<a name="log-analysis"></a>

Configurez l'analyse des journaux pour un dépannage détaillé :

1. **Journaux d'accès au CDN** : activez et analysez les journaux d'accès au CDN pour comprendre les modèles de demandes et identifier les problèmes

1. **MediaPackage CloudWatch journaux** : surveillez les MediaPackage journaux pour détecter les erreurs et les problèmes de performance

1. **Agrégation de journaux** : utilisez Amazon CloudWatch Logs Insights ou des outils tiers pour analyser les modèles de journaux

## Configurer des alertes et des notifications
<a name="alerting-setup"></a>

La configuration des alertes est essentielle à la détection et à la résolution proactives des problèmes. Sans alertes appropriées, les problèmes peuvent passer inaperçus jusqu'à ce qu'ils aient un impact significatif sur l'expérience des utilisateurs ou qu'ils entraînent des interruptions de service. Des alertes bien configurées vous aident à identifier et à résoudre les problèmes avant qu'ils n'affectent vos spectateurs, et à garantir que votre équipe est informée des problèmes critiques nécessitant une attention immédiate.

Configurez des alertes proactives pour identifier les problèmes avant qu'ils n'affectent les utilisateurs :

### Alertes critiques
<a name="critical-alerts"></a>

Configurez des alertes immédiates pour les problèmes critiques :
+ **Taux d'erreur élevés : alerte lorsque les taux** d'erreur 4xx ou 5xx dépassent 5 % sur une période de 5 minutes
+ **Diminution du taux d'accès** au cache : alerte lorsque le taux d'accès au cache tombe en dessous de 70 % pour les manifestes ou de 85 % pour les segments
+ **Latence élevée** : alerte lorsque la end-to-end latence dépasse les seuils cibles
+ Pics de **demandes d'origine** : alerte lorsque les demandes d'origine augmentent de plus de 50 % par rapport à la base de référence

### Alertes d'avertissement
<a name="warning-alerts"></a>

Configurez des alertes d'avertissement pour les tendances susceptibles d'indiquer l'apparition de problèmes :
+ Dégradation **progressive des performances** : alerte lorsque les temps de réponse augmentent de 20 % sur une période de 30 minutes
+ **Tendances en matière d'efficacité du cache** : alerte lorsque les taux d'accès au cache indiquent une tendance à la baisse au fil du temps
+ Modèles de **trafic inhabituels** : alerte en cas de modifications inattendues du volume des demandes ou de la distribution géographique

## Utiliser les données de surveillance pour l'optimisation
<a name="performance-optimization"></a>

Tirez parti des données de surveillance pour améliorer continuellement les performances :

### Évaluations régulières des performances
<a name="regular-reviews"></a>

1. **Examens hebdomadaires** : analysez les tendances de performance hebdomadaires et identifiez les opportunités d'optimisation

1. **Planification mensuelle de la capacité** : utilisez les modèles de trafic pour planifier les besoins en capacité et l'optimisation du CDN

1. **Révisions trimestrielles de l'architecture** : évaluez l'efficacité globale de l'architecture et identifiez les domaines à améliorer

### Actions d'optimisation courantes
<a name="optimization-actions"></a>

Sur la base des données de surveillance, considérez les actions d'optimisation suivantes :
+ **Ajustements de la politique de cache** : modifiez les valeurs TTL en fonction des modèles de mise à jour du contenu réels. Pour obtenir des conseils détaillés sur l'optimisation TTL, consultez[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).
+ **Optimisation géographique** : ajoutez des emplacements périphériques CDN dans les régions à fort trafic
+ **Optimisation des paramètres de requête** : supprimez les paramètres de requête inutiles qui fragmentent le cache
+ **Configuration du bouclier d'origine** : implémentez le bouclier d'origine dans les régions où le volume de demandes d'origine est élevé

Pour des instructions de surveillance détaillées spécifiques à MediaPackage, voir [Surveillance MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) dans le guide de MediaPackage l'utilisateur.

# Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor
<a name="cdn-emp-troubleshooting"></a>

AWS Elemental MediaTailor l'intégration au réseau de diffusion de contenu (CDN) AWS Elemental MediaPackage et le réseau de diffusion de contenu (CDN) peuvent rencontrer des problèmes courants qui affectent la lecture, la mise en cache ou d'autres fonctionnalités d'intégration. Utilisez ce guide lorsque vous rencontrez des problèmes de lecture, de mise en cache ou d'autres erreurs liées à l'intégration.

Pour obtenir des conseils complets sur le dépannage du CDN, notamment sur les problèmes de performances du cache universel, la résolution des erreurs HTTP, les procédures de test et les techniques de diagnostic applicables à toutes les MediaTailor implémentations, consultez. [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md) Cette section se concentre sur les exigences MediaPackage spécifiques en matière de dépannage.

Avant de résoudre le problème, assurez-vous d'avoir correctement effectué la configuration de base de l'intégration. Si vous n'avez pas encore configuré votre intégration ou si vous devez passer en revue les étapes de configuration, consultez[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md). Pour obtenir des conseils sur l'optimisation des performances du cache une fois les problèmes résolus, consultez[Mise en cache du CDN](cdn-emp-caching.md).

## Erreurs de filtrage manifestes
<a name="manifest-filtering-errors"></a>

Problèmes liés à la fonctionnalité de filtrage des MediaPackage manifestes, sur la base de conditions d'erreur documentées :

**Erreurs HTTP 400 avec filtrage des manifestes**  
**Symptômes : les** requêtes avec `aws.manifestfilter` paramètres renvoient une mauvaise demande HTTP 400  
**Causes validées (tirées de AWS la documentation)** :  
+ Les critères de filtrage donnent lieu à un manifeste vide (aucun flux ne correspond aux conditions du filtre)
+ Noms ou valeurs de paramètres de filtre non valides
+ Syntaxe de chaîne de requête mal formée
+ Paramètres de filtre dupliqués ou répétés
+ La chaîne de paramètres du filtre dépasse 1 024 caractères
+ Paramètres de requête appliqués aux playlists ou aux segments multimédias (non pris en charge)
**Solutions :**  

1. Vérifiez les paramètres de vos filtres pour vous assurer qu'ils correspondent aux flux de contenu disponibles. Si le filtrage n'aboutit à aucun flux correspondant, MediaPackage renvoie HTTP 400.

1. Validez la syntaxe du filtre par rapport aux noms de paramètres et aux formats de valeurs pris en charge.

1. Vérifiez qu'il n'y a pas de doublons dans votre chaîne de requête.

1. Assurez-vous que les paramètres du filtre ne sont appliqués qu'aux listes de lecture multivariantes, et non aux playlists ou aux segments multimédias.

1. Vérifiez que votre chaîne de paramètres totale est inférieure à 1 024 caractères.
**Référence** : [conditions d'erreur de filtrage du AWS Elemental MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

**Le filtrage des manifestes ne fonctionne pas (HTTP 200 mais aucun filtrage n'est appliqué)**  
**Symptômes : les** requêtes renvoient HTTP 200 mais le manifeste contient tous les flux au lieu d'un sous-ensemble filtré  
**Causes possibles :**  
+ Le CDN ne transmet pas le paramètre `aws.manifestfilter` de requête à MediaPackage
+ Paramètre de filtre introuvable dans les flux disponibles (renvoie un manifeste non filtré avec HTTP 200)
**Solutions :**  

1. Vérifiez que votre politique de cache CDN figure `aws.manifestfilter` dans la liste des chaînes de requête transférées.

1. Testez les paramètres du filtre directement par rapport aux MediaPackage points de terminaison (en contournant le CDN) pour vérifier qu'ils fonctionnent comme prévu.

1. Vérifiez que les valeurs des filtres correspondent aux caractéristiques réelles de vos flux de contenu.
**Référence** : [conditions d'erreur de filtrage du AWS Elemental MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## Procédures de diagnostic
<a name="validated-diagnostic-steps"></a>

Les procédures de diagnostic systématiques vous aident à identifier rapidement et efficacement la cause première des problèmes d'intégration. L'adoption d'une approche structurée évite de perdre du temps sur des hypothèses erronées et garantit que vous abordez le problème réel plutôt que les symptômes. Ces étapes de diagnostic fondées sur des preuves sont conçues pour isoler les problèmes et vous guider vers la solution appropriée.

Suivez ces étapes diagnostiques fondées sur des données probantes pour identifier les problèmes :

### Analyser les performances du cache
<a name="cache-performance-analysis"></a>

L'analyse des performances du cache est cruciale pour les intégrations EMP, car une faible efficacité du cache entraîne une augmentation de la charge d'origine, des coûts plus élevés et des problèmes de lecture potentiels.

Pour un dépannage complet des performances du cache, notamment une analyse du taux de réussite du cache, une optimisation des clés de cache et des étapes de diagnostic systématiques, consultez [Problèmes de performance du cache CDN](diagnose-performance-issues.md#cache-performance-troubleshooting) le guide de dépannage principal du CDN.

Considérations relatives au cache spécifiques à l'EMP :
+ **En-têtes de contrôle de cache EMP : vérifiez que votre CDN respecte les** en-têtes de contrôle de cache d'EMP plutôt que de les remplacer
+ Paramètres de **requête EMP : assurez-vous que seuls les paramètres** de requête EMP nécessaires sont inclus dans les clés de cache
+ **Comportement TTL EMP** : vérifiez que les différents types de contenu EMP ont des durées de cache appropriées

Pour obtenir des instructions détaillées sur l'optimisation des politiques de cache EMP et des paramètres TTL, consultez. [Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md)

### Valider la configuration du filtrage du manifeste
<a name="manifest-filtering-validation"></a>

La validation du filtrage des manifestes est essentielle, car les problèmes de filtrage peuvent entraîner la réception de contenus incorrects, de formats non pris en charge ou de contenus auxquels ils ne devraient pas avoir accès. Les tests systématiques permettent de déterminer si les problèmes sont liés à la configuration du CDN, à la syntaxe des paramètres de filtre ou à la disponibilité du contenu.

Testez systématiquement la fonctionnalité de filtrage des manifestes :

1. Testez les paramètres du filtre directement par rapport aux MediaPackage points de terminaison (en contournant le CDN) pour vérifier qu'ils fonctionnent correctement.

1. Comparez les manifestes filtrés et non filtrés pour confirmer que les flux attendus sont inclus/exclus.

1. Vérifiez que votre politique de cache CDN transmet le paramètre de `aws.manifestfilter` requête.

1. Vérifiez les erreurs HTTP 400 et comparez-les aux conditions d'erreur documentées.

Si vous devez implémenter ou modifier le filtrage des manifestes après avoir résolu les problèmes, consultez [Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md) les instructions de configuration complètes.

### Valider la configuration des paramètres de requête
<a name="query-parameter-validation"></a>

Assurez-vous que votre CDN transmet uniquement les paramètres de requête requis :

1. Passez en revue votre politique de cache CDN pour vous assurer qu'elle inclut uniquement les paramètres AWS recommandés :
   + `aws.manifestfilter`- pour le filtrage des manifestes
   + `aws.manifestsettings`- pour une visualisation décalée dans le temps
   + `_HLS_msn`et `_HLS_part` - pour le support LL-HLS

1. Supprimez tous les autres paramètres de requête de votre clé de cache, car ils sont MediaPackage ignorés et réduisent l'efficacité du cache.

**Référence** : [Travailler avec AWS Elemental MediaPackage et CDNs](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)

## Référence du code d'erreur
<a name="documented-error-reference"></a>

Référence pour les conditions d'erreur documentées et leurs causes :

**Mauvaise requête HTTP 400 (filtrage des manifestes)**  
**Causes documentées** :  
+ L'application du filtre entraîne un manifeste vide
+ Noms ou valeurs de paramètres non valides
+ Syntaxe de chaîne de requête mal formée
+ Paramètres de filtre dupliqués
+ La chaîne de paramètres dépasse 1 024 caractères
+ Paramètres de requête sur des playlists ou des segments multimédias
**Référence** : [conditions d'erreur de filtrage du MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

**HTTP 200 OK (aucun filtrage appliqué)**  
**Causes documentées** :  
+ Paramètre de filtre introuvable dans les flux disponibles (renvoie un manifeste non filtré)
+ Seuls les flux de sous-titres sont présents après le filtrage (renvoie un manifeste non filtré)
**Référence** : [conditions d'erreur de filtrage du MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)

## Ressources supplémentaires pour la résolution des problèmes
<a name="additional-resources"></a>

Pour les questions non abordées dans cette rubrique, consultez les AWS ressources officielles suivantes :
+ [Prévisualisation d'un manifeste à partir de AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html) - Utiliser l'aperçu du manifeste pour résoudre les problèmes d'empaquetage de contenu
+ [Augmenter CloudFront le taux de réussite du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Guide complet sur l'optimisation du cache du CDN
+ [Filtrage des manifestes](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html) - Guide complet des fonctionnalités MediaPackage de filtrage

# Intégration AWS Elemental MediaTailor à Amazon CloudFront
<a name="cloudfront-specific-recommendations"></a>

AWS Elemental MediaTailor s'intègre à Amazon CloudFront pour améliorer les performances et la fiabilité de diffusion de contenu. CloudFront est un réseau de diffusion de contenu (CDN) qui distribue votre contenu par le biais d'un réseau mondial de centres de données appelés emplacements périphériques. Lorsque les internautes demandent votre contenu MediaTailor, CloudFront achemine les demandes vers l'emplacement périphérique le plus proche. Cette approche réduit le temps de latence et améliore les performances de vos spectateurs.

L'intégration MediaTailor avec CloudFront offre plusieurs avantages clés :
+ Temps de latence réduit pour les spectateurs qui accèdent à du contenu personnalisé
+ Évolutivité améliorée pour gérer un public de grande taille
+ Fiabilité accrue grâce à des voies de livraison redondantes
+ Optimisation des coûts grâce à des stratégies de mise en cache efficaces
+ Des fonctionnalités avancées telles que le basculement multirégional avec Media Quality-Aware Resiliency (MQAR)

Pour obtenir des informations complètes sur CloudFront les fonctionnalités, consultez le [guide du CloudFront développeur](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html). Pour plus d'informations sur la CloudFront tarification, consultez la section [CloudFront Tarification](https://aws.amazon.com/cloudfront/pricing/).

Par souci de concision, nous utilisons parfois des « manifestes » pour désigner collectivement des listes de lecture multivariantes, des listes de lecture multimédia et. MPDs

**Topics**
+ [CloudFront Configuration de base](cloudfront-basic-setup.md)
+ [Optimisation des performances](cloudfront-performance-optimization.md)
+ [Résilience multirégionale](media-quality-resiliency.md)
+ [Surveillance et résolution des problèmes](monitoring-and-troubleshooting.md)

# Configurez CloudFront l'intégration de base avec MediaTailor
<a name="cloudfront-basic-setup"></a>

AWS Elemental MediaTailor l'intégration avec Amazon CloudFront améliore les performances de diffusion de contenu pour vos spectateurs. Cette rubrique vous explique comment configurer une CloudFront distribution de base pour MediaTailor. Grâce à cette intégration, vos spectateurs peuvent accéder à du contenu personnalisé via le CloudFront réseau. Vous apprendrez également à configurer une mise en cache appropriée pour différents types de contenu.

Pour plus d'informations sur la transmission de paramètres de requête à CloudFront des fins d'autorisation et de routage, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). Pour un routage avancé à l'aide de variables dynamiques, voir[MediaTailor variables de domaine pour plusieurs sources de contenu](variables-domains.md).

## Conditions préalables
<a name="cf-basic-prerequisites"></a>

Avant de procéder CloudFront à la configuration avec MediaTailor, assurez-vous de disposer des éléments suivants :
+ Un AWS compte actif autorisé à créer et à gérer CloudFront des distributions
+ Une configuration MediaTailor de lecture configurée (voir[Utilisation AWS Elemental MediaTailor pour insérer des publicités](configurations.md))
+ Votre serveur d'origine de contenu correctement configuré et accessible
+ Compréhension de base des concepts de streaming vidéo (HLS/DASH)

## Configuration de CloudFront la distribution
<a name="cf-basic-configuration"></a>

Procédez comme suit pour créer et configurer une CloudFront distribution pour MediaTailor :

**Pour créer une CloudFront distribution pour MediaTailor**

1. Connectez-vous à la console AWS de gestion et ouvrez-la sur CloudFront [https://console.aws.amazon.com/cloudfront/v3/home](https://console.aws.amazon.com/cloudfront/v3/home).

1. Choisissez **Create Distribution**.

1. Pour le **domaine Origin**, entrez l'URL de votre MediaTailor point de terminaison (par exemple,`a1b2c3d4.mediatailor.us-west-2.amazonaws.com`).

1. Pour **Protocole**, sélectionnez **HTTPS uniquement**.

1. Dans **Nom**, entrez un nom qui vous aide à identifier cette origine (par exemple,`mediatailor-origin`).

1. Configurez les paramètres de comportement du cache par défaut :

   1. Pour **le modèle de chemin**, utilisez la valeur par défaut (`*`).

   1. Pour **compresser automatiquement les objets**, sélectionnez **Oui**.

   1. Pour la **politique du protocole Viewer**, sélectionnez **Rediriger le HTTP vers HTTPS**.

   1. Pour les **méthodes HTTP autorisées**, sélectionnez **GET, HEAD**.

   1. Pour la **politique de cache**, sélectionnez **CachingDisabled**.

   1. Pour la **politique de demande Origin**, sélectionnez **AllViewer**cette option pour transférer tous les en-têtes pour le comportement par défaut.
**Note**  
Le comportement par défaut permet AllViewer de gérer en toute sécurité tout contenu qui ne correspond pas à des modèles de chemin spécifiques. Les comportements de cache spécifiques pour les manifestes et les segments seront configurés séparément avec des politiques appropriées.

1. Configurez les paramètres de distribution :

   1. Pour la **catégorie de prix**, sélectionnez l'option qui correspond le mieux à la zone géographique de votre public.

   1. Pour l'**ACL AWS WAF Web**, sélectionnez une ACL Web existante ou laissez le champ **Ne pas activer les protections de sécurité**.

   1. Pour l'**objet racine par défaut**, laissez le champ vide.

   1. Pour la **journalisation standard**, sélectionnez **Activé** pour activer la journalisation.

1. Choisissez **Create Distribution**.

## Configuration des comportements du cache
<a name="cf-cache-behaviors"></a>

Après avoir créé votre distribution, vous devez configurer des comportements de cache supplémentaires pour gérer les différents types de contenu de manière appropriée. Cette section décrit la configuration de base du comportement du cache pour CloudFront.

Pour une optimisation complète de la mise en cache, y compris les paramètres TTL avancés, les configurations des clés de cache et le réglage des performances, consultez [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md) le guide d'optimisation du CDN.

### Configuration du comportement du cache du manifeste
<a name="cf-manifest-behavior"></a>

Ne mettez pas en cache les manifestes car ils contiennent du contenu personnalisé. Pour configurer le comportement du cache, procédez comme suit :

**Pour configurer le comportement du cache du manifeste**

1. Dans la CloudFront console, sélectionnez votre distribution.

1. Choisissez l’onglet **Comportements**.

1. Choisissez **Create behavior (Créer un comportement)**.

1. Dans le champ **Path pattern**, saisissez pour `*.m3u8` qu'il corresponde à des playlists HLS multivariantes et à des playlists multimédias.

1. Pour **Origin**, sélectionnez votre MediaTailor origine.

1. Pour la **politique de cache**, sélectionnez **CachingDisabled**.

1. Pour la **politique de demande Origin**, sélectionnez **AllViewer**cette option pour transférer tous les en-têtes requis pour le contenu dynamique.

1. Choisissez **Créer**.

1. Répétez ces étapes pour les manifestes DASH en utilisant le modèle `*.mpd` de chemin correspondant MPDs.

Cette configuration garantit que chaque spectateur reçoit un manifeste personnalisé avec son contenu publicitaire spécifique. Le CDN ne met pas ces manifestes en cache. Chaque demande est donc directement envoyée à MediaTailor.

### Configuration du comportement du cache de segments
<a name="cf-segment-behavior"></a>

Configurez des comportements de cache distincts pour les segments publicitaires et les segments de contenu afin d'optimiser les performances et de garantir une gestion appropriée du CORS.

#### Configuration du comportement du cache des segments publicitaires
<a name="cf-ad-segment-behavior"></a>

Les segments publicitaires diffusés selon le modèle de `/tm/*` chemin nécessitent une configuration spécifique pour gérer correctement le CORS. Procédez comme suit :

**Pour configurer le comportement du cache des segments publicitaires**

1. Dans la CloudFront console, sélectionnez votre distribution.

1. Choisissez l’onglet **Comportements**.

1. Choisissez **Create behavior (Créer un comportement)**.

1. Dans **le champ Path pattern**, saisissez `/tm/*` pour qu'il corresponde aux segments publicitaires diffusés par MediaTailor.

1. Pour **Origin**, sélectionnez l'origine de vos MediaTailor segments (en utilisant le `segments.mediatailor.region.amazonaws.com` nom d'hôte).

1. Pour la **politique de cache**, sélectionnez **CachingOptimized**.

1. Pour la **politique de demande d'origine**, sélectionnez **Aucune**.

1. Pour la **politique des en-têtes de réponse**, sélectionnez **CORS- with-preflight-and - SecurityHeadersPolicy** pour vous assurer que les en-têtes CORS appropriés sont inclus dans les réponses.

1. Choisissez **Créer**.

#### Configuration du comportement du cache des segments de contenu
<a name="cf-content-segment-behavior"></a>

Les segments de contenu peuvent utiliser des politiques de mise en cache standard pour des performances optimales. Configurez des comportements distincts pour les différents formats de segment :

**Pour configurer le comportement du cache des segments de contenu**

1. Dans la CloudFront console, sélectionnez votre distribution.

1. Choisissez l’onglet **Comportements**.

1. Choisissez **Create behavior (Créer un comportement)**.

1. Pour **le modèle de chemin**, entrez `*.ts` pour correspondre aux segments de contenu HLS.

1. Pour **Origin**, sélectionnez l'origine de votre contenu.

1. Pour la **politique de cache**, sélectionnez **CachingOptimized**.

1. Pour la **politique de demande d'origine**, sélectionnez **Aucune**.

1. Pour la **politique des en-têtes de réponse**, sélectionnez **CORS- with-preflight-and - SecurityHeadersPolicy** pour garantir une gestion CORS cohérente de tous les types de contenu.

1. Choisissez **Créer**.

1. Répétez ces étapes pour les autres formats de segments de contenu en utilisant les modèles de chemin appropriés :
   + `*.mp4`pour les MP4 segments
   + `*.m4s`pour les segments DASH
   + `*.cmfv`et `*.cmfa` pour les segments CMAF

Cette configuration garantit que les segments publicitaires et les segments de contenu sont mis en cache de manière appropriée avec une gestion CORS appropriée. Les segments publicitaires utilisent l'origine MediaTailor des segments avec une protection CORS, tandis que les segments de contenu utilisent votre origine de contenu avec des politiques de mise en cache optimisées.

## Mettre à jour MediaTailor la configuration
<a name="cf-mediatailor-config"></a>

Après avoir configuré votre CloudFront distribution, mettez à jour votre MediaTailor configuration pour utiliser le CloudFront domaine :

**Pour mettre à jour votre MediaTailor configuration**

1. Ouvrez la [MediaTailor console](https://console.aws.amazon.com/mediatailor/home).

1. Sélectionnez la configuration que vous souhaitez mettre à jour.

1. Dans la section **Configuration du CDN**, entrez le nom de votre domaine de CloudFront distribution (par exemple,`d1234abcdef.cloudfront.net`) dans le champ de **préfixe du segment de contenu CDN**.

1. Enregistrez vos modifications.

Avec cette configuration, MediaTailor génère des manifestes pointant vers votre CloudFront distribution plutôt URLs que directement vers l'origine.

## Tester votre intégration
<a name="cf-basic-testing"></a>

Après avoir configuré votre CloudFront distribution et mis à jour votre MediaTailor configuration, testez l'intégration :

**Pour tester votre MediaTailor intégration CloudFront et votre intégration**

1. Demandez un manifeste par le biais CloudFront de votre distribution (par exemple,`https://d1234abcdef.cloudfront.net/v1/master/12345/my-config/index.m3u8`).

1. Vérifiez que le manifeste contient un segment URLs qui pointe vers votre CloudFront domaine.

1. Diffusez le contenu via un lecteur vidéo et vérifiez que le contenu et les publicités s'affichent correctement.

1. Vérifiez les CloudFront journaux pour vous assurer que les demandes sont correctement acheminées.

## Exemple de configuration
<a name="cf-basic-example"></a>

Voici un exemple de configuration de CloudFront distribution MediaTailor avec des comportements de cache appropriés :

**Example CloudFront exemple de configuration de distribution**  

```
{
  "DefaultCacheBehavior": {
    "TargetOriginId": "mediatailor-origin",
    "ViewerProtocolPolicy": "redirect-to-https",
    "AllowedMethods": {
      "Quantity": 2,
      "Items": ["GET", "HEAD"]
    },
    "CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
    "OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
    "Comment": "Default behavior with CachingDisabled and AllViewer"
  },
  "CacheBehaviors": [
    {
      "PathPattern": "*.m3u8",
      "TargetOriginId": "mediatailor-origin",
      "ViewerProtocolPolicy": "redirect-to-https",
      "CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
      "OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
      "Comment": "Manifest behavior with CachingDisabled and AllViewer"
    },
    {
      "PathPattern": "*.ts",
      "TargetOriginId": "mediatailor-origin", 
      "ViewerProtocolPolicy": "redirect-to-https",
      "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e58f6",
      "OriginRequestPolicyId": "88a5eaf4-2fd4-4709-b370-b4c650ea3fcf",
      "Comment": "Segment behavior with CachingOptimized and HostHeaderOnly"
    }
  ]
}
```

Cet exemple montre :
+ **Comportement par défaut** : utilise `CachingDisabled` et `AllViewer` gère en toute sécurité tout contenu qui ne correspond pas à des modèles de chemin spécifiques
+ **Comportement du manifeste (\$1.m3u8)** : utilisations `CachingDisabled` et pour le contenu dynamique `AllViewer`
+ **Comportement du segment (\$1.ts)** : utilisations `CachingOptimized` et `CORS-with-preflight-and-SecurityHeadersPolicy`

## Étapes suivantes
<a name="cf-basic-next-steps"></a>

Après avoir configuré votre CloudFront intégration de base avec MediaTailor, considérez les étapes suivantes :
+ Optimisez les performances grâce à des CloudFront fonctionnalités supplémentaires (voir[Optimisation MediaTailor des performances grâce aux CloudFront fonctionnalités](cloudfront-performance-optimization.md))
+ Mettre en œuvre la résilience multirégionale avec MQAR (voir) [Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR](media-quality-resiliency.md)
+ Configurer la surveillance et le dépannage (voir[Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor](monitoring-and-troubleshooting.md))

# Optimisation MediaTailor des performances grâce aux CloudFront fonctionnalités
<a name="cloudfront-performance-optimization"></a>

AWS Elemental MediaTailor les performances avec Amazon CloudFront peuvent être améliorées grâce à des fonctionnalités supplémentaires allant au-delà de la configuration de base. Après avoir configuré votre CloudFront configuration de base avec MediaTailor, vous pouvez implémenter des fonctionnalités supplémentaires pour améliorer les performances, la fiabilité et les options de personnalisation. Ces optimisations contribuent à améliorer l'expérience visuelle. Ils réduisent également les coûts et la charge d'origine.

Pour l'optimisation des performances à l'aide du routage dynamique et de la gestion des paramètres, voir[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). Pour les stratégies d'optimisation des paramètres de requête, voir[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

## Réduction de la charge d'origine avec Origin Shield
<a name="origin-shield-integration"></a>

Origin Shield ajoute une couche de mise en cache entre les emplacements CloudFront périphériques et votre serveur d'origine. Cette fonctionnalité est utile pour la diffusion en direct et les contenus VOD populaires. Cela aide lorsque de nombreux spectateurs demandent le même contenu en même temps.

En consolidant les demandes provenant de plusieurs emplacements périphériques, Origin Shield réduit la charge de travail MediaTailor et l'origine de votre contenu.

**Pour activer Origin Shield pour votre MediaTailor origine**

1. Ouvrez la CloudFront console et accédez à votre distribution.

1. Sélectionnez l'origine qui pointe vers votre configuration MediaTailor de lecture.

1. Sous **Origin Shield**, sélectionnez **Oui**.

1. Dans le menu déroulant, sélectionnez la AWS région la plus proche de votre MediaTailor terminal.

1. Enregistrez vos modifications.

En cas d'événements à fort trafic, Origin Shield réduit considérablement la charge de requêtes sur votre serveur d'origine et améliore la fiabilité. Pour obtenir des instructions détaillées, consultez la section [Enabling Origin Shield](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html#enable-origin-shield) dans le guide du CloudFront développeur.

## Personnalisation de la diffusion de contenu avec Functions CloudFront
<a name="cloudfront-functions-integration"></a>

CloudFront Les fonctions vous permettent d'exécuter JavaScript du code léger à la périphérie pour modifier les demandes et les réponses des utilisateurs. Vous pouvez utiliser ces fonctions pour des personnalisations simples telles que les modifications d'URL, la manipulation d'en-têtes ou l'authentification de base. Pour les MediaTailor flux de travail, les fonctions facilitent les tâches qui ne nécessitent pas de traitement complexe.

CloudFront Les fonctions offrent un moyen léger de personnaliser la diffusion de contenu à la périphérie. Voici comment les implémenter dans le cadre de votre MediaTailor intégration :

**Pour implémenter CloudFront des fonctions pour MediaTailor**

1. Dans la CloudFront console, accédez à **Functions**.

1. Créez une nouvelle fonction et sélectionnez l'objectif approprié :
   + **Manipulation d'URL** : pour modifier une liste de lecture multivariante, une liste de lecture multimédia et une demande MPD URLs avant qu'elles n'atteignent MediaTailor
   + **Manipulation des en-têtes** : pour ajouter ou modifier des en-têtes de demande
   + **Authentification simple** : pour valider les jetons ou les paramètres de requête

1. Rédigez le code JavaScript de votre fonction.

1. Testez votre fonction à l'aide d'exemples de MediaTailor requêtes.

1. Publiez et associez la fonction au comportement du cache de votre distribution.

**Example Exemple de CloudFront fonction pour la normalisation des URL**  

```
function handler(event) {
    var request = event.request;
    var uri = request.uri;
    
    // Normalize URLs to lowercase to improve cache hit ratio
    if (uri.includes('.m3u8') || uri.includes('.mpd')) {
        request.uri = uri.toLowerCase();
    }
    
    return request;
}
```

Pour plus d'informations et des exemples de code, voir [Personnaliser en périphérie à l'aide CloudFront des fonctions](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-functions.html) dans le guide du CloudFront développeur.

## Implémentation de personnalisations avancées avec Lambda @Edge
<a name="lambda-edge-integration"></a>

Lorsque vous avez besoin de capacités de traitement plus complexes que celles CloudFront proposées par Functions, utilisez Lambda @Edge. Ce service vous permet d'exécuter des fonctions Node.js ou Python à des emplacements CloudFront périphériques.

Les fonctions Lambda @Edge peuvent effectuer des opérations sophistiquées telles qu'une authentification complexe, des modifications de réponse plus importantes ou des intégrations d'API tierces.

Pour des personnalisations plus complexes, utilisez les fonctions Lambda @Edge avec MediaTailor votre CloudFront intégration et :

**Pour implémenter Lambda @Edge avec MediaTailor**

1. Créez une fonction Lambda dans la région USA Est (Virginie du Nord).

1. Rédigez votre code de fonction pour l'un des cas d'utilisation suivants :
   + **Manipulation d'URL** : pour modifier une liste de lecture multivariante, une liste de lecture multimédia et une demande MPD URLs avant qu'elles n'atteignent MediaTailor
   + **Tests A/B** - Pour rediriger les utilisateurs vers différents serveurs de décision publicitaire
   + **Demande d'authentification** : pour ajouter des en-têtes d'authentification
   + **Modification de l'en-tête de réponse** - Pour ajouter des en-têtes CORS

1. Publiez une version de votre fonction et créez un alias de fonction.

1. Associez la fonction à votre CloudFront distribution au point de déclenchement approprié (demande ou réponse du spectateur).

**Note**  
Lorsque vous utilisez Lambda @Edge avec MediaTailor, évitez d'utiliser des déclencheurs orientés vers l'origine (demande d'origine et réponse d'origine) si vous prévoyez d'utiliser les fonctionnalités Media Quality-Aware Resiliency (MQAR), car elles sont actuellement incompatibles.

Pour plus d'informations et des exemples de code, voir [Personnaliser en périphérie à l'aide de Lambda @Edge](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/lambda-at-the-edge.html) dans le guide du CloudFront développeur.

## Conseils supplémentaires pour l'optimisation des performances
<a name="performance-optimization-tips"></a>

Envisagez ces optimisations supplémentaires pour améliorer encore les performances :

Optimisez les taux de réussite du cache  
Surveillez le taux de réussite de votre cache à l'aide de CloudFront métriques et recherchez des opportunités pour l'améliorer :  
+ Standardisez les modèles d'URL pour améliorer la cohérence des clés de cache
+ Utilisez la liste blanche des chaînes de requête pour inclure uniquement les paramètres nécessaires dans la clé de cache
+ Envisagez d'implémenter la normalisation des URL avec CloudFront Functions

Réduisez la latence  
Mettez en œuvre les techniques suivantes pour minimiser le temps de latence :  
+ Activer la compression Brotli pour les réponses basées sur du texte
+ Utilisez HTTP/2 ou HTTP/3 pour améliorer l'efficacité de la connexion
+ Envisagez d'activer IPv6 le support pour les réseaux modernes

Optimisation des coûts  
Trouvez le juste équilibre entre performance et rentabilité :  
+ Utilisez Origin Shield pour réduire les demandes d'origine redondantes
+ Envisagez de sélectionner une classe de prix en fonction de la géographie de votre public
+ Mettez en œuvre une mise en cache agressive pour les segments afin de réduire le trafic d'origine

## Étapes suivantes
<a name="performance-next-steps"></a>

Après avoir optimisé les performances grâce aux CloudFront fonctionnalités, considérez les étapes suivantes :
+ Mettre en œuvre la résilience multirégionale avec MQAR (voir) [Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR](media-quality-resiliency.md)
+ Configurer la surveillance et le dépannage (voir[Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor](monitoring-and-troubleshooting.md))

# Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR
<a name="media-quality-resiliency"></a>

AWS Elemental MediaTailor La résilience multirégionale est améliorée grâce à Media Quality-Aware Resiliency (MQAR), une CloudFront fonctionnalité avancée d'Amazon qui permet d' MediaTailoroffrir la meilleure expérience de streaming possible. Il sélectionne automatiquement l'origine ayant le meilleur score de qualité lorsque vous avez plusieurs origines dans différentes AWS régions. Cette fonctionnalité est particulièrement utile pour la diffusion en direct lorsque vous avez besoin d'un service ininterrompu.

## Comment fonctionne MQAR
<a name="mqar-overview"></a>

MQAR permet CloudFront de sélectionner automatiquement l'origine ayant le meilleur score de qualité. Cela garantit aux spectateurs la meilleure expérience de streaming possible. Lorsqu'il est correctement configuré, le MQAR offre les avantages suivants :
+ Sélection automatique de l'origine de la plus haute qualité
+ Basculement fluide entre les AWS régions en cas de panne
+ Expérience utilisateur améliorée avec un minimum d'interruptions
+ Surveillance et adaptation de la qualité en temps réel

## Étape 1 : vérifier les exigences MQAR
<a name="mqar-requirements"></a>

Avant de mettre en œuvre la MQAR, vérifiez que votre infrastructure répond à ces exigences. Le MQAR fonctionne en comparant les scores de qualité provenant de plusieurs origines. Vous avez donc besoin d'un contenu identique disponible dans plusieurs AWS régions.
+ Encodeurs envoyant des flux d'ingestion alignés à tous les MediaPackage canaux à l'aide de flux d'ingestion CMAF verrouillés par Epoch
+ Deux MediaPackage canaux identiques dans différentes AWS régions, avec des points de terminaison d'origine identiques
+ Ingestion CMAF pour les MediaPackage canaux (activée par défaut)
+ CloudFront distribution configurée pour prendre en charge la MQAR
+ MediaTailor configurations pour chaque MediaPackage point de terminaison

## Étape 2 : Configurez vos encodeurs pour MQAR
<a name="mqar-encoder-config"></a>

Vos encodeurs doivent produire des sorties cohérentes et synchronisées dans toutes les régions pour que la MQAR fonctionne efficacement. Cette cohérence permet d' CloudFront établir des comparaisons de qualité précises entre les origines.

Configurez vos MediaLive sorties avec les paramètres suivants :
+ Assurez-vous que toutes les fréquences d'images vidéo du groupe de sortie CMAF sont cohérentes (toutes les fréquences d'images fractionnaires ou toutes les fréquences d'images entières).
+ Évitez les transitions entre les fréquences d'images fractionnaires et entières au cours des sessions d'encodage.
+ Configurez les numéros de séquence des segments de sortie afin qu'ils ne reviennent jamais en arrière d'une session de codage à l'autre.
+ Utilisez des noms de sortie d'encodeur identiques dans toutes les régions.

Pour plus d'informations sur la configuration MediaLive pour MQAR, consultez la section Utilisation [de MQCS](https://docs.aws.amazon.com//medialive/latest/ug/mqcs.html) dans le guide de l' MediaLive utilisateur.

## Étape 3 : Configuration MediaPackage pour MQAR
<a name="mqar-mediapackage-config"></a>

Configurez vos MediaPackage chaînes et vos points de terminaison avec les configurations suivantes :

**Pour configurer MediaPackage pour MQAR**

1. Créez des configurations de canaux et de points de terminaison identiques dans chaque AWS région.

1. Utilisez CMAF comme type d'entrée de canal.

1. Pour l' MediaPackage origine principale, activez la configuration des **erreurs du point de terminaison Force** avec les paramètres suivants :
   + Listes de lecture multivariantes périmées, listes de lecture multimédia ou MPDs
   + Liste de lecture multivariante, liste de lecture multimédia ou MPD incomplète
   + Entrée Slate

1. Pour les MediaPackage origines de sauvegarde, n'activez pas ces configurations d'erreur afin de maximiser les chances de réussite du basculement.

Pour plus d'informations sur la configuration MediaPackage pour le MQAR, voir [Exploiter les scores de qualité multimédia AWS Elemental MediaPackageà l'aide](https://docs.aws.amazon.com//mediapackage/latest/userguide/mqcs.html) du guide de l' MediaPackage utilisateur.

## Étape 4 : Configuration CloudFront pour MQAR
<a name="mqar-cloudfront-config"></a>

Dans la CloudFront configuration, vous activez MQAR et définissez la manière dont il sélectionne vos origines. Créez un groupe d'origine avec l'option Media quality score activée.

**Pour configurer CloudFront pour MQAR**

1. Créez une CloudFront distribution dont les origines pointent vers vos MediaTailor points de terminaison.

1. Créez un groupe d'origine qui inclut ces origines.

1. Dans les paramètres du groupe d'origine, activez l'option **Niveau de qualité multimédia**.

1. Configurez les critères de basculement pour inclure les codes de réponse 404 Not Found. Vous pouvez éventuellement inclure d'autres codes 4xx/5xx.

1. Créez des comportements de cache distincts pour le modèle de chemin de chaque canal. Cela empêche le mélange de partitions lorsque le même groupe d'origine dessert plusieurs canaux.

**Note**  
MQAR n'est pas disponible lorsque vous utilisez les fonctions Lambda @Edge dans des déclencheurs orientés vers l'origine (demande d'origine et réponse d'origine) associés au comportement du cache de votre distribution.

Pour plus d'informations sur la configuration CloudFront pour MQAR, consultez la section [Résilience sensible à la qualité des médias](https://docs.aws.amazon.com//AmazonCloudFront/latest/DeveloperGuide/media-quality-score.html) dans le guide du développeur. CloudFront 

## Étape 5 : Configuration MediaTailor pour MQAR
<a name="mqar-mediatailor-config"></a>

Pour terminer votre configuration MQAR, configurez-la MediaTailor dans chaque région pour qu'elle fonctionne avec votre architecture multirégionale. Cela garantit une insertion publicitaire cohérente, quelle que soit l'origine CloudFront sélectionnée.

**Pour configurer MediaTailor pour MQAR**

1. Créez des MediaTailor configurations identiques dans chaque région, en pointant vers les MediaPackage points de terminaison correspondants.

1. Configurez le préfixe du segment de contenu CDN pour utiliser votre domaine de CloudFront distribution.

1. Assurez-vous que les configurations du serveur de décision publicitaire sont identiques d'une région à l'autre.

Cette configuration garantit que, quelle que soit l'origine CloudFront sélectionnée en fonction des scores de qualité, MediaTailor vous pouvez continuer à personnaliser les publicités de manière cohérente.

## Étape 6 : Testez votre configuration MQAR
<a name="mqar-testing"></a>

Après avoir configuré MQAR, testez votre configuration pour vous assurer qu'elle fonctionne comme prévu :

**Pour tester votre configuration MQAR**

1. Demandez du contenu par le biais CloudFront de votre distribution.

1. Surveillez les journaux en temps réel pour vérifier CloudFront que les origines sont sélectionnées en fonction des scores de qualité.

1. Simulez une panne dans votre AWS région principale pour tester le comportement du basculement.

1. Vérifiez que l'insertion d'annonces continue de fonctionner correctement pendant le basculement.

## Étapes suivantes
<a name="mqar-next-steps"></a>

Après avoir implémenté la MQAR, considérez les étapes suivantes :
+ Configurez la surveillance et le dépannage pour votre configuration MQAR (voir[Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor](monitoring-and-troubleshooting.md))
+ Mettre en œuvre un déploiement automatisé à l'aide de AWS CloudFormation (voir[Automatisez MediaTailor et créez un CDN avec CloudFormation](automating-cdn-integration.md))

# Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor
<a name="monitoring-and-troubleshooting"></a>

AWS Elemental MediaTailor l'intégration avec Amazon CloudFront nécessite une surveillance et un dépannage continus afin de maintenir des performances optimales. Après avoir implémenté votre MediaTailor intégration CloudFront et, surveillez les performances et préparez-vous à résoudre les problèmes éventuels. Le réseau de diffusion de contenu (CDN) fournit des outils qui vous aident à comprendre les performances de votre distribution et à identifier les problèmes potentiels.

## Configuration de la surveillance de votre intégration
<a name="cf-monitoring-setup"></a>

Mettez en œuvre ces stratégies de surveillance pour suivre les performances de votre MediaTailor intégration CloudFront et de votre intégration :

**Pour configurer la surveillance de votre MediaTailor intégration CloudFront et**

1. Activez CloudFront la journalisation standard :

   1. Dans la CloudFront console, sélectionnez votre distribution.

   1. Sélectionnez l'onglet **Logs (Journaux)**.

   1. Sous **Journaux standard**, choisissez **Modifier**.

   1. Sélectionnez **Activé** et configurez un compartiment Amazon S3 pour le stockage des journaux.

   1. Sélectionnez **Enregistrer les modifications**.

1. Configurez des journaux CloudFront en temps réel :

   1. Dans la CloudFront console, sélectionnez votre distribution.

   1. Sélectionnez l'onglet **Logs (Journaux)**.

   1. Sous **Journaux en temps réel**, choisissez **Modifier**.

   1. Sélectionnez **Activé** et configurez un flux de diffusion Amazon Kinesis Data Streams ou Amazon Data Firehose.

   1. Incluez les champs suivants dans la configuration de votre journal :
      + `time-to-first-byte`- Temps de réponse
      + `sc-status`- Code d'état HTTP
      + `c-ip`- Adresse IP du visualiseur
      + `cs-uri-stem`- Chemin de l'URI de demande
      + `cs-user-agent`- Agent utilisateur
      + `x-edge-result-type`- Type de résultat (Hit, Miss, Error)

   1. Sélectionnez **Enregistrer les modifications**.

1. Créez des CloudWatch tableaux de bord :

   1. Dans la CloudWatch console, sélectionnez **Tableaux de bord.**

   1. Choisissez **Create dashboard (Créer un tableau de bord)**.

   1. Ajoutez des widgets pour ces CloudFront statistiques :
      + Requêtes
      + BytesDownloaded
      + 4 xxErrorRate
      + 5 xxErrorRate
      + TotalErrorRate
      + CacheHitRate

1. Configurez les CloudWatch alarmes :

   1. Dans la CloudWatch console, sélectionnez **Alarmes**.

   1. Sélectionnez **Créer une alerte**.

   1. Créez des alarmes pour les conditions suivantes :
      + 5 xxErrorRate > 1 % pendant 5 minutes
      + 4 xxErrorRate supérieurs à 5 % pendant 5 minutes
      + CacheHitRate moins de 80 % pendant 30 minutes

## Surveillance des performances MQAR
<a name="mqar-monitoring"></a>

Lorsque vous utilisez le MQAR, le suivi vous aide à comprendre comment CloudFront choisir entre vos origines et à déterminer si les scores de qualité répondent aux attentes. Les journaux en temps réel indiquent ces décisions au fur et à mesure qu'elles se produisent.

**Pour surveiller les performances de la MQAR**

1. Activez les journaux en temps réel pour votre CloudFront distribution.

1. Incluez les champs suivants dans la configuration de votre journal :
   + `r-host`- Le nom d'hôte de l'origine sélectionnée
   + `sr-reason`- La raison du choix de l'origine
   + `x-edge-mqcs`- Le score de confiance en matière de qualité des médias

1. Configurez une destination de journal dans Amazon Kinesis Data Streams ou Amazon Data Firehose.

1. Créez des tableaux de bord ou des alertes basés sur ces indicateurs pour surveiller les scores de qualité et les décisions de sélection de l'origine.

**Example Exemple de CloudWatch tableau de bord pour la surveillance MQAR**  
Créez un CloudWatch tableau de bord avec les indicateurs suivants :  
+ Nombre de sélections d'origine par région
+ Scores de qualité moyens au fil du temps
+ Événements de basculement
+ Taux d'erreur 4xx et 5xx par origine

Pour plus d'informations sur la configuration des journaux en temps réel, consultez la section [Journaux en temps réel](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) du guide du CloudFront développeur.

## Dépannage des problèmes courants
<a name="troubleshooting-common-issues"></a>

Des problèmes peuvent survenir en ce qui concerne votre MediaTailor intégration CloudFront et celle de votre entreprise, même avec une planification minutieuse. La compréhension des problèmes courants et des solutions vous permet de résoudre les problèmes rapidement et de minimiser l'impact sur les spectateurs.

Si vous rencontrez des problèmes avec votre MediaTailor intégration CloudFront et votre intégration, consultez les problèmes et solutions courants suivants :

Problèmes de mise en cache des manifestes  
**Symptôme :** les manifestes périmés ou les publicités ne se mettent pas à jour  
**Solution :** vérifiez que vous utilisez la politique de `CachingDisabled` cache pour les listes de lecture multivariantes, les listes de lecture multimédia et les chemins MPD. Vérifiez que votre configuration transmet correctement les paramètres de requête.

Erreurs CORS  
**Symptôme :** la console du navigateur affiche des erreurs CORS lors de l'accès au contenu  
**Solution :** configurez une politique d'en-têtes de réponse avec les en-têtes CORS appropriés et associez-la au comportement de votre cache.

MQAR ne fonctionne pas  
**Symptôme :** la sélection de l'origine ignore les scores de qualité  
**Solution :** Vérifiez que vous avez activé l'option Niveau de qualité multimédia dans les paramètres de votre groupe d'origine. Vérifiez que vous n'utilisez pas de déclencheurs Lambda @Edge orientés vers l'origine.

Échec de l'insertion d'annonces  
**Symptôme :** les publicités ne s'insèrent pas correctement  
**Solution :** Vérifiez que votre MediaTailor configuration pointe vers votre CloudFront distribution pour le préfixe de segment de contenu. Vérifiez que votre configuration transmet tous les en-têtes requis.

Pour les problèmes plus complexes, vous pouvez utiliser les approches de résolution des problèmes suivantes :

1. Vérifiez les journaux CloudFront de distribution pour détecter les modèles d'erreur

1. Utiliser les outils de développement du navigateur pour inspecter les requêtes réseau

1. Comparez le contenu du manifeste MediaTailor directement par rapport au contenu diffusé via CloudFront

1. Testez avec un lecteur simple qui prend en charge la journalisation détaillée

Pour plus d'assistance en matière de dépannage, consultez la section [Dépannage](https://docs.aws.amazon.com//mediatailor/latest/ug/troubleshooting.html) du guide de MediaTailor l'utilisateur.

## Processus de résolution des problèmes
<a name="troubleshooting-workflow"></a>

Suivez cette approche systématique pour résoudre les problèmes liés à votre MediaTailor intégration CloudFront et à votre intégration :

**Pour résoudre les problèmes d' MediaTailor intégration CloudFront et de résolution des problèmes**

1. Identifiez le problème spécifique :

   1. Déterminez si le problème concerne tous les spectateurs ou seulement certains

   1. Identifiez les types de contenu concernés (manifestes, segments ou les deux)

   1. Notez les messages d'erreur ou les symptômes

1. Vérifiez CloudFront les journaux :

   1. Recherchez les codes d'état d'erreur (4xx ou 5xx)

   1. Vérifiez les hit/miss modèles de cache

   1. Vérifiez que les demandes sont acheminées vers la bonne origine

1. Vérifiez la configuration :

   1. Vérifiez les comportements du cache pour vérifier les modèles de chemin corrects

   1. Vérifiez que les politiques de cache sont correctement appliquées

   1. Vérifiez que les politiques de demande d'origine transfèrent les en-têtes nécessaires

1. Testez l'accès direct :

   1. Essayez d'accéder au contenu directement depuis MediaTailor (en contournant CloudFront)

   1. Comparez les réponses entre accès direct et CloudFront accès

1. Mettre en œuvre la solution :

   1. Appliquez le correctif approprié en fonction de vos résultats

   1. Testez pour vérifier que le problème est résolu

   1. Documentez le problème et sa solution pour référence future

## Étapes suivantes
<a name="monitoring-next-steps"></a>

Après avoir configuré la surveillance et le dépannage pour votre MediaTailor intégration CloudFront et votre intégration, considérez les étapes suivantes :
+ Mettre en œuvre un déploiement automatisé à l'aide de AWS CloudFormation (voir[Automatisez MediaTailor et créez un CDN avec CloudFormation](automating-cdn-integration.md))
+ Créez des runbooks pour les scénarios opérationnels courants et les procédures de dépannage
+ Configurez la correction automatique des problèmes courants

# Configurer un tiers CDNs pour la diffusion MediaTailor des publicités
<a name="cdn-provider-specific"></a>

 CDNs Des tiers tels qu'Akamai et Fastly peuvent améliorer de manière significative les performances et l'évolutivité de votre diffusion AWS Elemental MediaTailor publicitaire tout en réduisant les coûts de bande passante. Cependant, la configuration du CDN pour la publicité personnalisée nécessite des paramètres spécifiques différents de ceux de la diffusion vidéo standard.

Pour plus d'informations sur le transfert de paramètres de requête par le biais d'un tiers CDNs, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). Pour les configurations de routage avancées utilisant des variables dynamiques, voir[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md).

Ce guide vous explique tout au long du processus de configuration de votre CDN tiers pour qu'il fonctionne de manière optimale. MediaTailor Vous allez apprendre à configurer deux comportements essentiels :
+ **Contournement du manifeste :** garantit que chaque spectateur reçoit des insertions publicitaires personnalisées en empêchant la mise en cache du manifeste
+ **Mise en cache des segments :** optimise les performances et réduit les coûts en mettant en cache efficacement le contenu vidéo

Le processus de configuration prend généralement 30 à 60 minutes et inclut la sélection du fournisseur, la configuration, la vérification et l'optimisation. Une fois terminée, vous disposerez d'une configuration CDN qui diffusera des publicités personnalisées de manière efficace tout en garantissant une expérience utilisateur optimale.

**Note**  
Ce guide se concentre sur les configurations d'Akamai et de Fastly. Pour les instructions de CloudFront configuration, voir[intégration d’CloudFront](cloudfront-specific-recommendations.md).

## Conditions préalables
<a name="cdn-3p-prerequisites"></a>

Avant de configurer votre CDN tiers avec MediaTailor, assurez-vous d'avoir :
+ Une MediaTailor configuration active qui inclut l'origine de votre contenu et votre serveur de décision publicitaire
+ Accès à l'interface de configuration de votre CDN
+ Liste des extensions de fichier utilisées dans votre contenu (.m3u8, .mpd, .ts, etc.)
+ La documentation de votre fournisseur de CDN à titre de référence

Pour obtenir des instructions de CloudFront configuration plutôt que des instructions tierces CDNs, consultez[intégration d’CloudFront](cloudfront-specific-recommendations.md).

**Terminologie**  
Pour comprendre les exigences de configuration du CDN, vous devez connaître les types de manifestes suivants :
+ **Manifestes HLS :**
  + Liste de *lecture multivariée* : manifeste de niveau supérieur contenant des liens vers des listes de lecture multimédia
  + Liste de *lecture multimédia* : le manifeste de deuxième niveau contenant des liens vers des segments de contenu
+ **DASH manifeste** :
  + *MPD (Media Presentation Description)* : terme standard pour les manifestes DASH

Ce guide fait référence à tous les fichiers manifestes (listes de lecture multivariantes, listes de lecture multimédia, etc. MPDs) collectivement en tant que *manifestes* lorsqu'il traite des exigences de configuration communes.

Pour connaître les principes généraux de configuration du CDN applicables à tous les fournisseurs, consultez[Configurer l'intégration du CDN avec MediaTailor](cdn-configuration.md).

Pour obtenir des conseils sur l'optimisation du CDN, consultez[Guide d'optimisation des performances pour le CDN et MediaTailor les intégrations](cdn-optimization.md).

## Configurer les règles de mise en cache du CDN
<a name="3p-cdn-config"></a>

La configuration de la mise en cache du CDN est essentielle à la diffusion des MediaTailor publicités, car elle détermine la manière dont votre contenu atteint les spectateurs. Une configuration appropriée garantit que les manifestes restent personnalisés pour chaque utilisateur, tandis que les segments sont efficacement mis en cache afin de réduire la charge d'origine et d'améliorer les performances.

Cette configuration prend généralement 15 à 30 minutes par fournisseur de CDN et nécessite deux comportements distincts :
+ **Gestion des manifestes :** empêche la mise en cache pour garantir que chaque spectateur reçoit des insertions publicitaires personnalisées
+ **Mise en cache des segments :** optimise l'efficacité du cache pour le contenu vidéo afin d'améliorer les performances de diffusion

Suivez ces étapes pour configurer les règles de mise en cache de votre CDN pour une diffusion publicitaire optimale.

Choisissez votre fournisseur de CDN dans les onglets suivants pour obtenir des instructions spécifiques :

------
#### [ Akamai ]

Configurez ces deux comportements dans votre propriété Akamai :
+ Gestion des manifestes pour empêcher la mise en cache
+ Mise en cache des segments pour des performances optimales

**Configuration de la livraison du manifeste**  
Configurez votre CDN Akamai pour éviter de mettre en cache des manifestes afin que chaque utilisateur reçoive des publicités personnalisées.

Les fichiers manifestes contiennent les points d'insertion d'annonces personnalisés MediaTailor générés pour chaque spectateur. La mise en cache de ces fichiers permettrait à tous les spectateurs de voir des publicités identiques, ce qui irait à l'encontre de l'objectif de la publicité personnalisée.

Procédez comme suit pour les demandes de manifeste (fichiers se terminant par .m3u8, .mpd ou .smil) :

1. Créez un comportement correspondant aux extensions de fichier manifeste (.m3u8, .mpd, .smil)

1. Définir l'**option de mise en cache** sur **No Store**

1. Configurer les clés de cache pour inclure tous les paramètres de requête

1. Activez **l'en-tête Forward Host** pour un routage d'origine correct

1. Configurez le transfert d'en-têtes pour tous les en-têtes. Pour les exigences minimales, voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers).

**Configuration de la diffusion par segment**  
Configurez votre CDN Akamai pour mettre en cache les segments vidéo afin d'optimiser l'efficacité du CDN et de réduire la charge d'origine.

Les segments vidéo sont des fichiers de contenu réels qui peuvent être mis en cache en toute sécurité car ils ne contiennent pas d'informations personnalisées. Une mise en cache appropriée des segments réduit les coûts de bande passante et améliore les performances de lecture pour les spectateurs.

Procédez comme suit pour les demandes de segment (fichiers se terminant par .ts, .mp4, .m4s, etc.) : 

1. Créez un comportement correspondant aux extensions de fichiers de segment (.ts, .mp4, .m4s)

1. Réglez le **contrôle du cache Honor Origin** sur **Oui**

1. Configurez les paramètres par défaut time-to-live (TTL) lorsque les en-têtes d'origine sont manquants :
   + TTL par défaut : 86400 secondes (24 heures)
   + TTL maximum : 604800 secondes (7 jours)

**Note**  
Après avoir configuré ces comportements, activez les modifications de vos propriétés dans le centre de contrôle Akamai.  
Les modifications prennent effet après activation.

------
#### [ Fastly ]

Créez ces deux configurations dans votre service Fastly :
+ Gestion des manifestes pour empêcher la mise en cache
+ Mise en cache des segments pour des performances optimales

**Configuration de la livraison du manifeste**  
Configurez votre CDN Fastly pour contourner la mise en cache des fichiers manifestes afin que chaque spectateur reçoive un contenu publicitaire personnalisé.

Les fichiers manifestes doivent être accessibles MediaTailor pour chaque demande afin de garantir une personnalisation appropriée des annonces. Le contournement du cache pour ces fichiers garantit que les paramètres de ciblage uniques de chaque utilisateur sont traités correctement.

Pour les demandes de manifeste, procédez comme suit :

1. Création d'une condition de demande pour identifier les chemins du manifeste

1. Définissez la condition de cache sur **Ne pas mettre en cache** pour ces demandes

1. Configurer les **paramètres** de transfert pour inclure tous les paramètres de requête

1. Ajoutez `User-Agent` à votre configuration de transfert d'en-têtes

**Configuration de la diffusion par segment**  
Configurez votre CDN Fastly pour mettre en cache les segments vidéo afin d'améliorer les performances de diffusion et de réduire le trafic d'origine.

La mise en cache des segments est essentielle pour une diffusion rentable et une expérience utilisateur optimale. Ces fichiers sont identiques pour tous les utilisateurs et bénéficient considérablement de la mise en cache du CDN.

Pour les demandes de segment, procédez comme suit :

1. Création d'une condition de demande pour identifier les chemins de segment

1. Définissez **les paramètres du cache** pour **honorer les en-têtes du cache d'origine**

1. Configurer la valeur par défaut time-to-live (TTL) à 86 400 secondes (24 heures) lorsque les en-têtes d'origine sont manquants

**Note**  
Après avoir effectué ces modifications, activez une nouvelle version de votre service Fastly.  
La configuration prend effet après activation.

------

## Vérifiez la configuration de votre CDN
<a name="cdn-3p-verify"></a>

La vérification garantit que la configuration de votre CDN fonctionne correctement avant que vous n'y dirigiez le trafic de production. Ces tests confirment que la personnalisation des publicités fonctionne correctement et que la mise en cache apporte les avantages escomptés en termes de performances.

La vérification complète prend généralement 10 à 15 minutes et doit être effectuée à partir de plusieurs emplacements géographiques si possible.

Après avoir configuré votre CDN, effectuez les vérifications suivantes pour vérifier qu'il fonctionne correctement :

1. Personnalisation du manifeste de test :

   1. Demandez la même URL de contenu avec des paramètres publicitaires différents

   1. Vérifiez que chaque demande renvoie des insertions publicitaires différentes

1. Tester la mise en cache des segments :

   1. Vérifiez les métriques du CDN pour connaître le taux de réussite du cache de segments (il doit être supérieur à 90 %)

   1. Surveillez le trafic d'origine pour confirmer qu'il est inférieur à celui de la livraison directe

1. Testez les performances de lecture :

   1. Diffusez du contenu via votre CDN à partir de différents endroits

   1. Vérifiez la fluidité de la lecture sans aucun problème de mise en mémoire tampon

Pour des méthodologies de test complètes et des procédures de validation avancées, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md).

## Optimisez les performances du CDN
<a name="cdn-3p-optimize"></a>

Après avoir vérifié votre configuration de base, implémentez ces optimisations pour optimiser les performances et minimiser les coûts :

### Surveillez les indicateurs de performance clés
<a name="cdn-3p-optimize-monitoring"></a>

Suivez ces indicateurs pour garantir des performances optimales :

Taux de réussite du cache  
**Objectif :** plus de 90 % pour les segments vidéo  
**Conséquence :** des ratios plus élevés réduisent la charge d'origine et améliorent l'expérience utilisateur  
**Surveillance : consultez quotidiennement** le tableau de bord d'analyse de votre fournisseur de CDN

Temps de réponse d'origine  
**Objectif :** moins de 200 ms pour les demandes de manifeste  
**Conséquence : l'**accélération de la diffusion des manifestes réduit le temps de démarrage pour les utilisateurs  
**Surveillance :** configurez des alertes pour des temps de réponse supérieurs à 500 ms

Taux d'erreur  
**Objectif :** Moins de 0,1 % pour toutes les demandes  
**Conséquence :** les taux d'erreur élevés indiquent des problèmes de configuration ou d'origine.  
**Surveillance :** configurez des alertes pour les taux d'erreur supérieurs à 1 %

### Affiner le comportement de mise en cache
<a name="cdn-3p-optimize-tuning"></a>

Ajustez ces paramètres en fonction des caractéristiques de votre contenu et des habitudes d'audience :

Optimisation TTL des segments  
**Contenu en direct :** utilisez un TTL plus court (1 à 4 heures) pour garantir des mises à jour en temps opportun  
**Contenu VOD :** utilisez un TTL plus long (24 à 48 heures) pour optimiser l'efficacité du cache  
**Segments publicitaires :** envisagez une durée TTL plus courte (30 minutes à 2 heures) pour le contenu publicitaire fréquemment mis à jour  
Pour des recommandations TTL complètes et des stratégies de mise en cache pour tous les MediaTailor flux de travail, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

Optimisation géographique  
**Origines multirégionales :** configurez la sélection de l'origine en fonction de l'emplacement du spectateur  
**Emplacements périphériques :** activez des emplacements périphériques supplémentaires dans les régions à forte concentration de spectateurs  
**Failover :** configurer les origines des sauvegardes pour une haute disponibilité

### Optimisez les coûts
<a name="cdn-3p-optimize-cost"></a>

Mettez en œuvre ces stratégies pour réduire les coûts du CDN tout en maintenant les performances :
+ **Compression : activez la compression** gzip pour les fichiers manifestes afin de réduire l'utilisation de la bande passante
+ **Stratégie de purge :** mise en œuvre d'une purge sélective du cache au lieu d'une purge complète du cache
+ **Analyse du trafic : passez** en revue les modèles de trafic tous les mois pour identifier les opportunités d'optimisation
+ **Sélection du niveau :** utilisez les niveaux de service CDN appropriés en fonction de vos exigences de performance

## Résoudre les problèmes liés aux CDN tiers
<a name="cdn-3p-troubleshooting"></a>

Les problèmes de configuration du CDN se manifestent généralement par des problèmes de personnalisation des publicités ou par une dégradation des performances. Utilisez cette approche systématique pour identifier et résoudre les problèmes les plus courants qui affectent la diffusion des MediaTailor publicités.

La plupart des dépannages peuvent être effectués en 15 à 30 minutes en vérifiant les symptômes spécifiques et en appliquant les solutions correspondantes.

Si les spectateurs rencontrent des problèmes liés à la diffusion des publicités ou à la qualité de lecture, utilisez ce guide pour identifier et résoudre les problèmes courants de configuration du CDN :

Akamai : manifestes mis en cache  
**Symptôme :** les spectateurs voient des publicités identiques même lorsque vous configurez des paramètres de ciblage différents.  
**Solution :** Vérifiez que vous avez appliqué l'option de mise en cache **No Store** aux chemins du manifeste.  
Vérifiez également que vous avez inclus les paramètres de requête dans la clé de cache.

Rapidement : clés de cache incorrectes  
**Symptôme :** les spectateurs sont confrontés à une personnalisation incohérente des publicités.  
Les spectateurs peuvent également voir des publicités destinées à d'autres spectateurs.  
**Solution :** Vérifiez que vous avez configuré les paramètres **de** transfert pour inclure tous les paramètres de requête dans la clé de cache.

Généralités : trafic d'origine élevé  
**Symptôme :** le trafic de vos serveurs d'origine est étonnamment élevé  
**Solution :** vérifiez les paramètres de mise en cache des segments et les time-to-live valeurs (TTL).  
Vérifiez les taux de réussite du cache dans les statistiques de votre CDN.

Généralités : erreurs de lecture  
**Symptôme :** les spectateurs rencontrent des problèmes de mise en mémoire tampon ou de lecture  
**Solution :** vérifiez les règles de routage du CDN et l'état de l'origine.  
Vérifiez que tous les en-têtes requis sont correctement transférés.

**Note**  
Si ces solutions ne résolvent pas votre problème, consultez la documentation de votre fournisseur de CDN. Vous pouvez également contacter leur équipe d'assistance pour des étapes de dépannage supplémentaires.

Pour obtenir des conseils généraux de résolution des problèmes liés au CDN, consultez[Résoudre les problèmes liés à l'intégration MediaTailor du CDN](cdn-troubleshooting.md).

# Guide d'optimisation des performances pour le CDN et MediaTailor les intégrations
<a name="cdn-optimization"></a>

AWS Elemental MediaTailor les performances peuvent être maximisées grâce à l'optimisation systématique du réseau de diffusion de contenu (CDN). Que vous mettiez en œuvre l'insertion publicitaire côté serveur (SSAI), l'assemblage de canaux ou des flux de travail combinés, les principes d'optimisation et les objectifs de performance restent cohérents. Ce guide fournit des techniques d'optimisation complètes et des points de référence qui s'appliquent à toutes les MediaTailor implémentations.

Pour une optimisation avancée du routage à l'aide de variables dynamiques et d'alias de configuration, consultez[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md). Pour les stratégies d'optimisation des paramètres de requête, voir[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

**Présentation du flux de travail d'optimisation :**

1. **Configuration de la mise en cache** : définissez les valeurs TTL et les comportements de cache appropriés

1. **Optimisation du routage** : configurez le routage des demandes et les politiques d'origine

1. **Mesurer les performances** - Effectuer le suivi par rapport aux points de référence établis

1. **Appliquer des techniques avancées** - Implémenter des fonctionnalités d'optimisation supplémentaires

**Topics**
+ [Optimisation de la mise en cache](cdn-optimize-caching.md)
+ [Optimisation du routage des demandes](cdn-optimize-routing.md)
+ [Critères de performance](cdn-performance-benchmarks.md)
+ [Optimisation avancée](cdn-advanced-optimization.md)

# Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor
<a name="cdn-optimize-caching"></a>

AWS Elemental MediaTailor les exigences de mise en cache varient selon le type de flux de travail et le format de contenu. Une configuration de mise en cache appropriée est essentielle pour des performances, une rentabilité et une expérience utilisateur optimales. Les sections suivantes fournissent des conseils de mise en cache détaillés pour les différentes MediaTailor implémentations.

## Mise en cache d'insertion de publicités côté serveur (SSAI)
<a name="ssai-caching-optimization"></a>

Pour les flux de travail d'insertion d'annonces côté serveur, les manifestes personnalisés ne peuvent pas être mis en cache, mais le contenu et les segments publicitaires doivent être mis en cache de manière agressive :


**Paramètres de mise en cache SSAI CDN**  

| Type de contenu | TTL | Modèle de chemin | Éléments clés du cache | 
| --- | --- | --- | --- | 
| Listes de lecture multivariantes | 0 secondes | /v1/maître/ \$1 | Chemin d'URL \$1 tous les paramètres de requête | 
| Listes de lecture multimédia | 0 secondes | /v1/manifest/ \$1 | Chemin d'URL \$1 tous les paramètres de requête | 
| TABLEAU DE BORD MPDs | 0 secondes | /v1/dash/ \$1 | Chemin d'URL \$1 tous les paramètres de requête | 
| Segments de contenu | 24 heures et plus | Chemins spécifiques au contenu | Chemin d'URL uniquement | 
| Segments publicitaires | 24 heures et plus | /v1/segment/ \$1 | Chemin d'URL uniquement | 
+ Définissez un TTL de 0 seconde pour les manifestes personnalisés afin de garantir que les spectateurs reçoivent du contenu up-to-date publicitaire
+ Configurez des valeurs TTL plus longues pour le contenu et les segments publicitaires afin d'optimiser l'efficacité du cache
+ Configurez des comportements de cache qui incluent des paramètres de personnalisation dans la clé de cache si vous soutenez la publicité ciblée
+ Mettre en œuvre le regroupement des demandes au niveau du CDN pour gérer efficacement les demandes simultanées

### Paramètres de configuration TTL recommandés
<a name="ssai-ttl-configuration"></a>

Pour des performances SSAI optimales, configurez vos politiques de cache CDN avec ces paramètres TTL spécifiques :


**Paramètres de configuration TTL SSAI**  

| Type de contenu | Réglage TTL | Valeur recommandée | 
| --- | --- | --- | 
| Segments publicitaires | TTL minimum | 1 seconde | 
| Segments publicitaires | TTL maximal | 86400 secondes (24 heures) | 
| Segments publicitaires | TTL par défaut | 86400 secondes (24 heures) | 
| Segments de contenu | TTL minimum | 1 seconde | 
| Segments de contenu | TTL maximal | 86400 secondes (24 heures) | 
| Segments de contenu | TTL par défaut | 86400 secondes (24 heures) | 

Ces paramètres garantissent :
+ **TTL minimum de 1 seconde** : permet une invalidation rapide du cache en cas de besoin tout en évitant les demandes d'origine excessives
+ **TTL maximum de 24 heures** : équilibre l'efficacité du cache avec les exigences de fraîcheur du contenu
+ **TTL par défaut de 24 heures** : fournit une mise en cache optimale pour les segments qui n'ont pas d'en-têtes de contrôle de cache explicites

## Mise en cache d'insertion de publicités guidée par le serveur (SGAI)
<a name="sgai-caching-optimization"></a>

L'insertion publicitaire guidée par le serveur (SGAI) permet une mise en cache efficace du CDN grâce à des manifestes multimédias pouvant être mis en cache qui utilisent des modèles d'URL prévisibles. Cette section se concentre sur les exigences de configuration spécifiques au CDN pour des performances SGAI optimales.

### Configuration de la mise en cache du CDN pour SGAI
<a name="sgai-caching-configuration"></a>

Configurez votre CDN avec ces comportements de mise en cache spécifiques à SGAI :


**Paramètres de mise en cache du CDN SGAI**  

| Type de contenu | TTL | Modèle de chemin | Éléments clés du cache | 
| --- | --- | --- | --- | 
| Listes de lecture multivariantes SGAI (ne pas mettre en cache) | 0 secondes (ne pas mettre en cache) | /v1/maître/ \$1 | Chemin d'URL \$1 paramètres de requête sélectionnés | 
| Listes de lecture multimédia SGAI | 1 à 4 secondes (durée d'un demi-segment) | /v1/i-média/ \$1 | Chemin d'URL \$1 paramètres de requête sélectionnés | 
| Réponses aux listes d'actifs (ne pas mettre en cache) | 0 secondes (ne pas mettre en cache) | /v1/interstitiels/ \$1 | Chemin d'URL \$1 tous les paramètres de requête | 
| Segments publicitaires | 24 heures et plus | Chemins spécifiques à l'annonce | Chemin d'URL uniquement | 

### Configuration du comportement du cache
<a name="sgai-cache-behavior-setup"></a>

Configurez des comportements de cache dédiés pour le contenu SGAI :
+ Comportement du **manifeste SGAI - Créez un comportement** de cache pour les `/v1/i-media/*` chemins avec un TTL de 1 à 4 secondes
+ **Comportement de la liste d'actifs** - Créez un comportement de cache pour les `/v1/interstitials/*` chemins avec un TTL de 0 seconde
+ **Gestion des paramètres de requête** : incluez uniquement les paramètres de ciblage essentiels dans les clés de cache pour optimiser l'efficacité du cache
+ **En-têtes de demande Origin - Transférez les** en-têtes nécessaires au ciblage publicitaire tout en préservant la capacité de mise en cache

## Mise en cache des assemblages de canaux
<a name="channel-assembly-caching-optimization"></a>

Pour les flux de travail d'assemblage de canaux, les manifestes peuvent être mis en cache pendant de courtes périodes, tandis que les segments doivent être mis en cache de manière agressive :


**Paramètres de mise en cache du CDN d'assemblage de canaux**  

| Type de contenu | VOD TTL | TTL en direct | Modèle de chemin | Éléments clés du cache | 
| --- | --- | --- | --- | --- | 
| Listes de lecture multivariantes | 5 à 30 minutes | 5 à 10 secondes | Chemins spécifiques au canal | Chemin d'URL \$1 tous les paramètres de requête | 
| Listes de lecture multimédia | 5 à 30 minutes | 2 à 5 secondes | Chemins spécifiques au canal | Chemin d'URL \$1 tous les paramètres de requête | 
| TABLEAU DE BORD MPDs | 5 à 30 minutes | 5 à 10 secondes | Chemins spécifiques au canal | Chemin d'URL \$1 tous les paramètres de requête | 
| Segments de contenu | 24 heures et plus | 5 à 15 minutes | Chemins spécifiques au contenu | Chemin d'URL uniquement | 
| Segments publicitaires | 24 heures et plus | 24 heures et plus | Chemins spécifiques à l'annonce | Chemin d'URL uniquement | 
+ Définissez des valeurs TTL courtes pour les manifestes afin de garantir que les spectateurs reçoivent up-to-date la programmation
+ Configurez des valeurs TTL plus longues pour les segments de contenu afin d'optimiser l'efficacité du cache
+ Configurez des comportements de cache qui incluent des paramètres de décalage temporel dans la clé de cache si vous acceptez l'affichage décalé dans le temps
+ Incluez les paramètres de requête dans la clé de cache pour gérer correctement les demandes de visualisation décalées dans le temps

Pour connaître les paramètres de configuration TTL détaillés et les meilleures pratiques, consultez[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](#cdn-optimize-caching).

## Mise en cache combinée du SSAI et de l'assemblage des canaux
<a name="combined-workflow-caching"></a>

Lorsque vous implémentez à la fois l'assemblage des canaux et le SSAI, assurez-vous que votre stratégie de mise en cache est cohérente pour les deux services afin d'éviter les conflits et d'optimiser les performances :


**Comparaison des paramètres de mise en cache des flux de travail combinés**  

| Type de contenu | Assemblage du canal | SSAI | Recommandation combinée | 
| --- | --- | --- | --- | 
| Manifestes de VOD | 5 à 30 minutes | 0 secondes | (utilisez une configuration séparée) | 
| Manifestes en direct | 2 à 10 secondes | 0 secondes | (utilisez une configuration séparée) | 
| Manifestes VOD SGAI | 5 à 30 minutes | 5 à 30 minutes | 5 à 30 minutes (manifestes pouvant être mis en cache) | 
| Manifestes SGAI Live | 2 à 4 secondes | 2 à 4 secondes | 2 à 4 secondes (manifestes pouvant être mis en cache) | 
| Segments de contenu | 24 heures et plus | 24 heures et plus | 24 heures et plus (constant) | 
| Segments publicitaires | 24 heures et plus | 24 heures et plus | 24 heures et plus (constant) | 

Cette configuration maximise l'efficacité du cache tout en garantissant que les spectateurs reçoivent des up-to-date manifestes pour une insertion publicitaire personnalisée.

# Optimisation du routage des demandes pour le CDN et les MediaTailor intégrations
<a name="cdn-optimize-routing"></a>

Implémentez ces optimisations de routage pour toutes les intégrations de AWS Elemental MediaTailor CDN :
+ Créez des comportements de cache distincts pour les demandes de manifeste et de segment
+ Configurer les politiques de demande d'origine pour contrôler le transfert d'en-têtes
+ Mettre en place des mécanismes appropriés de gestion des erreurs et de basculement
+ Implémentez des boucliers d'origine, s'ils sont disponibles dans votre CDN, afin de réduire la charge d'origine
+ Mettre en œuvre le regroupement des demandes au niveau du CDN pour gérer efficacement les demandes simultanées

# Benchmarks de performance pour le CDN et les intégrations MediaTailor
<a name="cdn-performance-benchmarks"></a>

Lorsque vous optimisez l'intégration de votre AWS Elemental MediaTailor CDN, visez ces tests de performance. Ces objectifs s'appliquent à toutes les MediaTailor implémentations, y compris le SSAI, l'assemblage de canaux et les flux de travail combinés :

Objectifs relatifs au taux de réussite du cache  
Segments de contenu : taux d'accès au cache supérieur à 95 %  
Segments publicitaires : taux de réussite du cache supérieur à 90 %  
Manifestes : Non applicable pour le SSAI (ne doivent pas être mis en cache pour l'insertion d'annonces personnalisées) ; 85 % ou plus pour l'assemblage des chaînes

Repères de latence  
Latence des demandes de manifeste : moins de 100 ms (P95)  
Diffusion du segment de contenu : moins de 50 ms (P95)  
Diffusion du segment publicitaire : moins de 75 ms (P95)  
End-to-end temps de démarrage : moins de 2 secondes

Métriques de charge d'origine  
Demandes d'origine par téléspectateur : moins de 0,1 demande par minute et par téléspectateur  
Bande passante d'origine par spectateur : moins de 5 % de la bande passante totale du spectateur

Objectifs en matière de taux d'erreur  
Erreurs manifestes : moins de 0,1 %  
Erreurs de segment : moins de 0,01 %  
Rebuffering déclaré par le joueur : moins de 1 %

Benchmarks d'évolutivité  
Support d'un trafic 10 fois supérieur à la normale pendant les périodes de pointe, sans dégradation  
Capacité à traiter plus de 1 000 demandes par seconde et par canal

Utilisez CloudWatch les métriques Amazon pour suivre ces indicateurs de performance. Pour des instructions de surveillance détaillées, voir[Configuration des outils de surveillance](cdn-monitoring.md#cdn-monitor-tools-setup).

# Techniques d'optimisation avancées pour le CDN et MediaTailor les intégrations
<a name="cdn-advanced-optimization"></a>

Après avoir mis en œuvre les optimisations de base de la mise en cache et du routage, considérez les techniques avancées suivantes pour améliorer encore les performances :

## Implémentation d'Origin Shield
<a name="origin-shield-optimization"></a>

Origin Shield ajoute une couche de mise en cache entre les emplacements périphériques du CDN et votre serveur d'origine, réduisant ainsi la charge d'origine et améliorant les performances :
+ Activez Origin Shield pour les contenus à fort trafic et la diffusion en direct
+ Choisissez des agences Origin Shield proches de vos MediaTailor régions
+ Surveillez les taux de réussite du cache Origin Shield et ajustez-les si nécessaire
+ Envisagez plusieurs sites Origin Shield pour les déploiements internationaux

## Optimisation de la compression du contenu
<a name="compression-optimization"></a>

Optimisez la compression du contenu pour réduire la bande passante et améliorer la vitesse de diffusion :
+ Activer la compression gzip pour les fichiers manifestes
+ Configurer le transfert d'en-tête Accept-Encoding pour MediaTailor la compression du manifeste
+ Utilisez la compression Brotli lorsqu'elle est prise en charge pour économiser davantage de bande passante
+ Évitez de compresser des segments vidéo déjà compressés

## Stratégies d'optimisation régionales
<a name="regional-optimization"></a>

Optimisez les performances pour le public mondial grâce à des stratégies régionales :
+ Déployez des MediaTailor configurations dans plusieurs régions pour un public mondial
+ Utilisez le géo-routage pour diriger les spectateurs vers la région la plus proche MediaTailor 
+ Configurer le basculement régional pour une haute disponibilité
+ Surveillez les indicateurs de performance régionaux séparément

# Considérations relatives à l'architecture pour le CDN et les MediaTailor intégrations
<a name="cdn-architecture-considerations"></a>

Positionnez correctement votre réseau de diffusion de contenu (CDN) dans votre architecture afin de garantir des performances et une fiabilité optimales avec AWS Elemental MediaTailor. L'architecture recommandée place le CDN entre les spectateurs et MediaTailor non entre MediaTailor votre ordinateur d'origine.

Pour obtenir des diagrammes d'architecture détaillés et des explications sur le flux de travail, consultez les rubriques suivantes.
+ [Insertion d'annonces avec CDN](ssai-cdn-workflow.md)pour les diagrammes d'architecture d'insertion de publicités et le flux de travail détaillé
+ [Comprendre l'architecture du CDN](channel-assembly-cdn-architecture.md)pour l'assemblage des canaux, les schémas d'architecture et le flux de travail

Positionnez correctement votre CDN dans votre architecture :

1. Placez votre CDN entre les joueurs et MediaTailor (pas entre MediaTailor et votre origine).

   Cette architecture permet à votre CDN de mettre en cache des segments publicitaires et des segments de contenu. Dans le même temps, MediaTailor peut générer des manifestes personnalisés pour chaque spectateur.

1. Créez des comportements de cache distincts pour les différents types de demandes :
   + Demandes de manifeste (pas de mise en cache)
   + Segments de contenu (TTL plus long)
   + Segments publicitaires (TTL plus long)

1. Configurez la gestion appropriée des erreurs :
   + Configurez une mise en cache négative (stockage temporaire des réponses aux erreurs) pour éviter de surcharger votre source de demandes répétées lors d'interruptions de service. La mise en cache négative signifie que le CDN stockera temporairement les réponses aux erreurs (comme les erreurs 404 ou 500) afin d'éviter les demandes répétées de contenu qui n'existe pas ou qui est temporairement indisponible.
   + Configurer les codes de réponse aux erreurs appropriés et le comportement des nouvelles tentatives

1. Implémenter la mise en cache intermédiaire (bouclier d'origine) :

   Origin Shield est une fonctionnalité qui crée une couche de mise en cache supplémentaire entre les emplacements périphériques du CDN et votre serveur d'origine. Cela réduit le nombre de demandes redondantes qui atteignent votre serveur d'origine.
   + Configurer une couche de mise en cache intermédiaire entre les emplacements périphériques et votre origine
   + Réduisez le nombre de demandes redondantes adressées à votre source en cas d'échec du cache
   + Améliorez les taux de réussite du cache sur l'ensemble de votre infrastructure CDN

# Fonctionnalités CDN avancées pour MediaTailor
<a name="advanced-cdn-features"></a>

Après avoir implémenté la configuration de base du réseau de diffusion de contenu (CDN), explorez ces fonctionnalités avancées pour améliorer encore les performances et la fiabilité de votre plateforme de AWS Elemental MediaTailor streaming.

Routage adapté à la qualité des médias (MQAR)  
La MQAR est une CloudFront fonctionnalité d'Amazon qui sélectionne automatiquement la source de contenu de la plus haute qualité en fonction des indicateurs de performance du réseau en temps réel. Au lieu d'utiliser un serveur d'origine fixe, MQAR achemine les demandes de manière dynamique vers l'origine la plus performante en fonction de facteurs tels que la latence et le débit. Cela permet de garantir que les spectateurs reçoivent un flux de la meilleure qualité possible, même en cas de fluctuations du réseau.  
Si vous utilisez Amazon CloudFront, implémentez MQAR pour sélectionner automatiquement la source de contenu de la plus haute qualité en fonction de statistiques en temps réel. Pour plus de détails, consultez [intégration d’CloudFront](cloudfront-specific-recommendations.md) la section sur CloudFront l'intégration.

Filtrage des manifestes  
Le filtrage des manifestes vous permet de personnaliser les rendus (versions de qualité différente du même contenu) qui sont inclus dans les manifestes destinés MediaTailor aux spectateurs. Le filtrage permet d'optimiser l'utilisation de la bande passante en supprimant les rendus qui ne sont pas adaptés à certains appareils ou à certaines conditions du réseau. Par exemple, vous pouvez supprimer les rendus 4K pour les appareils mobiles ou les connexions à faible bande passante.  
Pour plus d'informations sur la mise en œuvre du filtrage des manifestes avec AWS Elemental MediaPackage, consultez[MediaPackage Intégration au CDN](mediapackage-integration.md).

Stratégie multi-CDN  
Une stratégie multi-CDN utilise plusieurs fournisseurs de CDN simultanément pour améliorer la fiabilité et les performances. Si un CDN rencontre des problèmes, le trafic peut automatiquement être transféré vers un autre fournisseur. Cette approche est particulièrement utile pour les événements en direct très médiatisés où la fiabilité est essentielle.  
Pour plus d'informations sur la mise en œuvre d'une stratégie multi-CDN avec MediaTailor, voir. [Planifier l'intégration du CDN](planning-cdn-integration.md)

# Surveillez les opérations et les performances du MediaTailor CDN
<a name="cdn-monitoring"></a>

Une surveillance efficace de votre intégration AWS Elemental MediaTailor et de celle de votre réseau de diffusion de contenu (CDN) garantit une diffusion de contenu fiable, des performances optimales et une détection rapide des problèmes. Cette approche de surveillance s'applique à toutes les MediaTailor implémentations, y compris l'insertion de publicités côté serveur (SSAI), l'assemblage de canaux et les flux de travail combinés.

Le suivi de l'intégration de votre CDN vous permet de :
+ Détectez et résolvez les problèmes avant qu'ils n'affectent les spectateurs
+ Suivez les indicateurs de performance clés et maintenez la qualité du service
+ Maintenir des performances de cache optimales et réduire la charge d'origine
+ Assurez-vous que les taux de réussite de l'insertion d'annonces répondent aux exigences de l'entreprise

Pour résoudre les problèmes liés aux paramètres qui peuvent apparaître dans les données de surveillance, voir. [MediaTailor guide de résolution des problèmes de paramètres](parameter-troubleshooting.md) Pour plus d'informations sur la surveillance de l'utilisation des paramètres de requête, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).

## Indicateurs de performance essentiels du CDN
<a name="cdn-monitor-essential-metrics"></a>

Suivez ces indicateurs de base pour évaluer l'efficacité de votre CDN lors des MediaTailor mises en œuvre :

Taux de réussite du cache  
**Ce qu'il mesure** : le pourcentage de demandes traitées depuis le cache du CDN par rapport à l'origine.  
**Valeurs cibles** :  
+ Segments de contenu : taux d'accès au cache de 95 % ou plus
+ Segments publicitaires : taux d'accès au cache de 90 % ou plus
+ Manifestes : varie selon l'implémentation (les manifestes personnalisés ne doivent pas être mis en cache)
**Pourquoi c'est important** : des taux d'accès au cache plus élevés réduisent la charge d'origine, améliorent les temps de réponse et réduisent les coûts de bande passante.

Volume de demandes d'origine  
**Ce qu'il mesure** : le nombre de demandes parvenant à vos serveurs MediaTailor d'origine.  
**Modèle cible** : devrait rester faible et stable, avec des pics occasionnels dus à des erreurs de cache ou à de nouveaux contenus.  
**Pourquoi c'est important : les** volumes élevés de demandes d'origine indiquent une inefficacité de la mise en cache et peuvent avoir un impact sur MediaTailor les performances.

Latence de réponse  
**Ce qu'il mesure** : la rapidité avec laquelle le CDN répond aux demandes des utilisateurs.  
**Valeurs cibles** :  
+ Contenu mis en cache : moins de 100 ms (P95)
+ Demandes d'origine : moins de 500 ms (P95)
+ Demandes de manifeste : moins de 100 ms (P95)
+ Demandes de segment : moins de 50 ms (P95)
**Pourquoi c'est important** : la faible latence garantit une lecture fluide et une bonne expérience utilisateur.

Taux d'erreur  
**Ce qu'il mesure** : le pourcentage de demandes qui génèrent des erreurs HTTP.  
**Valeurs cibles** :  
+ Erreurs 4xx : moins de 0,1 % du total des demandes
+ Erreurs 5xx : moins de 0,01 % du total des demandes
+ Erreurs d'origine : moins de 0,05 % des demandes d'origine
**Pourquoi c'est important : les** taux d'erreur élevés indiquent des problèmes de configuration ou de service qui ont une incidence sur l'expérience utilisateur.

### MediaTailor métriques spécifiques
<a name="emt-specific-metrics"></a>

Surveillez ces MediaTailor indicateurs parallèlement aux indicateurs du CDN pour une visibilité complète :

Taux de remplissage des publicités  
**Indicateurs clés** : `Avail.FillRate` et `AdDecisionServer.FillRate`  
**Valeurs cibles** : supérieures à 90 % pour les deux mesures  
**Pourquoi c'est important** : impacte directement les recettes publicitaires et l'expérience des spectateurs

Performance de génération de manifestes  
**Indicateurs clés** : `GetManifest.Latency` et `GetManifest.Errors`  
**Valeurs cibles** : latence inférieure à 200 ms, taux d'erreur inférieur à 1 %  
**Pourquoi c'est important** : affecte le temps de démarrage et la fiabilité de la lecture

État du serveur Ad Decision  
**Indicateurs clés** : `AdDecisionServer.Latency``AdDecisionServer.Errors`, et `AdDecisionServer.Timeouts`  
**Valeurs cibles** : latence inférieure à 1 000 ms, taux d'erreur inférieur à 5 %, délais d'attente minimaux  
**Pourquoi c'est important : les** performances de l'ADS ont un impact direct sur le succès de l'insertion des annonces

## Configuration des outils de surveillance
<a name="cdn-monitor-tools-setup"></a>

Configurez ces outils pour surveiller efficacement votre intégration MediaTailor et celle du CDN :

### CloudWatch Intégration avec Amazon
<a name="cloudwatch-integration"></a>

Amazon CloudWatch fournit les bases de la surveillance de votre intégration MediaTailor et de celle du CDN :

MediaTailor métriques  
MediaTailor publie automatiquement des statistiques CloudWatch permettant de suivre les demandes, les réponses et les erreurs. Les métriques clés incluent :  
+ `RequestCount`: nombre total de demandes adressées à MediaTailor
+ `ResponseTime`: latence MediaTailor de réponse
+ `4xxErrorCount`et `5xxErrorCount` : Suivi des erreurs
Pour une liste complète des MediaTailor indicateurs, voir[Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md).

Métriques du CDN  
Activez la collecte de métriques CDN en CloudWatch incluant :  
+ Taux de réussite du cache pour différents types de contenu
+ Nombre de demandes d'origine et temps de réponse
+ Taux d'erreur par code d'état
Pour CloudFront des statistiques spécifiques, activez le suivi détaillé dans vos paramètres de distribution.

### Configuration du tableau de bord
<a name="dashboard-configuration"></a>

Créez des tableaux de bord qui offrent une visibilité sur vos performances MediaTailor et celles du CDN :

1. **Créez un tableau de bord unifié** : combinez MediaTailor les métriques du CDN dans un seul CloudWatch tableau de bord pour une visibilité complète.

1. **Organiser par flux de travail** : regroupez les métriques par type d'implémentation (SSAI, assemblage de canaux ou flux de travail combinés).

1. **Incluez les indicateurs de performance clés** :
   + Tendances du taux de réussite du cache au fil du temps
   + Percentiles de latence de réponse (P50, P95, P99)
   + Tendances et pics du taux d'erreur

Pour obtenir des conseils détaillés sur la création de tableaux de bord, consultez la section [CloudWatchTableaux de bord](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).

### Configuration des alertes
<a name="alert-configuration"></a>

Configurez des alertes pour détecter les problèmes avant qu'ils n'affectent les utilisateurs :

Alertes critiques  
Configurez des alertes immédiates en cas de problèmes graves :  
+ **Taux d'erreur élevés** : alerte lorsque le nombre d'erreurs 5xx dépasse 0,1 % des demandes sur une période de 5 minutes
+ **Problèmes avec le serveur d'origine** : alerte lorsque le temps de réponse d'origine dépasse 2 secondes
+ **Diminution du taux d'accès** au cache : alerte lorsque le taux d'accès au cache tombe en dessous de 70 % pour les manifestes ou de 85 % pour les segments

Alertes d'avertissement  
Configurez des alertes d'alerte précoce en cas de dégradation des performances :  
+ **La latence augmente** : alerte lorsque le temps de réponse du P95 dépasse 200 ms
+ **Diminution de l'efficacité du** cache : alerte lorsque le taux d'accès au cache tombe en dessous de 90 % pour les segments

## Liste de contrôle de mise en œuvre
<a name="cdn-monitor-implementation-checklist"></a>

Utilisez cette liste de contrôle pour garantir une couverture complète de la surveillance :

1. **Collecte de métriques** :
   + ✓ MediaTailor métriques activées dans CloudWatch
   + ✓ Surveillance détaillée du CDN activée

1. **Configuration du tableau de bord** :
   + ✓ Tableau de CloudWatch bord unifié créé
   + ✓ Indicateurs clés visualisés avec des plages de temps appropriées
   + ✓ Tableau de bord partagé avec les équipes concernées

1. **Configuration des alertes** :
   + ✓ Alertes critiques configurées avec notification immédiate
   + ✓ Alertes d'avertissement configurées pour une détection précoce
   + ✓ Procédures d'escalade des alertes documentées

1. **Procédures opérationnelles** :
   + ✓ Procédures de réponse aux incidents documentées
   + ✓ Un calendrier d'examen régulier a été établi
   + ✓ Entraînement de l'équipe terminé

## Rubriques en relation
<a name="cdn-monitor-related-topics"></a>

Pour obtenir des conseils supplémentaires sur des scénarios de surveillance spécifiques :
+ **Optimisation des performances** : pour des techniques d'optimisation détaillées basées sur les données de surveillance, voir[Optimisation des performances du CDN](cdn-optimization.md).
+ **Résolution des problèmes** : pour connaître les procédures de dépannage détaillées utilisant les données de surveillance, consultez la documentation de dépannage spécifique à votre flux de travail.
+ **Analyse des journaux** : pour une analyse et une surveillance complètes des journaux, voir[Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor](cdn-log-error-reference.md).

# Tests et validation pour le CDN et MediaTailor les intégrations
<a name="cdn-integration-testing"></a>

AWS Elemental MediaTailor L'intégration du réseau de diffusion de contenu (CDN) nécessite des tests approfondis pour garantir une diffusion publicitaire fiable et des performances optimales. Les tests systématiques permettent d'identifier les problèmes d'intégration avant qu'ils n'affectent les utilisateurs. Utilisez cette approche globale pour valider votre réseau de diffusion de contenu et MediaTailor son intégration dans différents scénarios, configurations et conditions de charge.

**Sujets connexes :**
+ Pour la configuration opérationnelle, y compris la surveillance et la journalisation, voir [Surveillance du CDN](cdn-monitoring.md)
+ Pour résoudre les problèmes en cas de problème, voir [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md)
+ Pour obtenir des conseils sur l'optimisation des performances, voir [Guide d'optimisation des performances pour le CDN et MediaTailor les intégrations](cdn-optimization.md)

**Topics**
+ [Conditions préalables aux tests](testing-prerequisites.md)
+ [Méthodologie de test systématique](systematic-testing-approach.md)
+ [Liste de contrôle préalable au déploiement](testing-checklist.md)
+ [Référence des outils de test](testing-tools-reference.md)

# Prérequis de test et configuration pour le CDN et les intégrations MediaTailor
<a name="testing-prerequisites"></a>

AWS Elemental MediaTailor les tests d'intégration du réseau de diffusion de contenu (CDN) nécessitent une préparation et une allocation de ressources appropriées. Avant de commencer les tests systématiques, assurez-vous de disposer des ressources et des outils nécessaires.

**Ressources requises :**
+ Tester la distribution du CDN configurée pour refléter les paramètres de production
+ Testez MediaTailor la configuration avec du contenu et des sources publicitaires connus
+ Testez le contenu avec des caractéristiques prévisibles (durée, format, marqueurs de rupture publicitaire)
+ Tester le serveur de décision publicitaire ou simuler des réponses ADS
+ Plusieurs appareils de test et types de joueurs

**Outils de test :**
+ `curl`pour tester les requêtes HTTP
+ `ffprobe`pour la validation du manifeste HLS
+ `mp4box`pour la validation du manifeste DASH
+ Outils de développement de navigateurs pour l'analyse du réseau
+ Lecteurs vidéo à end-to-end tester

# Méthodologie de test systématique pour le CDN et les intégrations MediaTailor
<a name="systematic-testing-approach"></a>

AWS Elemental MediaTailor les tests d'intégration des réseaux de diffusion de contenu (CDN) doivent suivre une approche systématique et progressive afin de garantir une couverture complète. Suivez cette approche structurée pour tester de manière exhaustive votre réseau de diffusion de contenu et votre MediaTailor intégration. Chaque phase s'appuie sur la précédente pour isoler les problèmes potentiels.

Pour des conseils supplémentaires sur les approches de test systématiques, voir [Testing for reliability in the AWS Well-Architected](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/test-reliability.html) Framework.

## Phase 1 : tester la MediaTailor connectivité directe
<a name="phase1-direct-emt-testing"></a>

Commencez par tester les MediaTailor fonctionnalités sans impliquer le CDN pour établir une base de référence.

1. Testez les demandes de manifeste directement sur les MediaTailor points de terminaison :
   + Testez les demandes de playlist multivariantes HLS : `curl -v "https://your-emt-endpoint.mediatailor.region.amazonaws.com/v1/master/hls/config-name/master.m3u8"`
   + Testez les requêtes DASH MPD : `curl -v "https://your-emt-endpoint.mediatailor.region.amazonaws.com/v1/dash/config-name/manifest.mpd"`
   + Vérifiez que les réponses au manifeste contiennent les marqueurs de rupture de publicité attendus
   + Vérifiez ce URLs point de segment pour corriger les origines

1. Vérifiez que l'insertion d'annonces fonctionne correctement :
   + Testez avec différents paramètres de ciblage publicitaire
   + Vérifiez que les segments publicitaires sont correctement transcodés et disponibles
   + Vérifiez l'heure et la durée des pauses publicitaires
   + Testez le comportement de secours lorsque les publicités ne sont pas disponibles

1. Mesurez les performances de référence :
   + Enregistrer les temps de réponse aux demandes de manifeste
   + Mesurez les temps de réponse des serveurs de décision publicitaire
   + Création et gestion de sessions de test

**Critères de réussite :** toutes les MediaTailor demandes directes renvoient des réponses HTTP 200 avec des manifestes correctement formatés contenant le contenu publicitaire attendu.

## Phase 2 : tester l'intégration de base du CDN
<a name="phase2-basic-cdn-integration"></a>

Ajoutez un CDN au chemin de demande et testez les fonctionnalités de base.

1. Testez les demandes de manifeste via le CDN :
   + Configurer le CDN avec des règles de routage simples
   + Testez les demandes de manifeste via les points de terminaison du CDN
   + Vérifiez que le CDN transmet correctement les demandes à MediaTailor
   + Vérifiez que les réponses au manifeste ne sont pas mises en cache (TTL = 0)

1. Routage des segments de test :
   + Vérifier que les segments de contenu sont acheminés vers le serveur d'origine
   + Vérifier le routage des segments publicitaires vers le stockage MediaTailor publicitaire
   + Tester le comportement de mise en cache des segments

1. Comparez les performances du CDN aux performances directes :
   + Mesurez les différences de temps de réponse
   + Vérifiez les éventuelles différences de contenu dans les réponses
   + Vérifiez que la gestion des erreurs fonctionne correctement

**Critères de réussite :** le CDN doit transmettre par proxy les requêtes aux serveurs d'origine MediaTailor et aux serveurs d'origine avec un impact minimal sur les performances.

## Phase 3 : transfert des paramètres de requête de test
<a name="phase3-parameter-forwarding"></a>

Ajoutez le transfert des paramètres de requête et testez la personnalisation des publicités.

1. Configurez le transfert des paramètres de requête sur le CDN :
   + Activez le transfert de tous les paramètres de requête vers MediaTailor
   + Initialisation de la session de test (l'identifiant de session est automatiquement généré MediaTailor lors de la première demande)
   + Testez avec des paramètres de ciblage personnalisés

1. Testez la personnalisation des publicités :
   + Vérifiez les différents paramètres et produisez des réponses publicitaires différentes
   + Codage des paramètres de test et caractères spéciaux
   + Vérifiez que les paramètres sont correctement transmis à ADS

1. Validez la gestion des sessions :
   + Création et persistance de sessions de test
   + Vérifier la cohérence des identifiants de session entre les demandes
   + Gestion de l'expiration des sessions de test

**Critères de réussite :** le contenu des annonces varie en fonction des paramètres de requête, et les sessions sont gérées correctement.

## Phase 4 : Tester le transfert des en-têtes
<a name="phase4-header-forwarding"></a>

Ajoutez le transfert d'en-tête dans le CDN et testez le ciblage spécifique à l'appareil.

1. Configurez le transfert d'en-têtes pour tous les en-têtes. Pour les exigences minimales, voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers).

1. Tester le ciblage des appareils :
   + Testez avec différentes chaînes d'agent utilisateur (mobile, ordinateur de bureau, TV)
   + Vérifiez les réponses publicitaires spécifiques à l'appareil
   + Testez le ciblage géographique avec différentes adresses IP

1. Validez la gestion du CORS :
   + Testez les en-têtes CORS pour vérifier leur compatibilité avec les lecteurs Web
   + Vérifiez que les demandes OPTIONS avant le vol fonctionnent correctement
   + Tester à partir de différents domaines

**Critères de réussite :** le ciblage par appareil et par zone géographique doit fonctionner correctement, et les lecteurs Web ne doivent pas rencontrer d'erreurs CORS.

## Phase 5 : Test de scénario complet
<a name="phase5-comprehensive-testing"></a>

Effectuez des tests sur plusieurs scénarios pour garantir un fonctionnement robuste.

1. Testez avec différents types de joueurs :
   + Lecteurs HLS.js dans les navigateurs Web
   + Lecteurs Video.js compatibles avec HLS et DASH
   + Joueurs natifs sur appareils mobiles
   + Lecteurs Smart TV et décodeurs

1. Testez sur différents appareils et plateformes :
   + Appareils mobiles (iOS, Android)
   + Navigateurs de bureau (Chrome, Firefox, Safari, Edge)
   + Appareils intelligents TVs et appareils de streaming
   + Différentes versions du système d'exploitation

1. Testez différents types de contenu :
   + Contenu diffusé en direct
   + Contenu de vidéo à la demande (VOD)
   + Différents formats vidéo et débits
   + Contenu présentant différents types de pauses publicitaires

1. Testez des scénarios de ciblage publicitaire :
   + Différents paramètres de ciblage démographique
   + Ciblage géographique dans différentes régions
   + Ciblage basé sur le temps (différents moments de la journée)
   + Paramètres de logique métier personnalisés

**Critères de réussite :** toutes les combinaisons de joueurs et d'appareils doivent fonctionner correctement avec un ciblage publicitaire approprié.

## Phase 6 : tests de charge et de performance
<a name="phase6-load-performance-testing"></a>

Validez les performances dans des conditions de charge réalistes.

**Important**  
**Avant de tester la charge, contactez [AWS Support](https://aws.amazon.com/premiumsupport/) :** avant d'effectuer des tests de charge et de performance, créez un ticket de AWS support pour informer l'équipe de MediaTailor service de vos tests prévus. Cela garantit :  
Le service est préparé pour les niveaux de charge attendus
La capacité appropriée est disponible pendant votre fenêtre de test
Vos tests ne seront pas confondus avec un incident de production
Vous recevez des conseils sur les meilleures pratiques et les limites des tests
Incluez dans votre ticket d'assistance : les utilisateurs simultanés attendus, la durée du test, les régions géographiques et tout scénario spécifique que vous envisagez de tester.

1. Testez des scénarios d'utilisateurs simultanés :
   + Simulez plusieurs spectateurs simultanés
   + Testez le dimensionnement du CDN et les performances du cache
   + Surveillez les performances du serveur d'origine en cas de charge
   + Verify MediaTailor peut gérer des sessions simultanées

1. Mesurez les indicateurs de performance :
   + Surveillez les temps de réponse sous charge
   + Vérifiez que les taux d'accès au cache répondent aux attentes (> 80 % pour les contenus populaires)
   + Mesurez le délai jusqu'à la première image pour différents scénarios
   + Suivez les taux d'erreur pendant les pics de charge

1. Testez les scénarios de basculement :
   + Tester le comportement lorsque ADS n'est pas disponible
   + Tester le basculement du serveur Origin
   + Vérifier la gestion des erreurs et la restauration
   + Tester le basculement de l'emplacement périphérique du CDN

**Critères de réussite :** le système doit maintenir des performances acceptables sous la charge attendue, avec une dégradation progressive en cas de panne. Assurez-vous de contacter [AWS Support pour](https://aws.amazon.com/premiumsupport/) qu'il approuve votre plan de test de charge avant son exécution.

# Liste de contrôle des tests préalables au déploiement pour le CDN et les intégrations MediaTailor
<a name="testing-checklist"></a>

AWS Elemental MediaTailor L'intégration du réseau de diffusion de contenu (CDN) doit passer des tests complets avant le déploiement en production. Utilisez cette liste de contrôle avant de déployer des modifications de configuration en production.

**Fonctionnalité de base :**
+ ☐ Les demandes de manifeste renvoient des réponses HTTP 200
+ ☐ Les segments de contenu se chargent correctement
+ ☐ Les segments publicitaires se chargent correctement
+ ☐ Les pauses publicitaires apparaissent aux heures prévues
+ ☐ La lecture passe en douceur entre le contenu et les publicités

**Validation de la configuration :**
+ ☐ Les paramètres de requête sont transmis correctement
+ ☐ Les en-têtes requis sont transmis correctement
+ ☐ La mise en cache du manifeste est désactivée (TTL = 0)
+ ☐ La mise en cache des segments est configurée de manière appropriée
+ ☐ Les en-têtes CORS sont configurés pour les lecteurs Web

**Tests multiplateformes :**
+ ☐ Testé sur des appareils mobiles
+ ☐ Testé sur les navigateurs de bureau
+ ☐ Testé avec différents types de joueurs
+ ☐ Formats HLS et DASH testés

**Validation des performances :**
+ ☐ Ticket d' AWS assistance créé pour l'approbation des tests de charge
+ ☐ Les temps de réponse répondent aux objectifs de performance
+ ☐ Les taux de réussite du cache sont acceptables
+ ☐ Les taux d'erreur sont dans les limites acceptables
+ ☐ La surveillance et les alertes sont configurées

# Référence des outils et utilitaires de test pour le CDN et MediaTailor les intégrations
<a name="testing-tools-reference"></a>

AWS Elemental MediaTailor les tests d'intégration du réseau de diffusion de contenu (CDN) nécessitent divers outils pour une validation et un débogage complets. Guide de référence pour les outils couramment utilisés dans les réseaux de diffusion de contenu et les tests MediaTailor d'intégration.

`curl`- Test des requêtes HTTP  
Tester les demandes de manifeste : `curl -v "https://your-cdn-domain.com/v1/master/hls/config/master.m3u8"`  
Test avec des en-têtes : `curl -H "User-Agent: TestAgent/1.0" "https://your-cdn-domain.com/..."`  
Test avec paramètres : `curl "https://your-cdn-domain.com/...?aws.sessionId=test123"`

`ffprobe`- Validation du manifeste HLS  
Validez la syntaxe HLS : `ffprobe -v quiet -print_format json -show_format "https://your-cdn-domain.com/master.m3u8"`  
Vérifiez les informations du segment : `ffprobe -v quiet -show_entries packet=pts_time "segment.ts"`

`mp4box`- Validation du manifeste DASH  
Validez le DASH MPD : `mp4box -info "https://your-cdn-domain.com/manifest.mpd"`  
Vérifiez le chronométrage des segments : `mp4box -info segment.m4s`

Outils de développement de navigateurs  
Surveillez les demandes réseau dans l'onglet Réseau  
Vérifiez les erreurs CORS dans l'onglet Console  
Inspecter les request/response en-têtes  
Analyser les indicateurs de chronométrage et de performance

**Ressources supplémentaires :**
+ [Résolution des problèmes CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Troubleshooting.html) - Guide complet de résolution des problèmes liés aux CDN
+ [Augmenter CloudFront le taux de réussite du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Conseils d'optimisation des performances
+ [Surveiller AWS les ressources](https://docs.aws.amazon.com/wellarchitected/latest/performance-efficiency-pillar/monitor-aws-resources.html) - Meilleures pratiques en matière de surveillance des performances

# Résoudre les problèmes liés à l'intégration MediaTailor du CDN
<a name="cdn-troubleshooting"></a>

Ce guide de dépannage complet couvre les problèmes courants d'intégration du réseau de diffusion de contenu (CDN) dans toutes les AWS Elemental MediaTailor implémentations, notamment l'insertion de publicités côté serveur (SSAI), l'assemblage des canaux et l'intégration. AWS Elemental MediaPackage Lorsque votre CDN et votre MediaTailor intégration rencontrent des problèmes, utilisez cette approche diagnostique systématique pour identifier rapidement les causes profondes et mettre en œuvre des solutions validées.

Ce guide s'applique à toutes les intégrations de MediaTailor CDN, quel que soit votre flux de travail spécifique. Pour les problèmes spécifiques à des services ou à des flux de travail particuliers, consultez les sections de résolution des problèmes connexes référencées à la fin de ce guide.

**Avant de commencer :** Préparez les éléments suivants pour un dépannage efficace :
+ Exemple de lecture URLs illustrant le problème
+ Journaux d'accès au CDN datant de la période au cours de laquelle les problèmes sont survenus
+ MediaTailor nom de configuration et AWS région
+ Type et version du lecteur (par exemple, HLS.js 1.4.0, Video.js 8.0)
+ Informations sur l'appareil et le navigateur à l'origine des problèmes

**Sujets connexes :**
+ Pour la configuration opérationnelle et la préparation au dépannage, voir [Résoudre les problèmes liés à l'intégration du CDN](#cdn-troubleshooting)
+ Pour l'analyse du journal et la référence aux codes d'erreur, voir [Référence d'analyse du journal d'intégration du CDN](cdn-log-error-reference.md)
+ Pour l'escalade et l'obtention d'une aide supplémentaire, voir [Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md)

# Liste de contrôle diagnostique pour les MediaTailor intégrations au CDN
<a name="quick-diagnostic-checklist"></a>

AWS Elemental MediaTailor les problèmes d'intégration du réseau de diffusion de contenu (CDN) peuvent se manifester de différentes manières. Utilisez cette liste de contrôle pour identifier rapidement le type de problème que vous rencontrez :

1. **Le problème concerne-t-il tous les spectateurs ou certains spectateurs en particulier ?**
   + Tous les spectateurs → Probable problème de CDN ou MediaTailor de configuration
   + Nombre de spectateurs spécifiques → Probable problème de personnalisation ou de ciblage

1. **Les manifestes se chargent-ils correctement ?**
   + Non → Problème de routage ou de MediaTailor connectivité du CDN
   + Oui, mais contenu incorrect → Problème de mise en cache ou de personnalisation

1. **Les segments se chargent-ils correctement ?**
   + Échec des segments de contenu → Problème de connectivité avec Origin
   + Échec des segments publicitaires → Problème de diffusion ou de transcodage des annonces

1. **Les annonces sont-elles insérées correctement ?**
   + Aucune publicité n'apparaît → Vérifiez la connectivité et la configuration ADS
   + De mauvaises annonces apparaissent → Vérifiez les paramètres de ciblage et de personnalisation des annonces
   + Les publicités ne sont pas diffusées → Vérifiez le transcodage des publicités et la disponibilité des segments

1. **La lecture est-elle fluide et ininterrompue ?**
   + Problèmes de mise en mémoire tampon → Vérifiez les performances du cache CDN et les temps de réponse d'origine
   + Erreurs de lecture → Vérifier la syntaxe du manifeste et la disponibilité des segments
   + Problèmes de transition publicitaire → Vérifiez le calendrier des pauses publicitaires et l'alignement des segments

1. **Existe-t-il des codes ou des messages d'erreur spécifiques ?**
   + Erreurs HTTP 4xx → Vérifier le routage et la configuration du CDN
   + Erreurs HTTP 5xx → Vérifier l'état du serveur d'origine et du MediaTailor service
   + Erreurs spécifiques au joueur → Vérifier le format du manifeste et la compatibilité du lecteur

**Prochaines étapes en fonction de votre diagnostic :**

Problèmes de configuration du CDN  
Pour un dépannage détaillé du routage et de la mise en cache du CDN, consultez. [Résoudre les problèmes liés à l'intégration MediaTailor du CDN](cdn-troubleshooting.md)

Problèmes de manifeste et de lecture  
Pour la validation du manifeste et le dépannage de la lecture, voir[Procédures de test d'intégration CDN](cdn-testing-procedures.md).

Problèmes d'insertion et de ciblage des publicités  
Pour la résolution des problèmes spécifiques aux publicités, notamment la connectivité ADS et la diffusion des publicités, consultez la documentation de résolution des problèmes spécifiques à votre flux de travail.

Problèmes de performance et de surveillance  
Pour l'analyse des performances et la configuration de la surveillance, voir[Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md).

Analyse du journal et codes d'erreur  
Pour une analyse détaillée du journal et une référence aux codes d'erreur, consultez[Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor](cdn-log-error-reference.md).

Tests et validation  
Pour des procédures de test complètes, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md).

Si vous avez besoin d'une assistance immédiate ou si vous ne parvenez pas à résoudre le problème à l'aide des ressources liées, consultez [Bénéficiez d'une assistance et d'une aide au dépannage pour le CDN et les intégrations MediaTailor](cdn-get-help.md) les procédures d'escalade.

# Procédures de test d'intégration CDN
<a name="cdn-testing-procedures"></a>

Des tests appropriés sont essentiels avant de déployer votre intégration MediaTailor CDN en production. Ces procédures de test permettent d'identifier les problèmes de configuration, les problèmes de performances et les problèmes de compatibilité entre les différents appareils et plateformes.

## Validation d'intégration de base
<a name="basic-integration-testing"></a>

Effectuez ces tests fondamentaux pour vérifier que votre intégration CDN fonctionne correctement :

1. **Livraison du manifeste de test** :
   + Demandez un manifeste via votre CDN et vérifiez qu'il renvoie une réponse valide
   + Vérifiez que le manifeste contient le contenu attendu et les points d'insertion des annonces
   + Vérifiez que le manifeste URLs utilise votre domaine CDN, pas l'origine
   + Valider la syntaxe du manifeste à l'aide des outils de validation HLS ou DASH

1. **Vérifiez la réécriture de l'URL** :
   + Vérifiez que le segment de contenu URLs des manifestes pointe vers votre domaine CDN
   + Vérifiez que le segment publicitaire URLs pointe vers votre domaine CDN
   + Assurez-vous que tous les membres de URLs votre famille sont correctement résolus

1. **Testez la lecture du contenu** :
   + Diffusez du contenu via un lecteur vidéo et vérifiez la fluidité de la lecture
   + Vérifiez que le contenu et les publicités sont diffusés sans interruption
   + Vérifiez que les transitions entre le contenu et les publicités sont correctes
   + Fonctionnalité de recherche de tests et de nettoyage

1. **Validez le routage du CDN** :
   + Surveillez les journaux d'accès au CDN pour vous assurer que les demandes sont correctement acheminées
   + Vérifiez que les hit/miss modèles de cache sont conformes aux attentes
   + Vérifiez que les demandes d'origine ne se produisent que pour les erreurs de cache

## Procédures de test avancées
<a name="advanced-integration-testing"></a>

Effectuez ces tests supplémentaires pour une validation complète :

1. **Tests de compatibilité multiplateformes :**
   + Testez sur plusieurs appareils (ordinateur de bureau, mobile, tablette, téléviseur intelligent)
   + Vérifiez la compatibilité entre les différents navigateurs
   + Testez avec différents lecteurs vidéo (HLS.js, Video.js, lecteurs natifs)
   + Valider sur différents systèmes d'exploitation

1. **Tests de performance** :
   + Mesurer les temps de réponse aux demandes de manifeste (objectif : < 100 ms pour les demandes mises en cache)
   + Testez les performances de chargement des segments sur différents débits
   + Vérifiez que le temps de démarrage répond aux objectifs de performance
   + Test dans différentes conditions de réseau

1. **Validation du suivi des publicités** :
   + Vérifiez que les balises de suivi des publicités se déclenchent correctement
   + Vérifiez l'exactitude des données d'analyse publicitaire
   + Suivi des empreintes et de l'achèvement des tests
   + Valider la fonctionnalité de clic

1. **Test des conditions d'erreur** :
   + Tester le comportement lorsque l'origine est temporairement indisponible
   + Vérifiez le traitement gracieux des demandes mal formées
   + Testez les scénarios de basculement du CDN
   + Valider la clarté et l'utilité des messages d'erreur

## Création d'un environnement de test
<a name="test-environment-setup"></a>

Configurez un environnement de test qui reflète votre configuration de production pour une validation complète :

1. Configurez des distributions CDN distinctes pour les tests :
   + Créez des distributions CDN de test avec les mêmes comportements de cache que ceux de production
   + Configurez des origines de test qui reflètent votre configuration de production
   + Utilisez des noms de domaine distincts pour éviter les conflits avec le trafic de production

1. Créez des MediaTailor configurations de test :
   + Configurez des configurations de lecture de test avec les mêmes paramètres que ceux de production
   + Configuration des points de terminaison du serveur de test et de décision
   + Utilisez du contenu publicitaire de test qui correspond à vos formats d'annonces de production

1. Mettre en œuvre des processus de test systématiques :
   + Création de listes de contrôle de test pour les modifications de configuration
   + Documentez les procédures de test pour votre équipe
   + Configurez des tests automatisés dans la mesure du possible

## Testez sur plusieurs scénarios
<a name="multi-scenario-testing"></a>

Validez votre intégration dans différents scénarios et conditions pour garantir une couverture complète :

1. Testez avec plusieurs types de joueurs et appareils :
   + Testez avec différents lecteurs vidéo (web, mobile, TV connectée)
   + Validez sur différents systèmes d'exploitation et navigateurs
   + Testez différentes conditions du réseau et vitesses de connexion

1. Créez des scripts de test automatisés :
   + Automatisez la validation des demandes de manifeste
   + Créez des scripts pour tester des scénarios d'insertion de publicités
   + Mettre en œuvre des tests de performance pour les scénarios à fort trafic

1. Validez le ciblage et la personnalisation des publicités :
   + Testez avec différents profils d'utilisateurs et paramètres de ciblage
   + Valider l'intégration du serveur de décision publicitaire
   + Testez des scénarios de secours lorsque les publicités ne sont pas disponibles

## Outils et techniques de test
<a name="testing-tools-techniques"></a>

Utilisez ces outils et techniques pour des tests efficaces :

Outils de développement de navigateurs  
Utilisez l'onglet Réseau pour inspecter les requêtes et réponses HTTP  
Surveillez la console pour détecter JavaScript les erreurs et les avertissements  
Vérifier les en-têtes de réponse et le comportement de mise en cache  
Vérifiez les informations temporelles pour l'analyse des performances

Tests en ligne de commande  
Utilisez curl pour tester des en-têtes spécifiques URLs et inspecter les en-têtes :  

```
curl -I "https://your-cdn-domain.com/path/to/manifest.m3u8"
```
Utilisez wget pour les tests de téléchargement et l'analyse du calendrier  
Utilisez des outils tels que httpie pour des tests HTTP plus lisibles

Test du lecteur vidéo  
Testez avec des implémentations à plusieurs joueurs  
Utilisez les modes de débogage du joueur pour inspecter le comportement interne  
Surveillez les événements liés aux joueurs et les rappels d'erreur  
Valider le comportement de commutation adaptative à débit

Analyse et surveillance du CDN  
Surveillez les métriques du CDN en temps réel pendant les tests  
Consultez les journaux d'accès pour détecter les modèles de demandes  
Utilisez des outils de test spécifiques au CDN lorsqu'ils sont disponibles  
Configurez des alertes temporaires pour la validation des tests

Pour des méthodologies de test complètes supplémentaires et des approches de validation systématique, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md).

# Résoudre les erreurs 404 du manifeste CDN pour MediaTailor
<a name="common-integration-issues"></a>

AWS Elemental MediaTailor Les erreurs 404 du manifeste du réseau de diffusion de contenu (CDN) constituent un problème d'intégration courant qui empêche le démarrage de la lecture. Cette section fournit un step-by-step dépannage en cas d'échec de livraison de manifestes. 

Les demandes de playlist multivariante, de playlist multimédia ou de MPD renvoient 404 erreurs  
**Solution rapide (essayez d'abord) :**  

1. Vérifiez que le nom MediaTailor de configuration indiqué dans votre URL correspond exactement (en distinguant majuscules et minuscules)

1. Testez l'URL du manifeste directement MediaTailor sans CDN : `curl -v "https://your-emt-endpoint.mediatailor.region.amazonaws.com/v1/master/hls/config-name/master.m3u8"`

1. Si le test direct fonctionne, vérifiez les règles de routage du CDN pour les demandes de manifeste
**Si la solution rapide ne fonctionne pas :**  
**Symptômes :** les joueurs ne démarrent pas la lecture, les demandes de manifeste renvoient des erreurs HTTP 404 dans les journaux du CDN.  
**Exemples de messages d'erreur :**  
+ Console du navigateur : `"Failed to load resource: the server responded with a status of 404 (Not Found)"`
+ Erreur du joueur : `"MANIFEST_LOAD_ERROR"` ou `"NETWORK_ERROR"`
+ Journaux du CDN : `GET /v1/master/hls/example-config/master.m3u8 404`
**Résolution :**  
Vérifiez que les règles de routage de votre CDN sont correctement configurées pour transférer les demandes de playlist multivariante, de playlist multimédia et de MPD à. MediaTailor  
Vérifiez que la MediaTailor configuration existe et qu'elle est correctement configurée.  
Assurez-vous que les modèles de comportement de votre CDN correspondent aux chemins de demande de manifeste attendus (par exemple`*.m3u8`,`*.mpd`).

# Diagnostiquez les problèmes et les erreurs de livraison de manifestes CDN pour MediaTailor
<a name="diagnose-manifest-issues"></a>

AWS Elemental MediaTailor les problèmes de diffusion du manifeste sur le réseau de diffusion de contenu (CDN) peuvent empêcher l'insertion et la lecture correctes des publicités. Si les spectateurs reçoivent des publicités incorrectes ou incohérentes dans les playlists multivariantes, les playlists multimédias, ou MPDs si :

1. Vérifiez les manifestes mis en cache :
   + Vérifiez que les paramètres TTL sont définis sur 0 pour toutes les listes de lecture multivariantes, les listes de lecture multimédia et les chemins MPD
   + Vérifiez que votre CDN ne met pas en cache les listes de lecture multivariantes, les listes de lecture multimédia ou MPDs malgré les paramètres TTL
   + Vérifiez l'état du cache dans les journaux du CDN : les demandes de manifeste doivent s'afficher `Miss` ou `RefreshHit` non `Hit`

1. Vérifiez la configuration de routage du CDN :
   + Confirmez que les demandes de manifeste sont acheminées vers les MediaTailor points de terminaison, et non mises en cache ou traitées depuis le point d'origine
   + Vérifiez que les modèles de comportement du CDN correspondent correctement aux chemins du manifeste (\$1.m3u8, \$1.mpd)
   + Vérifiez que les paramètres de requête sont transférés à des MediaTailor fins de personnalisation
   + Testez le manifeste URLs directement MediaTailor pour isoler les problèmes liés au CDN et au service

1. Vérifiez la configuration du transfert d'en-têtes :
   + Vérifiez que les en-têtes requis sont transmis (voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers))
   + Vérifiez que l'en-tête de l'agent utilisateur est transféré pour un ciblage publicitaire spécifique à l'appareil
   + Vérifiez que l' X-Forwarded-Foren-tête est transmis pour le ciblage géographique
   + Assurez-vous que l'en-tête Accept-Encoding est transmis pour la prise en charge de la compression

1. Validez le contenu et la structure du manifeste :
   + Vérifiez que les manifestes contiennent les marqueurs d'insertion de publicités attendus (EXT-X-CUE-OUT/IN pour HLS)
   + Vérifiez que le segment URLs dans les manifestes utilise votre domaine CDN, pas les domaines d'origine
   + Vérifiez que les segments publicitaires sont correctement insérés et accessibles
   + Testez la syntaxe du manifeste à l'aide d'outils de validation (ffprobe pour HLS, mp4box pour DASH)

1. Testez différents scénarios :
   + Testez avec une session différente IDs pour vérifier que la personnalisation fonctionne
   + Effectuez des tests à partir de différents emplacements géographiques pour vérifier le ciblage géographique
   + Testez avec différentes chaînes d'agent utilisateur pour vérifier le ciblage des appareils
   + Comparez les réponses manifestes avec et sans CDN pour identifier les différences

**Ressources de résolution des problèmes supplémentaires :**
+ Pour une configuration détaillée de la mise en cache du CDN, voir [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
+ Pour une configuration complète du routage CDN, voir [Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md)
+ Pour les exigences relatives au transfert d'en-têtes, voir [En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
+ Pour l'analyse des journaux et les codes d'erreur, voir [Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor](cdn-log-error-reference.md)
+ Pour les procédures de test et de validation, voir [Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md)

**Critères de réussite :** une fois le problème résolu, les joueurs devraient démarrer la lecture normalement et les publicités devraient apparaître comme prévu. Les demandes de manifeste doivent renvoyer des codes d'état HTTP 200 dans les journaux du CDN, et les manifestes doivent contenir un contenu publicitaire correctement personnalisé.

# Résoudre les problèmes de livraison et de chargement des segments CDN pour MediaTailor
<a name="diagnose-segment-issues"></a>

AWS Elemental MediaTailor les problèmes de diffusion des segments du réseau de diffusion de contenu (CDN) peuvent entraîner une mise en mémoire tampon et des interruptions de lecture. Si les joueurs ne parviennent pas à charger des segments ou à mettre en mémoire tampon leur expérience :

1. Vérifiez les règles de routage du CDN :
   + Vérifiez que les segments de contenu sont acheminés vers la bonne origine
   + Vérifiez que les segments publicitaires sont acheminés vers le bon emplacement de stockage MediaTailor publicitaire
   + Vérifiez que les extensions de fichiers de segment correspondent à vos modèles de comportement du CDN
   + Vérifiez que le segment URLs des manifestes utilise le bon domaine CDN
   + Pour obtenir des instructions détaillées sur la configuration des modèles de routage et de trajectoire comportementale, voir [Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md)

1. Vérifiez la configuration CORS :
   + Pour les lecteurs Web, assurez-vous que votre CDN passe bien ou qu'il définit correctement les en-têtes CORS
   + Testez à l'aide des outils de développement du navigateur pour identifier les erreurs liées au CORS
   + Vérifiez que les demandes OPTIONS avant le vol sont traitées correctement

1. Accessibilité et performance des segments de test :
   + Testez URLs directement chaque segment pour vérifier qu'il est accessible
   + Vérifiez les temps de réponse des segments et identifiez les goulots d'étranglement en matière de performances
   + Vérifiez que la taille des fichiers de segment est adaptée à vos cibles de bande passante
   + Chargement des segments de test depuis différents emplacements géographiques

1. Validez le comportement de mise en cache du CDN pour les segments :
   + Vérifiez que les segments de contenu disposent des paramètres TTL appropriés (généralement plus longs que les manifestes)
   + Vérifiez que les segments publicitaires sont mis en cache de manière appropriée en fonction des exigences de personnalisation
   + Surveillez les taux de réussite du cache pour le contenu et les segments publicitaires
   + Assurez-vous que les clés de cache n'incluent pas de paramètres inutiles qui réduisent l'efficacité du cache

1. Vérifiez la connectivité et l'état du serveur d'origine :
   + Vérifiez que les serveurs d'origine répondent correctement aux demandes de segment
   + Vérifiez la capacité du serveur d'origine et les temps de réponse en cas de charge
   + Vérifiez que les serveurs d'origine disposent des fichiers de segment attendus
   + Testez les scénarios de basculement d'origine si plusieurs origines sont configurées

1. Résolvez les problèmes spécifiques aux segments publicitaires :
   + Vérifiez que les segments publicitaires sont correctement transcodés et disponibles dans MediaTailor
   + Vérifiez que les segments publicitaires URLs sont correctement générés dans les manifestes
   + Testez le chargement des segments publicitaires à l'aide de différents paramètres de ciblage publicitaire
   + Surveillez les retards de transcodage des annonces susceptibles d'entraîner l'indisponibilité des segments

1. Validez la compatibilité et le comportement des joueurs :
   + Testez le chargement des segments avec différents types de joueurs et différentes versions
   + Vérifiez les paramètres de la mémoire tampon du lecteur et les modèles de demandes de segments
   + Vérifiez la gestion des erreurs du lecteur en cas d'échec des demandes de segment
   + Tester la logique de commutation adaptative à débit et de sélection de segments

**Ressources de résolution des problèmes supplémentaires :**
+ Pour la configuration du routage et du comportement du CDN, voir [Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md)
+ Pour l'optimisation de la mise en cache du CDN, voir [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
+ Pour obtenir des conseils de configuration CORS, voir [Bonnes pratiques de sécurité de l'intégration CDN pour MediaTailor](cdn-security-best-practices.md)
+ Pour le suivi et l'analyse des performances, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)
+ Pour des procédures de test complètes, voir [Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md)
+ Pour l'analyse des journaux et le diagnostic des erreurs, voir [Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor](cdn-log-error-reference.md)

**Critères de réussite :** une fois résolus, les joueurs doivent charger les segments de manière fluide, sans interruption de la mise en mémoire tampon. Les demandes de segment doivent renvoyer des codes d'état HTTP 200 avec des temps de réponse appropriés, et le contenu et les segments publicitaires doivent être accessibles et correctement mis en cache.

# Résoudre les problèmes de gestion et de suivi des sessions CDN pour MediaTailor
<a name="diagnose-session-issues"></a>

AWS Elemental MediaTailor la gestion des sessions du réseau de diffusion de contenu (CDN) est essentielle pour une personnalisation et un suivi appropriés des publicités. Si vous rencontrez des erreurs liées à la session ou si vous rencontrez un comportement incohérent entre les demandes :

1. Vérifiez la cohérence de l'identifiant de session :
   + Vérifiez que votre lecteur conserve le même identifiant de session pour toutes les demandes relatives à une seule session de lecture
   + Vérifiez les journaux du CDN pour confirmer que la session IDs est correctement transférée
   + Assurez-vous que IDs les sessions sont correctement codées en URL dans les paramètres de requête
   + Utilisez CloudWatch les journaux pour vérifier la cohérence des identifiants de session entre les demandes (voir les étapes de validation ci-dessous)

1. Validez l'initialisation de la session :
   + Vérifiez que la première demande de manifeste crée correctement une session
   + Vérifiez que le transfert des paramètres de session est correct (par exemple,`aws.sessionId`)
   + Vérifiez l'initialisation de la session à l'aide des journaux de débogage (voir la configuration des journaux de débogage ci-dessous)

1. Activez la journalisation du débogage pour un dépannage détaillé des sessions :
   + **Pour les rapports côté serveur :** ajoutez `?aws.logMode=DEBUG` à votre demande de lecture :

     ```
     GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG
     ```
   + **Pour les rapports côté client :** incluez `"logMode": "DEBUG"` dans le corps de votre demande d'initialisation de session
   + **Important :** la `DEBUG` valeur distingue les majuscules et minuscules
   + Maximum de 10 sessions de débogage actives autorisées simultanément

1. Utilisez CloudWatch les requêtes Logs pour valider le comportement des sessions :
   + **Vérifiez que la session de débogage est active :**

     ```
     fields @timestamp, @message
     | filter sessionId = "your-session-id-here"
     | filter eventType = "SESSION_INITIALIZED" # client-side reporting
     or mediaTailorPath like "/v1/master" # server-side reporting HLS
     or mediaTailorPath like "/v1/dash" # server-side reporting DASH
     ```
   + **Afficher tous les événements d'une session :**

     ```
     fields @timestamp, @message, eventType, mediaTailorPath
     | filter sessionId = "your-session-id-here"
     | sort @timestamp asc
     ```
   + **Vérifiez la génération du manifeste pour une session :**

     ```
     fields @timestamp, responseBody, @message
     | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"
     ```

1. Tester le transfert des paramètres de session via le CDN :
   + Testez les demandes de manifeste avec des paramètres de session directement par rapport MediaTailor (en contournant le CDN)
   + Comparez le comportement des sessions avec et sans CDN pour identifier les problèmes de transfert
   + Vérifiez que la configuration de transfert des paramètres de requête CDN inclut les paramètres liés à la session
   + Vérifiez que le CDN ne met pas en cache les réponses qui devraient être spécifiques à la session

**Messages d'erreur de session courants :**
+ `ConflictException`(HTTP 409) - Plusieurs demandes de playlist simultanées pour la même session. **Solution :** assurez-vous que votre joueur demande les playlists une par une conformément aux spécifications HLS
+ `NotFoundException`(HTTP 404) - La session n'est pas disponible ou la configuration n'existe pas. **Solution :** Vérifiez la validité de votre configuration et réinitialisez la session
+ `BadRequestException`(HTTP 400) - ID de session non valide ou demande mal formatée. **Solution :** vérifier le format des demandes et la validité de l'identifiant de session

**Ressources de résolution des problèmes supplémentaires :**
+ Pour une configuration complète de la journalisation du débogage et une référence aux champs, voir [Génération de AWS Elemental MediaTailor journaux de débogage](debug-log-mode.md)
+ Pour CloudWatch des exemples de requêtes de journaux et d'analyse des journaux, voir [Écrire AWS Elemental MediaTailor des journaux directement sur Amazon CloudWatch Logs](monitoring-cw-logs.md)
+ Pour la configuration du transfert des paramètres de requête CDN, voir [Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md)
+ Pour une référence complète des codes d'erreur, voir [Résolution des problèmes de lecture depuis MediaTailor](playback-errors.md)

**Critères de réussite :** une fois résolues, les sessions doivent s'initialiser correctement, maintenir une session IDs cohérente entre les demandes, et les journaux de débogage doivent indiquer les `SESSION_INITIALIZED` événements appropriés et la génération de manifestes sans erreur.

# Résolvez les problèmes de synchronisation et de synchronisation des pauses publicitaires sur le CDN pour MediaTailor
<a name="diagnose-timing-issues"></a>

AWS Elemental MediaTailor l'heure des pauses publicitaires du réseau de diffusion de contenu (CDN) doit être synchronisée avec précision avec les marqueurs de contenu. Si les annonces apparaissent à des heures incorrectes ou si l'heure des pauses publicitaires est incohérente :

1. Vérifiez les marqueurs de coupure de publicité dans le contenu :
   + Vérifiez que les marqueurs SCTE-35 sont correctement placés dans votre contenu d'origine
   + Vérifiez que la durée des interruptions publicitaires correspond à la longueur réelle du contenu publicitaire
   + Vérifiez que la durée des pauses publicitaires correspond aux limites du contenu
   + Validez le format du marqueur SCTE-35 et la précision du chronométrage dans vos manifestes d'origine
   + Testez les marqueurs de coupure publicitaire avec différents types de contenu (en direct ou en VOD)

1. Vérifiez l'impact de la mise en cache du CDN sur le timing :
   + Assurez-vous que le TTL du manifeste est défini sur 0 pour éviter toute dérive temporelle
   + Vérifiez que les paramètres sensibles au temps ne sont pas mis en cache
   + Vérifiez les problèmes de synchronisation des horloges entre la source de MediaTailor contenu et le CDN
   + Surveillez la dérive temporelle dans les diffusions en direct de longue durée
   + Vérifiez la synchronisation de l'heure du serveur CDN Edge avec NTP

1. Validez l'implémentation du marqueur SCTE-35 :
   + Vérifiez que les EXT-X-DATERANGE étiquettes incluent les spécifications SCTE35 de SORTIE et de DURÉE appropriées
   + Vérifiez la présence de marqueurs SCTE35 SCTE35 -OUT et -IN jumelés lorsque vous utilisez un chronométrage explicite
   + Vérifiez que les horodatages de la date de début correspondent à l'heure réelle du contenu
   + Testez différents formats de marqueurs SCTE-35 (marqueurs basés sur la durée ou marqueurs jumelés)

1. Testez le calendrier des pauses publicitaires dans différents scénarios :
   + Comparez la durée des pauses publicitaires avec les MediaTailor demandes directes par rapport aux demandes CDN
   + Testez la cohérence des délais entre les différents emplacements périphériques du CDN
   + Vérifiez l'heure des pauses publicitaires en fonction des différents types de joueurs et de leurs comportements de mise en mémoire tampon
   + Surveillez la précision du chronométrage pendant les périodes de pointe

1. Déboguez les problèmes de synchronisation à l'aide des journaux et de la surveillance :
   + Activez la journalisation du débogage pour suivre le temps de traitement des interruptions publicitaires
   + Surveillez CloudWatch les indicateurs relatifs au calendrier d'insertion des annonces
   + Vérifiez les journaux du CDN pour les modèles de demandes liés au calendrier
   + Utilisez les outils de débogage des joueurs pour vérifier l'heure des pauses publicitaires du point de vue du client

**Tolérances temporelles attendues :**
+ L'heure des pauses publicitaires doit correspondre aux marqueurs SCTE-35 de votre contenu
+ La durée de l'annonce doit correspondre à la durée spécifiée dans la réponse de votre serveur de décision publicitaire
+ La synchronisation de l'horloge entre le contenu MediaTailor, la source et le CDN doit se faire dans un délai d'une seconde
+ La synchronisation du marqueur SCTE-35 doit être précise à 100 ms près de la synchronisation réelle du contenu

**Ressources de résolution des problèmes supplémentaires :**
+ Pour le format et la mise en œuvre du marqueur SCTE-35, voir [Intégration d'une source de contenu pour l'insertion d' MediaTailor annonces](integrating-origin.md)
+ Pour la configuration de la journalisation du débogage et l'analyse du calendrier, voir [Génération de AWS Elemental MediaTailor journaux de débogage](debug-log-mode.md)
+ Pour la configuration de la mise en cache du CDN et son impact sur le timing, voir [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
+ Pour les procédures de test complètes, y compris la validation du calendrier, voir [Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md)
+ Pour surveiller le temps d'insertion des publicités et les performances, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)

**Critères de succès :** une fois résolus, les pauses publicitaires devraient apparaître exactement aux heures spécifiées par les marqueurs SCTE-35, avec un timing constant sur tous les sites périphériques du CDN et sur tous les types de joueurs. Les journaux de débogage doivent indiquer le moment précis du traitement des interruptions de publicité, sans dérive ni erreur de synchronisation.

# Optimisez les performances du CDN et résolvez les problèmes de latence pour MediaTailor
<a name="diagnose-performance-issues"></a>

AWS Elemental MediaTailor les performances d'intégration du réseau de diffusion de contenu (CDN) ont un impact direct sur l'expérience des spectateurs et la qualité de diffusion des publicités. Si vous constatez des temps de réponse lents ou une dégradation des performances :

## Techniques de mesure du rendement
<a name="performance-measurement-techniques"></a>

Avant de résoudre les problèmes de performance, établissez des mesures de référence et une surveillance continue :

1. Mesurez les indicateurs de performance clés :
   + Temps de **réponse :** les demandes de manifeste doivent être traitées dans un délai de 200 ms, les demandes de segment dans un délai de 100 ms
   + Taux d'**accès au cache :** segments de contenu > 95 %, segments publicitaires > 90 %
   + **Volume des demandes d'origine :** doit être inférieur à 5 % du total des demandes lorsque le cache est optimisé
   + **Durée de réalisation de la première image :** la lecture initiale devrait commencer dans les 2 à 3 secondes

1. Utilisez des outils de mesure du rendement :
   + **Tableaux de bord d'analyse du CDN :** surveillez les performances du cache, les temps de réponse et les taux d'erreur
   + **CloudWatch métriques :** suivez les métriques MediaTailor du service, y compris GetManifest .Latency
   + **Outils de développement de navigateurs :** mesurez les performances côté client et la synchronisation du réseau
   + **Outils de ligne de commande :** utilisez curl avec des options de chronométrage pour mesurer des demandes spécifiques

1. Mettre en œuvre une surveillance continue :
   + Configurez des alertes de performance automatisées en cas de dégradation du temps de réponse
   + Surveillez les performances dans différentes régions géographiques
   + Suivez les performances pendant les périodes de pointe
   + Comparez les indicateurs de performance avant et après les modifications de configuration

**Ressources de mesure du rendement :**
+ Pour une configuration complète de surveillance des performances, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)
+ Pour les procédures de test de performance, voir [Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md)
+ Pour CloudWatch les mesures et le suivi, voir [Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md)

## Problèmes de performance du cache CDN
<a name="cache-performance-troubleshooting"></a>

Les problèmes de performance du cache font partie des problèmes d'intégration des CDN les plus courants. Ces problèmes affectent toutes les MediaTailor implémentations et peuvent avoir un impact significatif sur l'expérience utilisateur et les coûts.

**Faible taux de réussite du cache**  
**Symptômes** : volume de demandes d'origine élevé, latence accrue, coûts de bande passante plus élevés, mauvaise expérience utilisateur  
**Valeurs cibles** :  
+ Segments de contenu : taux d'accès au cache de 95 % ou plus
+ Segments publicitaires : taux d'accès au cache de 90 % ou plus
+ Manifestes : varie selon l'implémentation (les manifestes personnalisés ne doivent pas être mis en cache)
**Causes courantes :**  
+ Paramètres TTL incorrects pour différents types de contenu
+ La configuration de la clé de cache inclut des paramètres de requête inutiles
+ Les en-têtes de contrôle du cache depuis l'origine ne sont pas correctement configurés
+ Invalidations ou purges fréquentes du cache
+ Problèmes de distribution géographique (contenu non mis en cache aux emplacements périphériques)
**Solutions :**  

1. Vérifiez et optimisez les paramètres TTL :
   + Segments de contenu : définissez le TTL pour qu'il corresponde à la durée du segment ou plus
   + Segments publicitaires : définissez le TTL sur 24 heures ou plus pour les publicités réutilisables
   + Ressources statiques : définissez le TTL sur 24 heures ou plus

   Pour des recommandations TTL complètes et des stratégies d'optimisation de la mise en cache, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

1. Optimisez la configuration des clés de cache :
   + Supprimer les paramètres de requête inutiles des clés de cache
   + Assurez-vous que seuls les paramètres affectant le contenu sont inclus
   + Normaliser l'ordre des paramètres et la distinction majuscules/

1. Vérifiez que les en-têtes de contrôle du cache d'origine sont correctement définis

1. Implémentez Origin Shield (ou une fonctionnalité CDN équivalente) pour les implémentations à fort trafic. La fonctionnalité Origin Shield est disponible dans les principales CDNs versions, mais elle peut porter des noms différents (tels que CloudFront Origin Shield, Fastly Shield, Cloudflare Argo Tiered Cache). Si votre CDN ne propose pas cette fonctionnalité, vous pouvez l'activer MediaTailor lorsque vous contactez [AWS Support](https://aws.amazon.com/premiumsupport/).

1. Passez en revue les stratégies d'invalidation du cache et réduisez les purges inutiles
**Étapes de validation** :  

1. Surveillez les taux de réussite du cache à l'aide de tableaux de bord d'analyse du CDN

1. Test spécifique URLs avec curl pour vérifier les en-têtes du cache

1. Comparez le volume de demandes d'origine avant et après les modifications

**Volume élevé de demandes d'origine**  
**Symptômes** : nombre étonnamment élevé de demandes atteignant le point MediaTailor d'origine, augmentation de la charge du serveur d'origine, augmentation des coûts  
**Schéma attendu** : les demandes d'origine doivent représenter moins de 5 % du total des demandes des utilisateurs lorsque les taux d'accès au cache sont optimaux  
**Causes courantes :**  
+ Erreurs de cache dues à de faibles valeurs TTL
+ Fragmentation des clés de cache (trop de clés de cache uniques)
+ Pics de trafic géographique dans les régions où le contenu n'est pas mis en cache
+ Invalidations fréquentes du cache
**Solutions :**  

1. Analyser les modèles de demandes pour identifier les causes des défaillances du cache

1. Optimisez les paramètres TTL en fonction du type de contenu et de la fréquence de mise à jour

1. Mettre en œuvre des stratégies de réchauffement du cache pour les nouveaux contenus

1. Pensez à l'implémentation d'Origin Shield (disponible dans CDNs les principales versions sous différents noms, voir [Implémentation d'Origin Shield](cdn-advanced-optimization.md#origin-shield-optimization) pour plus de détails)
**Seuil d'alerte** : définissez des alertes lorsque les demandes d'origine dépassent 10 % du total des demandes ou augmentent de 50 % par rapport à la base de référence

## Résolution d'erreur HTTP courante
<a name="http-error-troubleshooting"></a>

Les erreurs HTTP dans les intégrations CDN indiquent souvent des problèmes de configuration ou de service. Ces modèles d'erreur sont cohérents dans toutes les MediaTailor implémentations.

**Erreur 404 Introuvable**  
**Symptômes : les** demandes de manifeste ou de segment renvoient le HTTP 404, les joueurs ne chargent pas le contenu, « MANIFEST\$1LOAD\$1ERROR » dans les journaux des joueurs  
**Causes courantes :**  
+ Configuration d'origine du CDN incorrecte (URL de point de MediaTailor terminaison incorrecte)
+ Modèles de chemin de comportement du cache manquants ou incorrects
+ Problèmes de réécriture d'URL dans la configuration du CDN
+ MediaTailor erreur de nom de configuration ou de point de terminaison de lecture
+ Problèmes de synchronisation liés au contenu en direct (demande de segments futurs)
**Étapes de diagnostic** :  

1. Testez la même URL directement par rapport à l' MediaTailor origine (contournez le CDN)

1. Vérifiez que la configuration d'origine du CDN correspond au point de terminaison MediaTailor de lecture

1. Vérifiez le comportement du cache CDN, les modèles de chemin et la priorité

1. Consultez les journaux d'accès au CDN pour connaître les détails du routage des demandes

1. Valider le nom de MediaTailor configuration et les paramètres régionaux
**Solutions :**  
+ Configuration d'origine du CDN correcte pour correspondre au point de terminaison MediaTailor de lecture
+ Mettre à jour les modèles de chemin de comportement du cache pour acheminer correctement les demandes
+ Corrigez les règles de réécriture d'URL, le cas échéant
+ Vérifiez que MediaTailor la configuration existe et qu'elle est active

**403 Erreurs interdites**  
**Symptômes : les** demandes renvoient le protocole HTTP 403, les messages d'accès sont refusés, l'authentification échoue  
**Causes courantes :**  
+ Paramètres de requête manquants ou incorrects requis par MediaTailor
+ Le CDN ne transmet pas les en-têtes ou les paramètres requis
+ Restrictions relatives aux adresses IP ou blocage géographique
+ Problèmes liés au jeton d'authentification (si vous utilisez un jeton signé URLs)
**Solutions :**  
+ Vérifiez que tous les paramètres de requête requis sont inclus et transmis
+ Vérifiez la configuration du CDN pour le transfert d'en-têtes et de paramètres
+ Passez en revue les restrictions IP et les paramètres géographiques
+ Valider les jetons d'authentification et les processus de signature

**400 erreurs liées à une mauvaise demande**  
**Symptômes : les** requêtes renvoient le HTTP 400, erreurs de requête mal formées, échecs de validation des paramètres  
**Causes courantes :**  
+ Paramètres de requête mal formés ou problèmes de codage d'URL
+ Valeurs de paramètres ou formats non valides
+ Paramètres requis manquants pour des MediaTailor fonctionnalités spécifiques
+ Limites de longueur d'URL dépassées
**Solutions :**  
+ Valider les formats des paramètres de requête et le codage des URL
+ Vérifier les valeurs des paramètres par rapport aux exigences de MediaTailor l'API
+ Assurez-vous que tous les paramètres requis sont inclus
+ Vérifiez la longueur de l'URL et envisagez l'optimisation des paramètres

**5xx Erreurs du serveur**  
**Symptômes : les** requêtes renvoient des erreurs HTTP 500, 502, 503 ou 504, des pannes de service intermittentes  
**Causes courantes :**  
+ MediaTailor problèmes de service ou limites de capacité
+ Problèmes de connectivité d'origine CDN
+ Problèmes de délai d'attente dus à la lenteur des réponses d'origine
+ Dégradation temporaire du service
**Solutions :**  
+ Consultez le AWS Service Health Dashboard pour connaître l'état du MediaTailor service
+ Vérifiez la connectivité d'origine du CDN et les paramètres de délai d'expiration
+ Implémenter une logique de nouvelle tentative avec un retard exponentiel
+ Surveillez MediaTailor CloudWatch les indicateurs relatifs à l'état des services
+ Contactez AWS le Support si les problèmes persistent

1. Mesurez les performances de référence :
   + Testez les temps de réponse aux demandes de manifeste directement sur MediaTailor (cible : <200 ms)
   + Mesurez les temps de réponse du CDN pour les demandes de manifeste (objectif : <100 ms pour les accès au cache)
   + Vérifiez les temps de chargement des segments à la fois depuis l'origine et le CDN

1. Analysez les performances du CDN :
   + Vérifiez le taux de réussite du cache pour les segments de contenu (objectif : > 80 % pour le contenu populaire)
   + Vérifiez que le bouclier d'origine (ou une fonctionnalité CDN équivalente) est activé et configuré dans la même AWS région que votre origine. Différents CDNs utilisent des noms différents pour cette fonctionnalité
   + Surveillez les performances de localisation périphérique et la distribution géographique du CDN

**Critères de performance :**
+ Surveillez les temps de réponse à la génération des manifestes et comparez-les à vos performances de référence
+ Les accès au cache du CDN sont nettement plus rapides que les requêtes d'origine
+ Les temps de réponse de l'ADS ne devraient pas entraîner de retards dans la génération du manifeste

**Ressources de résolution des problèmes supplémentaires :**
+ Pour des stratégies complètes d'optimisation des performances, voir [Guide d'optimisation des performances pour le CDN et MediaTailor les intégrations](cdn-optimization.md)
+ Pour plus de détails sur l'implémentation d'Origin Shield, voir [Implémentation d'Origin Shield](cdn-advanced-optimization.md#origin-shield-optimization)
+ Pour l'optimisation de la mise en cache du CDN, voir [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
+ Pour le suivi des performances et les indicateurs, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)
+ Pour les procédures de test de performance, voir [Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md)

**Critères de réussite :** une fois résolus, les temps de réponse doivent atteindre les objectifs de référence (manifestes inférieurs à 200 ms, segments inférieurs à 100 ms), les taux d'accès au cache doivent dépasser 90 % pour la plupart des types de contenu et le volume des demandes d'origine doit être inférieur à 5 % du total des demandes. Les performances doivent être cohérentes dans toutes les régions géographiques et tous les types d'appareils.

# Corrigez le comportement incohérent du CDN sur les appareils et les plateformes pour MediaTailor
<a name="resolve-inconsistent-behavior"></a>

AWS Elemental MediaTailor L'intégration d'un réseau de diffusion de contenu (CDN) devrait permettre une diffusion uniforme des publicités sur tous les appareils et plateformes. Si les publicités se comportent différemment d'un appareil à l'autre :

1. Garantissez un transfert d'en-tête cohérent dans tous les comportements du CDN.
   + Vérifiez que les en-têtes User-Agent et de ciblage personnalisé sont transmis de manière cohérente X-Forwarded-For
   + Vérifiez que les règles de transfert d'en-têtes s'appliquent à tous les comportements de cache pertinents

1. Vérifiez la compatibilité du lecteur avec la configuration de votre CDN.
   + Testez avec plusieurs types de joueurs (HLS.js, Video.js, joueurs natifs) pour identifier les problèmes spécifiques aux joueurs
   + Vérifiez les exigences d'en-tête spécifiques au joueur ou les différences de gestion des URL

1. Effectuez des tests avec plusieurs types d'appareils pour identifier les problèmes spécifiques à l'appareil.
   + Incluez les appareils mobiles, les tablettes, les navigateurs intelligents TVs et les navigateurs de bureau dans vos tests
   + Testez différents systèmes d'exploitation et versions de navigateur
   + Vérifiez que le ciblage publicitaire spécifique à l'appareil fonctionne correctement

Si vous avez suivi ces étapes de résolution des problèmes et que vous avez toujours besoin d'aide, consultez[Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md).

## Préparation au dépannage
<a name="troubleshooting-preparation"></a>

Configurez des outils et des processus pour simplifier le dépannage lorsque des problèmes d'intégration du CDN surviennent. La préparation proactive permet de résoudre les problèmes plus rapidement et plus efficacement en cas de problème.

### Activez la journalisation complète
<a name="enable-comprehensive-logging"></a>

Des journaux détaillés sont essentiels pour diagnostiquer les problèmes d'intégration du CDN. Configurez la journalisation pour saisir les informations dont vous aurez besoin lors du dépannage.

1. Activez les journaux d'accès détaillés au CDN :
   + Configurer la journalisation pour tous les comportements de cache qui traitent les MediaTailor demandes
   + Inclure des chaînes de requête et des en-têtes personnalisés dans les entrées du journal
   + Configurer des outils d'analyse des journaux pour identifier les modèles et les anomalies
   + Activez les journaux en temps réel pour détecter immédiatement les problèmes lors d'événements en direct
   + Configurer les politiques de conservation des journaux pour conserver l'historique des données de dépannage

1. Configurer la MediaTailor journalisation :
   + Activez les journaux d'accès pour vos MediaTailor configurations
   + Configuration de groupes de CloudWatch journaux pour une gestion centralisée des journaux
   + Configurer des filtres de journal pour identifier les modèles d'erreur

1. Configurer la journalisation du serveur d'origine :
   + Activez des journaux d'accès détaillés sur vos serveurs d'origine de contenu
   + Inclure les en-têtes de demande et les codes de réponse dans les journaux
   + Surveillez les indicateurs de performance du serveur d'origine

### Ajouter des en-têtes de demande de diagnostic
<a name="add-diagnostic-headers"></a>

Les en-têtes personnalisés permettent de suivre les demandes via votre CDN et d'identifier les problèmes de routage.

1. Configurez les en-têtes de diagnostic du CDN :
   + Ajoutez un identifiant unique à chaque demande (par exemple,`X-Request-ID`)
   + Inclure des informations spécifiques au CDN dans les en-têtes de demande
   + Ajoutez des informations de localisation périphérique ou de point de présence (POP) pour suivre l'itinéraire géographique
   + Inclure les en-têtes d'état du cache (Hit, Miss, RefreshHit) pour l'analyse du comportement du cache

1. Ajoutez des en-têtes de réponse pour le débogage :
   + Inclure les en-têtes d'identification du serveur
   + Ajoutez des informations de chronométrage pour l'analyse des performances
   + Inclure les en-têtes de contrôle du cache pour les demandes de manifeste

### Établir des indicateurs de performance de référence
<a name="establish-baseline-metrics"></a>

Documentez les plages de performances normales pour identifier rapidement les anomalies lors du dépannage :

1. **Enregistrez les mesures de base** :
   + Taux de réussite du cache pour différents types de contenu
   + Percentiles de temps de réponse (P50, P95, P99)
   + Taux d'erreur par code d'état
   + Modèles de volume des demandes par heure de la journée

1. **Documenter les attentes en matière de performance**
   + Taux de réussite du cache cible (95 % et plus pour le contenu, plus de 90 % pour les publicités)
   + Temps de réponse acceptables (<100 ms en cache, <500 ms en origine)
   + Taux d'erreur maximaux acceptables (< 1 % pour 4xx, < 0,1 % pour 5xx)

1. **Créez des tableaux de bord de performance** : configurez des tableaux de bord de surveillance qui présentent les mesures actuelles par rapport aux valeurs de référence.

### Préparer des outils de résolution des problèmes
<a name="prepare-troubleshooting-tools"></a>

Configurez les outils et les autorisations d'accès nécessaires pour un dépannage efficace :

1. Outils de **ligne de commande** :
   + `curl`pour tester les requêtes et réponses HTTP
   + `dig`ou `nslookup` pour le dépannage du DNS
   + Outils de validation HLS/DASH pour la vérification des manifestes
   + Outils d'analyse de journaux (grep, awk ou analyseurs de journaux spécialisés)

1. **Autorisations d'accès** :
   + Accès à la console de gestion du CDN pour la révision de la configuration
   + MediaTailor accès à la console pour la vérification de la configuration
   + CloudWatch accès aux métriques et à l'analyse des journaux
   + Accès au serveur Origin pour le dépannage du backend

1. **Documentation :**
   + Schémas d'architecture réseau
   + CDN et documentation MediaTailor de configuration
   + Informations de contact pour les procédures d'escalade
   + Résolution des problèmes liés aux runbooks pour les scénarios courants

## Guides de dépannage spécifiques au flux de travail
<a name="workflow-specific-troubleshooting"></a>

Ce guide de dépannage universel couvre les problèmes courants liés à toutes les intégrations de MediaTailor CDN. Pour les problèmes spécifiques à des flux de travail ou à des services particuliers, consultez ces ressources de dépannage spécialisées :

Résolution des problèmes liés à l'insertion de publicités côté serveur (SSAI)  
Pour les problèmes spécifiques au SSAI, notamment les échecs d'insertion de publicités, les problèmes de transition des annonces et les problèmes de personnalisation, consultez la documentation de dépannage du SSAI spécifique au flux de travail.  
**Problèmes courants spécifiques à la SSAI** :  
+ Échecs d'insertion d'annonces et pauses publicitaires vides
+ Problèmes de synchronisation et de synchronisation liés à la transition des annonces
+ Problèmes de personnalisation et de ciblage
+ Divergences entre le suivi et les analyses des publicités

Résolution des problèmes d'assemblage des canaux  
Pour les problèmes spécifiques à l'assemblage des canaux, notamment les problèmes de génération de manifestes et la fonctionnalité de décalage temporel, consultez la documentation du flux de travail d'assemblage des canaux.  
**Problèmes courants liés à l'assemblage des canaux** :  
+ Erreurs de génération et de compilation de manifestes
+ Problèmes liés à la fenêtre de décalage horaire et au fonctionnement du DVR
+ Problèmes de disponibilité du contenu source et de basculement
+ Planification du programme et synchronisation des métadonnées

MediaPackage résolution des problèmes d'intégration  
Pour MediaPackage des problèmes spécifiques tels que le filtrage des manifestes et les problèmes liés aux terminaux EMP, consultez[Résolution des problèmes d'intégration au CDN](cdn-emp-troubleshooting.md).  
**Problèmes MediaPackage d'intégration courants** :  
+ Erreurs de paramètres de filtrage du manifeste
+ MediaPackage problèmes de connectivité des terminaux
+ Problèmes de comportement du cache spécifiques à EMP
+ MediaPackage problèmes d'authentification d'origine

CloudFront résolution de problèmes spécifiques  
Pour les problèmes de configuration et d'installation CloudFront spécifiques, consultez la documentation CloudFront d'intégration.  
** CloudFront Problèmes courants** :  
+ Configuration de la distribution et configuration du comportement du cache
+ Identité d'accès à l'origine et configuration de sécurité
+ CloudFront codes d'erreur et réponses spécifiques
+ Restrictions géographiques et problèmes de localisation périphérique

**Ressources supplémentaires** :
+ Pour obtenir des conseils sur l'optimisation des performances, voir [Optimisation des performances du CDN](cdn-optimization.md)
+ Pour la configuration de la surveillance et des alertes, voir [Surveillance du CDN](cdn-monitoring.md)
+ Pour obtenir une assistance et une assistance générales, voir [Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md)

# Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor
<a name="cdn-log-error-reference"></a>

AWS Elemental MediaTailor les journaux d'intégration du réseau de diffusion de contenu (CDN) fournissent des informations précieuses sur les performances et les erreurs. Ce guide couvre à la fois les journaux CDN (provenant de votre réseau de diffusion de contenu) et MediaTailor les journaux et codes d'erreur pertinents pour le dépannage de l'intégration du CDN. Utilisez cette référence lorsque vous devez comprendre ce que les journaux et les codes d'erreur de votre réseau de diffusion de contenu vous indiquent à propos de votre MediaTailor intégration. Ce guide vous aide à interpréter les entrées du journal et les messages d'erreur afin d'identifier la cause première des problèmes.

**Sujets connexes :**
+ Pour les procédures de step-by-step dépannage, voir [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md)
+ Pour des stratégies de surveillance et de prévention proactives, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)
+ Pour l'escalade et l'obtention d'une aide supplémentaire, voir [Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md)
+ Pour une configuration et des ressources de MediaTailor journalisation complètes, voir [MediaTailor ressources de configuration de journalisation](#mediatailor-logging-resources)
+ Pour une référence CloudFront sur le format du journal, voir [format du journal CloudFront d'accès](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html#LogFileFormat)
+ Pour une référence au code d'état [HTTP, voir Codes d'état de réponse HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)

# Techniques d'interprétation et d'analyse des logs CDN pour MediaTailor
<a name="cdn-log-interpretation"></a>

AWS Elemental MediaTailor L'intégration d'un réseau de diffusion de contenu (CDN) génère des journaux détaillés qui vous aident à comprendre les modèles de demandes et à identifier les problèmes. Lorsque vous analysez les journaux du réseau de diffusion de contenu, concentrez-vous sur les indicateurs clés suivants :

**Remarque :** Les exemples suivants utilisent CloudFront la terminologie Amazon. D'autres fournisseurs de CDN peuvent utiliser des termes différents pour des concepts similaires.

Codes d’état HTTP  
+ `200`- Demande réussie
+ `404`- Ressource introuvable (vérifiez les règles de routage et MediaTailor la configuration)
+ `403`- Accès refusé (vérifiez les paramètres de sécurité du CDN et les autorisations d'origine)
+ `502/503/504`- Erreurs du serveur d'origine (vérification de l'état MediaTailor du service et de la connectivité d'origine)

Indicateurs de comportement du cache  
+ `Hit`- Contenu diffusé depuis le cache du CDN
+ `Miss`- Contenu extrait depuis l'origine
+ `RefreshHit`- Contenu mis en cache validé avec Origin
+ `Error`- La demande a entraîné une erreur

Modèles de demandes à surveiller  
+ Les demandes de manifeste doivent généralement résulter `Miss` ou être `RefreshHit` dues à de faibles paramètres TTL
+ Les segments de contenu doivent s'afficher `Hit` pour les contenus populaires
+ Des segments publicitaires peuvent s'afficher `Miss` en raison de la personnalisation

**Surveillance de l'état des services**

Lors de l'analyse des journaux du CDN et de la résolution des problèmes, vérifiez l'état du MediaTailor service pour déterminer si les problèmes sont liés au service :

AWS Tableau de bord du Service Health  
Vérifiez l'état actuel du MediaTailor service et tout événement de service en cours  
Accès : [AWS Service Health Dashboard](https://status.aws.amazon.com/)  
À utiliser lorsque : vous constatez des erreurs 5xx ou des délais d'expiration de service généralisés dans les journaux du CDN

AWS Personal Health Dashboard  
Afficher les notifications relatives à l'état du service et les événements de maintenance spécifiques au compte  
Accès : [AWS Personal Health Dashboard](https://console.aws.amazon.com/phd/home)  
À utiliser lorsque : vous avez besoin d'informations sur l'état du service ou de notifications de maintenance spécifiques au compte

Surveillance CloudWatch des métriques Amazon  
Surveillez les indicateurs MediaTailor de santé des services à l'aide CloudWatch de mesures :  
+ `GetManifest.Errors`- Suivez les erreurs de génération de manifestes
+ `GetManifest.Latency`- Surveillez les performances du temps de réponse
+ `AdDecisionServer.Errors`- Surveillez les problèmes de connectivité des serveurs publicitaires
+ `Origin.Errors`- Suivez les problèmes de connectivité du serveur d'origine
Accès : [CloudWatchconsole](https://console.aws.amazon.com/cloudwatch/home)  
Utilisez-le lorsque : vous avez besoin de mesures de performance de service détaillées et de tendances historiques

**Processus de résolution des problèmes liés à l'état du service**

1. Consultez le AWS Service Health Dashboard pour connaître l'état actuel du service

1. Consultez le AWS Personal Health Dashboard pour les notifications spécifiques au compte

1. Surveillez CloudWatch les métriques pour les indicateurs de performance des services

1. Corrélez l'état de santé du service avec les modèles de journalisation et les taux d'erreur du CDN

1. Si l'état du service est normal, concentrez-vous sur la configuration du CDN et les problèmes liés au serveur d'origine

**Ressources d'analyse des journaux CDN**
+ [CloudFront journaux d'accès](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html) - Guide complet sur le format et les champs des journaux CDN
+ [CloudFront journaux en temps réel](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) - Streaming et analyse des journaux en temps réel
+ [Analyse des données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) - Requête et analyse avancées des journaux
+ [Surveillez les ressources de charge de travail](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/monitor-workload-resources.html) - Modèles de surveillance Well-Architected

**Topics**
+ [Interprétation du journal CDN](cdn-log-interpretation.md)
+ [Référence des codes d'erreur](emt-error-codes-reference.md)
+ [Outils d'analyse des journaux](log-analysis-techniques.md)
+ [MediaTailor ressources de configuration de journalisation](#mediatailor-logging-resources)

# MediaTailor codes d'erreur et résolution des problèmes liés à l'intégration du CDN
<a name="emt-error-codes-reference"></a>

AWS Elemental MediaTailor les codes d'erreur fournissent des informations spécifiques sur les problèmes d'intégration lorsqu'ils sont transmis via votre réseau de diffusion de contenu (CDN). Lorsque des erreurs sont MediaTailor renvoyées par le biais de votre réseau de diffusion de contenu, ces codes indiquent des problèmes spécifiques :

**Remarque :** Ces codes d'erreur sont renvoyés MediaTailor et transmis par votre CDN. Pour les erreurs spécifiques au CDN, consultez la documentation de votre fournisseur de CDN.

400 Requête erronée  
**Causes courantes :** paramètres de requête mal formés, paramètres requis manquants, session non valide IDs  
**Vérification :** configuration du transfert de chaînes de requêtes CDN, encodage des paramètres

403 Forbidden  
**Causes fréquentes :** un joueur client demande un segment qui n'existe pas ou qui n'est pas autorisé à y accéder. Pour les segments publicitaires, MediaTailor il est possible que vous ayez spécifié un segment inexistant (contactez [AWS Support pour en](https://aws.amazon.com/premiumsupport/) savoir plus). Pour les segments de contenu, les restrictions d'accès du fournisseur d'origine ou les problèmes d'authentification  
**Vérifiez :** pour les segments publicitaires : contactez le [support AWS](https://aws.amazon.com/premiumsupport/) si le segment généré n' MediaTailor est pas valide URLs. Pour les segments de contenu : vérifiez les autorisations du serveur d'origine, les informations d'authentification et les politiques d'accès. Vérifiez si les segments existent au niveau demandé URLs

404 – Non trouvé  
**Causes courantes :** MediaTailor la configuration n'existe pas ou est inactive, chemin d'URL de lecture incorrect, manifeste ou demande de segment vers des ressources inexistantes  
**Vérification : vérifiez** que MediaTailor la configuration existe et qu'elle est active, confirmez que l'URL de lecture correspond au formulaire`GetPlaybackConfiguration`, vérifiez les règles `ManifestEndpointPrefix` de routage du CDN, transférez les demandes aux points de terminaison appropriés MediaTailor 

500 Erreur de serveur interne  
**Causes courantes :** problèmes liés au serveur Origin, problèmes de connectivité ADS, erreurs de traitement des manifestes  
**Vérification :** état du serveur Origin, validité de la réponse ADS, état du MediaTailor service

502 Passerelle défectueuse  
**Causes courantes :** serveur d'origine inaccessible, réponse d'origine non valide `UnsupportedManifestException` en raison de problèmes d'alignement des listes de lecture HLS (marqueurs SCTE non alignés sur les listes de lecture, marqueurs SCTE manquants sur certaines listes de lecture, temps de pause publicitaire incohérent selon les variantes de débit)  
**Vérification :** règles de connectivité et de pare-feu au serveur Origin, résolution DNS, cohérence des playlists HLS sur toutes les variantes de débit, alignement des marqueurs SCTE-35 sur les mêmes segments dans toutes les playlists, vérification que toutes les playlists contiennent les marqueurs de coupure de publicité requis

**Ressources d'analyse des codes d'erreur :**
+ [Résolution des problèmes MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html) - Référence complète du code MediaTailor d'erreur
+ [Résolution des problèmes de réponse aux CloudFront erreurs - Analyse des erreurs](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/troubleshooting-response-errors.html) spécifiques au CDN
+ Codes [d'état des réponses HTTP - Référence complète des codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) d'état HTTP
+ [Gestion des défaillances - Modèles de gestion](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/failure-management.html) des erreurs Well-Architected

# Outils d'analyse des journaux CDN et techniques de surveillance pour MediaTailor
<a name="log-analysis-techniques"></a>

AWS Elemental MediaTailor L'intégration d'un réseau de diffusion de contenu (CDN) génère d'importants volumes de données de journal qui nécessitent des outils et des techniques d'analyse efficaces. Utilisez ces approches pour analyser efficacement le réseau de diffusion de contenu et MediaTailor les journaux :
+ **Analyse par ligne de commande :** utilisez des outils tels que `grep``awk`, et `sort` pour filtrer et analyser les modèles de journalisation
+ **Amazon CloudWatch Logs Insights :** CDN de requêtes et MediaTailor journaux avec une syntaxe similaire à celle de SQL pour une analyse avancée
+ **Outils tiers :** pensez aux plateformes d'analyse des journaux pour une surveillance et des alertes complètes
+ **Tableaux de bord personnalisés :** créez des visualisations qui combinent les métriques du CDN avec les données de performance MediaTailor 

Si vous avez besoin d'une assistance supplémentaire pour l'analyse des logs ou l'interprétation de modèles d'erreur complexes, consultez[Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md).

**Outils et ressources d'analyse des journaux :**
+ [CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) - Requêtes de type SQL pour l'analyse des journaux
+ [Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/what-is.html) - Recherche et analyse avancées dans les journaux
+ [CloudWatch tableaux de bord](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) - Visualisation et surveillance personnalisées
+ [Instrumentation des systèmes distribués pour une visibilité opérationnelle - Modèles](https://aws.amazon.com/builders-library/instrumenting-distributed-systems-for-operational-visibility/) d'observabilité avancés
+ Observabilité [de la charge de travail de conception - Guide d'observabilité](https://docs.aws.amazon.com/wellarchitected/latest/operational-excellence-pillar/design-workload-observability.html) de Well-Architected

## MediaTailor ressources de configuration de journalisation
<a name="mediatailor-logging-resources"></a>

Outre les journaux CDN, MediaTailor fournit des fonctionnalités de journalisation complètes pour surveiller l'insertion des publicités, la génération de manifestes et les interactions entre les services. Utilisez ces ressources pour configurer et analyser les MediaTailor journaux :

MediaTailor manifeste et journaux de service  
Configurez et analysez les journaux pour la génération de manifestes, les interactions d'origine et les événements de service :  
+ [AWS Elemental MediaTailor description des journaux manifestes et types d'événements](log-types.md)- Référence complète pour les journaux de MediaTailor manifestes et les types d'événements
+ [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md)- Guide de visualisation et d'interprétation MediaTailor des journaux

Configuration des journaux vendus  
Configurez la livraison flexible des journaux vers plusieurs destinations avec optimisation des coûts :  
+ [Utiliser les journaux vendus pour envoyer AWS Elemental MediaTailor des journaux](vended-logs.md)- Configurer la livraison des journaux vers Amazon S3, Firehose ou Logs CloudWatch 
+ [Migration de votre stratégie de AWS Elemental MediaTailor journalisation](vended-logs-migrate.md)- Guide de migration pour les configurations de journalisation existantes

CloudWatch Intégration des journaux  
Intégrez MediaTailor les journaux à CloudWatch des fins de surveillance et d'analyse :  
+ [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md)- Configuration et analyse des CloudWatch journaux
+ [CloudWatchInsights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)- Interrogation et analyse avancées des journaux

Journalisation spécifique à la publicité  
Surveillez les performances d'insertion des publicités et résolvez les problèmes liés aux publicités :  
+ Journaux d'interaction ADS - Surveillez les communications et les erreurs du serveur de décision publicitaire

**Principales différences entre le CDN et les MediaTailor logs :**
+ **Journaux du CDN** : affiche request/response les modèles, le comportement du cache et les erreurs au niveau du réseau provenant de votre réseau de diffusion de contenu
+ **MediaTailor journaux : affiche les** détails d'insertion des annonces, les événements de génération de manifestes, les interactions d'origine et les erreurs spécifiques au service
+ **Analyse combinée** : utilisez les deux types de journaux ensemble pour une visibilité complète de votre flux de travail de streaming

Pour une surveillance complète qui combine à la fois le CDN et la MediaTailor journalisation, voir[Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md).

# Automatisez MediaTailor et créez un CDN avec CloudFormation
<a name="automating-cdn-integration"></a>

L'automatisation à l' AWS Elemental MediaTailor aide d'un réseau de diffusion de contenu (CDN) AWS CloudFormation rationalise votre flux de travail d'insertion publicitaire et améliore la fiabilité.

Cette section explique comment utiliser AWS CloudFormation (AWS infrastructure en tant que service de code) pour configurer automatiquement un réseau AWS Elemental MediaTailor de diffusion de contenu (CDN). Bien que vous puissiez configurer manuellement cette intégration comme décrit dans les sections précédentes, son utilisation CloudFormation permet de gagner du temps et de réduire les erreurs en automatisant l'ensemble du processus à l'aide d'un seul modèle.

Si vous êtes nouveau dans ce CloudFormation domaine, il s'agit d'un service qui vous permet de créer un modèle de fichier qui définit toutes les ressources AWS dont vous avez besoin. Lorsque vous déployez ce modèle, il crée et configure CloudFormation automatiquement ces ressources pour vous, en veillant à ce qu'elles fonctionnent correctement ensemble.

Pour plus d'informations CloudFormation, consultez le [guide de CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html). Pour plus d'informations sur les types de MediaTailor ressources dans CloudFormation, voir [AWS: : MediaTailor Resource Type Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_MediaTailor.html).

**Topics**
+ [Pourquoi utiliser AWS CloudFormation](cloudformation-benefits.md)
+ [Préparation au déploiement](prepare-cloudformation-deployment.md)
+ [Déployer le modèle](deploy-cloudformation-template.md)
+ [Utiliser les ressources déployées](use-deployed-resources.md)
+ [Testez et validez votre déploiement](test-validate-deployment.md)
+ [Résolution des problèmes de déploiement](troubleshoot-deployment-issues.md)
+ [Personnalisez le modèle](customize-cloudformation-template.md)
+ [Référence de modèles](cloudformation-template-reference.md)

# Pourquoi utiliser CloudFormation for MediaTailor et intégrer un CDN
<a name="cloudformation-benefits"></a>

AWS Elemental MediaTailor l'automatisation AWS CloudFormation offre des avantages significatifs aux professionnels de la diffusion qui gèrent les flux de travail de streaming. La configuration manuelle à l' MediaTailor aide d'un réseau de diffusion de contenu (CDN) peut être chronophage et source d'erreurs. Le recours à l' CloudFormation automatisation présente les avantages suivants.
+ **Cohérence** : garantit que la même configuration est déployée à chaque fois, réduisant ainsi les erreurs humaines.
+ **Contrôle de version** : stockez votre infrastructure sous forme de code dans un système de contrôle de version pour suivre les modifications.
+ **Déploiement rapide** : déployez des configurations complexes en quelques minutes au lieu de plusieurs heures de configuration manuelle.
+ **Réplication de l'environnement** : répliquez facilement les configurations dans les environnements de développement, de test et de production.
+ **Documentation** : Le modèle lui-même sert de documentation de votre infrastructure.

Voici comment le flux de travail automatisé se compare à la configuration manuelle :


| Configuration manuelle (plusieurs étapes) | Configuration automatisée (modèle unique) | 
| --- | --- | 
| Création d'une configuration de MediaTailor lecture | Déployer un CloudFormation modèle avec des paramètres | 
| Création d'une CloudFront distribution | 
| Configuration des comportements du cache | 
| Configuration des configurations de sécurité | 

Le flux de travail automatisé pour la configuration MediaTailor CloudFront suit les étapes suivantes :

1. Déployez le CloudFormation modèle avec l'origine de votre contenu et les paramètres de votre serveur publicitaire

1. CloudFormation crée et configure toutes les ressources nécessaires :
   + MediaTailor configuration de lecture pour l'insertion de publicités
   + CloudFront distribution avec des comportements de cache appropriés
   + Configurations de sécurité pour la protection du contenu

1. Utilisez les CloudFormation sorties pour accéder à votre flux publicitaire URLs

1. Diffusez votre contenu avec des publicités insérées dynamiquement

# Préparation au CloudFormation déploiement du CDN et MediaTailor des intégrations
<a name="prepare-cloudformation-deployment"></a>

AWS Elemental MediaTailor déploiement AWS CloudFormation nécessitant des prérequis et des étapes de préparation spécifiques. Avant de commencer CloudFormation à travailler avec Amazon pour intégrer MediaTailor CloudFront, assurez-vous de disposer des éléments suivants.
+ Un AWS compte avec des autorisations de création MediaTailor CloudFront, et CloudFormation des ressources
+ Une origine de contenu sur laquelle votre contenu vidéo est hébergé (Amazon S3 ou un autre serveur d'origine, par exemple) AWS Elemental MediaPackage
+ Un serveur de décision publicitaire (ADS) capable de répondre aux demandes VAST

Avant de déployer le CloudFormation modèle, collectez les paramètres obligatoires suivants :

`AdServerUrl`  
URL du serveur publicitaire VAST pour l'insertion dynamique d'annonces. Un point de terminaison VAST statique est fourni pour les tests.

`ContentOriginDomainName`  
Nom de domaine de l'origine de votre contenu sans protocole (par exemple *mediapackage-domain.mediapackagev2.us-west-2.amazonaws.com**mybucket.s3.amazonaws.com*, ou*custom-origin.example.com*). N'incluez pas de préfixes http ://ou https ://ni aucun chemin.

`ContentOriginType`  
Type d'origine du contenu :  
+ *mediapackagev2* : Pour les origines AWS Elemental MediaPackage 
+ *s3* : Pour les origines des compartiments Amazon S3
+ *personnalisé* : pour tout autre type d'origine

Le modèle créera plusieurs AWS ressources qui fonctionnent ensemble pour diffuser votre contenu sous forme de publicités personnalisées. Ce qui suit décrit le rôle de chaque composant :

## Contrôle d'accès à l'origine
<a name="origin-access-control-resource"></a>

Le contrôle d'accès à l'origine (OAC) est une fonctionnalité de sécurité qui garantit que votre contenu n'est accessible que par le biais de votre serveur d'origine CloudFront, et non directement à partir de celui-ci. Cela permet de protéger votre contenu contre tout accès non autorisé.

Pour Amazon S3 Origins MediaPackage et Amazon S3, le modèle crée une ressource Origin Access Control (OAC) pour sécuriser l'accès à votre contenu. 

## MediaTailor configuration de lecture
<a name="mediatailor-resource"></a>

La configuration de MediaTailor lecture est le composant principal qui gère l'insertion des publicités. Il reçoit du contenu provenant de votre origine, demande des publicités à votre serveur publicitaire et les combine dans un flux personnalisé pour chaque spectateur.

Le modèle crée une configuration de MediaTailor lecture avec les paramètres suivants :
+ Source de contenu vidéo pointant vers votre CloudFront distribution
+ URL du serveur de décision publicitaire configurée sur le point de terminaison VAST que vous avez spécifié
+ Configuration de pré-diffusion en direct pour l'insertion de publicités pendant les diffusions en direct
+ Configuration du CDN avec les préfixes d'URL de segment appropriés

## CloudFront distribution
<a name="cloudfront-resource"></a>

La CloudFront distribution diffuse votre contenu aux spectateurs du monde entier avec une faible latence. Il gère différents types de demandes (manifestes, segments de contenu, segments publicitaires) et les achemine vers les sources appropriées.

Pour les professionnels de la diffusion CDNs novices, voici quelques termes clés :

Origin  
Un serveur sur lequel votre contenu original est stocké (comme MediaPackage Amazon S3)

Comportement de cache  
Règles qui déterminent la manière dont les différents types de contenu sont mis en cache et diffusés

Politique de cache  
Paramètres qui contrôlent la durée de mise en cache du contenu et les composants de demande qui affectent la mise en cache

Le modèle crée une CloudFront distribution avec les composants suivants :
+ Trois origines :
  + Origine du contenu (MediaPackageAmazon S3 ou personnalisé)
  + MediaTailor origine des manifestes
  + MediaTailor origine des segments
+ Comportements du cache avec des modèles appropriés :
  + Comportement par défaut pour les segments de contenu
  + Comportement des segments MediaTailor publicitaires (/tm/\$1)
  + Comportement pour les médias MediaTailor interstitiels (/v1/i-media/\$1)
  + Comportement pour les manifestes personnalisés (/v1/\$1)
  + Comportement des demandes de redirection de segment (/segment/\$1)
+ Politiques de cache optimisées pour chaque comportement :
  + `CachingOptimized`pour du contenu pouvant être mis en cache
  + `CachingDisabled`pour des manifestes personnalisés
+ Politiques de demande d'origine pour garantir le transfert correct des en-têtes
+ Politiques d'en-tête de réponse pour le support CORS

# Déployer le CloudFormation modèle pour le CDN et les intégrations MediaTailor
<a name="deploy-cloudformation-template"></a>

AWS Elemental MediaTailor le déploiement à l'aide du AWS CloudFormation modèle est simple une fois que vous comprenez ce que le modèle va créer. Ce processus prend environ 15 à 30 minutes, la plupart du temps étant consacré à attendre le déploiement de la CloudFront distribution.

Pour déployer le CloudFormation modèle et configurer votre flux de travail d'insertion automatique d'annonces, procédez comme suit :

**Pour déployer le MediaTailor CloudFormation modèle**

1. Téléchargez le CloudFormation modèle depuis le AWS Elemental MediaTailor GitHub référentiel ou copiez-le depuis le[AWS CloudFormation modèle de référence pour AWS Elemental MediaTailor l' CloudFront intégration à Amazon](cloudformation-template-reference.md).

1. Ouvrez la [CloudFormation console](https://console.aws.amazon.com/cloudformation/home).

1. Choisissez **Créer une pile** > **Avec de nouvelles ressources (standard)**.

1. Sous **Spécifier le modèle**, choisissez **Télécharger un fichier modèle** et chargez le modèle.

1. Entrez un nom de pile et fournissez des valeurs pour les paramètres requis :
   + **AdServerUrl**: URL de votre serveur publicitaire VAST (par exemple, https ://*your-ad-server.com*/vast)
   + **ContentOriginDomainName**: nom de domaine de l'origine de votre contenu sans protocole (par exemple,*mediapackage-domain.mediapackagev2.us-west-2.amazonaws.com*)
   + **ContentOriginType**: Sélectionnez le type d'origine du contenu :
     + *mediapackagev2* : Pour les origines AWS Elemental MediaPackage 
     + *s3* : Pour les origines des compartiments Amazon S3
     + *personnalisé* : pour tout autre type d'origine

1. Passez en revue la configuration et choisissez **Create stack**.

1. Attendez que la création de la pile soit terminée, ce qui prend généralement 5 à 10 minutes. Vous pouvez suivre les progrès dans l'onglet **Événements**.

1. Une fois terminé, accédez à l'onglet **Sorties** URLs pour trouver les manifestes HLS et DASH.

**Note**  
Si vous l'utilisez AWS Elemental MediaPackage comme origine de contenu, assurez-vous que vos MediaPackage points de terminaison sont correctement configurés et accessibles. Pour de plus amples informations, veuillez consulter [MediaPackage Intégration au CDN](mediapackage-integration.md).

# Utiliser les ressources CloudFormation déployées pour le CDN et l'intégration MediaTailor
<a name="use-deployed-resources"></a>

AWS Elemental MediaTailor les ressources déployées par la AWS CloudFormation pile fournissent plusieurs résultats importants que vous utiliserez pour accéder à votre contenu grâce à l'insertion de publicités. Une fois la CloudFormation pile créée avec succès, vous devez comprendre comment utiliser les résultats pour accéder à votre contenu contenant des annonces insérées. Cette méthode est similaire à celle que vous utiliseriez MediaTailor URLs dans une configuration manuelle, mais le CloudFormation déploiement les fournit URLs automatiquement.

Une fois le déploiement réussi, la CloudFormation pile fournit plusieurs résultats importants que vous utiliserez pour accéder à votre contenu lors de l'insertion d'annonces :

`CloudFrontDomainName`  
Le nom de domaine de votre CloudFront distribution (par exemple,*d1234abcdef.CloudFront.net*)

`HlsManifestUrl`  
URL de base pour les manifestes HLS avec insertion d'annonces (par exemple, https ://*d1234abcdef.CloudFront.net**12345*/v1/master////) *my-playback-config*

`DashManifestUrl`  
URL de base pour les manifestes DASH avec insertion d'annonces (par exemple, https ://*d1234abcdef.CloudFront.net**12345*/v1/dash////) *my-playback-config*

`MediaTailorPlaybackConfigName`  
Nom de la configuration MediaTailor de lecture créée (par exemple*my-stack-PlaybackConfig*)

## Construire une lecture URLs
<a name="construct-playback-urls"></a>

Pour créer l'URL de diffusion complète de votre contenu contenant des publicités, vous devez associer l'URL de base des CloudFormation résultats à votre chemin de manifeste spécifique. Il s'agit d'une étape essentielle que les professionnels de la diffusion doivent comprendre, car elle connecte votre contenu existant au système d'insertion publicitaire.

1. Commencez par l'URL du manifeste approprié dans les sorties :

   ```
   HlsManifestUrl: https://d1234abcdef.CloudFront.net/v1/master/12345/my-playback-config/
   ```

1. Ajoutez le chemin de votre manifeste spécifique :

   ```
   Your manifest path: channel/index.m3u8
   ```

1. L'URL de lecture complète devient :

   ```
   https://d1234abcdef.CloudFront.net/v1/master/12345/my-playback-config/channel/index.m3u8
   ```

Utilisez cette URL dans votre lecteur vidéo pour diffuser du contenu contenant des publicités insérées dynamiquement.

**Astuce**  
Si vous ne savez pas quel doit être le chemin de votre manifeste, vérifiez votre serveur d'origine. Pour les MediaPackage origines, il s'agit du chemin d'accès au manifeste HLS ou DASH de votre terminal. Pour les origines d'Amazon S3, il s'agit du chemin d'accès à votre fichier manifeste dans le compartiment.

Pour plus d'informations sur la structure des MediaTailor URL, consultez[Configurer l'intégration du CDN avec MediaTailor](cdn-configuration.md).

## Configuration d'un lecteur vidéo
<a name="configure-video-player"></a>

Une fois que vous avez obtenu votre URL de lecture, vous devez configurer un lecteur vidéo pour l'utiliser. Pour les professionnels de la diffusion, cela revient à configurer un lecteur pour n'importe quel stream HLS ou DASH, mais le stream inclura désormais des publicités personnalisées. Voici un exemple simple d'utilisation du populaire HLS.js  lecteur :

```
<!DOCTYPE html>
<html>
<head>
    <title>MediaTailor Playback Example</title>
    <script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
</head>
<body>
    <video id="video" controls style="width: 640px; height: 360px;"></video>
    
    <script>
        const video = document.getElementById('video');
        const mediaUrl = 'https://<replaceable>d1234abcdef.CloudFront.net</replaceable>/v1/master/<replaceable>12345</replaceable>/<replaceable>my-playback-config</replaceable>/<replaceable>channel/index.m3u8</replaceable>';
        
        if (Hls.isSupported()) {
            const hls = new Hls();
            hls.loadSource(mediaUrl);
            hls.attachMedia(video);
        } else if (video.canPlayType('application/vnd.apple.mpegurl')) {
            video.src = mediaUrl;
        }
    </script>
</body>
</html>
```

Vous pouvez également utiliser des lecteurs de diffusion professionnels tels que :
+ Joueur JW
+ Lecteur Bitmovin
+ THEOplayer
+ Video.js

Pour plus d'informations sur l'intégration des joueurs avec MediaTailor, consultez[MediaTailor exigences relatives à l'intégration des serveurs publicitaires](vast.md).

# Testez et validez votre CloudFormation déploiement pour le CDN et l'intégration MediaTailor
<a name="test-validate-deployment"></a>

AWS Elemental MediaTailor la validation du déploiement est une étape essentielle pour les professionnels de la diffusion avant la mise en ligne. Cette section vous explique comment tester votre déploiement afin de vous assurer que les publicités sont correctement insérées et que le contenu est diffusé sans problème.

Après avoir déployé le CloudFormation modèle, procédez comme suit pour vérifier que votre configuration fonctionne correctement :

**Pour tester votre CloudFront intégration MediaTailor et votre intégration**

1. Vérifiez que toutes les ressources ont été créées correctement dans la CloudFormation console.

1. Vérifiez que la configuration de MediaTailor lecture est active dans la [MediaTailor console](https://console.aws.amazon.com/mediatailor/home).

1. Vérifiez que la CloudFront distribution est déployée et activée dans la [CloudFront console](https://console.aws.amazon.com/CloudFront/home).

1. Testez la lecture à l'aide d'un exemple de manifeste :

   1. Créez l'URL de lecture complète comme décrit dans[Construire une lecture URLs](use-deployed-resources.md#construct-playback-urls).

   1. Utilisez un lecteur vidéo compatible HLS ou DASH (comme VLC, JW Player ou le lecteur AWS console).

   1. Vérifiez que le contenu est diffusé et que les publicités sont insérées aux points de rupture attendus.

1. Vérifiez les connexions MediaTailor CloudWatch pour détecter d'éventuelles erreurs d'insertion d'annonces.

Lorsque vous testez l'insertion d'annonces, recherchez les indicateurs de succès suivants :
+ Transitions fluides entre le contenu et les publicités
+ Les publicités apparaissent aux points de rupture attendus (pré-lancement, mi-lancement, post-lancement)
+ La qualité de l'annonce correspond à la qualité du contenu
+ Aucune erreur de mise en mémoire tampon ou de lecture pendant les transitions publicitaires

Pour des procédures de test plus détaillées, voir[Comprendre le comportement d'insertion des AWS Elemental MediaTailor publicités](ad-behavior.md). Pour des tests et une validation complets de l'intégration du CDN, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md).

# Résoudre les problèmes de CloudFormation déploiement courants pour le CDN et les intégrations MediaTailor
<a name="troubleshoot-deployment-issues"></a>

AWS Elemental MediaTailor des problèmes de déploiement peuvent survenir même en cas d'automatisation lors du déploiement ou de la lecture. En tant que professionnel de la diffusion, comprendre comment résoudre ces problèmes vous aidera à maintenir un service de streaming fiable avec insertion de publicités.

Si vous rencontrez des problèmes lors de votre CloudFormation déploiement ou de l' CloudFrontintégration qui en résulte MediaTailor , consultez les problèmes et solutions courants suivants :

## CloudFormation problèmes de déploiement
<a name="deployment-troubleshooting"></a>

La création de la pile échoue avec l'erreur « Échec de la création de ressources »  
**Causes possibles :**  
+ Format de nom de domaine d'origine du contenu non valide
+ Autorisations insuffisantes pour créer des ressources
**Solution :** Vérifiez l'erreur de ressource spécifique dans l'onglet CloudFormation Événements. Vérifiez que le nom de domaine d'origine du contenu est correctement formaté sans préfixes ni chemins de protocole. Assurez-vous que votre rôle IAM dispose des autorisations suffisantes pour créer toutes les ressources requises.

CloudFront le déploiement de la distribution prend beaucoup de temps  
**Cause :** le déploiement complet des CloudFront distributions prend généralement 15 à 30 minutes.  
**Solution :** il s'agit du comportement normal. Attendez que la distribution atteigne l'état « Déployé » avant de procéder au test.

## Problèmes de lecture et d'insertion de publicités
<a name="playback-troubleshooting"></a>

Le contenu est diffusé mais aucune publicité n'est insérée  
**Causes possibles :**  
+ Le serveur de décision publicitaire ne répond pas ou renvoie un VAST vide
+ Le contenu ne contient pas de marqueurs publicitaires
**Solution :** vérifiez que votre serveur publicitaire est accessible et qu'il renvoie des réponses VAST valides. Vérifiez que votre contenu comporte des marqueurs publicitaires appropriés (marqueurs SCTE-35 pour le contenu en direct ou balises ad break pour la VOD).

403 Erreurs interdites lors de l'accès au contenu  
**Causes possibles :**  
+ Le contrôle d'accès à l'origine n'est pas configuré correctement
+ Problèmes liés au bucket d'origine ou aux autorisations des terminaux
**Solution :** pour les origines d'Amazon S3, vérifiez que la politique des compartiments autorise l'accès depuis la CloudFront distribution. Pour les MediaPackage origines, vérifiez que le contrôle d'accès aux origines est correctement configuré et que le point de terminaison est accessible.

Erreurs de lecture ou mise en mémoire tampon  
**Causes possibles :**  
+ Les modèles de chemins de comportement du cache ne correspondent pas aux chemins de contenu
+ Configuration du domaine d'origine incorrecte
**Solution :** vérifiez que vos comportements de cache présentent les modèles de chemin corrects pour acheminer les demandes vers les origines appropriées. Consultez CloudFront les journaux pour voir quelle origine traite les demandes et confirmez qu'il s'agit bien de celle attendue.

Pour les professionnels de la diffusion, ces conseils de dépannage supplémentaires peuvent être utiles :
+ Utilisez Amazon CloudWatch Logs Insights pour rechercher des modèles d'erreur spécifiques dans MediaTailor les journaux
+ Testez d'abord avec un simple serveur publicitaire VAST (comme celui fourni par défaut dans le modèle) avant d'utiliser votre serveur publicitaire de production
+ Vérifiez les marqueurs publicitaires de votre contenu à l'aide de l'outil d'inspection des MediaTailor manifestes de la console
+ Vérifiez le trafic réseau dans les outils de développement de votre navigateur pour vérifier si les demandes adressées au serveur publicitaire sont correctement envoyées

Pour un dépannage supplémentaire, consultez les CloudWatch journaux afin d'identifier les deux types d'erreurs MediaTailor et CloudFront d'identifier les erreurs spécifiques. 

# Personnalisez le CloudFormation modèle pour le CDN et les intégrations MediaTailor
<a name="customize-cloudformation-template"></a>

AWS Elemental MediaTailor la personnalisation du modèle permet aux professionnels de la diffusion d'adapter le AWS CloudFormation modèle aux exigences spécifiques du flux de travail. Bien que le modèle de base fonctionne pour de nombreux scénarios, ces personnalisations peuvent vous aider à répondre à des besoins plus complexes.

Les exemples ci-dessous montrent des extraits de code YAML que vous pouvez ajouter au modèle. Si vous ne connaissez pas le langage YAML ou CloudFormation la syntaxe, envisagez de faire appel à un développeur ou à un architecte de AWS solutions pour effectuer ces modifications.

Vous pouvez personnaliser le CloudFormation modèle pour répondre à vos exigences spécifiques en matière de flux de travail.

## Ajouter ou modifier des origines
<a name="add-modify-origins"></a>

Pour les flux de diffusion qui utilisent plusieurs sources de contenu (telles que des sources principales et de sauvegarde, ou différentes bibliothèques de contenu), vous pouvez ajouter des origines supplémentaires à votre CloudFront distribution :

```
Origins:
  # Add a new origin for additional content
  - Id: SecondaryContentOrigin
    DomainName: secondary-content.example.com
    CustomOriginConfig:
      OriginProtocolPolicy: 'https-only'
      OriginSSLProtocols: 
        - TLSv1.2
```

Ajoutez ensuite un comportement de cache correspondant pour acheminer des modèles spécifiques vers cette origine :

```
CacheBehaviors:
  - PathPattern: '/secondary-content/*'
    TargetOriginId: SecondaryContentOrigin
    ViewerProtocolPolicy: 'https-only'
    CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6  # Managed-CachingOptimized
```

## Création de politiques de cache personnalisées
<a name="create-custom-cache-policies"></a>

Pour les flux de diffusion soumis à des exigences de mise en cache spécifiques (comme les paramètres de sélection de qualité ou l'authentification du spectateur), vous pouvez créer des politiques de cache personnalisées au lieu d'utiliser des politiques de cache gérées. Pour obtenir des conseils détaillés sur les valeurs TTL et les stratégies de mise en cache, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)

```
# Define a custom cache policy
CustomCachePolicy:
  Type: AWS::CloudFront::CachePolicy
  Properties:
    CachePolicyConfig:
      Name: !Sub '${AWS::StackName}-CustomCachePolicy'
      DefaultTTL: 86400  # 24 hours
      MaxTTL: 31536000   # 1 year
      MinTTL: 1          # 1 second
      ParametersInCacheKeyAndForwardedToOrigin:
        CookiesConfig:
          CookieBehavior: none
        HeadersConfig:
          HeaderBehavior: none
        QueryStringsConfig:
          QueryStringBehavior: whitelist
          QueryStrings:
            - quality
            - format

# Reference the custom policy in a cache behavior
CacheBehaviors:
  - PathPattern: '/custom-path/*'
    TargetOriginId: ContentOrigin
    ViewerProtocolPolicy: 'https-only'
    CachePolicyId: !Ref CustomCachePolicy
```

## Améliorez la MediaTailor configuration
<a name="enhance-mediatailor-config"></a>

Pour les flux de diffusion nécessitant des fonctionnalités avancées d'insertion de publicités, vous pouvez améliorer la MediaTailor configuration grâce à des options telles que le préchargement des publicités (pour réduire le temps de latence), les seuils de personnalisation et les publicités exceptionnelles.

```
MediaTailorPlaybackConfig:
  Type: AWS::MediaTailor::PlaybackConfiguration
  Properties:
    # Add ad prefetching for improved performance
    AvailSuppression:
      Mode: BEHIND_LIVE_EDGE
      Value: 00:00:00
    # Add personalization parameters
    PersonalizationThresholdSeconds: 2
    # Add bumper ads
    Bumper:
      StartUrl: https://example.com/bumper-start.mp4
      EndUrl: https://example.com/bumper-end.mp4
    # Other existing properties...
```

Pour plus d'informations sur les options MediaTailor de configuration, consultez[Utilisation AWS Elemental MediaTailor pour insérer des publicités](configurations.md).

## Ajoutez des fonctionnalités de sécurité
<a name="add-security-features"></a>

Pour les flux de diffusion soumis à des exigences de sécurité spécifiques (comme les restrictions géographiques ou la protection contre les attaques DDo S), vous pouvez ajouter des AWS WAF intégrations et des restrictions géographiques :

```
# Create a AWS WAF Web ACL
WebACL:
  Type: AWS::WAFv2::WebACL
  Properties:
    Name: !Sub '${AWS::StackName}-WebACL'
    Scope: CloudFront
    DefaultAction:
      Allow: {}
    VisibilityConfig:
      SampledRequestsEnabled: true
      CloudWatchMetricsEnabled: true
      MetricName: !Sub '${AWS::StackName}-WebACL'
    Rules:
      - Name: RateLimitRule
        Priority: 0
        Action:
          Block: {}
        VisibilityConfig:
          SampledRequestsEnabled: true
          CloudWatchMetricsEnabled: true
          MetricName: RateLimitRule
        Statement:
          RateBasedStatement:
            Limit: 1000
            AggregateKeyType: IP

# Reference the AWS WAF Web ACL in the CloudFront distribution
CloudFrontDistribution:
  Type: AWS::CloudFront::Distribution
  Properties:
    DistributionConfig:
      WebACLId: !GetAtt WebACL.Arn
      # Add geo-restriction
      Restrictions:
        GeoRestriction:
          RestrictionType: whitelist
          Locations:
            - US
            - CA
            - GB
      # Other existing properties...
```

Pour plus d'informations sur les CloudFormation modèles, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html).

Pour obtenir des CloudFormation modèles et des exemples spécifiques à la diffusion, consultez le référentiel d'[outils GitHub AWS Media Services](https://github.com/aws-samples/aws-media-services-tools).

# AWS CloudFormation modèle de référence pour AWS Elemental MediaTailor l' CloudFront intégration à Amazon
<a name="cloudformation-template-reference"></a>

AWS Elemental MediaTailor l'intégration avec Amazon CloudFront peut être automatisée à l'aide du AWS CloudFormation modèle complet suivant :

```
AWSTemplateFormatVersion: '2010-09-09'
Description: | CloudFormation template that sets up AWS Elemental MediaTailor integration with CloudFront Distribution
  for server-side ad insertion. This template supports various content origins including MediaPackage, Amazon S3,
  and custom origins, making it versatile for different streaming architectures.

Parameters:
  AdServerUrl:
    Type: String
    Default: 'https://d1kbmkziz9rksx.CloudFront.net/VASTEndpoint.xml'
    Description: URL of the VAST ad server for dynamic ad insertion. Static VAST endpoint provided for testing. 

  ContentOriginDomainName:
    Type: String
    Description: |
      Domain name of your content origin without protocol (e.g., mediapackage-domain.mediapackagev2.us-west-2.amazonaws.com,
      mybucket.s3.amazonaws.com, or custom-origin.example.com).
      Do not include http:// or https:// prefixes or any paths.
    AllowedPattern: "^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$"
    ConstraintDescription: Must be a valid domain name (e.g., example.com) without protocol or path components. IP addresses are not allowed.

  ContentOriginType:
    Type: String
    AllowedValues:
      - mediapackagev2
      - s3
      - custom
    Default: mediapackagev2
    Description: |
      The type of content origin:
      - mediapackagev2: AWS Elemental MediaPackage V2
      - s3: Amazon S3 bucket
      - custom: Any other custom origin

Resources:
  #---------------------------------------------------------------------------
  # Origin Access Control (for securing MediaPackage V2 and Amazon S3 origins)
  #---------------------------------------------------------------------------
  CloudFrontOriginAccessControl:
    Type: AWS::CloudFront::OriginAccessControl
    Condition: IsNotCustomOrigin
    Properties:
      OriginAccessControlConfig:
        Name: !Sub '${AWS::StackName}-OAC'
        OriginAccessControlOriginType: !Ref ContentOriginType
        SigningBehavior: always
        SigningProtocol: sigv4
        Description: Origin Access Control for content origin

  #---------------------------------------------------------------------------
  # MediaTailor Playback Configuration
  #---------------------------------------------------------------------------
  MediaTailorPlaybackConfig:
    Type: AWS::MediaTailor::PlaybackConfiguration
    Properties:
      Name: !Sub '${AWS::StackName}-PlaybackConfig'
      # The video content source should point to your CloudFront distribution
      VideoContentSourceUrl: !Sub 'https://${CloudFrontDistribution.DomainName}/'
      # The Ad Decision Server URL is where MediaTailor will request ads
      AdDecisionServerUrl: !Ref AdServerUrl
      # Configuration for pre-roll ads during live streams
      LivePreRollConfiguration:
        AdDecisionServerUrl: !Ref AdServerUrl
        MaxDurationSeconds: 30
      # CDN configuration for integrating with CloudFront
      CdnConfiguration:
        AdSegmentUrlPrefix: '/'
        ContentSegmentUrlPrefix: '/'
      # Set a reasonable manifest segment timeout
      ManifestProcessingRules:
        AdMarkerPassthrough:
          Enabled: false

  #---------------------------------------------------------------------------
  # CloudFront Distribution
  #---------------------------------------------------------------------------
  CloudFrontDistribution:
    Type: AWS::CloudFront::Distribution
    Properties:
      DistributionConfig:
        Enabled: true
        HttpVersion: http2and3
        IPV6Enabled: true
        Comment: !Sub 'Distribution for MediaTailor ad insertion with ${ContentOriginType} origin'
        
        # Default cache behavior points to the content origin
        DefaultCacheBehavior:
          TargetOriginId: ContentOrigin
          ViewerProtocolPolicy: 'https-only'
          # Using managed policies for optimal performance and simplicity
          CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6  # Managed-CachingOptimized
          OriginRequestPolicyId: 88a5eaf4-2fd4-4709-b370-b4c650ea3fcf # Managed-HostHeaderOnly
          ResponseHeadersPolicyId: eaab4381-ed33-4a86-88ca-d9558dc6cd63  # Managed-CORS-with-preflight-and-SecurityHeadersPolicy
          Compress: true
        
        # Define all the origins needed for the workflow
        Origins:
          # Main content origin (MediaPackage, Amazon S3, or Custom)
          - Id: ContentOrigin
            DomainName: !Ref ContentOriginDomainName
            # Apply Origin Access Control for secure origins
            OriginAccessControlId: !If [IsNotCustomOrigin, !GetAtt CloudFrontOriginAccessControl.Id, !Ref "AWS::NoValue"]
            # For custom origins, we need a CustomOriginConfig
            CustomOriginConfig:
              OriginProtocolPolicy: 'https-only'
              OriginSSLProtocols: 
                - TLSv1.2
              OriginKeepaliveTimeout: 5
              OriginReadTimeout: 30
              HTTPPort: 80
              HTTPSPort: 443
              
          # MediaTailor Manifests Origin - handles manifest manipulation for ad insertion
          - Id: MediaTailorManifests
            DomainName: !Sub 'manifests.mediatailor.${AWS::Region}.amazonaws.com'
            CustomOriginConfig:
              OriginProtocolPolicy: 'https-only'
              OriginSSLProtocols: 
                - TLSv1.2
              OriginKeepaliveTimeout: 5
              OriginReadTimeout: 30
            # Origin Shield improves caching efficiency 
            OriginShield:
              Enabled: true
              OriginShieldRegion: !Ref AWS::Region
              
          # MediaTailor Segments Origin - handles personalized ads
          - Id: MediaTailorSegments
            DomainName: !Sub 'segments.mediatailor.${AWS::Region}.amazonaws.com'
            CustomOriginConfig:
              OriginProtocolPolicy: 'https-only'
              OriginSSLProtocols: 
                - TLSv1.2
              OriginKeepaliveTimeout: 5
              OriginReadTimeout: 30
        
        # Cache behaviors to route specific request patterns to the right origin
        CacheBehaviors:
          # Handle MediaTailor segment requests for ad content which are cache-able
          - PathPattern: '/tm/*'
            TargetOriginId: MediaTailorSegments
            ViewerProtocolPolicy: 'https-only'
            CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6  # Managed-CachingOptimized
            OriginRequestPolicyId: 88a5eaf4-2fd4-4709-b370-b4c650ea3fcf  # Managed-HostHeaderOnly
            ResponseHeadersPolicyId: eaab4381-ed33-4a86-88ca-d9558dc6cd63  # Managed-CORS-with-preflight-and-SecurityHeadersPolicy
            Compress: true
            
          # Handle MediaTailor interstitial (SGAI) media requests which are cache-able
          - PathPattern: '/v1/i-media/*'
            TargetOriginId: MediaTailorManifests
            ViewerProtocolPolicy: 'https-only'
            CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6  # Managed-CachingOptimized
            OriginRequestPolicyId: 88a5eaf4-2fd4-4709-b370-b4c650ea3fcf  # Managed-HostHeaderOnly
            ResponseHeadersPolicyId: eaab4381-ed33-4a86-88ca-d9558dc6cd63  # Managed-CORS-with-preflight-and-SecurityHeadersPolicy
            Compress: true
            
          # Handle MediaTailor Personalized manifests which are not cache-able
          - PathPattern: '/v1/*'
            TargetOriginId: MediaTailorManifests
            ViewerProtocolPolicy: 'https-only'
            CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad # Managed-CachingDisabled
            OriginRequestPolicyId: 59781a5b-3903-41f3-afcb-af62929ccde1 # Managed-AllViewer
            ResponseHeadersPolicyId: eaab4381-ed33-4a86-88ca-d9558dc6cd63  # Managed-CORS-with-preflight-and-SecurityHeadersPolicy
            Compress: true
            
          # Handle MediaTailor segment *redirect* requests which are not cache-able (used for server side reporting)
          - PathPattern: '/segment/*'
            TargetOriginId: MediaTailorManifests
            ViewerProtocolPolicy: 'https-only'
            CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad # Managed-CachingDisabled
            OriginRequestPolicyId: 59781a5b-3903-41f3-afcb-af62929ccde1 # Managed-AllViewer
            ResponseHeadersPolicyId: eaab4381-ed33-4a86-88ca-d9558dc6cd63  # Managed-CORS-with-preflight-and-SecurityHeadersPolicy
            Compress: true

Conditions:
  IsNotCustomOrigin: !Not [!Equals [!Ref ContentOriginType, 'custom']]

Outputs:
  CloudFrontDomainName:
    Description: Domain name of the CloudFront distribution
    Value: !GetAtt CloudFrontDistribution.DomainName
    
  HlsManifestUrl:
    Description: URL for HLS manifest with ads inserted (append your manifest path)
    Value: !Sub 'https://${CloudFrontDistribution.DomainName}${MediaTailorPlaybackConfig.HlsConfiguration.ManifestEndpointPrefix}'
    
  DashManifestUrl:
    Description: URL for DASH manifest with ads inserted (append your manifest path)
    Value: !Sub 'https://${CloudFrontDistribution.DomainName}${MediaTailorPlaybackConfig.DashConfiguration.ManifestEndpointPrefix}'
    
  MediaTailorPlaybackConfigName:
    Description: Name of the MediaTailor playback configuration
    Value: !Ref MediaTailorPlaybackConfig
```

# Configuration prête pour la production CloudFront pour MediaTailor
<a name="cf-comprehensive-configuration"></a>

Cette configuration CloudFront de distribution fournit tout ce dont vous avez besoin pour diffuser MediaTailor du contenu grâce à l'insertion de publicités côté serveur à grande échelle. Copiez cette configuration et personnalisez-la en fonction de vos origines et de vos besoins spécifiques.

**Ce que cette configuration permet d'accomplir**  
Cette configuration crée une CloudFront distribution prête pour la production qui gère tous les types de MediaTailor demandes avec une mise en cache et des performances optimales. Il inclut trois origines (votre contenu, vos MediaTailor segments et vos MediaTailor manifestes) avec quatre comportements de cache qui acheminent correctement les demandes et mettent en cache le contenu de manière appropriée.

**Quand utiliser cette configuration**  
Cette configuration est idéale pour la diffusion en direct et video-on-demand les flux de travail hybrides qui nécessitent l'insertion de publicités côté serveur.

## Architecture à trois origines
<a name="cf-three-origin-architecture"></a>

MediaTailor utilise un modèle d'architecture à trois origines pour optimiser les performances de diffusion de contenu et d'insertion de publicités. Chaque origine répond à un objectif spécifique dans le flux de travail d'insertion d'annonces :

L'origine de votre contenu  
C'est votre véritable source de contenu qui alimente MediaTailor. Par exemple, il peut s'agir de la AWS Elemental MediaPackage V2 ou d'un autre service de diffusion de contenu. Cette origine diffuse votre contenu d'origine avant l'insertion de l'annonce. Parmi les exemples courants, citons :  
+ MediaPackage Configurations d'emballage V2
+ Réseaux de diffusion de contenu tiers
+ Serveurs de streaming sur site
+ Compartiments Amazon S3 avec contenu statique

MediaTailor origine des segments  
Cette origine utilise le nom d'hôte `segments.mediatailor.region.amazonaws.com` et diffuse les segments publicitaires eux-mêmes après les MediaTailor avoir encodés. Il s'agit des segments vidéo qui contiennent les publicités. Cette origine gère :  
+ Segments publicitaires transcodés dans le même format que votre contenu
+ Demandes redirigées depuis le modèle de `/segment/*` chemin
+ Segments publicitaires qui ont été traités pour l'insertion d'annonces côté serveur

MediaTailor origine des manifestes  
Cette origine utilise le nom d'hôte `manifests.mediatailor.region.amazonaws.com` et peut être utilisée comme nom d'hôte régional pour les configurations de lecture dans la région spécifiée AWS . MediaTailor sélectionne la configuration de lecture correcte en fonction du chemin indiqué dans la demande. Cette origine fournit :  
+ Manifestes HLS et DASH personnalisés avec insertion de publicités spécifiques à l'utilisateur
+ Manifestes d'insertion de publicités guidés par le serveur (SGAI) pour le contenu pouvant être mis en cache
+ Suivi des publicités et gestion des balises pour les rapports côté serveur

Avec le nom d'hôte d'origine`manifests.mediatailor.region.amazonaws.com`, vous pouvez avoir plusieurs configurations de lecture qui fonctionnent avec la même CloudFront distribution si elles se trouvent dans la région spécifiée et si vous incluez le nom de la configuration de lecture dans le chemin de la demande. Par exemple :
+ `https://your-distribution.cloudfront.net/v1/master/playback-config-1/manifest.m3u8`
+ `https://your-distribution.cloudfront.net/v1/master/playback-config-2/manifest.m3u8`

Sélectionnez les politiques de demande d'origine en fonction du type de contenu pour éviter l'empoisonnement du cache tout en garantissant le bon fonctionnement. La principale distinction est entre le contenu pouvant être mis en cache et le contenu non cachable :
+ **Manifestes (non cachables)** : `AllViewer` à utiliser pour transférer tous les en-têtes nécessaires au contenu dynamique. Comme les manifestes ne sont pas mis en cache, il n'y a aucun risque d'empoisonnement du cache.
+ **Segments (pouvant être mis en cache)** : à utiliser `None` pour des performances optimales.
+ **Origines S3** : utilisation `CORS-S3Origin` pour les compartiments Amazon S3
+ **MediaPackage origines** : Utilisation `CORS-S3Origin` pour les points de terminaison MediaPackage V2

![\[Origins table showing ContentOrigin, MediaTailorSegments, and MediaTailorManifests with their respective details.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/origins-cdn.png)


## Priorité et configuration du comportement du cache
<a name="cf-behavior-precedence"></a>

MediaTailor nécessite des configurations de comportement de cache spécifiques pour gérer correctement les différents types de demandes. La priorité des comportements du cache est essentielle car elle permet de les CDNs traiter dans l'ordre (du plus petit au plus grand) et d'utiliser le comportement pour le premier modèle de chemin correspondant. Il est essentiel de comprendre cette priorité pour résoudre les problèmes :
+ **Priorité 0** : la plupart des modèles spécifiques (similaires`/tm/*`) sont évalués en premier
+ **Numéros de priorité plus élevés : les** modèles moins spécifiques sont évalués dans l'ordre
+ **Comportement par défaut** : capture toutes les demandes qui ne correspondent pas à d'autres modèles

Si les demandes ne se comportent pas comme prévu, vérifiez que vos modèles de chemins ne se chevauchent pas de manière involontaire.

![\[Table showing behaviors with path patterns, origins, and policies for different URL paths.\]](http://docs.aws.amazon.com/fr_fr/mediatailor/latest/ug/images/bhv.png)


### Priorité 0 : comportement du chemin des segments publicitaires
<a name="cf-transcode-manage-behavior"></a>

Ce comportement gère les demandes redirigées depuis le comportement du chemin du segment, en diffusant les segments publicitaires réels. CloudFront applique les comportements suivants à toutes les demandes comportant un modèle de `/tm/*` chemin. Il s'agit du comportement le plus prioritaire, car la diffusion de segments publicitaires est essentielle pour une diffusion ininterrompue.
+ **Schéma de trajectoire :** `/tm/*`

  Exemple URLs qui correspond à ce modèle :
  + `https://your-distribution.cloudfront.net/tm/ad-segment-001.ts`
  + `https://your-distribution.cloudfront.net/tm/transcoded-ad.m4s`
+ **Origine :** origine que vous avez créée avec le `segments.mediatailor.region.amazonaws.com` domaine. 

  C'est **MediaTailorSegments**ce que montre l'exemple de la section précédente sur les origines. 
+ **Politique de cache :** `Managed-CachingOptimized`

  Pour plus de détails sur ce qui est inclus dans la politique de cache CloudFront géré, consultez [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)le guide de CloudFront l'utilisateur. Vous pouvez également utiliser ces mêmes paramètres issus de la politique gérée de votre CDN tiers.
+ **Politique de demande d'origine :** `None`
+ **Politique relative aux en-têtes de réponse :** `Managed-CORS-with-preflight-and-SecurityHeadersPolicy`

  Pour plus de détails sur ce qui est inclus dans la politique des en-têtes de réponse, voir [CORS with-preflight-and - SecurityHeadersPolicy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) dans le guide de l' CloudFront utilisateur. 

#### Adaptation de ces paramètres à d'autres CDNs
<a name="adapting-to-other-cdns"></a>

Si vous utilisez un CDN autre que CloudFront, recherchez des paramètres équivalents permettant d'accomplir les tâches suivantes.

**Correspondance des modèles de trajectoire**  
Configurer un comportement spécifique pour le modèle de `/tm/*` chemin afin de gérer les segments MediaTailor publicitaires

**Configuration de la clé de cache**  
Incluez l'`Origin`en-tête dans votre clé de cache pour vous assurer que les réponses sont mises en cache séparément pour différentes origines

**Transfert d'en-tête**  
Transférer l'`Origin`en-tête et les autres en-têtes liés à Cors vers l'origine

**Gestion des en-têtes de réponse**  
Configurez votre CDN pour vous assurer que l'`Access-Control-Allow-Origin`en-tête est présent dans les réponses

La terminologie spécifique et les options de configuration varient selon le fournisseur de CDN, mais les principes sous-jacents restent les mêmes.

### Priorité 1 : Comportement d'insertion d'annonces guidé par le serveur
<a name="cf-sgai-behavior"></a>

Ce comportement gère les demandes [MediaTailor présentation et mise en œuvre de l'insertion d'annonces guidées par le serveur](server-guided.md) (SGAI) lorsque les clients configurent le mode guidé, qui fournit des manifestes pouvant être mis en cache. CloudFront applique les comportements suivants à toutes les demandes comportant un modèle de `/v1/i-media/*` chemin. Le SGAI permet d'améliorer les performances de mise en cache car les manifestes ne sont pas spécifiques à l'utilisateur.
+ **Modèle de chemin :** `/v1/i-media/*` (chemin iMedia pour SGAI)

  Exemple URLs qui correspond à ce modèle :
  + `https://your-distribution.cloudfront.net/v1/i-media/your-config/manifest.m3u8`
  + `https://your-distribution.cloudfront.net/v1/i-media/your-config/playlist.mpd`
+ **Origine :** origine que vous avez créée avec le `manifests.mediatailor.region.amazonaws.com` domaine. 

  C'est **MediaTailorManifests**ce que montre l'exemple de la section précédente sur les origines. 
+ **Politique de cache :** `Managed-CachingOptimized`

  Pour plus de détails sur ce qui est inclus dans la politique de cache CloudFront géré, consultez [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)le guide de CloudFront l'utilisateur. Vous pouvez également utiliser ces mêmes paramètres issus de la politique gérée de votre CDN tiers.
+ **Politique de demande d'origine :** `None`
+ **Politique relative aux en-têtes de réponse :** `Managed-CORS-with-preflight-and-SecurityHeadersPolicy`

  Pour plus de détails sur ce qui est inclus dans la politique des en-têtes de réponse, voir [CORS with-preflight-and - SecurityHeadersPolicy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) dans le guide de l' CloudFront utilisateur. 

### Priorité 2 : Comportement manifeste personnalisé
<a name="cf-personalized-manifest-behavior"></a>

Ce comportement gère les demandes de manifeste personnalisées. CloudFront applique les comportements suivants à toutes les demandes comportant un modèle de `/v1/*` chemin. CloudFront applique les comportements suivants et ne met pas en cache les manifestes personnalisés car ils contiennent du contenu publicitaire spécifique à l'utilisateur. URLs Ces comportements s'appliquent à toutes les demandes comportant un modèle de `/v1/*` chemin. Il s'agit de la MediaTailor fonctionnalité de base qui permet à chaque spectateur de recevoir un manifeste unique avec une insertion publicitaire personnalisée.
+ **Modèle de chemin :** `/v1/*` ( MediaTailor requêtes V1 standard)

  Exemple URLs qui correspond à ce modèle :
  + `https://your-distribution.cloudfront.net/v1/master/your-config/manifest.m3u8`
  + `https://your-distribution.cloudfront.net/v1/dash/your-config/manifest.mpd`
+ **Origine :** origine que vous avez créée avec le `manifests.mediatailor.region.amazonaws.com` domaine. 

  C'est **MediaTailorManifests**ce que montre l'exemple de la section précédente sur les origines. 
+ **Politique de cache :** `Managed-CachingDisabled`

  Pour plus de détails sur ce qui est inclus dans la politique de cache, consultez [CachingDisabled](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-policy-caching-disabled)le guide de CloudFront l'utilisateur. 
+ **Politique de demande d'origine :** `AllViewer`

  Pour les manifestes personnalisés, utilisez la `AllViewer` politique pour transférer tous les en-têtes nécessaires au contenu dynamique. 
+ **Politique relative aux en-têtes de réponse :** `Managed-CORS-with-preflight-and-SecurityHeadersPolicy`

  Pour plus de détails sur ce qui est inclus dans la politique des en-têtes de réponse, voir [CORS with-preflight-and - SecurityHeadersPolicy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) dans le guide de l' CloudFront utilisateur. 

**En-tête Accept-Encoding**  
Nous recommandons que votre CDN préserve l'`Accept-Encoding`en-tête des lecteurs. Cet en-tête donne des MediaTailor instructions sur la compression de manifestes personnalisés. 

Dans CloudFront, la politique de demande `AllViewerAndCloudFrontHeaders` d'origine inclut le transfert de l'`Accept-Encoding`en-tête par le visualiseur. Si vous utilisez un autre CDN, assurez-vous qu'il préserve cet en-tête.

Voici comment MediaTailor gère l'`Accept-Encoding`en-tête.
+ **Appareils anciens : les appareils** intelligents plus anciens TVs qui ne supportent pas gzip n'envoient pas l'en-tête Accept-Encoding et renvoient donc MediaTailor des manifestes non compressés
+ **Appareils modernes : les** iPhones, les navigateurs Chrome et autres clients modernes envoient l'en-tête Accept-Encoding, ce qui permet de MediaTailor compresser les manifestes avant leur livraison

### Priorité 3 : Comportement du chemin des balises côté serveur
<a name="cf-segment-path-behavior"></a>

Ce comportement gère les demandes MediaTailor qui entraînent des redirections pour[Suivi côté serveur](ad-reporting-server-side.md). Ces demandes sont essentielles pour le suivi des balises. Chaque demande doit donc être traitée par MediaTailor. CloudFront applique les comportements suivants à toutes les demandes comportant un modèle de `/segment/*` chemin. 
+ **Schéma de trajectoire :** `/segment/*`

  Exemple URLs qui correspond à ce modèle :
  + `https://your-distribution.cloudfront.net/segment/tracking-beacon-123`
  + `https://your-distribution.cloudfront.net/segment/ad-request-456.ts`
+ **Origine :** origine que vous avez créée avec le `manifests.mediatailor.region.amazonaws.com` domaine. 

  C'est **MediaTailorManifests**ce que montre l'exemple de la section précédente sur les origines. 
+ **Politique de cache :** `Managed-CachingDisabled`

  Pour plus de détails sur ce qui est inclus dans la politique de cache, consultez [CachingDisabled](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-policy-caching-disabled)le guide de CloudFront l'utilisateur. 
+ **Politique de demande d'origine :** `AllViewer`

  Pour les demandes de balises côté serveur, utilisez la `AllViewer` politique pour transférer tous les en-têtes nécessaires au suivi. Comme ces demandes ne sont pas mises en cache, il n'y a aucun risque d'empoisonnement du cache.
+ **Politique relative aux en-têtes de réponse :** `Managed-CORS-with-preflight-and-SecurityHeadersPolicy`

  Pour plus de détails sur ce qui est inclus dans la politique des en-têtes de réponse, voir [CORS with-preflight-and - SecurityHeadersPolicy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) dans le guide de l' CloudFront utilisateur. 

Lors MediaTailor du traitement de ces demandes, il renvoie une réponse de redirection 302 avec un chemin pointant vers l'emplacement réel du segment. Par exemple, une demande `/segment/ad123.ts` peut être redirigée vers `/tm/encoded-ad-segment.ts` l'origine du segment.

### Priorité 4 : Comportement du chemin d'origine du contenu
<a name="cf-default-behavior"></a>

Si le chemin de la demande ne correspond à aucun des autres modèles, CloudFront applique le comportement par défaut. Ce comportement envoie les demandes directement à l'origine du contenu, sans traitement depuis MediaTailor. Cela permet d'accéder directement à l'origine de votre contenu (comme la MediaPackage V2) en cas de besoin. CloudFront applique les comportements suivants à toutes les demandes qui n'incluent aucun des modèles de chemin précédents.
+ **Schéma de trajectoire :** `(*)` 
+ **Origine : origine** que vous avez créée avec le domaine correspondant à l'origine de votre contenu. 

  C'est **ContentOrigin**ce que montre l'exemple de la section précédente sur les origines. 
+ **Politique de cache :** `Managed-CachingOptimized`

  Pour plus de détails sur ce qui est inclus dans la politique de cache CloudFront géré, consultez [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)le guide de CloudFront l'utilisateur. Vous pouvez également utiliser ces mêmes paramètres issus de la politique gérée de votre CDN tiers.
**Note**  
Pour les implémentations HLS à faible latence, envisagez d'utiliser une politique de mise en cache personnalisée avec des directives HLS à faible latence (LLH) au lieu de la politique standard. `CachingOptimized`
+ **Politique de demande d'origine :** `None`
+ **Politique relative aux en-têtes de réponse :** `Managed-CORS-with-preflight-and-SecurityHeadersPolicy`

  Bien que le comportement d'origine du contenu par défaut ne présente généralement pas les mêmes risques d'empoisonnement du cache CORS que le comportement des segments publicitaires, il est toujours recommandé d'appliquer la politique des en-têtes de `Managed-CORS-with-preflight-and-SecurityHeadersPolicy` réponse et d'inclure l'`Origin`en-tête dans votre clé de cache. Cela garantit une gestion cohérente du CORS pour tous les types de contenu et évite les problèmes de lecture potentiels sur les lecteurs Web.

  Pour les segments de contenu, la politique de `Managed-CachingOptimized` cache fournit de bonnes performances tandis que la politique des en-têtes de `Managed-CORS-with-preflight-and-SecurityHeadersPolicy` réponse garantit une gestion correcte du CORS. Cette combinaison permet une mise en cache efficace tout en maintenant la compatibilité avec les lecteurs Web qui nécessitent des en-têtes CORS.

  L'application d'une gestion CORS cohérente à la fois aux segments publicitaires et aux segments de contenu permet de créer une expérience de lecture plus fiable et de simplifier le dépannage. Sans une configuration CORS appropriée, les joueurs peuvent rencontrer des comportements incohérents lors de la transition entre le contenu et les publicités.

  Pour plus de détails sur ce qui est inclus dans la politique des en-têtes de réponse, voir [CORS with-preflight-and - SecurityHeadersPolicy](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) dans le guide de l' CloudFront utilisateur. 

# Bénéficiez d'une assistance et d'une aide au dépannage pour le CDN et les intégrations MediaTailor
<a name="cdn-get-help"></a>

AWS Elemental MediaTailor Les problèmes d'intégration du CDN peuvent être complexes à diagnostiquer et à résoudre. Utilisez ce guide lorsque vous avez besoin d'une aide supplémentaire pour résoudre des problèmes liés au CDN et à MediaTailor l'intégration que vous ne pouvez pas résoudre par le biais d'un dépannage en libre-service.

**Avant de passer à l'escalade, essayez les options de libre-service suivantes :**
+ Suivez les étapes de résolution des problèmes décrites dans [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md)
+ Analysez vos journaux et vos codes d'erreur à l'aide de [Référence d'analyse du journal d'intégration du CDN](cdn-log-error-reference.md)
+ Passez en revue votre configuration de surveillance avec [Configuration des outils de surveillance](cdn-monitoring.md#cdn-monitor-tools-setup)
+ Consultez le [guide de MediaTailor dépannage](https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html) pour les problèmes spécifiques au service
+ Recherchez dans [AWS Re:Post](https://repost.aws/) des problèmes similaires et des solutions communautaires
+ Consultez le [centre de connaissances AWS](https://aws.amazon.com/premiumsupport/knowledge-center/) pour découvrir les modèles d'intégration courants

**Topics**
+ [Quand passer au Support](#when-to-escalate)
+ [Recueillez des informations pour obtenir de l'aide](#information-to-gather)
+ [Ressources de support](#support-resources)
+ [Meilleures pratiques en matière de dossiers de support](#support-case-best-practices)

## Quand signaler les problèmes liés au MediaTailor CDN à AWS Support
<a name="when-to-escalate"></a>

AWS Elemental MediaTailor Les problèmes d'intégration du CDN doivent être signalés au AWS Support lorsque le dépannage en libre-service ne résout pas le problème. Envisagez de contacter le AWS Support lorsque :

**Remarque :** le support technique nécessite un plan de AWS support payant. Pour en savoir plus sur les plans de support et les temps de réponse, consultez les [plans de support AWS](https://aws.amazon.com/premiumsupport/plans/).
+ Les problèmes affectent la production, le trafic ou les revenus
+ Vous avez suivi toutes les étapes de résolution des problèmes sans résolution
+ Les modèles d'erreur suggèrent des problèmes de niveau de service
+ Vous avez besoin d'assistance pour des scénarios de configuration complexes
+ Les problèmes de performances persistent malgré les efforts d'optimisation

## Collectez des informations MediaTailor sur le CDN avant de contacter le support
<a name="information-to-gather"></a>

AWS Elemental MediaTailor Les cas de support relatifs à l'intégration du CDN nécessitent des informations de configuration et de diagnostic spécifiques pour un dépannage efficace. Avant de contacter AWS le Support, collectez les informations suivantes pour accélérer la résolution :

**Conseil :** Le fait de disposer de ces informations avant de créer votre dossier de support réduira considérablement le temps de résolution et aidera les ingénieurs du support à comprendre votre configuration spécifique.
+ **MediaTailor détails de configuration :**
  + Nom de la configuration et AWS région
  + ARN de configuration de lecture
  + URL ADS et type d'intégration
+ **Détails de configuration du CDN :**
  + ID de distribution ou nom de configuration du CDN
  + Configurations du comportement du cache pour les manifestes et les segments
  + Configuration d'origine et règles de routage
+ **Informations sur les erreurs :**
  + Messages d'erreur spécifiques et codes d'état HTTP
  + Horodatage en cas de problème
  +  URLs Échantillon illustrant le problème
  + Entrées relatives au CDN et au MediaTailor journal liées au problème
+ **Informations sur les tests :**
  + Mesures que vous avez déjà prises pour résoudre le problème
  + Appareils et lecteurs sur lesquels le problème se produit
  + Si le problème concerne l'ensemble du contenu ou des flux spécifiques
  + Fréquence et schéma du problème (intermittent, constant, basé sur le temps)

## MediaTailor Ressources et canaux de soutien à l'intégration du CDN
<a name="support-resources"></a>

AWS Elemental MediaTailor L'assistance à l'intégration du CDN est disponible via plusieurs canaux pour vous aider à résoudre les problèmes et à optimiser votre mise en œuvre :
+ **AWS Support :** créez un dossier de support via la console AWS de gestion pour obtenir une assistance technique

  Accès : [AWS Support Center](https://console.aws.amazon.com/support/home)
+ **AWS Re:post :** Plateforme de questions-réponses axée sur la communauté pour les questions connexes et le soutien de la AWS communauté

  Accès : [AWS Re:post](https://repost.aws/)
+ **AWS Documentation :** guides complets MediaTailor et services CDN

  Accès : [MediaTailordocumentation](https://docs.aws.amazon.com/mediatailor/) et [CloudFrontdocumentation](cloudfront/)
+ **AWS Formation :** cours et certifications pour les services médias et l'optimisation des CDN

  Accès : [AWS formation et certification](https://aws.amazon.com/training/)
+ **AWS Centre de connaissances :** articles sélectionnés sur les AWS problèmes courants et les meilleures pratiques

  Accès : [AWS Knowledge Center](https://aws.amazon.com/premiumsupport/knowledge-center/)
+ **AWS Trusted Advisor :** recommandations automatisées pour l'optimisation et les meilleures pratiques

  Accès : [AWS Trusted Advisor](https://console.aws.amazon.com/trustedadvisor/home)
+ **AWS Personal Health Dashboard :** notifications relatives à l'état du service et à la maintenance

  Accès : [AWS Personal Health Dashboard](https://console.aws.amazon.com/phd/home)

## MediaTailor Meilleures pratiques en matière d'assistance à l'intégration du CDN
<a name="support-case-best-practices"></a>

AWS Elemental MediaTailor Les cas de support relatifs à l'intégration du CDN sont résolus plus efficacement lorsque vous suivez ces bonnes pratiques. Pour obtenir la résolution la plus rapide :
+ Choisissez le niveau de gravité approprié en fonction de l'impact commercial
+ Fournissez toutes les informations pertinentes lors de la soumission initiale de votre dossier
+ Incluez des exemples spécifiques et des étapes de reproduction
+ Joindre les fichiers journaux pertinents et les captures d'écran de configuration
+ Répondre rapidement aux demandes d'informations supplémentaires des ingénieurs de support

**Ressources d'assistance supplémentaires :**
+ [AWS Gestion des dossiers de support](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) - Guide de création et de gestion des dossiers de support
+ [AWS Plans de support - Comparez les fonctionnalités des plans](https://aws.amazon.com/premiumsupport/plans/) de support et les temps de réponse
+ [Préparez-vous à supporter les charges de travail - Recommandations](https://docs.aws.amazon.com/wellarchitected/latest/operational-excellence-pillar/prepare-to-support-workloads.html) de Well-Architected pour la préparation opérationnelle
+ [AWS Well-Architected](https://aws.amazon.com/architecture/well-architected/) Framework - Meilleures pratiques pour créer et exploiter des charges de travail sur AWS