Codes d'erreur VAST courants et comment les résoudre
Publié: 2022-09-04La plupart des publicités vidéo sur Internet doivent respecter les spécifications définies par la norme Video Ad Serving Template (VAST) pour garantir la fonctionnalité et la compatibilité avec les lecteurs vidéo. L'un des problèmes les plus courants rencontrés par les éditeurs produisant de la publicité vidéo via les plates-formes Google, telles que YouTube et Google AdSense, est les codes d'erreur VAST.
Découvrez ce que sont les codes d'erreur VAST, quels sont les codes d'erreur les plus courants et comment les résoudre.
Qu'est-ce qu'une erreur VAST ?
Un code d'erreur de modèle de diffusion d'annonce vidéo est l'un des nombreux états d'erreur possibles définis par l'Interactive Advertising Bureau (IAB) . Une erreur VAST indique un problème entre le serveur hébergeant le contenu de l'annonce et le lecteur vidéo du consommateur cible, qui peut entraver ou empêcher le bon affichage de l'annonce .
La nature exacte de l'erreur dépend du code affiché ; chaque code correspond à un problème identifié.
Défis courants liés à l'affichage d'annonces VAST dans Ad Tech
Bien que l'affichage d'annonces VAST tende à être plus simple à mettre en œuvre et plus rentable à long terme que des solutions alternatives telles que Video Player-Ad Interface Definition (VPAID), le principal défi pour les éditeurs est d' assurer la visibilité des annonces .
De nombreux types de problèmes techniques perturbent fréquemment la visibilité et la fonctionnalité des annonces VAST. Dans de nombreux cas, des interruptions se produisent en raison de paramètres de configuration incorrects , que ce soit du côté de l'acheteur ou de l'éditeur. Ces perturbations se manifestent sous la forme de codes d'erreur VAST .
Les codes d'erreur VAST sont classés en deux niveaux de gravité : les erreurs fatales et les erreurs potentiellement non fatales .
Codes d'erreur fatale VAST courants et comment les résoudre
Un code d'erreur fatale VAST est le plus grave, car il est le plus susceptible d'avoir arrêté la demande d'annonce , entraînant une interruption de l'affichage. Certaines erreurs fatales VAST courantes incluent :
Erreur VAST 100 : erreur d'analyse XML
L'erreur VAST 100 est l'une des erreurs fatales les plus courantes. Les causes potentielles de l'erreur VAST 100 incluent une réponse incorrecte de l'acheteur ou un document XML non valide, corrompu ou mal formaté . Une autre possibilité est un problème de redirection d'URL VAST, par exemple, lorsque la redirection ne se résout pas correctement.
Les éditeurs qui remarquent un code d'erreur 100 doivent alerter l'acheteur . À leur tour, les acheteurs doivent vérifier que l'URL VAST est correctement configurée, puis s'assurer que tous les documents XML VAST sont fonctionnels et correctement formatés avec les attributs appropriés.
Erreur VAST 101 : erreur de validation du schéma
Une erreur de validation de schéma se produit généralement lorsque la réponse de l'acheteur ne contient pas les éléments ou attributs XML requis ou contient des éléments non reconnus.
La meilleure façon de traiter un code d'erreur 101 consiste pour l'acheteur à consulter la documentation IAB , à vérifier les spécifications XML VAST et à s'assurer que tous les éléments requis et correctement formatés sont présents .
Erreur VAST 102 : version de réponse non prise en charge
Ce code d'erreur courant est déclenché lorsqu'un lecteur vidéo cible ne prend pas en charge la version VAST de la demande d'enchère. Cela peut également se produire si l'échange a envoyé la mauvaise version de VAST .
Dans de rares cas, l'annonce VAST peut ne pas spécifier de numéro de version. Dans ce cas, cela peut également être considéré comme une erreur de validation de schéma .
Pour corriger l'erreur 102, l'acheteur doit s'assurer que les réponses ne comportent que des versions VAST prises en charge .
Erreur VAST 300 : erreur d'encapsuleur
L'erreur VAST 300 est une erreur générale de wrapper. Il est déclenché lorsque la limite du wrapper est atteinte .
Ce code d'erreur n'est pas exploitable ; il n'y a pas de méthodes de résolution . Cependant, il existe quelques étapes correctives qui peuvent potentiellement empêcher l'affichage d'une erreur 300, telles que l'examen périodique des URI VAST et la vérification qu'aucun d'entre eux n'expire.
Erreur VAST 301 : expiration du délai de redirection atteint
L'IAB a initialement défini le code d'erreur 301 pour indiquer un URI VAST défectueux, qui ne répond pas ou qui a expiré. Cependant, les spécialistes des technologies publicitaires associent généralement les erreurs 301 à une latence élevée (familièrement appelée « décalage ») et à des connexions Internet médiocres ou instables .
Les causes directes potentielles d'une erreur 301 incluent :
- Le paramètre de délai d'attente du lecteur est trop bas (le paramètre par défaut est 5)
- Mauvaise dimension de la création (taille de l'annonce)
- URI invalide
- Délai d'expiration de l'URI VAST
- Latence élevée
- HTTP à HTTPS
- Site mal optimisé
Erreur VAST 302 : limite d'encapsuleur atteinte
Le lecteur vidéo qui reçoit une publicité est généralement configuré avec sa propre limite d'enveloppe prédéfinie. Atteindre cette limite est la cause la plus fréquente d'un code d'erreur 302.
Les erreurs 302 se produisent généralement en raison d'un nombre excessif de réponses d'encapsuleur reçues sans réponse en ligne. L'action corrective consiste pour l'éditeur à augmenter la limite d'encapsulation du lecteur vidéo .
Dans de rares cas, des erreurs 302 se produisent en raison d'une connexion en guirlande : une boucle ou un nombre excessif de redirections VAST avant de renvoyer un fichier multimédia, entraînant l'abandon de la demande d'annonce par le lecteur vidéo. Dans ce cas, l'acheteur doit s'assurer qu'aucune redirection VAST ne pointe vers une autre redirection.
Erreur VAST 303 : réponse VAST vide renvoyée
Le code d'erreur 303 indique une réponse VAST vide, généralement due à une demande d'annonce contenue dans un wrapper tiers .
Les acheteurs et les éditeurs travaillant avec des réseaux tiers doivent vérifier le taux de remplissage , qui est généralement inférieur à 100 %. Par exemple, un taux de remplissage de 86 % signifie qu'il y a 14 % de chances que cette erreur se produise.
Pour résoudre une erreur VAST 303, les éditeurs doivent activer la fonctionnalité de remplacement dans Google Ad Manager . Suivez ces étapes:
- Connectez-vous à votre compte Google Ad Manager et ouvrez le tableau de bord.
- Cliquez sur le bouton Admin dans le panneau de gauche, accédez à Vidéo, puis à Paramètres vidéo.
- Activez le repli vidéo, puis cliquez sur Enregistrer.
Erreur VAST 400 : erreur linéaire générale
Une erreur VAST 404 est généralement due à l' incapacité d'un lecteur vidéo à afficher une publicité linéaire .
Les causes les plus courantes d'un échec d'affichage des publicités linéaires incluent :
- Le navigateur Web limite la lecture automatique (lecture automatique) avec le son
- Le format MediaFile n'est pas valide (par exemple, il ne s'agit pas d'un fichier vidéo valide ou d'un format incorrectement spécifié)
- Source inconnue ou non précisée
Les éditeurs qui remarquent une erreur 400 doivent vérifier les problèmes de lecteur vidéo et configurer le lecteur pour qu'il détecte les navigateurs dont la lecture automatique est restreinte . Si ces mesures ne résolvent pas le problème, les acheteurs doivent vérifier la réponse VAST et s'assurer qu'elle renvoie une création valide .
Erreur VAST 401 : MediaFile introuvable
Si vous voyez un code d'erreur 401, cela signifie que l'URI MediaFile ne renvoie pas de création vidéo valide ou ne trouve pas de fichier vidéo valide.
Les éditeurs qui découvrent ce code d'erreur doivent alerter les acheteurs dès que possible , et ces derniers doivent s'assurer que tous leurs URI MediaFile renvoient une création vidéo valide.
Erreur VAST 402 : impossible de télécharger ou délai d'expiration de l'URI MediaFile
Une erreur VAST 402 peut avoir plusieurs causes possibles. Les quatre problèmes suivants sont les plus probables :
- La valeur (en millisecondes) de la variable loadVideoTimeout dans le SDK IMA du fichier est trop faible. Si le temps de chargement de la page prend plus de temps que cette valeur, la lecture de l'annonce sera annulée , ce qui peut entraîner une erreur.
- Mauvaises performances ou optimisation du site Web, entraînant des retards de temps de chargement suffisants pour annuler la lecture des publicités
- Le fichier vidéo se lance ou tente de se lancer automatiquement dans un environnement mobile où il n'est pas prévu qu'il se comporte de cette façon (la plupart des annonces vidéo sur mobile doivent être cliquables, sauf dans certains cas)
- Sur les navigateurs Google Chrome, affichage d'une annonce vidéo dans un environnement de lecture automatique même si la fenêtre n'est pas active (par exemple, fenêtre réduite, onglet différent sélectionné ou un autre programme sur un autre écran actuellement actif)
Bien que toutes ces causes n'aient pas de remèdes correspondants, la solution recommandée aux éditeurs consiste à inspecter le délai d'expiration du lecteur vidéo et à définir la variable loadVideoTimeout sur une valeur plus élevée. La valeur par défaut est -1, correspondant à 8 secondes (8 000 ms).
D'autres solutions potentielles incluent l'optimisation du site Web pour atteindre des vitesses de chargement plus rapides ou l'ajustement du débit vidéo pour de meilleures performances de diffusion d'annonces sur les appareils mobiles.
Erreur VAST 403 : la réponse a déclaré des types MIME non pris en charge pour tous les fichiers multimédias
Ce code d'erreur est parmi les plus fréquemment rencontrés et est le plus courant sur les appareils mobiles.
Le code d'erreur 403 indique qu'une réponse VAST a déclaré un ou plusieurs types d'extensions de messagerie Internet polyvalentes (MIME) non pris en charge pour tous les MediaFiles disponibles (par exemple, tentative de lecture de contenu Flash sur mobile). Ce code d'erreur peut également se produire lorsque le mauvais type de création a essayé de jouer .
Lorsqu'ils rencontrent ce code d'erreur, les éditeurs doivent s'assurer que le format de fichier et la technologie des annonces sont compatibles avec l'appareil et le système d'exploitation du lecteur. Les acheteurs doivent également vérifier que toutes les créations renvoyées respectent les formats vidéo de la demande d'enchère (par exemple, les applications mobiles ne doivent pas demander de créations VPAID).
Erreur VAST 405 : erreur d'affichage du fichier multimédia
Une erreur d'affichage MediaFile (VAST 405) se produit généralement en raison d'une création défectueuse . Les types de défaillance courants incluent :
- Le type MIME et le type de fichier vidéo ne correspondent pas
- Configuration incorrecte du partage des ressources cross-origin (CORS) sur le CDN de la création
- Problème de transcodage
Pour résoudre ce problème, les acheteurs doivent vérifier que tous les types MIME de création et les options de configuration CDN sont exacts .
Erreur VAST 406 : fichier mezzanine requis manquant
La cause la plus courante d'un code d'erreur 406 est une réponse VAST renvoyée sans fichier mezzanine requis . Un fichier mezzanine est un fichier vidéo haute résolution de haute qualité, souvent brut (non compressé) ou compressé de sorte qu'il est impossible de le distinguer du fichier brut.
Les fichiers mezzanine sont généralement requis dans les environnements reposant sur des implémentations publicitaires côté serveur . Ces fichiers sont utilisés pour générer des fichiers vidéo de qualité appropriée pour la plate-forme cible, comme pour les environnements mobiles ou pour effectuer l'assemblage de publicités.
Les acheteurs voyant un code d'erreur 406 doivent s'assurer qu'un fichier mezzanine approprié est inclus dans la réponse VAST .
Erreur VAST 407 : fichier mezzanine téléchargé pour la première fois
Le code d'erreur 407 indique que le fichier mezzanine est en cours de téléchargement et de transcodage pour la première fois , entraînant l'échec de la diffusion d'une annonce. Ce code d'erreur est attendu et non actionnable ; la seule action corrective consiste à attendre la fin du processus de transcodage .
Selon la taille du fichier mezzanine, ce processus peut prendre plusieurs heures.
Erreur VAST 408 : annonce rejetée dans la réponse VAST
Si vous voyez le code d'erreur VAST 408, cela signifie que le fichier publicitaire renvoyé dans la réponse VAST a été rejeté .
Les éditeurs doivent alerter les acheteurs des erreurs 408 dès que possible, et les acheteurs doivent s'assurer que les réponses VAST ne contiennent que des créations approuvées . Les entités agissant en tant qu'hébergeurs de créations publicitaires (par exemple, l'agence de publicité ou d'édition) doivent également être conscientes de tout refus de publicité afin de prendre les mesures appropriées.
Erreur VAST 409 : la création interactive définie dans le nœud InteractiveCreativeFile ne s'est pas exécutée
La cause la plus probable d'une erreur VAST 409 est l'échec de la lecture de la création définie par le nœud Les acheteurs doivent s'assurer que toutes les créations interactives (par exemple, une démo jouable pour un jeu mobile) renvoyées dans la réponse VAST sont lues correctement lorsqu'elles sont demandées.
Erreur VAST 410 : le code référencé dans le nœud de vérification n'a pas été exécuté
Les erreurs VAST 410 se produisent généralement en raison d'un échec d'exécution du code défini dans le nœud Les acheteurs doivent s'assurer que le code AdVerification est fonctionnel et correctement mis en œuvre.
Erreur VAST 500 : erreur générale des annonces non linéaires
Si ce code d'erreur est renvoyé, cela signifie généralement que le lecteur vidéo n'a pas réussi à afficher une annonce non linéaire pour des raisons inconnues .
Les éditeurs peuvent tenter de corriger le code d'erreur en vérifiant les problèmes de lecteur vidéo , et les acheteurs doivent vérifier toutes les réponses VAST pour s'assurer qu'elles renvoient des créations valides.
Erreur VAST 501 : les dimensions de la création publicitaire non linéaire ne s'alignent pas sur la zone d'affichage de la création
Une erreur VAST 501 est généralement le résultat d'un échec de lecture d'une annonce non linéaire en raison d'une inadéquation entre les dimensions de la création (taille de l'annonce) et la zone d'affichage de la création (espace à l'écran). Plus précisément, les erreurs 501 se produisent lorsque les dimensions de la création sont trop grandes pour la zone d'affichage (en d'autres termes, l'annonce est trop grande pour l'écran).
Dans des cas plus rares, une erreur 501 peut être déclenchée par un CSS mal configuré , tel que des styles CSS fixant la hauteur et la largeur de l'élément de contenu vidéo.
Les éditeurs peuvent remédier à ce code d'erreur en modifiant la hauteur et la largeur définies de la création pour qu'elles correspondent à la zone d'affichage. Si l'éditeur a défini la taille de l'élément de contenu vidéo à l'aide de styles CSS, l'action recommandée consiste à utiliser des attributs HTML à la place.
Erreur VAST 502 : Impossible de récupérer les annonces non linéaires/la ressource non linéaire
La cause la plus courante d'un code VAST 502 est la réponse d'un acheteur renvoyant une annonce non linéaire qui n'a pas renvoyé de création valide . Les acheteurs doivent s'assurer que toutes les réponses d'annonces non linéaires renvoient des créations valides.
Erreur VAST 503 : Impossible de trouver une ressource non linéaire avec le type pris en charge
Les éditeurs qui demandent une taille de création supérieure aux dimensions du lecteur vidéo peuvent rencontrer un code d'erreur 503. Un type de média non valide peut entraîner ce code d'erreur dans des cas plus rares.
L'action corrective recommandée consiste pour l'éditeur à s'assurer que toutes les tailles de création et tous les types de médias demandés sont compatibles avec le lecteur vidéo.
Erreur VAST 901 : erreur VPAID générale
Une erreur 901 est un code d'erreur fatale générique que toute erreur VPAID peut provoquer. Les causes possibles incluent :
- Le wrapper SSP VPAID a expiré
- Le wrapper SSP VPAID n'achète pas
- Les créations VPAID nécessitent un mode non sécurisé
- Utilisation d'une balise "Adaptateur IMA" avec le SDK IMA (la balise VAST correcte à utiliser est "Direct SDK")
Les éditeurs doivent s'assurer que toutes les demandes VPAID sont prises en charge pour les appareils cibles et les lecteurs vidéo. La fonctionnalité de profil de création vidéo de Google peut vous aider à gérer vos créations et à éviter ce code d'erreur.
Les acheteurs peuvent examiner les réponses VAST renvoyant des wrappers VPAID HTML5 et s'assurer qu'ils incluent un élément MP4 et n'interrompent pas la lecture.
Codes d'erreur VAST potentiellement non fatals courants et comment les résoudre
Une erreur non fatale indique un problème qui n'a peut-être pas empêché l'affichage de l'annonce. Cependant, il est essentiel de traiter la cause de l'erreur dès que possible pour garantir des performances optimales et éviter des erreurs plus graves. Voici quelques erreurs VAST courantes non fatales :
Erreur VAST 200 : le lecteur vidéo attendait un type d'annonce différent
Une erreur VAST 200 se produit généralement lorsque le lecteur vidéo ne prend pas en charge ou n'attend pas le type d'annonce demandé dans une demande d'enchère.
Un exemple de type d'annonce non pris en charge est celui des annonces désactivables envoyées aux lecteurs qui ne peuvent prendre en charge que les annonces linéaires.
Les éditeurs peuvent résoudre ce code d'erreur en recherchant les erreurs de trafficking . Si l'éditeur ne parvient pas à résoudre le problème, l'acheteur doit s'assurer que les réponses VAST n'envoient que les types d'annonces spécifiés .
Erreur VAST 201 : le lecteur vidéo attendait une linéarité différente
Ce code d'erreur est généralement causé par un décalage de linéarité entre la demande du lecteur vidéo et la réponse de l'acheteur . Un exemple d'incompatibilité de linéarité est une réponse VAST envoyant une publicité non linéaire alors que la demande spécifiait une publicité linéaire.
Les éditeurs doivent s'assurer que les demandes d'annonces spécifient la linéarité correcte, et les acheteurs doivent vérifier que les réponses VAST incluent uniquement la linéarité spécifiée dans la demande d'annonce.
Erreur VAST 202 : le lecteur vidéo devrait avoir une durée différente
VAST Le code d'erreur 202 se produit lorsque la réponse renvoie une création avec une durée différente de celle spécifiée . Par exemple, si la durée spécifiée est de 30 secondes, mais que la durée réelle du MediaFile est de 45 secondes, cela peut entraîner une erreur 202.
Les éditeurs doivent configurer correctement la durée de la création dans Google Ad Manager et les acheteurs doivent s'assurer que la réponse respecte la durée maximale spécifiée pour la demande.
Erreur VAST 203 : le lecteur vidéo devrait avoir une taille différente
Ce code d'erreur est le plus souvent causé par une incompatibilité entre les MediaFiles renvoyés et le périphérique cible . Par exemple, l'envoi d'une création avec un débit élevé vers des appareils mobiles, même si ces appareils sont mieux adaptés aux débits plus faibles.
Les acheteurs peuvent remédier à une erreur 203 en s'assurant que toutes les réponses VAST incluent des MediaFiles compatibles avec plusieurs types d'appareils et de technologies , y compris la compatibilité du débit binaire.
Erreur VAST 600 : erreur générale associée aux annonces associées
L'erreur 600 est une erreur générique non fatale généralement causée par un problème non spécifié avec les annonces compagnons. Cela se produit le plus souvent lorsque l'éditeur ne peut pas afficher une annonce associée sans raison particulière.
Pour résoudre ce code d'erreur, les éditeurs peuvent essayer de rechercher d' éventuels problèmes de diffusion d'annonces , et les acheteurs doivent s'assurer que les réponses VAST renvoient des fichiers de création valides.
Erreur VAST 601 : les dimensions de la création associée ne s'alignent pas sur la zone d'affichage associée
Ce code d'erreur se produit généralement lorsque la taille d'une création associée est trop grande pour tenir dans la zone d'affichage de l'annonce associée.
Les éditeurs doivent s'assurer que la taille de l'annonce associée demandée (hauteur et longueur) correspond aux dimensions du bloc d'annonces.
Erreur VAST 602 : impossible d'afficher le compagnon requis
Une erreur VAST 602 signifie que l'éditeur n'a pas réussi à afficher la création associée renvoyée dans la réponse VAST correspondante .
Ce code d'erreur est généralement le symptôme d' un problème de diffusion d'annonces , que les éditeurs doivent rechercher et résoudre. Les acheteurs doivent également s'assurer que la réponse VAST renvoie une création valide.
Erreur VAST 603 : Impossible de récupérer les annonces compagnons/la ressource compagnon
Les erreurs Vast 603 se produisent généralement lorsque la réponse de l'acheteur renvoie un compagnon qui n'a pas pu renvoyer une création valide . L'acheteur doit vérifier et s'assurer que toutes les réponses d'annonces associées renvoient des créations valides.
Erreur VAST 604 : impossible de trouver une ressource associée avec le type pris en charge
Une erreur VAST 604 est généralement le résultat d' un éditeur demandant un type de création non pris en charge pour un espace publicitaire compagnon.
Pour résoudre ce code d'erreur, les éditeurs doivent s'assurer que l'espace publicitaire associé prend en charge les types de création spécifiés.
Codes d'erreur VAST potentiellement fatals et non fatals
Ces codes d'erreur peuvent ou non correspondre à des erreurs fatales.
Erreur VAST 900 : erreur VAST 2 (potentiellement non fatale)
Ce code d'erreur spécifique est dû à une erreur VAST 2 de tout type , même si des versions ultérieures de VAST sont demandées (par exemple, VAST 3) ou si la version par défaut de votre réseau est VAST 3 ou une version ultérieure.
Pour résoudre ce code d'erreur, les éditeurs doivent commencer à demander VAST 3 ou activer VAST 3 sur leur réseau . Il est conseillé aux acheteurs de travailler avec l'éditeur pour un dépannage plus spécifique.
Erreur fatale VAST 900 : erreur VAST 3 indéfinie
Ce code d'erreur est renvoyé lorsqu'une erreur VAST 3 inconnue s'est produite et a arrêté la demande d'annonce. En raison de la nature non spécifique de ce code d'erreur, il est conseillé aux éditeurs et aux acheteurs de travailler ensemble pour identifier le problème exact .
Meilleures pratiques pour les éditeurs pour gérer les erreurs
Bien que la meilleure façon d'éviter les codes d'erreur de tout type soit d'empêcher les conditions nécessaires à l'apparition d'un code d'erreur, elles sont parfois inévitables. Voici quelques bonnes pratiques que les éditeurs doivent suivre :
- Portez une attention particulière au numéro de code d'erreur . De nombreuses erreurs peuvent être résolues ou atténuées sans contacter l'acheteur, ce qui permet de gagner un temps considérable.
- Assurez-vous que les plates-formes côté demande (DSP) ont la possibilité d'analyser chaque création et de résoudre les problèmes potentiels à l'origine d'erreurs avant de diffuser l'annonce.
- Communiquez et collaborez avec vos DSP, plates-formes côté offre (SSP), réseaux publicitaires et serveurs publicitaires pour améliorer les performances de vos créations.
Résoudre les codes d'erreur VAST avec CodeFuel
Comprendre la nature de chaque erreur VAST est essentiel pour résoudre tous les problèmes potentiels de diffusion d'annonces et optimiser les performances de vos publicités vidéo .
Si vous avez besoin d'aide pour résoudre les erreurs VAST , CodeFuel peut vous aider. Notre équipe d'experts en publicité vidéo et de spécialistes de la monétisation peut vous aider et résoudre tous les codes d'erreur VAST susceptibles de se produire. Contactez-nous aujourd'hui pour plus d'informations.