# Paramètres d'URL

> Apprenez à utiliser les paramètres d'URL dans PandaSuite pour créer des deep links, personnaliser l'expérience utilisateur et suivre vos campagnes marketing, sans code.

https://docs.pandasuite.com/fr/essentials/project-properties/url-parameters/

**Les paramètres d'URL permettent de passer des informations dans un lien pour piloter votre application : afficher le bon écran, personnaliser le contenu, pré-remplir un formulaire, ou activer une langue. Le tout sans code et sans serveur.**

```
https://app.pandasuite.com/abc123?session_name=demo&lang=fr
```

Un paramètre est un couple `clé=valeur` ajouté après le `?`. Plusieurs paramètres sont séparés par `&`. À l'ouverture du lien, PandaSuite les rend immédiatement accessibles dans votre projet via le [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/).

> **Info**
>
> Les paramètres d'URL fonctionnent sur les liens de partage, les web-apps et PWA publiées, les exports ZIP auto-hébergés, et les apps iOS/Android avec un [domaine personnalisé](https://docs.pandasuite.com/fr/essentials/web-publishing/custom-domain/).

## Étape 1 : Déclarer le paramètre

1. Dans PandaSuite Studio, cliquez sur **Projet** dans le fil d'Ariane.
2. Dans le panneau **Propriétés**, cliquez sur **+ Ajouter** dans la section **Paramètres d'URL**.
3. Nommez-le exactement comme il apparaîtra dans l'URL (ex : `lang`, `session_name`).
4. Définissez une **valeur par défaut** si vous souhaitez un comportement de repli quand le paramètre est absent.

> **Attention : Respecter la casse**
>
> Le nom doit correspondre exactement à la clé dans l'URL : `lang` ≠ `Lang`

## Étape 2 : Utiliser la valeur dans le projet

Partout dans le projet, ouvrez le **data binding** et suivez l'arborescence :

`Projet` → `Contexte` → `Lancement` → `Paramètre(s)` → *votre\_paramètre*

Vous pouvez lier cette valeur à n'importe quel champ : contenu d'un texte, écran cible d'une action, condition, etc.

> **Info**
>
> Vous devez manipuler un lien complet dans un binding ? Utilisez le [type de
> donnée URL](https://docs.pandasuite.com/fr/essentials/data/data-types/#url) et les [fonctions
> URL](https://docs.pandasuite.com/fr/essentials/data/functions/#fonctions-url). Cette page couvre
> uniquement les valeurs entrantes déjà exposées dans **Projet** →
> **Contexte** → **Lancement**.

## Cas d'utilisation

### Deep link vers un écran précis

Le cas d'usage le plus courant : ouvrir l'application directement sur un écran donné.

1. Déclarez un paramètre `wid`.
2. Ajoutez un déclencheur **Lancement de projet** au niveau du projet.
3. Ajoutez une action **Changer d'écran** et liez le champ *Écran* à `Paramètre(s)` → `wid`.
4. [Copiez l'ID de l'écran cible](https://docs.pandasuite.com/fr/essentials/layout/screens/#identifiant-et-url-directe-dun-écran) depuis le menu contextuel de l'écran.
5. Construisez votre URL :

```
https://app.pandasuite.com/abc123?wid=c6bd920408125e82000712
```

### Afficher un contenu personnalisé

Liez le **Contenu** d'un bloc de texte au paramètre `session_name` :

```
https://viewer.pandasuite.com/xyz?session_name=Bienvenue+Sophie
```

Le texte affiche immédiatement "Bienvenue Sophie" à l'ouverture.

### Activer la bonne langue

1. Déclarez un paramètre `lang`.
2. Ajoutez un composant [Condition](https://docs.pandasuite.com/fr/essentials/components/condition/) au niveau Projet.
3. Créez une règle : si `lang == "fr"` → action **Changer de langue** → Français.

```
https://app.pandasuite.com/abc123?lang=fr
```

### Pré-remplir un formulaire

Liez les champs de votre formulaire aux paramètres `email`, `firstname`, etc. Utile pour les campagnes emailing où les destinataires arrivent avec leurs informations déjà renseignées.

### Tracker une campagne marketing (UTM)

Déclarez `utm_source`, `utm_campaign`, etc. et stockez-les dans des variables ou le [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) pour les exploiter ultérieurement.

### Personnaliser une présentation

[Modèle : Smart business présentation](https://pandasuite.com/fr/templates/proposition-commerciale-interactive/)

[Image : Template Smart business présentation : écrans au logo du client Grow avec une estimation, alimentés par une base Airtable de clients]

Chaque URL affiche un logo différent et des valeurs issues d'une base Airtable. [Voir le tutoriel complet](https://docs.pandasuite.com/fr/tutorials/how-to/interactive-sales-proposal-template/)

## Bonnes pratiques

- Utilisez un **URL encoder** pour les valeurs contenant des espaces ou des caractères spéciaux.
- Ne transmettez jamais de données sensibles (mot de passe, token) en clair dans l'URL.
- Documentez vos paramètres pour vos équipes marketing et partenaires.

## Ressources associées

- [Data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/)
- [Types de données](https://docs.pandasuite.com/fr/essentials/data/data-types/#url)
- [Fonctions](https://docs.pandasuite.com/fr/essentials/data/functions/#fonctions-url)
- [Identifiant et URL directe d'un écran](https://docs.pandasuite.com/fr/essentials/layout/screens/#identifiant-et-url-directe-dun-écran)
- [Composant Condition](https://docs.pandasuite.com/fr/essentials/components/condition/)
- [Domaine personnalisé](https://docs.pandasuite.com/fr/essentials/web-publishing/custom-domain/)
- [Lien de partage](https://docs.pandasuite.com/fr/essentials/project-management/sharing-link/)