Cet article regroupe les problèmes les plus fréquents lors de la création d’un flow dans le Flow & Paywall Builder, chacun accompagné de sa cause et de sa solution.

Un flow refuse de s’afficher en aperçu ou de se publier

Vous pouvez rencontrer les erreurs suivantes lorsque vous tentez d’afficher un aperçu ou de publier le flow :

Message	Cause et solution
No product selected	Une carte produit n’a aucun produit. Sélectionnez-en un ou supprimez la carte.
This product no longer exists, This offer no longer exists	Le produit ou l’offre a été supprimé de votre Dashboard. Choisissez-en un autre à l’endroit où il est utilisé, ou utilisez Replace in N places sur l’entrée Missing dans le panneau Products pour corriger toutes les utilisations sur l’écran en une seule fois.
This product is off this screen, This offer is off this screen	Une variable de texte, une condition ou une action fait référence à un produit qui ne figure pas dans la liste de l’écran, par exemple après l’avoir supprimé dans le panneau Products. Rajoutez le produit dans le panneau, ou modifiez la référence.
Offer required	offer_price, offer_billing_period ou offer_full_duration est utilisé avec un produit qui n’a pas d’offre. Choisissez une offre pour le produit, ou utilisez plutôt une variable prod_*.
Product reference is invalid	Une référence produit est malformée. Resélectionnez le produit.
Purchase action has no product to buy	Une action Purchase n’a aucun produit : soit laissé vide, soit pointant vers une carte supprimée. Dans l’onglet Interactions de l’élément, définissez Product sur un produit ou sur products.selectedProduct.
Select product action has no product to select	La carte vers laquelle pointait une action Select product a disparu : supprimée, déplacée hors de son groupe de produits, ou sur un autre écran. Dans l’onglet Interactions de l’élément, faites pointer l’action vers une carte de cet écran.
Flow has no screens, Screen ”…” has no elements	Ajoutez du contenu à l’écran vide ou supprimez-le. Un flow qui ne contient que du contenu Remote Config est exempté.
Invalid interaction action	Une action est incomplète : Open URL sans URL, Navigate to screen sans destination, Set variable sans assignation, Custom sans identifiant d’action, Show alert sans titre ni message, Show ou Hide sans élément, un paiement web Purchase sans URL de paywall web. Ouvrez les interactions de l’élément et complétez ou supprimez l’action.
Missing navigation target	Une action Navigate to screen pointe vers un écran qui a été supprimé. Choisissez un écran existant ou supprimez l’action.
Missing product target, Invalid product target, Product target on another screen, Ambiguous product target, Select Product inside a component	Une action Select product cible une carte qui a été supprimée, ne fait pas partie d’un groupe de produits, se trouve sur un autre écran, partage son identifiant d’élément avec un élément d’un autre écran, ou se trouve dans un pied de page ou un en-tête partagé entre les écrans. Faites pointer l’action vers une carte dans un groupe de produits sur le même écran, avec un identifiant unique.
Missing selectable group	Un élément pointe vers un groupe sélectionnable qui n’existe plus. Reconnectez-le ou recréez le groupe.
Invalid visibility condition	Une règle de visibilité conditionnelle est incomplète. Complétez-la dans le générateur de conditions.
Localized conditional text mismatch	Un texte conditionnel a des branches différentes selon les locales. Donnez à chaque locale les mêmes conditions.
Missing product reference	Un flow plus ancien utilise un produit qui n’est pas enregistré sur l’écran. Ouvrez l’écran et ajoutez le produit dans le panneau Products.

Prévisualisez le flow dans l’application Adapty régulièrement pendant la construction. Un flow qui ne peut pas être publié ne se chargera pas non plus, et le message d’erreur identifie le problème.

La publication échoue avec « Something went wrong » sans détails

La requête de publication a échoué du côté d’Adapty, pas à cause de votre flow. Votre version en ligne reste inchangée. Attendez quelques minutes et publiez à nouveau. Si l’échec persiste, copiez le Request ID affiché dans la notification et envoyez-le à support@adapty.io pour que l’équipe puisse localiser la requête en échec.

Une offre ne s’applique pas lors de l’achat

Le builder vérifie uniquement que l’offre existe toujours dans Adapty. C’est le store qui décide si la réduction s’applique au moment de l’achat : les offres de lancement dépendent de l’éligibilité du client, et les offres promotionnelles App Store nécessitent une clé d’achat intégré valide. Ces deux cas sont traités dans Incohérences de produit et de prix.

Le prix d’une offre est vide dans l’aperçu

L’aperçu du builder ne peut pas accéder aux stores, donc offer_price, offer_billing_period et offer_full_duration affichent le nom de la variable entre accolades au lieu d’une valeur. Ces variables sont résolues lorsque le SDK affiche le flow dans votre application. Pour prévisualiser les conditions qui dépendent du type d’offre, consultez Prévisualiser les produits et offres.

La publication échoue après avoir saisi une couleur hex abrégée

Saisissez chaque couleur sous la forme de six chiffres hexadécimaux, par exemple #FFFFFF. Le champ couleur accepte une valeur plus courte sans jamais la développer : une forme abrégée comme #FFF parvient donc à la configuration du SDK sous une forme invalide et la publication est rejetée. L’opacité n’a rien à voir là-dedans — la même valeur échoue à 100 % d’opacité. Le cas le plus trompeur est une valeur à quatre chiffres : elle est publiée, mais affiche une couleur que vous n’avez pas choisie.

Les modifications typographiques n’atteignent pas un état d’élément

Une fois qu’un état, comme Selected, possède ses propres paramètres typographiques, les modifications apportées à la typographie de l’état Default — y compris l’application d’un style de texte différent — n’affectent pas cet état. Modifiez directement la typographie de l’état concerné.

Les éléments perdent leur style après la suppression d’un style de texte

Supprimer un style de texte ne copie pas ses paramètres dans les éléments qui l’utilisent : ces éléments reviennent à la typographie par défaut. Avant de supprimer un style, réaffectez les éléments concernés à un autre style ou définissez manuellement leur typographie.

Les conditions et variables se cassent après un changement d’identifiant d’élément

Les conditions et variables texte référencent les éléments par leur Element ID (identifiant d’élément). Si vous modifiez cet identifiant, les références ne sont pas mises à jour automatiquement — elles cessent silencieusement de fonctionner. Définissez l’identifiant avant de l’utiliser comme référence. Si vous devez le modifier, mettez à jour chaque condition et variable qui s’y réfère. Exception : les segments de barre de progression — renommer un segment met automatiquement à jour ses références.

Une condition ou variable renvoie une valeur vide

Le sélecteur de variables liste les champs de tous les écrans, donc une condition ou une variable texte peut faire référence à une saisie que l’utilisateur n’a pas encore remplie. À l’exécution, cette référence renvoie une valeur vide. Ne faites référence qu’aux champs collectés plus tôt dans le flow.

L’action Set variable ne change pas le produit sélectionné

Le produit sélectionné n’est pas une variable que vous pouvez affecter, donc Set variable ne peut pas modifier la sélection. Utilisez l’action Select product à la place.

Une image ou une vidéo ne se télécharge pas

Un fichier qui dépasse les limites du Flow & Paywall Builder ne se téléchargera pas. Vérifiez le fichier par rapport aux exigences d’Image et de Vidéo :

Élément	Formats	Taille maximale	Autres limites
Image	.JPG, .PNG, .WEBP	20 Mo	—
Vidéo	.MP4, .WEBM	50 Mo	30 secondes maximum ; 640×640 pixels minimum

Ces formats ne sont pas pris en charge :

• GIF animés et WEBP animés : pour ajouter du mouvement, utilisez un élément Vidéo à la place.
• SVG : exportez le fichier en PNG ou WEBP. Pour les icônes, vous n’avez rien à uploader — l’élément Icône puise dans la bibliothèque Tabler Icons intégrée.

Un pied de page ne s’affiche pas

Un pied de page s’affiche uniquement sur un écran où le Défilement vertical est activé. Activez le Défilement vertical dans Screen settings > Scroll.