Ce que votre page doit gérer

Ce dont votre page est responsable une fois une expérience intégrée : hauteur, panneaux, headers, connexion, politique de sécurité et permissions.

3 min de lecture

Cette page s'adresse à votre développeur web. Tout ce qui se trouve dans l'iframe relève de l'expérience ; le comportement de l'iframe dans votre page est de votre ressort.

Hauteur

L'expérience n'a pas de hauteur fixe. Un formulaire est court, un jeu remplit l'écran, et une récompense se situe entre les deux. L'iframe doit s'adapter. Sinon, le visiteur se retrouve avec une barre de défilement dans votre page, et votre pied de page flotte à mi-hauteur.

Deux types de pages obtiennent leur hauteur différemment :

PageSa hauteur
Pages d'accueil, formulaires, listes et la plupart des étapesL'expérience la communique à chaque changement. Votre page l'applique.
Jeux, et quelques étapes en plein écran comme les pages d'erreurIls remplissent la hauteur de l'iframe, quelle qu'elle soit, et ne communiquent rien

Fixez la hauteur de l'iframe à chaque chargement

Un jeu ne communique jamais de hauteur : une page qui en attend une attend donc indéfiniment. À chaque chargement d'une nouvelle page dans l'iframe, réglez sa hauteur sur la hauteur visible de l'écran, moins celle de votre header sticky.

Le tag JavaScript gère les deux types pour vous. Une page écrite à la main a besoin des messages entre la page et l'expérience.

Panneaux qui s'ouvrent dans l'expérience

Les expériences ouvrent des panneaux, comme une récompense ou un formulaire. Un panneau se trouve dans l'iframe : sur une longue page, il pourrait donc s'ouvrir loin de l'endroit où regarde le visiteur.

L'expérience ouvre donc chaque panneau près du dernier appui du visiteur, sans dépasser la hauteur de l'écran. Le tag fait ensuite défiler votre page pour centrer le panneau, sous votre header sticky. Sur une page écrite à la main, c'est à votre code de gérer ce défilement : voir Panneaux.

Votre page peut toujours défiler pendant qu'un panneau est ouvert. Le panneau est fixé dans l'iframe : il se déplace donc avec votre page.

Headers sticky

Si votre site a un header fixé en haut de l'écran, un panneau risque de s'ouvrir derrière lui. Le tag détecte de lui-même un header standard et en écarte les panneaux. Si votre header est inhabituel, indiquez-le au tag : voir Headers sticky.

Connexion

Quand un participant se connecte, l'écran de connexion occupe tout l'onglet. Ensuite, le tag le ramène sur votre page, dans la même expérience. Avec votre propre iframe, c'est votre page qui s'en charge : voir Une page parente écrite à la main.

C'est aussi votre page qui détermine si le participant démarre l'expérience connecté. Avec le tag JavaScript, il démarre sans connexion à chaque chargement de la page. Une variable loginStatus permet de modifier ce comportement : voir Statut de connexion.

Une iframe écrite à la main n'envoie pas de login : un participant qui s'est connecté auparavant reste donc connecté. Ajoutez login=0 à son adresse pour démarrer sans connexion, ou login=1 pour faire d'abord passer le visiteur par la connexion.

Votre politique de sécurité de contenu

Si votre site envoie une politique de sécurité de contenu, comme la plupart, elle doit autoriser deux hôtes. Sinon, l'intégration est bloquée, sans que rien à l'écran ne l'explique :

  • l'hôte depuis lequel se charge le tag ;
  • l'hôte depuis lequel l'expérience est diffusée.

Les valeurs exactes se trouvent dans Ce dont le tag a besoin de votre page. Abordez le sujet tôt : sur beaucoup de sites, une autre équipe gère la politique, et sa validation prend plus de temps que le développement.

Permissions du navigateur

Les permissions comme la caméra sont accordées à votre page, puis transmises à l'iframe par son attribut allow. Votre site doit aussi utiliser HTTPS. Si l'iframe n'obtient jamais la permission, aucune demande ne s'affiche pour le visiteur, et le jeu semble en panne plutôt que bloqué.

Le tag n'ajoute aucun attribut allow à son iframe : une expérience qui utilise la caméra ou la localisation ne peut donc pas passer par le tag. Écrivez l'iframe vous-même, avec allow="camera; geolocation". Une page parente écrite à la main en contient une, avec le retour de la connexion.

Étapes suivantes

Sur cette page