> 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

Mettez en avant un message Carte lorsqu'un client se trouve à proximité d'un emplacement configuré (magasin ou lieu).

Les notifications géolocalisées affichent un message contextuel à proximité d’un lieu. Apple Wallet ou Google Wallet peuvent l’afficher lorsqu’un client est à proximité. Utilisez-les pour des rappels (« n’oubliez pas votre carte ») et des informations sur place (« 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=""><figcaption></figcaption></figure>

Cela fonctionne pour **les magasins et tout lieu**. Les exemples de lieux typiques 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 au moment du paiement.
* Affichez un rappel de bon uniquement si un bon est disponible.
* Annoncez l’ouverture d’un magasin aux clients à proximité de cet emplacement.
* Rappelez aux détenteurs de billets les informations sur la porte/l’accès lorsqu’ils s’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 apparaissent uniquement 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 de Google Wallet dans votre appareil **Paramètres** (la localisation doit être autorisée).
{% endhint %}

## Comment ça marche

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 « store » 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 à 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 lors de la conception

Les limites de la plateforme suivantes s’appliquent :

* Jusqu’à **10 coordonnées GPS** par Carte.
* Jusqu’à **rayon de 300 m** 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 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/engager-and-animer/automatisation/notifications-push.md).

## Prérequis

Vous devez configurer des 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 **Stores** . Vous pouvez l’utiliser pour des magasins de détail et pour des lieux. Exemple : créez une entrée de magasin pour `Stade - Porte A` ou `Salle de concert - entrée principale`.

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

<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 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 **Plus d’options** menu, puis sélectionnez **Notifications**.
{% endstep %}

{% step %}

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

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

Restez concis. Visez **≤ 140 caractères** pour éviter la troncature.
{% 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. Puis testez 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="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éolocalisée sont configurés par modèle et peuvent être traduits.</p></figcaption></figure></div>

## Comment The Wallet Crew sélectionne les lieux pour chaque 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**.
* Les **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 à proximité.

## Mises à jour automatiques des coordonnées de localisation

Lorsque vous effectuez une mise à jour de Carte via The Wallet Crew, les coordonnées de localisation 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é 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é au moment du paiement.
{%- 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 The Wallet Crew 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éclencheurs de géolocalisation n’envoient pas d’événements « entré » ou « en magasin » à 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 activer 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éolocalisée n’est-elle pas apparue sur Android (Google Wallet) ?</strong></summary>

Commencez par les réglages 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).

Puis validez 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’il la quitte. Il peut réapparaître la prochaine fois qu’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 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 le Bluetooth (identifiants iBeacon). Les notifications géolocalisées utilisent des coordonnées GPS.

Apple Wallet prend également en charge les déclencheurs de balises. Si vous prévoyez de les utiliser, confirmez d’abord vos 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 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/engager-and-animer/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.