> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-animation/fr/engager-and-animer/geolocated-notifications.md).

# Notifications géolocalisées

Afficher un message de Carte lorsqu’un client se trouve à proximité d’un magasin ou d’un lieu configuré, en utilisant les emplacements pertinents enregistrés sur la Carte.

Les notifications géolocalisées affichent un message contextuel près d’un emplacement. Apple Wallet ou Google Wallet peuvent l’afficher lorsqu’un client se trouve à proximité. Utilisez-les pour des rappels (« n’oubliez pas votre carte ») et des informations sur site (« la porte a changé »).

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-053f463a09f1c104da5a25a107eab553ee0bb683%2Fdocumentation-geolocated-notifications-geolocated-notifications.png?alt=media" alt="A geolocated wallet notification shown on a phone near a store"><figcaption><p>Vérifiez que le message se lit clairement d’un coup d’œil, puisqu’il apparaît sur l’écran verrouillé.</p></figcaption></figure>

Cela fonctionne pour **les magasins et tout lieu**. Les exemples typiques de lieux sont les stades, les salles de concert, les théâtres et les pop-ups.

<details>

<summary><strong>Exemples concrets</strong></summary>

* Rappelez aux membres du programme de fidélité de scanner leur carte à la caisse.
* Affichez un rappel de bon uniquement si un bon est disponible.
* Annoncez l’ouverture d’un magasin aux clients proches de cet emplacement.
* Rappelez aux détenteurs de billets les informations de porte/entrée lorsqu’ils approchent du lieu.
* Affichez un message « votre billet est prêt » près de l’entrée du lieu.

</details>

{% hint style="info" %}
Les notifications géolocalisées n’apparaissent que si le client active les fonctionnalités de localisation pour son application Wallet.

Sur iOS : **Réglages → Confidentialité et sécurité → Services de localisation → Wallet**.

Sur Android : vérifiez les autorisations Google Wallet dans les paramètres de l’appareil **Réglages** (la localisation doit être autorisée).
{% endhint %}

## Fonctionnement

Les Cartes Wallet peuvent stocker un petit ensemble d’emplacements de « pertinence ». Le téléphone compare la position de l’appareil à ces emplacements. Lorsque le client entre dans le rayon configuré, l’application Wallet peut afficher la Carte et son message.

L’équipe Wallet configure ces emplacements sur la Carte en fonction du jeu de données d’emplacements de la marque. La plupart des marques utilisent les adresses des magasins. Pour les lieux, le lieu est généralement modélisé comme un enregistrement « magasin » afin qu’il puisse être géolocalisé de la même manière.

### Ce que les clients verront (varie selon la plateforme)

{% tabs %}
{% tab title="Apple Wallet (iOS)" %}
iOS peut afficher une suggestion sur l’écran verrouillé lorsque le client se trouve près de l’un des emplacements configurés. La suggestion peut inclure le message configuré sur le modèle.
{% endtab %}

{% tab title="Google Wallet (Android)" %}
Android peut afficher une expérience de « Carte à proximité » lorsque le client se trouve près de l’un des emplacements configurés. L’interface exacte dépend de la version d’Android et du fabricant de l’appareil.
{% endtab %}
{% endtabs %}

### Limites à prendre en compte

Ces limites de plateforme s’appliquent :

* Jusqu’à **10 coordonnées GPS** par Carte.
* Jusqu’à **300 m de rayon** par coordonnée.

La visibilité du message est contrôlée par le système d’exploitation. En pratique, le message peut rester visible tant que le client reste dans la zone.

### Géolocalisation vs « notifications push »

Les notifications géolocalisées ne sont pas « envoyées » à un moment précis par l’équipe Wallet. Elles sont déclenchées par le téléphone du client lorsqu’il détecte la proximité.

Pour un message déclenché côté serveur, utilisez plutôt les notifications Wallet standard. Commencez par [Notifications push](/guides-animation/fr/engager-and-animer/automatisation/push-notifications.md).

## Prérequis

Les emplacements (adresses) doivent être configurés dans l’équipe Wallet. La plateforme utilise ces adresses pour calculer les coordonnées GPS.

Les emplacements sont gérés via le jeu de données **Magasins** qui couvre à la fois les magasins de détail et les lieux. Exemple : créez une entrée de magasin pour `Stade - Porte A` ou `Salle de concert - Entrée principale`.

Lorsque les emplacements ne sont pas encore configurés, commencez par [Magasins](https://docs.thewalletcrew.io/guides-enrolment/fr/).

<div data-with-frame="true"><figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-a9d0ebfebdfac9a3abc4f5b263071d9f1ec3cba6%2Fdocumentation-geolocated-notifications-wallet-crew-back-office-showing-store-address.png?alt=media" alt="The Wallet Crew back office showing store and address configuration"><figcaption><p>Les adresses sont utilisées pour calculer les coordonnées GPS (magasins ou lieux).</p></figcaption></figure></div>

## Configurer le message dans l’équipe Wallet

Configurez le message directement sur le modèle de Carte. Utilisez Liquid pour la personnalisation.

{% stepper %}
{% step %}

#### Ouvrez les paramètres de notification d’un modèle

Allez dans **Modèles**. Ouvrez le modèle **Plus d’options** menu, puis sélectionnez **Notifications**.
{% endstep %}

{% step %}

#### Rédiger le message (onglet Notification géo)

Ouvrez l’onglet **Notification géo** . Rédigez le message. Ajoutez des variables Liquid si nécessaire.

Restez concis. Visez **≤ 140 caractères** pour éviter la troncature.
{% endstep %}

{% step %}

#### Configurer les traductions (facultatif)

Lorsque le modèle est traduit, mettez à jour le message de notification géo pour chaque langue.
{% endstep %}

{% step %}

#### Enregistrer et tester

Cliquez sur **Envoyer la notification** pour enregistrer. Testez ensuite avec un appareil à proximité d’un emplacement configuré.

Validez à la fois le comportement de localisation et le rendu Liquid.
{% endstep %}
{% endstepper %}

<div data-with-frame="true"><figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-8f13190d544134531d045b124aa0372a2c895d49%2Fdocumentation-geolocated-notifications-notification-screen-showing-geo-tab.png?alt=media" alt="Notification configuration screen showing the Geo notification tab"><figcaption><p>Les messages de notification géo sont configurés par modèle et peuvent être traduits.</p></figcaption></figure></div>

## Comment l’équipe Wallet sélectionne les emplacements pour chaque client

La logique de sélection des emplacements dépend du cas d’usage. Les programmes de fidélité s’appuient généralement sur la logique du « magasin habituel ». Les billets d’événement s’appuient généralement sur l’emplacement du lieu attribué à la Carte.

Pour une configuration de type commerce, les notifications géolocalisées sont généralement calculées pour :

* Le **magasin habituel**.
* Les **9 emplacements les plus proches** de ce magasin habituel (ou de l’adresse du client).

Cela permet de rester dans la limite de 10 emplacements tout en couvrant les emplacements proches.

## Mises à jour automatiques des coordonnées d’emplacement

Lorsqu’une mise à jour de Carte est effectuée via l’équipe Wallet, les coordonnées d’emplacement peuvent être recalculées :

* Si le magasin habituel du client change, la liste des « emplacements les plus proches » est recalculée.
* Si l’adresse du client change, la liste des « emplacements les plus proches » est recalculée.
* Lorsque de nouveaux magasins sont ajoutés (avec une adresse), ils peuvent devenir éligibles comme « emplacements les plus proches ».

Cela permet d’aligner les déclencheurs de localisation sur les données de localisation les plus récentes.

## Exemples Liquid pour les messages de notification géo

Utilisez Liquid pour afficher un message uniquement aux clients pertinents. Les entrées typiques sont les identifiants de magasin, les données de profil client et la disponibilité des bons.

{% code title="Exemple 1 — afficher un rappel de bon uniquement si un bon existe" %}

```liquid
{%- if y2.bons.loyaltyCertificates.size > 0 -%}
Votre bon de fidélité de 20 € est disponible. Utilisez-le en magasin aujourd’hui.
{%- else -%}
N’oubliez pas de scanner votre carte de fidélité à la caisse.
{%- endif -%}
```

{% endcode %}

{% code title="Exemple 2 — message spécifique au magasin" %}

```liquid
{%- if storeId == "013" -%}
Ce magasin est définitivement fermé. Visitez nos autres magasins à proximité.
{%- else -%}
Bon retour. Votre magasin est à proximité. Venez découvrir nos dernières nouveautés.
{%- endif -%}
```

{% endcode %}

## FAQ

<details>

<summary><strong>Pouvons-nous suivre combien de clients ont reçu le message géolocalisé ?</strong></summary>

Non. Ce n’est pas un message que l’équipe Wallet envoie activement à un moment donné. Le téléphone du client le déclenche localement lorsqu’il s’approche des coordonnées configurées.

</details>

<details>

<summary><strong>Savons-nous si le client se trouve à l’intérieur du magasin ou du lieu ?</strong></summary>

Non. Les déclenchements de géolocalisation n’envoient pas d’événements « entrée » ou « en magasin » à l’équipe Wallet.

</details>

<details>

<summary><strong>Pourquoi la notification géo ne s’est-elle pas affichée sur un iPhone ?</strong></summary>

Commencez par les réglages iOS. Le client doit autoriser l’accès à la localisation pour Wallet dans **Réglages → Confidentialité et sécurité → Services de localisation → Wallet**.

Puis validez les données de la Carte. La Carte doit inclure des coordonnées de localisation. Le client doit être suffisamment proche du rayon configuré.

</details>

<details>

<summary><strong>Pourquoi la notification géo ne s’est-elle pas affichée sur Android (Google Wallet) ?</strong></summary>

Commencez par les réglages Android. Le client doit autoriser les fonctionnalités de localisation pour Google Wallet (et ne pas les restreindre via les paramètres de confidentialité du système).

Puis validez les données de la Carte. La Carte doit inclure des emplacements, et le client doit être suffisamment proche pour les déclencher.

</details>

<details>

<summary><strong>Quel est le délai entre deux notifications géolocalisées ?</strong></summary>

Le système d’exploitation affiche généralement le message lorsque le client entre dans la zone configurée. Il peut disparaître lorsqu’il la quitte. Il peut réapparaître la fois suivante où il y entre.

Référence d’Apple : [Afficher une Carte sur l’écran verrouillé](https://developer.apple.com/documentation/walletpasses/showing-a-pass-on-the-lock-screen).

</details>

<details>

<summary><strong>Comment les 10 emplacements sont-ils sélectionnés pour un client ?</strong></summary>

Chaque client a un magasin habituel. L’équipe Wallet sélectionne les 9 emplacements les plus proches de ce magasin habituel, pour un total de 10.

</details>

<details>

<summary><strong>Est-ce la même chose que les notifications basées sur des balises ?</strong></summary>

Non. Les balises utilisent le Bluetooth (identifiants iBeacon). Les notifications géolocalisées utilisent des coordonnées GPS.

Apple Wallet prend également en charge les déclencheurs de balise. Avant de les utiliser, confirmez les appareils cibles et les contraintes matérielles du magasin.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/guides-animation/fr/engager-and-animer/geolocated-notifications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.