Vérifier la compatibilité et la prise en charge des SDK

compatibilité avec les lecteurs de flux vidéo.

Cette page fournit des informations générales sur la compatibilité et la prise en charge de l'IMA DAI pour les navigateurs, les formats vidéo et les plates-formes.

Formats vidéo et navigateurs compatibles

HTML5 est une norme encore récente et en constante évolution. Par conséquent, la compatibilité avec différentes fonctionnalités varie selon les navigateurs, et il n'existe pas de format vidéo par défaut unique compatible avec tous les principaux navigateurs. Les trois principaux formats vidéo utilisés dans la majorité des navigateurs sont H.264, HLS et Dash.

Compatibilité des événements VAST

Cette section liste les événements VAST qui sont automatiquement signalés au serveur en fonction des informations renvoyées dans la réponse VAST.

Totalement compatible

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (déclenché en cas d'avance rapide significative vers l'arrière), start, thirdQuartile.

Partiellement compatible

  • click

    L'événement Click n'est envoyé que pour les annonces vidéo. Les clics ne peuvent pas être enregistrés dans les lecteurs plein écran natifs sur Android, iOS ou ordinateur, mais ils peuvent toujours être enregistrés par un élément de suivi des clics sur la page lorsque la vidéo est fermée. Toutefois, si l'élément vidéo utilise des commandes natives sur l'iPad, les clics ne peuvent pas être capturés.

  • fullscreen

    IMA est compatible avec le mode plein écran simulé, dans lequel la vidéo occupe toute la fenêtre du navigateur. IMA considère qu'une vidéo est en mode plein écran lorsque ses offsetWidth et offsetHeight sont au moins de la taille du corps du document. Ce mode est compatible avec tous les navigateurs.

    Sur l'iPhone et les plates-formes Android antérieures à la version 3.0, les vidéos sont toujours lues en mode plein écran.

  • mute, unmute

    Seuls iOS et Android disposent d'un contrôle natif du volume. Par conséquent, IMA ne peut pas déterminer le volume ni l'état de la mise en sourdine, et le SDK n'est pas informé des modifications. Vous trouverez ci-dessous la liste des versions de navigateur compatibles et non compatibles avec mute, unmute :

    • Navigateurs compatibles : Firefox 3.5+, Chrome 8+, Safari 4+
    • Non compatible : iOS, Android

Pour en savoir plus sur la diffusion d'annonces VAST, consultez les consignes de l'IAB.

Événements publicitaires lors du visionnage de coupures publicitaires

IMA ne déclenche pas d'événements d'annonce lorsque les utilisateurs regardent à nouveau des annonces pour les raisons suivantes :

  • Les URL d'événement ne doivent être déclenchées qu'une seule fois, sinon cela pourrait être considéré comme un comportement spammeur.
  • Cela permet aux utilisateurs de rechercher des contenus dans les pauses publicitaires qu'ils ont déjà regardées, ce qui améliore l'expérience de recherche.

Voici les seuls événements déclenchés lorsque vous regardez à nouveau des pauses publicitaires :

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

Plates-formes de lecteur vidéo compatibles

Les SDK IMA de Google sont compatibles avec les plates-formes suivantes :

Plate-forme Version
HTML5 Ordinateur : Chrome, Firefox, Safari, Edge, Opera
Mobile : Chrome/Navigateur Android (Android pour téléphones et tablettes), Safari et Chrome (iOS)
iOS iOS 10.0 et versions ultérieures
Android Android 4.4 ou version ultérieure
Google Cast Tous les appareils Cast
tvOS tvOS 14 ou version ultérieure
Roku Tous les appareils qui reçoivent encore des mises à jour logicielles de Roku

Formats de flux vidéo acceptés

IMA est compatible avec HLS et DASH dans ses SDK. Consultez ce tableau pour obtenir de l'aide sur des plates-formes SDK spécifiques. Pour que le flux soit lu correctement, votre lecteur vidéo doit être compatible avec le type de flux utilisé.

Plate-forme du SDK IMA HLS DASH
HTML5 Coche Coche
iOS Coche Red-X
Android Coche Coche
Google Cast Coche Coche
tvOS Coche Red-X
Roku Coche Coche

Fonctionnalités vidéo et versions du SDK

Pour en savoir plus sur les fonctionnalités suivantes, consultez Présentation de la publicité vidéo.

Suite vidéo de l'IAB Assistance
VAST 4 Avertissement 1
VAST 3 Avertissement 2
VAST 2 Coche
VPAID 2 Red-X
VMAP 1.0.1 Avertissement 3
Fonctionnalités vidéo Ad Manager Assistance
Annonces linéaires Coche
Annonces non linéaires (superpositions) Red-X
Annonces associées Avertissement 4
Ressources d'annonces associées alternatives VAST 3 Red-X
Visibilité Active View Coche
Redirections VAST Coche
Remplissage des annonces associées avec une demande display Red-X
Compatibilité avec Google Publisher Tag (GPT) Red-X
Sensibilisation au contenu Red-X
Règles relatives aux annonces Coche
Diffusion d'annonces en série Coche
Bumper Coche
Créer des rapports sur le suivi multi-événement (MET) Coche
Désactivable (réservation / non-TrueView) Avertissement 5
Fonctionnalités AdSense pour les vidéos 7 Assistance
InStream TrueView Avertissement 6
Sélection InStream Coche
InStream standard Coche
Emplacement complet Red-X
Annonces associées Avertissement 4
Remplissage des composants Red-X
Superpositions Red-X
Fonctionnalités Ad Exchange dans Ad Manager Assistance
InStream TrueView Avertissement 6
Sélection InStream Coche
InStream standard Coche
Emplacement complet Red-X
Annonces associées Avertissement 4
Remplissage des composants Red-X
Superpositions Red-X
Visibilité Active View Coche
Pourquoi cette annonce ? Avertissement 8

1 Parmi les fonctionnalités VAST 4 compatibles avec Google Ad Manager, IMA prend en charge les suivantes :

2 Les fonctionnalités VAST 3.0 suivantes ne sont pas encore disponibles :

  • Compagnon adSlotId
  • Options de diffusion des annonces associées
  • Icônes

3 Les fonctionnalités VMAP suivantes ne sont pas encore disponibles :

  • Événements de suivi spécifiques à VMAP
  • Codes d'erreur spécifiques à VMAP
  • Annonces en superposition
  • Décalages temporels autres que hh:mm:ss ou "start" et "end"
  • Attribut breakType
  • repeatAfter attribut

4 Seules les images associées sont acceptées. Les composants associés illustrés nécessitent une implémentation personnalisée pour remplir les annonces. Les annonces associées ne sont pas compatibles avec tvOS.

5 Les annonces désactivables traditionnelles ne sont compatibles qu'avec les SDK IMA pour l'insertion dynamique d'annonces pour HTML5, iOS, tvOS, Roku et Android (y compris Android TV). Avec le SDK Cast, vous devez déclarer la possibilité d'ignorer les annonces avec StreamRequest.senderCanSkip pour prendre en charge les annonces traditionnelles pouvant être ignorées.

6 Les annonces désactivables TrueView ne sont compatibles qu'avec les SDK IMA DAI pour HTML5, iOS et Android (y compris Android TV).

7 Les fonctionnalités AdSense ne sont pas compatibles avec le SDK Cast.

8 Pourquoi cette annonce ? exige que le paramètre adUiElement soit transmis lors de la création de StreamManager. La fonctionnalité Pourquoi cette annonce ? n'est pas compatible avec le SDK Cast.

Mises en garde concernant les frameworks JavaScript

Il existe certaines considérations à prendre en compte lorsque vous utilisez un framework JavaScript, tel que React ou AngularJS, avec le SDK IMA HTML5. Ces frameworks déplacent souvent des éléments du DOM, ce qui peut casser le SDK IMA, car il s'attend à ce que le DOM soit statique lorsqu'il est initialisé. Le SDK IMA est compatible avec les frameworks JavaScript, à condition qu'il soit initialisé une fois que le framework a fini de déplacer les éléments DOM. Plus précisément, l'élément HTML5 transmis en tant qu'argument adUiElement lors de la construction de StreamManager ne doit pas être déplacé une fois qu'il est instancié.

Compatibilité avec Apple AirPlay

Le SDK IMA n'est pas compatible avec Apple AirPlay. Désactivez AirPlay ou les demandes d'annonces lorsqu'AirPlay est détecté.