> 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/engagement-et-animation/geolocated-notifications.md).

# Notifications géolocalisées

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

<figure><img src="/files/424a471693d49f232f49e1adc12fe28a2f1489e3" alt=""><figcaption></figcaption></figure>

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

<details>

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

* Rappelez aux membres du programme de fidélité de scanner leur carte en caisse.
* Afficher un rappel de bon uniquement si un bon est disponible.
* Annoncez l’ouverture d’un magasin aux clients à proximité de ce lieu.
* Rappelez aux détenteurs de billets les informations de porte d’accès lorsqu’ils approchent du lieu.
* Afficher 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 fonctions 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 sur votre appareil **Paramètres** (la localisation doit être autorisée).
{% endhint %}

## Comment ça fonctionne

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

The Wallet Crew configure ces lieux sur la carte en fonction de votre jeu de données de localisation. La plupart des marques utilisent les adresses des magasins. Pour les lieux, vous modélisez généralement le lieu 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 de verrouillage lorsque le client se trouve à proximité de l’un des lieux configurés. La suggestion peut inclure le message que vous avez configuré.
{% 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 lieux configurés. L’interface exacte dépend de la version d’Android et du fabricant de l’appareil.
{% endtab %}
{% endtabs %}

### Limites à prendre en compte

Les limites de la plateforme suivantes s’appliquent :

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

L’affichage du message est contrôlé 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 The Wallet Crew. Elles sont déclenchées par le téléphone du client lorsqu’il détecte une proximité.

Si vous avez besoin d’un message déclenché par le serveur, utilisez plutôt les notifications Wallet standard. Commencez par [Notifications push](/guides-animation/fr/engagement-et-animation/push-notification.md).

## Prérequis

Vous devez configurer les lieux (adresses) dans The Wallet Crew. La plateforme utilise ces adresses pour calculer les coordonnées GPS.

Les lieux sont gérés via le **jeu de données Stores** . Vous pouvez l’utiliser pour les magasins de détail et pour les lieux. Exemple : créez une entrée de magasin pour `Stadium - Gate A` ou `Salle de concert - Entrée principale`.

Si vous n’avez pas encore configuré de lieux, commencez par [jeu de données Stores](https://docs.thewalletcrew.io/guides-enrolment).

<div data-with-frame="true"><figure><img src="/files/d42389eae5e22f13a153df5e62ec7d8549bb6f76" alt="The Wallet Crew back office showing store and address configuration"><figcaption><p>Les adresses servent à calculer les coordonnées GPS (magasins ou lieux).</p></figcaption></figure></div>

## Configurez le message dans The Wallet Crew

Configurez le message directement sur le modèle de carte. Utilisez Liquid si vous avez besoin de personnalisation.

{% stepper %}
{% step %}

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

Accédez à **Modèles**. Ouvrez le modèle **menu Plus d’options** puis sélectionnez **Notifications**.
{% endstep %}

{% step %}

#### Rédigez le message (onglet Notification géolocalisée)

Ouvrez l’onglet **Notification géolocalisée** . Rédigez votre message. Ajoutez des variables Liquid si nécessaire.

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

{% step %}

#### Configurez les traductions (facultatif)

Si votre modèle est traduit, mettez à jour le message de notification géolocalisée pour chaque langue.
{% endstep %}

{% step %}

#### Enregistrez et testez

Cliquez sur **Envoyer la notification** pour enregistrer. Testez ensuite avec un appareil près d’un lieu configuré.

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

<div data-with-frame="true"><figure><img src="/files/3f2f5c5c1648e18b3a1b1e69466ce201430f447d" alt="Notification configuration screen showing the Geo notification tab"><figcaption><p>Les messages de notification géolocalisée sont configurés par modèle et peuvent être traduits.</p></figcaption></figure></div>

## Comment The Wallet Crew sélectionne les lieux par client

La logique de sélection des lieux dépend de votre cas d’usage. Les programmes de fidélité reposent généralement sur la logique du « magasin principal ». Les billets d’événement reposent généralement sur le lieu que vous attribuez à la carte.

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

* le **magasin principal**.
* du client **9 lieux les plus proches** de ce magasin principal (ou de l’adresse du client).

Cela maintient la carte dans la limite de 10 lieux tout en couvrant les lieux proches.

## Mises à jour automatiques des coordonnées des lieux

Lorsque vous effectuez une mise à jour de carte via The Wallet Crew, les coordonnées des lieux peuvent être recalculées :

* Si le magasin principal du client change, la liste des « lieux les plus proches » est recalculée.
* Si l’adresse du client change, la liste des « lieux les plus proches » est recalculée.
* Si vous ajoutez de nouveaux magasins (avec une adresse), ils peuvent devenir éligibles comme « lieux les plus proches ».

Cela aligne les déclencheurs de localisation sur vos données de localisation les plus récentes.

## Exemples Liquid pour les messages de notification géolocalisée

Utilisez Liquid pour afficher un message uniquement aux clients concernés. Les entrées typiques sont les identifiants de magasin, les données de profil client et la disponibilité de 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 aujourd’hui en magasin.
{%- else -%}
N’oubliez pas de scanner votre carte de fidélité en caisse.
{%- endif -%}
```

{% endcode %}

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

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

{% endcode %}

## FAQ

<details>

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

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

</details>

<details>

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

Non. Les déclencheurs de géolocalisation n’envoient pas d’événements « entré » ou « en magasin » vers The Wallet Crew.

</details>

<details>

<summary><strong>Pourquoi la notification géolocalisée n’est-elle pas apparue 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**.

Validez ensuite 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éolocalisée n’est-elle pas apparue sur Android (Google Wallet) ?</strong></summary>

Commencez par les paramètres Android. L’utilisateur doit autoriser les fonctions de localisation pour Google Wallet (et ne pas les restreindre via les paramètres de confidentialité du système).

Validez ensuite les données de la carte. La carte doit inclure des lieux, 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’ils en sortent. Il peut réapparaître la prochaine fois qu’ils y entrent.

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

</details>

<details>

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

Chaque client a un magasin principal. The Wallet Crew sélectionne les 9 lieux les plus proches de ce magasin principal, 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 Bluetooth (identifiants iBeacon). Les notifications géolocalisées utilisent des coordonnées GPS.

Apple Wallet prend aussi en charge les déclencheurs de balises. Si vous prévoyez de les utiliser, vérifiez d’abord vos appareils cibles et les contraintes matérielles des magasins.

</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 dynamically by asking a question.

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

```
GET https://docs.thewalletcrew.io/guides-animation/fr/engagement-et-animation/geolocated-notifications.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.