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.
# MediaTailor guide de résolution des problèmes liés à l'absence de publicité
Le fait de sauter des publicités est l'un des problèmes les plus courants signalés par les MediaTailor clients. Ce guide vous aide à identifier les problèmes liés au fait de sauter des publicités et fournit des procédures de step-by-step résolution des problèmes.
## Symptômes et impact
Lorsque vous ignorez des publicités, vous pouvez observer les symptômes suivants :
+ Les publicités n'apparaissent pas pendant les pauses publicitaires prévues
+ Les pauses publicitaires diffusent du contenu plutôt que des publicités
+ Diffusion incohérente des publicités entre les différentes sessions de visionnage
+ CloudWatch journaux indiquant `AdSkipped` les événements avec diverses raisons d'omission
Le fait de sauter des publicités a un impact direct sur les revenus et peut créer une mauvaise expérience pour les spectateurs. Résolvez ces problèmes rapidement pour maintenir des performances optimales.
## Identifier les raisons des sauts
Utilisez CloudWatch Logs Insights pour rechercher dans le groupe de `MediaTailor/AdDecisionServerInteractions` journaux les publicités ignorées :
```
fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId
| filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason)
| sort @timestamp desc
```
Cette requête renvoie les événements les plus récents où les annonces ont été ignorées, avec leurs raisons spécifiques, afin de vous aider à identifier les modèles.
**Topics**
+ [Symptômes](#ad-skipping-symptoms)
+ [Ignorer les raisons](#identifying-skip-reasons)
+ [NEW\$1CREATIVE ignore](troubleshooting-new-creative-skipping.md)
+ [Délai d'expiration ADS ignoré](troubleshooting-ads-timeout-skipping.md)
+ [Analyse VAST, saut](troubleshooting-vast-parsing-skipping.md)
+ [Incompatibilité de durée (saut)](troubleshooting-duration-mismatch-skipping.md)
+ [Saut de variables de session](troubleshooting-session-variables-skipping.md)
+ [Surveiller et ignorer](monitoring-ad-skipping-issues.md)
+ [Bonnes pratiques en matière de prévention](preventing-ad-skipping-best-practices.md)
+ [Matériaux de référence](ad-skipping-reference-materials.md)
# MediaTailor NEW\$1CREATIVE : résolution des problèmes liés au fait d'ignorer les publicités
Lorsque des annonces sont ignorées avec `NEW_CREATIVE` raison, vous avez AWS Elemental MediaTailor rencontré une annonce qui doit être transcodée avant d'être insérée. Ce guide de dépannage explique les causes et fournit des procédures step-by-step de résolution.
## Quelles sont les causes du saut dans NEW\$1CREATIVE
MediaTailor transcode les publicités en fonction de trois facteurs clés : le Creative ID, l'ID de compte AWS et le jeu de variantes de transcodage (les rendus de lecture du flux de contenu sous-jacent). Lorsqu'une partie du Creative ID ou de l'ensemble de variantes de transcodage est différente, MediaTailor reconnaît l'annonce comme une nouvelle variante nécessitant un transcodage.
### Changements de débit
Les changements de débit peuvent entraîner le saut de NEW\$1CREATIVE lorsque le débit ne correspond pas après avoir été arrondi aux 8 000 bits les plus proches. Cela se produit généralement dans les situations suivantes :
+ Le flux de contenu sous-jacent modifie le manifeste principal
+ Les nouvelles sessions sont créées avec des variantes différentes des sessions existantes
+ Les débits des flux de contenu ne sont pas cohérents entre les sessions de lecture
#### Variance de bande passante des tâches de récolte
Pour les tâches de récolte, MediaTailor utilise un seuil de variation de bande passante de 15 % lors de la mise en correspondance des annonces avec des flux de contenu. S'il existe une différence de 15 % ou plus entre la bande passante de la diffusion en direct et celle du fichier HLS récolté, l'annonce sera à nouveau transcodée. Cela peut entraîner l'omission de NEW\$1CREATIVE pendant le processus de transcodage.
Ce comportement se produit généralement lorsque :
+ Les mêmes publicités pré-transcodées sont utilisées à la fois pour le streaming en direct et le contenu VOD
+ Le contenu récolté possède des paramètres d'encodage différents de ceux de la diffusion en direct d'origine
+ Les différences de bande passante dépassent le seuil de 15 % entre le contenu en direct et le contenu récolté
### Conflits liés à Creative ID
Lorsque MediaTailor vous rencontrez un identifiant créatif différent pour un fichier multimédia déjà transcodé, la séquence suivante se produit :
1. L'annonce est ignorée avec la raison NEW\$1CREATIVE
1. Cela entraîne une tentative de transcodage inutile
1. La création est marquée comme DUPLICATE\$1TRANSCODE ou COPY\$1DEDUP
**Note**
MediaTailor n'expire pas et ne supprime pas les publicités transcodées. Nous les stockons indéfiniment dans un compartiment S3 que nous MediaTailor détenons.
## Étapes de résolution
Pour résoudre les problèmes liés au fait que NEW\$1CREATIVE ignore les publicités, procédez comme suit :
1. Vérifiez que votre serveur de décision publicitaire renvoie des créations cohérentes IDs pour le même contenu publicitaire.
1. Vérifiez que votre flux de contenu conserve des débits et des ensembles de variantes cohérents.
1. Envisagez de mettre en œuvre la prélecture des annonces pour vous assurer que les publicités sont transcodées avant leur diffusion. Pour de plus amples informations, veuillez consulter [Publicités de prélecture](prefetching-ads.md).
1. Pour les problèmes persistants, contactez le [support AWS](https://aws.amazon.com/premiumsupport/) pour obtenir une assistance supplémentaire en matière de résolution des problèmes.
## Surveillance des modèles NEW\$1CREATIVE
Utilisez cette requête CloudWatch Logs Insights pour analyser les tendances observées dans NEW\$1CREATIVE en cas de sauts d'annonces :
```
fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50
```
# MediaTailor Résolution des problèmes liés au délai d'expiration et aux sauts d'ADS
Lorsque des publicités sont ignorées `ADS_TIMEOUT` pour des raisons connexes, vous rencontrez des problèmes de connectivité ou de performance avec votre serveur de décision publicitaire. AWS Elemental MediaTailor nécessite une communication fiable avec votre ADS pour insérer des annonces avec succès. Ce guide de dépannage explique comment identifier et résoudre ces problèmes de connectivité.
## Problèmes courants de connectivité ADS
Les problèmes courants de connectivité ADS sont les suivants :
+ Le serveur de décision publicitaire n'est pas accessible depuis MediaTailor
+ ADS ne répond pas dans le délai d'expiration configuré
+ ADS est incapable de gérer le volume de demandes pendant les périodes de pointe
+ Problèmes de connectivité réseau entre MediaTailor et votre ADS
## Étapes de résolution
Pour résoudre les problèmes liés au délai d'expiration de l'ADS :
1. Vérifiez que votre serveur de décision publicitaire est accessible depuis MediaTailor.
1. Vérifiez que votre ADS répond dans le délai d'expiration configuré.
1. Assurez-vous que votre ADS peut gérer le volume de demandes pendant les périodes de pointe.
1. Envisagez de mettre en œuvre une stratégie publicitaire de secours lorsque votre ADS principal n'est pas disponible.
## Surveillance des performances de l'ADS
Configurez des CloudWatch alarmes pour la `AdDecisionServer.Timeouts` métrique afin de détecter de manière proactive les problèmes de connectivité ADS.
# MediaTailor Résolution des problèmes liés à l'analyse et à l'omission VAST
Lorsque des publicités sont ignorées `VAST_PARSING_ERROR` ou`MEDIA_FILE_UNAVAILABLE`, vous rencontrez des problèmes avec vos réponses VAST ou vos fichiers multimédias publicitaires. AWS Elemental MediaTailor nécessite des réponses VAST correctement formatées et des fichiers multimédias accessibles pour une insertion réussie des annonces. Ce guide de dépannage explique comment identifier et résoudre ces problèmes.
## Problèmes courants liés à VAST
Les problèmes courants liés à VAST sont les suivants :
+ Le format de réponse VAST n'est pas conforme à la spécification VAST
+ Le fichier multimédia URLs dans la réponse VAST n'est pas accessible au public
+ Les caractères spéciaux ne sont pas correctement encodés dans VAST XML
+ Réponse VASTE : fichiers multimédias ou formats requis manquants
## Étapes de résolution
Pour résoudre les problèmes d'analyse VAST :
1. Validez votre format de réponse VAST par rapport à la spécification VAST.
1. Assurez-vous que tous les fichiers multimédias URLs de la réponse VAST sont accessibles au public.
1. Vérifiez le bon encodage des caractères spéciaux dans votre VAST XML.
1. Vérifiez que votre réponse VAST inclut des fichiers multimédias dans des formats compatibles avec MediaTailor.
## Résolution des problèmes liés aux wrapper VAST
En cas de problème avec `INVALID_VAST_WRAPPER_AD` ou `REJECTED_REPLICA_VAST` :
+ Valider les réponses du wrapper VAST par rapport à la spécification VAST
+ Assurez-vous que tous les éléments du wrapper sont correctement formatés et contiennent un tagURI valide VASTAd
+ Vérifiez la configuration du serveur publicitaire pour connaître les politiques de détection des contenus dupliqués
+ Assurez-vous que les réponses VAST contiennent un contenu créatif unique au cours d'une même session
# MediaTailor résolution des problèmes liés à l'inadéquation de la durée et aux sauts
Lorsque des annonces sont ignorées ou pour des raisons liées au format `AVAIL_DURATION_EXCEEDED``LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`, vous rencontrez des problèmes de durée ou de compatibilité de format. AWS Elemental MediaTailor nécessite un formatage de durée approprié et une correspondance entre le contenu de l'annonce et le temps de pause publicitaire disponible. Ce guide de dépannage explique comment identifier et résoudre ces problèmes liés à la durée.
## Problèmes de durée courants
Les problèmes de durée courants sont les suivants :
+ Publicités plus longues que la durée d'interruption de publicité disponible
+ Marqueurs de coupure de publicité incorrects dans le contenu signalant une durée incorrecte
+ Le seuil de personnalisation n'est pas atteint pour l'insertion d'annonces
+ Format de durée incorrect dans les EXT-X-CUE-OUT balises
## Exigences relatives au format de durée
Le paramètre de durée de la EXT-X-CUE-OUT balise doit être formaté sous la forme d'une valeur entière, et non d'un format de durée ISO 8601.
**Exigences relatives au format de durée**
| Format | Exemple | Statut |
| --- | --- | --- |
| Entier (correct) | 32 | Supporté : représente 32 secondes |
| Décimal (correct) | 30.000 | Supporté : représente 30 secondes |
| ISO 8601 (incorrect) | PT32S | Non pris en charge : entraîne des échecs d'insertion |
## Étapes de résolution
Pour résoudre les problèmes d'inadéquation des durées, procédez comme suit :
1. Assurez-vous que votre ADS renvoie des publicités correspondant à la durée de pause publicitaire disponible.
1. Vérifiez que les marqueurs de coupure de publicité insérés dans le contenu indiquent correctement la durée prévue.
1. Vérifiez que les paramètres de EXT-X-CUE-OUT durée utilisent le format entier.
1. Envisagez d'ajuster le seuil de personnalisation en fonction de votre cas d'utilisation.
# MediaTailor résolution des problèmes liés aux variables de session et aux sauts
Les variables de session jouent un rôle essentiel dans le ciblage et la sélection des publicités dans AWS Elemental MediaTailor. La configuration incorrecte des variables de session est une cause fréquente de problèmes liés au fait de sauter des publicités. Ce guide de dépannage complet explique comment identifier et résoudre les problèmes liés aux variables de session susceptibles d'empêcher l'insertion réussie d'annonces.
## Problèmes courants liés aux variables de session
Les problèmes courants liés aux variables de session sont les suivants :
+ **Variables obligatoires manquantes** : votre serveur de décision publicitaire peut avoir besoin de variables spécifiques qui ne sont pas fournies.
+ **Syntaxe de variable incorrecte** : les variables doivent utiliser la syntaxe correcte (par exemple, `[session.id]` au lieu de`${session.id}`).
+ **Problèmes de codage d'URL : les** caractères spéciaux dans les valeurs des variables peuvent nécessiter un codage URL approprié.
+ **Paramètres du joueur incohérents : les** paramètres du joueur doivent être transmis de manière cohérente d'une session à l'autre.
+ **Défaillances de résolution de variables dynamiques** : les variables qui ne peuvent pas être résolues sont remplacées par des chaînes vides.
+ **Problèmes d'analyse UPID SCTE-35** : Les problèmes liés au traitement UPID par segmentation peuvent entraîner des échecs de résolution des variables de session.
## Vérification de la résolution des variables de session
Pour vérifier que vos variables de session sont correctement résolues :
1. Activez la journalisation du débogage pour votre configuration MediaTailor
1. Vérifiez le groupe de `MediaTailor/AdDecisionServerInteractions` journaux pour la demande ADS réelle URLs
1. Vérifiez que toutes les variables de l'URL du modèle ont été remplacées par des valeurs appropriées
1. Recherchez toutes les variables qui ont été remplacées par des chaînes vides, ce qui peut indiquer des échecs de résolution
## Résolution des problèmes liés à l'analyse SCTE-35 UPID
Les problèmes liés au traitement UPID par segmentation SCTE-35 peuvent entraîner des problèmes liés aux variables de session :
+ **Exigences de format :** UPID doit avoir `segmentation_upid_type` 12 et inclure `format_identifier` pour un traitement approprié
+ **Règles d'analyse :** l'UPID décodé peut contenir des séparateurs de deux points pour plusieurs valeurs. Le nombre de variables de modèle et de jetons UPID décodés doit être égal
+ **Formats non valides :** évitez les doubles virgules sans valeur (par exemple, `::` ou`:46175218::4053`) car ils entraînent des échecs d'analyse
# MediaTailor surveillance et alertes relatives au non-respect des publicités
La surveillance proactive vous aide à détecter et à résoudre les problèmes liés au fait de sauter des publicités avant qu'ils n'aient un impact significatif sur vos revenus. AWS Elemental MediaTailor fournit des statistiques complètes et des fonctionnalités de journalisation qui permettent de surveiller efficacement les performances d'insertion des publicités. Ce guide explique comment configurer une surveillance efficace pour les problèmes liés au fait de sauter des publicités.
## CloudWatch Indicateurs clés à surveiller
Configurez CloudWatch des alarmes pour ces MediaTailor indicateurs clés :
+ `AdDecisionServer.Ads.Skipped`- Nombre de publicités ignorées
+ `AdDecisionServer.Timeouts`- Nombre de délais d'attente de l'ADS
+ `Avail.FilledDuration`- Durée des pauses publicitaires complètes
+ `Avail.SlateOnly`- Nombre de pauses publicitaires contenant uniquement de l'ardoise
## Requêtes Advanced CloudWatch Logs Insights
Utilisez ces requêtes spécialisées pour un dépannage détaillé :
### Analyse complète des sessions
Pour une analyse détaillée du comportement d'insertion d'annonces pour une session spécifique :
```
fields @timestamp, sessionId, eventType, creativeId, skipReason, adBreakIndex
| filter sessionId = "your-session-id-here"
| filter eventType in ["FILLED_AVAIL", "SKIPPED_AVAIL", "MAKING_ADS_REQUEST"]
| sort @timestamp asc
| limit 100
```
### Trouver de la créativité IDs
Pour identifier les événements Creative à IDs partir de FILLED\$1AVAIL :
```
fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
```
**Note**
`sessionId`Remplacez-le par l'identifiant de session réel que vous étudiez.
# MediaTailor meilleures pratiques en matière de prévention du contournement des publicités
La mise en œuvre de ces meilleures pratiques permet d'éviter les problèmes de sauts d'annonces avant qu'ils ne surviennent, garantissant ainsi de meilleures performances d'insertion publicitaire et une AWS Elemental MediaTailor protection des revenus. Ces mesures proactives s'attaquent aux causes les plus courantes de l'absence de publicité et contribuent à garantir une diffusion uniforme des publicités.
## Mesures proactives
+ **Mettre en œuvre la prélecture des publicités :** utilisez MediaTailor la fonction de prélecture pour garantir que les publicités sont transcodées avant leur diffusion. Voir [Publicités de prélecture](prefetching-ads.md) pour les détails de mise en œuvre
+ **Maintenez une création cohérente IDs** : assurez-vous que votre serveur de décision publicitaire utilise des créations cohérentes IDs pour le même contenu publicitaire d'une session à l'autre
+ **Assurez-vous que le format de durée est correct** : utilisez des valeurs entières pour les paramètres de EXT-X-CUE-OUT durée au lieu du format ISO 8601
+ **Configuration de l'optimisation de la VOD** : définissez maxConcurrentAds des demandes pour les flux VOD avec plusieurs interruptions publicitaires afin de réduire la charge du serveur
+ **Optimisez les performances ADS** : configurez votre serveur de décision publicitaire pour qu'il réponde rapidement et gère les pics de trafic
## Directives d'implémentation
+ **Mettre en œuvre une gestion appropriée des erreurs** : configurez le contenu de la liste pour remplir les pauses publicitaires lorsque les publicités ne peuvent pas être insérées
+ **Testez de manière approfondie** : validez votre flux de travail d'insertion d'annonces sur différents appareils et selon les conditions du réseau
+ **Mettez en œuvre des stratégies de secours** : configurez des sources publicitaires de sauvegarde ou des publicités par défaut en cas de défaillance des sources publicitaires principales
+ **Surveillez les modèles de transcodage** : surveillez l'efficacité du transcodage dans les CloudWatch journaux et contactez AWS [Support](https://aws.amazon.com/premiumsupport/) si vous remarquez des modèles indiquant des problèmes de transcodage
# MediaTailor guide de référence pour ignorer les publicités
Cette section fournit des informations de référence complètes sur les raisons pour lesquelles les publicités sont ignorées et des liens vers la documentation associée pour AWS Elemental MediaTailor. Utilisez ce guide de référence pour comprendre la signification spécifique des différentes raisons d'omission et pour trouver des ressources de résolution des problèmes supplémentaires.
## Référence complète des raisons pour lesquelles les annonces sont ignorées
MediaTailor enregistre les raisons spécifiques pour lesquelles les publicités sont ignorées dans le message du journal des `FILLED_AVAIL` événements provenant du groupe de `MediaTailor/AdDecisionServerInteractions` journaux.
**Complétez les raisons pour lesquelles vous avez omis**
| Ignorer la raison | Description |
| --- | --- |
| NEW\$1CREATIVE | L'annonce n'a pas encore été transcodée. Cela se produit lorsqu' MediaTailorune nouvelle création publicitaire doit être transcodée avant d'être insérée. |
| PROFILE\$1NOT\$1FOUND | Le profil de MediaConvert transcodage associé à la configuration de la session n'existe pas, ce qui empêche la préparation des publicités. |
| TRANSCODE\$1ERROR | Le processus de transcodage des annonces a rencontré une erreur et n'a pas pu être terminé. |
| TRANSCODE\$1IN\$1PROGRESS | Le transcodage de l'annonce est toujours en cours et n'est pas encore prêt à être inséré. |
| INTERNAL\$1ERROR | Une MediaTailor erreur interne s'est produite lors de la manipulation de l'annonce, empêchant son insertion. |
| AVAIL\$1DURATION\$1EXCEEDED | L'annonce ne correspond pas à la durée restante de la pause publicitaire. |
| LEFTOVER\$1AVAIL\$1EXCEEDED\$1THRESHOLD | La durée cumulée de toutes les publicités qui auraient pu être insérées n'atteint pas le seuil de personnalisation configuré pour la session. |
| VAST\$1PARSING\$1ERROR | La réponse VAST du serveur de décision publicitaire contient des erreurs ou est mal formée. |
| ADS\$1TIMEOUT | Le serveur de décision publicitaire n'a pas répondu dans le délai défini. |
| MEDIA\$1FILE\$1UNAVAILABLE | Les fichiers multimédias publicitaires spécifiés dans la réponse VAST ne sont pas accessibles. |
| SESSION\$1INITIALIZATION\$1FAILED | La MediaTailor session n'a pas pu s'initialiser correctement, souvent en raison de variables de session incorrectes. |
| EARLY\$1CUE\$1IN | La pause publicitaire s'est terminée plus tôt que prévu en raison d'un signal d'alerte précoce, empêchant l'insertion complète de l'annonce. |
| NO\$1VARIANT\$1MATCH | La création publicitaire ne possède pas de variante correspondant aux paramètres d'encodage du flux de contenu (débit, résolution, codec). |
| NO\$1MODEL\$1CREATIVE\$1MATCH | La création publicitaire ne correspond pas au modèle ou aux exigences de format attendus pour la configuration de diffusion actuelle. |
| REJECTED\$1REPLICA\$1VAST | La réponse VAST a été rejetée en raison des politiques de détection des répliques ou des doublons de contenu. |
| INVALID\$1VAST\$1WRAPPER\$1AD | L'enveloppe publicitaire VAST contient des éléments d'emballage non valides ou mal formés qui empêchent l'insertion réussie de la publicité. |
| IMPORT\$1ERROR | Une erreur s'est produite lors du processus d'importation des annonces, empêchant le traitement de l'annonce en vue de son insertion. |
| IMPORT\$1IN\$1PROGRESS | Le processus d'importation des annonces est actuellement en cours et n'est pas encore terminé. |
## Ressources connexes
Pour plus d'informations sur la résolution des problèmes liés au fait de sauter des publicités, consultez les rubriques connexes suivantes :
+ [MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md)- Guide complet des variables publicitaires dynamiques dans MediaTailor
+ [Publicités de prélecture](prefetching-ads.md)- Comment implémenter le préchargement des publicités pour éviter les sauts liés au transcodage
+ [Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon](monitoring-cloudwatch-metrics.md)- Surveillance à l' MediaTailor aide de CloudWatch métriques
+ [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md)- Comment consulter et analyser les MediaTailor journaux
+ [Résolution des problèmes liés au flux d' MediaTailor événements](troubleshooting-event-flow.md)- Comprendre le flux des événements d'insertion d'annonces