# Comment transférer des paramètres et des balises UTM

{% hint style="info" %}
Des plateformes comme Instagram, Facebook, WhatsApp et Telegram mettent en œuvre ce mécanisme via le `visit_key` paramètre.
{% endhint %}

**Prise en charge des liens profonds**\
La plupart des messageries (comme Instagram, Facebook, Telegram) prennent en charge les liens profonds. Cependant, d’autres ne le font pas.

**Contournement pour WhatsApp**\
Bien que WhatsApp ne prenne pas en charge les liens profonds de manière native, vous pouvez tout de même transmettre des paramètres et des balises UTM. Pour ce faire, insérez une variable spéciale dans le texte du message prérempli qui apparaît à l’utilisateur après qu’il a cliqué sur votre lien. (Cette méthode sera abordée en détail plus loin.)

**Stockage des paramètres**\
Tous les paramètres transmis sont enregistrés comme variables client dans le système.

**Structure et types des paramètres**\
Un paramètre est une **paire nom-valeur**. Selon leur origine, les paramètres peuvent être :

* **Statique :** Vous définissez la valeur exacte à transmettre.
  * **Exemple :** `utm_term=webinar1` (où `utm_term` est le nom et `webinar1` est la valeur statique).
* **Dynamique :** La plateforme publicitaire (par exemple, Google Ads, Facebook Ads) insère automatiquement les données pertinentes au moment du clic.
  * **Exemple :** `term={keyword}` — ici, l’espace réservé `{keyword}` est remplacé dynamiquement par le terme de recherche réel qui a déclenché l’annonce.

#### Comment utiliser ces paramètres sur un site

Tous les paramètres transmis à votre site seront convertis en variables de deal une fois que le client lancera le bot. Cela inclut les balises UTM et d’autres libellés.

**Pour obtenir le lien de votre site**, allez dans la section **« Sites »** section.

<div data-with-frame="true"><figure><img src="/files/84418080983f0abc843ede3642256f8cb2e73bad" alt="" width="563"><figcaption></figcaption></figure></div>

Exemple d’ajout de balises UTM à un lien de site :

`https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration`

Les paramètres et les libellés seront transmis au bot et enregistrés comme variables client.

<div data-with-frame="true"><figure><img src="/files/2f4b34c2269ee8c62d8f13da0016b2b6fb823a69" alt=""><figcaption></figcaption></figure></div>

#### Comment utiliser ces paramètres sans site

Vous pouvez utiliser **des liens proxy** pour transmettre des paramètres directement. Une fois le bot lancé via un tel lien, toutes les données transmises seront enregistrées comme variables de deal.

**Le format du lien avec paramètres doit être le suivant :**

**Structure du lien proxy**

Un lien proxy paramétré se compose de deux parties :

1. **URL de base** (le lien proxy lui-même) : `https://mavibot.ai/r/mavibot_1`
2. **Chaîne de requête** (vos paramètres) : `?param1=value1&param2=value2`

**Exemple : ajout de balises UTM à un lien Telegram**

Voici un exemple de lien direct depuis un site vers Telegram avec des paramètres UTM :

<https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor>

<div data-with-frame="true"><figure><img src="/files/6d9ecd06db9b0e586d01cdf886ed36781b67708b" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/51b9d50cd54339e811e9e10e1cc6a38c7fed6cff" alt=""><figcaption></figcaption></figure></div>

**Liens directs vers les messageries dans « Sites »**

Cette section affiche des liens cliquables pour toutes les messageries intégrées à votre système.

## Fonctionnalités de WhatsApp

Comme WhatsApp ne prend pas en charge les liens profonds, vous devez ajouter une variable spéciale au message d’ouverture du bot. Le bot utilisera cette variable pour identifier les paramètres avec lesquels WhatsApp a été lancé.

**La variable : `#{visit_key}`**

Lorsqu’un utilisateur clique sur votre lien WhatsApp, cet espace réservé sera automatiquement remplacé par un code numérique unique contenant les paramètres transmis.

<div data-with-frame="true"><figure><img src="/files/b109efd19c15eaf4c1f5819e9b020187fd8066db" alt=""><figcaption></figcaption></figure></div>

« Sites » → Site → Paramètres de la page du site → Messageries → Paramètres WhatsApp

Lorsqu’un utilisateur accède à WhatsApp depuis votre site (ou via un lien de messagerie depuis les paramètres du site), le `#{visit_key}` espace réservé est remplacé par un code numérique unique.

<div data-with-frame="true"><figure><img src="/files/67253e1ef55bfa5c71ade457e44ee2c42ccc6c1c" alt="" width="375"><figcaption></figcaption></figure></div>

## Abonnement Instagram

**Évolution du suivi des paramètres**

* **Ancienne méthode (`#{visit_key}`):**
* Le `#{visit_key}` la variable était utilisée en la plaçant dans le **« Message initial WhatsApp »**. Cela vous permettait de suivre les paramètres de lancement pour les interactions Instagram.
* **Méthode actuelle (liens profonds avec paramètres de parrainage) :**

Vous pouvez désormais transmettre directement des paramètres de parrainage via les liens profonds Instagram, offrant ainsi plus de flexibilité et de contrôle.

**Avantages de l’utilisation des paramètres de parrainage :**

Avec les paramètres de parrainage, vous pouvez :

* **Suivre les campagnes** en reliant les clics à des sources ou canaux spécifiques.
* **Attribuer des utilisateurs** en reliant un visiteur Instagram à une session ou à un compte dans votre application externe.
* **Personnaliser les parcours** en orientant les utilisateurs vers du contenu ciblé ou des fonctionnalités spécifiques au sein de votre compte Instagram.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>Lien profond Instagram</p></figcaption></figure>

Le paramètre REF\_PARAM est transmis au serveur via un webhook.

Exemple : <https://ig.me/m/mavibotai?ref=mavi>

Vous pouvez copier le lien vers votre bot Instagram dans la section « Canaux ».

Le lien ressemble à : <https://ig.me/m/\\>\<account\_login\_instagram> \*

<div data-with-frame="true"><figure><img src="/files/e684c8f104aec221e0a583841cf16ad6ab85e12e" alt=""><figcaption></figcaption></figure></div>

Le lien ressemble à : <https://ig.me/m/\\>\<account\_login\_instagram>\*

Ajoutez le paramètre au lien copié : ?ref=\<votre paramètre>&#x20;

Ensuite, vous pouvez utiliser le lien avec le paramètre ref pour faire entrer les utilisateurs dans l’Instagram botanique.

Le paramètre ne sera transmis QUE lors du tout premier contact de l’utilisateur avec votre compte (bot).

## Balises UTM dans la section Analytics

Vous pouvez consulter les statistiques sur les balises UTM dans la section « Analytics »

Accédez à la section « Analytics » et sélectionnez l’onglet « Clients ».

<div data-with-frame="true"><figure><img src="/files/98df7a674c455212933108524031902b179ecd25" alt="" width="563"><figcaption></figcaption></figure></div>

Cliquez sur le bouton « Ajouter un widget ».

<div data-with-frame="true"><figure><img src="/files/78f20c561ea2356a2a119e34b8eb376350f748e8" alt="" width="563"><figcaption></figcaption></figure></div>

Le **Le générateur de widgets** s’ouvrira.

1. Sélectionnez le **Balises UTM** .
2. Cliquez sur le bouton **« Ajouter une valeur »** .

<div data-with-frame="true"><figure><img src="/files/a6af03a5abe2bc760aaed1f7655314f95ea9722c" alt="" width="375"><figcaption></figcaption></figure></div>

Des paramètres supplémentaires pour les valeurs des balises UTM apparaissent. Cliquez sur le champ **« Sélectionner une balise »**.

<div data-with-frame="true"><figure><img src="/files/18eac4aa3d9eebf367232c3d77c2a01225bcec1a" alt="" width="563"><figcaption></figcaption></figure></div>

et sélectionnez le libellé pour lequel vous souhaitez consulter les statistiques.

<div data-with-frame="true"><figure><img src="/files/a43bec45567a3e06b84c2cb868795385ca4e95b7" alt="" width="325"><figcaption></figcaption></figure></div>

Si vous souhaitez ajouter plusieurs balises ou toutes les balises, cliquez à nouveau sur « Ajouter une valeur ».

<div data-with-frame="true"><figure><img src="/files/0b1c649530240c388d6b0c45a4fb9faf8eab1c19" alt="" width="563"><figcaption></figcaption></figure></div>

N’oubliez pas de spécifier la période et les autres paramètres, et assurez-vous de les enregistrer.

Ajoutez ensuite le nombre requis de balises, puis cliquez sur le bouton « Enregistrer ».&#x20;

<div data-with-frame="true"><figure><img src="/files/ffedd4bbd811b0c97db8bfbd3bcb3830637bd3f0" alt="" width="375"><figcaption></figcaption></figure></div>

Ensuite, vous devez cliquer sur le bouton « Ajouter un widget ».

<div data-with-frame="true"><figure><img src="/files/c7de5f6efb4c04b08f6fd911ceb5b37fccc24dec" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
En savoir plus sur l’utilisation des analyses dans l’article « [MaviBot Analytics](/doc/fr/analytique-mavibot.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/websites/sites/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.