Symptômes Causes Étapes de résolution des problèmes Variables de session Requêtes avancées Bonnes pratiques Ressources connexes

Résolution des problèmes liés au fait de sauter MediaTailor

Le fait de sauter des publicités est l'un des problèmes les plus courants signalés par les MediaTailor clients. Cette section fournit une analyse détaillée des raisons pour lesquelles les publicités peuvent être ignorées pendant la diffusion et propose des solutions pour garantir une insertion correcte des publicités.

Symptômes et impact

Lorsque vous ignorez des publicités, vous pouvez observer les symptômes suivants :

Les publicités ne s'affichent pas pendant les pauses publicitaires prévues
Des pauses publicitaires remplies de contenu plutôt que de 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 la génération de revenus et peut nuire à l'expérience des spectateurs s'il n'est pas traité rapidement.

Causes courantes

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. Il est essentiel de comprendre les raisons de ces sauts pour un dépannage efficace.

Raisons courantes pour lesquelles les annonces ne sont
Ignorer la raison	Description
`NEW_CREATIVE`	L'annonce n'a pas encore été transcodée. Cela se produit lorsqu' MediaTailor une nouvelle création publicitaire doit être transcodée avant d'être insérée.
`PROFILE_NOT_FOUND`	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_ERROR`	Le processus de transcodage des annonces a rencontré une erreur et n'a pas pu être terminé.
`TRANSCODE_IN_PROGRESS`	Le transcodage de l'annonce est toujours en cours et n'est pas encore prêt à être inséré.
`INTERNAL_ERROR`	Une MediaTailor erreur interne s'est produite lors de la manipulation de l'annonce, empêchant son insertion.
`AVAIL_DURATION_EXCEEDED`	L'annonce ne correspond pas à la durée restante de la pause publicitaire.
`LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`	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_PARSING_ERROR`	La réponse VAST du serveur de décision publicitaire contient des erreurs ou est mal formée.
`ADS_TIMEOUT`	Le serveur de décision publicitaire n'a pas répondu dans le délai défini.
`MEDIA_FILE_UNAVAILABLE`	Les fichiers multimédias publicitaires spécifiés dans la réponse VAST ne sont pas accessibles.
`SESSION_INITIALIZATION_FAILED`	La MediaTailor session n'a pas pu s'initialiser correctement, souvent en raison de variables de session incorrectes.
`EARLY_CUE_IN`	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_VARIANT_MATCH`	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_MODEL_CREATIVE_MATCH`	La création publicitaire ne correspond pas au modèle ou aux exigences de format attendus pour la configuration de diffusion actuelle.
`REJECTED_REPLICA_VAST`	La réponse VAST a été rejetée en raison des politiques de détection des répliques ou des doublons de contenu.
`INVALID_VAST_WRAPPER_AD`	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_ERROR`	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_IN_PROGRESS`	Le processus d'importation des annonces est actuellement en cours et n'est pas encore terminé.

Outre ces raisons spécifiques d'omission, les autres causes courantes incluent :

Configuration incorrecte des variables de session
Problèmes de connectivité du serveur Ad Decision (ADS)
Création incohérente IDs pour le même contenu publicitaire
Problèmes de compatibilité du lecteur avec le format du manifeste
Problèmes de configuration du CDN affectant la diffusion des segments publicitaires

Étapes de résolution des problèmes

Procédez comme suit pour diagnostiquer et résoudre les problèmes liés au fait de sauter des publicités :

Identifiez la raison spécifique du saut

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.
Vérifier la configuration des variables de session

Les variables de session incorrectes sont une cause fréquente d'omission d'annonces. Vérifiez que :
- Toutes les variables de session requises sont correctement configurées dans votre modèle d'URL ADS
- Les variables dynamiques sont correctement formatées (voir MediaTailor variables publicitaires dynamiques pour la syntaxe appropriée)
- Les paramètres du joueur sont correctement transmis à MediaTailor
Exemple d'URL ADS correctement configurée avec des variables de session :
```
https://my-ads-server.com/ads?
sessionId=[session.id]&
playerParams=[player_params.param1]&
deviceType=[player_params.device]&
correlator=[session.avail_duration_ms]
                
```
Résoudre les problèmes liés à NEW_CREATIVE

Si des publicités sont ignorées NEW_CREATIVE pour la raison suivante :

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). Si 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. Cela inclut les changements de débit lorsqu'ils sont arrondis aux 8 000 bits les plus proches, ce qui peut se produire lorsque le flux de contenu sous-jacent modifie le manifeste principal.

Pour obtenir des informations détaillées sur les scénarios NEW_CREATIVE, notamment les modifications du débit et les conflits liés aux Creative ID, consultez la Analyse détaillée de NEW_CREATIVE section qui suit cette procédure.
1. Vérifiez que votre serveur de décision publicitaire renvoie des créations cohérentes IDs pour le même contenu publicitaire
2. Vérifiez si votre flux de contenu maintient des débits et des ensembles de variantes cohérents
3. Envisagez de mettre en œuvre la prélecture des annonces pour garantir que les publicités sont transcodées avant leur diffusion (voir) Publicités de prélecture
4. Pour les problèmes persistants, contactez le support AWS pour obtenir une assistance supplémentaire en matière de résolution des problèmes
Résoudre les problèmes de connectivité ADS

Si des publicités sont ignorées pour ADS_TIMEOUT des raisons connexes :
- Vérifiez que votre serveur de décision publicitaire est accessible depuis MediaTailor
- Vérifiez si votre ADS répond dans le délai d'expiration configuré
- Assurez-vous que votre ADS peut gérer le volume de demandes pendant les périodes de pointe
- Envisagez de mettre en œuvre une stratégie publicitaire de secours lorsque votre ADS principal n'est pas disponible
Résolvez les problèmes de réponse VAST

Si les publicités sont ignorées par VAST_PARSING_ERROR ou MEDIA_FILE_UNAVAILABLE :
- Validez votre format de réponse VAST par rapport à la spécification VAST
- Assurez-vous que tous les fichiers multimédias URLs de la réponse VAST sont accessibles au public
- Vérifiez le bon encodage des caractères spéciaux dans votre VAST XML
- Vérifiez que votre réponse VAST inclut des fichiers multimédias dans des formats compatibles avec MediaTailor
Résoudre les problèmes d'inadéquation des durées

Si les publicités sont ignorées par AVAIL_DURATION_EXCEEDED ou LEFTOVER_AVAIL_EXCEEDED_THRESHOLD :
- Assurez-vous que votre ADS renvoie des publicités qui correspondent à la durée de pause publicitaire disponible
- Vérifiez si vos marqueurs de rupture de publicité dans le contenu indiquent correctement la durée prévue
- Envisagez d'ajuster le seuil de personnalisation le cas échéant pour votre cas d'utilisation
Surveiller CloudWatch les métriques

Configurez des CloudWatch alarmes pour les MediaTailor indicateurs clés afin de détecter de manière proactive les problèmes liés au fait de sauter des publicité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
Pour de plus amples informations sur les métriques disponibles, veuillez consulter Surveillance AWS Elemental MediaTailor à l'aide des CloudWatch métriques Amazon.
Résoudre les problèmes de mise en correspondance des variantes et de format

Si des annonces sont ignorées pour des raisons liées au format NO_VARIANT_MATCH NO_MODEL_CREATIVE_MATCHEARLY_CUE_IN, ou pour des raisons liées au format :
- NO_VARIANT_MATCH: assurez-vous que vos créations publicitaires sont disponibles dans des variantes correspondant aux paramètres d'encodage de votre flux de contenu (débit, résolution, codec). Configurez votre serveur publicitaire pour qu'il diffuse des annonces dans des formats compatibles.
- NO_MODEL_CREATIVE_MATCH: passez en revue les exigences relatives au modèle créatif de votre configuration de diffusion et assurez-vous que votre serveur publicitaire propose des publicités conformes au format et aux spécifications attendus.
- EARLY_CUE_IN: vérifiez que les signaux d'entrée de votre flux de contenu sont correctement synchronisés et que les pauses publicitaires ont une durée suffisante pour permettre l'insertion de publicités. Vérifiez l'absence de EXT-X-CUE-IN balises prématurées ou de messages SCTE-35 splice_insert.
Résoudre les problèmes liés au wrapper et à l'importation VAST

Si les publicités sont ignorées parREJECTED_REPLICA_VAST, INVALID_VAST_WRAPPER_ADIMPORT_ERROR, ou IMPORT_IN_PROGRESS :
- REJECTED_REPLICA_VAST: Vérifiez la configuration de votre 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 et évitez de diffuser des publicités identiques au cours de la même session.
- INVALID_VAST_WRAPPER_AD: validez les réponses de votre 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.
- IMPORT_ERRORet IMPORT_IN_PROGRESS : Cela indique des problèmes liés au processus d'importation des annonces. Vérifiez l'accessibilité et la compatibilité des formats dans les fichiers sources de création publicitaire. Surveillez la progression des importations et réessayez les importations qui ont échoué.

Analyse détaillée de NEW_CREATIVE

Cette section fournit des informations complètes sur les scénarios d'exclusion des publicités NEW_CREATIVE, notamment les causes sous-jacentes et les techniques avancées de résolution des problèmes.

Scénario de modifications du débit

Les changements de débit peuvent entraîner le saut de NEW_CREATIVE 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 lorsque :

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

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 :

L'annonce est ignorée avec la raison NEW_CREATIVE
Cela entraîne une tentative de transcodage inutile
La création est marquée comme DUPLICATE_TRANSCODE ou COPY_DEDUP

Note

MediaTailor n'expire pas et ne supprime pas les publicités transcodées. Ils sont stockés indéfiniment dans un compartiment S3 MediaTailor appartenant à un propriétaire.

Traitement ETAG

L'ETAG est un identifiant unique associé à une version spécifique d'une liste de lecture ou d'un manifeste publicitaire. MediaTailor utilise le Creative ID pour identifier une ressource publicitaire, mais si le Creative ID change à chaque demande, l'annonce peut être marquée comme nouvelle création, empêchant ainsi son insertion.

Avertissement

Il n'est pas garanti que l'identifiant créatif soit unique, ce qui peut entraîner l'affichage de publicités incorrectes.

Problèmes liés au format de durée

L'insertion publicitaire côté serveur (SSAI) nécessite des formats de paramètres de durée spécifiques dans les fichiers manifestes. Des formats de durée incorrects peuvent entraîner des échecs d'insertion d'annonces.

EXT-X-CUE-OUT paramètre 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

Exemple de format de manifeste correct :



#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXTINF:10.0,
segment1.ts
#EXT-X-CUE-OUT:30
#EXTINF:10.0,
segment2.ts
#EXT-X-CUE-IN
#EXTINF:10.0,
segment3.ts

Important

Assurez-vous que tous les paramètres de EXT-X-CUE-OUT durée utilisent un format entier pour éviter les problèmes d'insertion de publicités.

Validation des formats de marqueurs publicitaires

Pour valider le format de votre marqueur publicitaire et identifier les problèmes d'analyse de la durée :

Vérifiez le format des marqueurs publicitaires dans CloudWatch les journaux sous AD_MARKER_FOUND les événements
Recherchez les raisons FORMAT_ERROR de ne pas participer aux FILLED_AVAIL événements
Vérifiez que les valeurs de durée de votre manifeste de contenu utilisent les formats pris en charge
Testez avec différents formats de durée pour identifier les problèmes de compatibilité

Optimisation des flux VOD

Les flux de vidéo à la demande (VOD) peuvent générer plusieurs requêtes ADS, ce qui peut avoir un impact sur les performances. MediaTailor fournit des fonctionnalités d'optimisation pour remédier à ce comportement.

Problème de requêtes ADS multiples

Par défaut, les flux VOD peuvent générer plusieurs événements MAKING_ADS_REQUEST dans les journaux. MediaTailor Cela se produit parce que chaque interruption publicitaire dans le contenu VOD déclenche une demande ADS distincte adressée au serveur de décision publicitaire.

Pour déterminer si vos flux VOD génèrent des demandes ADS excessives, utilisez cette requête CloudWatch Logs Insights :



fields @timestamp, sessionId, eventType, adBreakIndex
| filter eventType = "MAKING_ADS_REQUEST"
| stats count() by sessionId
| sort count desc
| limit 20

Fonction de parallélisation VOD

MediaTailor propose une fonctionnalité de parallélisation pour optimiser le traitement des demandes ADS pour le contenu VOD. Cette fonctionnalité peut être configurée à l'aide du maxConcurrentAdsRequests paramètre de votre configuration de lecture.

Exemple de configuration :



{
  "Name": "OptimizedVODConfig",
  "VideoContentSourceUrl": "https://example.com/content/",
  "AdDecisionServerUrl": "https://example.com/ads",
  "maxConcurrentAdsRequests": 3
}

Cette configuration limite le nombre de requêtes ADS simultanées, réduit la charge du serveur et améliore les temps de réponse.

Gestion des réponses VAST encapsulée

La fonctionnalité de parallélisation optimise également la gestion des réponses VAST encapsulées, qui sont courantes dans les scénarios de publicité programmatique. Les réponses VAST encapsulées contiennent plusieurs couches de balises VAST qui doivent être déballées pour accéder aux fichiers multimédia eux-mêmes.

Dépannage des variables de session

Les variables de session jouent un rôle essentiel dans le ciblage et la sélection des publicités. La configuration incorrecte des variables de session est une cause fréquente de problèmes liés au fait de sauter des publicités.

Problèmes courants liés aux variables de session

Les problèmes suivants liés aux variables de session peuvent entraîner l'omission de publicités :

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 d'encodage 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 seront 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 :

Activez la journalisation du débogage pour votre configuration MediaTailor
Vérifiez le groupe de MediaTailor/AdDecisionServerInteractions journaux pour la demande ADS réelle URLs
Vérifiez que toutes les variables de l'URL du modèle ont été remplacées par des valeurs appropriées
Recherchez toutes les variables qui ont été remplacées par des chaînes vides, ce qui peut indiquer des échecs de résolution

Exemple d'entrée de journal indiquant l'URL d'une demande ADS résolue :



{
  "eventType": "MAKING_ADS_REQUEST",
  "sessionId": "abcd1234-5678-efgh-9012-ijklmnopqrst",
  "requestUrl": "https://my-ads-server.com/ads?sessionId=abcd1234-5678-efgh-9012-ijklmnopqrst&playerParams=mobile&deviceType=android&correlator=30000",
  "timestamp": "2025-06-20T19:00:00Z"
}

Analyse UPID SCTE-35 et variables de session

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.
Gestion de l'identifiant de format : MediaTailor suppose que les quatre premiers octets sont format_identifier. En cas d'absence, private_data tronque les quatre premiers octets, ce qui peut entraîner la réception par l'ADS de valeurs différentes de celles attendues.

Requêtes Advanced CloudWatch Logs Insights

Utilisez ces requêtes CloudWatch Logs Insights spécialisées pour résoudre en détail les problèmes d'insertion de publicités :

Trouver de la créativité IDs

Pour identifier les événements Creative à IDs partir de FILLED_AVAIL dans le journal ads_interaction_log :



fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc

Note

sessionIdRemplacez-le par l'identifiant de session réel que vous étudiez.

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

NEW_CREATIVE ignore l'analyse

Pour analyser les modèles dans NEW_CREATIVE en cas de sauts d'annonces, procédez comme suit :



fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50

Bonnes pratiques pour éviter de sauter des publicités

Mettez en œuvre les meilleures pratiques suivantes pour minimiser les problèmes liés au fait de sauter des publicités :

Implémenter 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 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.
Configurez l'optimisation de la VOD : définissez des maxConcurrentAds demandes pour les flux VOD avec plusieurs interruptions publicitaires afin de réduire la charge du serveur.
Surveillez les modèles de transcodage : surveillez l'efficacité du transcodage dans les CloudWatch journaux et contactez AWS Support si vous remarquez des modèles indiquant des problèmes de transcodage.
Vérifiez la cohérence de l'ETAG : assurez-vous que les fichiers multimédias URIs sont cohérents pour un contenu identique afin d'éviter tout retranscodage inutile.
Mettez en œuvre un dépannage systématique : suivez une approche structurée : identifiez les raisons des sauts, analysez les causes profondes, mettez en œuvre des solutions et validez les correctifs.
Optimisez les performances ADS : configurez votre serveur de décision publicitaire pour qu'il réponde rapidement et gère les pics de trafic.
Mettez en œuvre une gestion appropriée des erreurs : configurez le contenu de la liste pour qu'il remplisse les pauses publicitaires lorsque les publicités ne peuvent pas être insérées.
Surveillez les statistiques d'insertion des publicités : configurez des CloudWatch alarmes pour détecter rapidement les problèmes liés au fait de sauter des publicités.
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.

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- Guide complet des variables publicitaires dynamiques dans MediaTailor
Publicités de prélecture- 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- Surveillance à l' MediaTailor aide de CloudWatch métriques
Affichage des AWS Elemental MediaTailor journaux- Comment consulter et analyser les MediaTailor journaux
Résolution des problèmes liés au flux d' MediaTailor événements- Comprendre le flux des événements d'insertion d'annonces
Résolution des problèmes liés au flux d' MediaTailor événements- Techniques avancées de surveillance et de dépannage
Pour plus d'informations sur les différences qui incitent MediaTailor à retranscoder une annonce, consultez la documentation AWS sur la logique de correspondance des variantes
Pour une résolution avancée des problèmes liés au contenu publicitaire, contactez AWS Support

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Résolution des problèmes de lecture

MediaTailor ressources