Aller au contenu

Informations du projet

Via le data binding, le projet expose une arborescence de données contextuelles. Vous pouvez vous en servir pour personnaliser l’expérience, adapter l’interface, détecter le contexte de lancement ou exploiter des paramètres transmis au projet.

Informations projet

Informations du projet

Voici l’arborescence exposée par le projet, regroupée par catégorie :

Contexte général

  • Projet > Contexte > locale
  • Projet > Contexte > userAgent
  • Projet > Contexte > timezone
  • Projet > Contexte > timestamp

Ecran et projet

  • Projet > Contexte > Ecran > width
  • Projet > Contexte > Ecran > height
  • Projet > Contexte > Ecran > density
  • Projet > Contexte > Ecran > breakpoint
  • Projet > Contexte > Projet > width
  • Projet > Contexte > Projet > height
  • Projet > Contexte > Projet > portrait

Ecrans

  • Projet > Ecrans > Courant
  • Projet > Ecrans > Courant > did
  • Projet > Ecrans > Courant > name
  • Projet > Ecrans > Courant > index
  • Projet > Ecrans > Liste > ... > screen

La valeur Ecran conserve did comme identifiant utilisé pour la navigation. name et index sont exposés pour l’affichage, le tri ou les conditions. L’index commence à 0 et suit l’ordre des écrans dans le projet.

Viewer et environnement

  • Projet > Contexte > Viewer > type
  • Projet > Contexte > Viewer > uid
  • Projet > Contexte > Viewer > deviceToken
  • Projet > Contexte > Viewer > Web > isPWAInstalled
  • Projet > Contexte > Réseau > wifiSSID
  • Projet > Contexte > Permissions > tracking

Viewer > deviceToken contient le token natif de push notification exposé par les viewers iOS et Android. Il peut être vide si les push notifications ne sont pas configurées, si l’utilisateur n’a pas accordé l’autorisation de notification ou avant que la plateforme native ait généré un token.

Lancement

  • Projet > Contexte > Lancement > Paramètre(s) > ...
  • Projet > Contexte > Lancement > Url

Paramètres métier

  • Projet > Push Notification (données) > title
  • Projet > Push Notification (données) > message
  • Projet > Push Notification (données) > sound
  • Projet > Push Notification (données) > Données > ...
  • Projet > Paramètre(s) EMM > ...
  • Projet > Paramètre(s) SAML > ...

Paramètre(s) > ..., Push Notification (données) > Données > ..., Paramètre(s) EMM > ... et Paramètre(s) SAML > ... sont dynamiques : les clés disponibles dépendent des paramètres déclarés dans les propriétés du projet ou du contenu du payload de push.

Quelques usages courants

  • Détecter la langue de l’appareil avec Projet > Contexte > locale
  • Adapter une mise en page à l’écran avec Projet > Contexte > Ecran > breakpoint
  • Afficher le nom de l’écran courant avec Projet > Ecrans > Courant > name
  • Vérifier la position de l’écran courant avec Projet > Ecrans > Courant > index
  • Contrôler un deep link avec Projet > Contexte > Lancement > Paramètre(s) > wid
  • Envoyer le device token courant à votre backend avec Projet > Contexte > Viewer > deviceToken
  • Réutiliser un code de campagne push avec Projet > Push Notification (données) > Données > campaign
  • Vérifier l’état du suivi iOS avec Projet > Contexte > Permissions > tracking

Afficher un indicateur de page

L’arborescence des écrans permet de construire un indicateur de page dynamique, du type 3 / 8, qui se met à jour tout seul à mesure que le lecteur passe d’un écran à l’autre. Il combine deux valeurs exposées : la position de l’écran courant et le nombre total d’écrans.

Insérez un bloc de texte à l’endroit voulu, ouvrez le data binding de son Contenu, puis choisissez la fonction Concat pour assembler trois éléments :

  1. Numéro de la page couranteProjet > Ecrans > Courant > index, avec la fonction Add réglée sur 1. L’index commençant à 0, ajouter 1 fait afficher 1 pour le premier écran.
  2. Un séparateur — un texte court tel que /.
  3. Nombre total d’écrans — la fonction Count appliquée à Projet > Ecrans > Liste.

Comme le binding lit Courant > index, l’indicateur se rafraîchit automatiquement à chaque changement d’écran actif, y compris lorsque le lecteur swipe en Mode magazine.

Ressources associées