> 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/engage-and-animate/geolocated-notifications.md).

# Notifications géolocalisées

Affichez un message Carte lorsqu’un client se trouve à proximité d’un magasin ou d’un lieu configuré, et configurez le message dans la console d’administration.

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-le pour les rappels (« n’oubliez pas votre carte ») et les 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-24d1665f78605bf7581670fe0a93ffa5a0657f0d%2Fgeolocated-notification-phone-example-clean-labels.png?alt=media" alt="A geolocated wallet notification shown on a phone, with a map and a concert hall in the background"><figcaption><p>Vérifiez que le message se lit clairement d’un coup d’œil, puisqu’il apparaît sur l’écran de verrouillage.</p></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 d’achat uniquement si un bon d’achat est disponible.
* Annoncez l’ouverture d’un magasin aux clients près de cet emplacement.
* Rappelez aux détenteurs de billets les informations de porte/entrée à l’approche 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 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 dans les paramètres de l’appareil **Paramètres** (la localisation doit être autorisée).
{% endhint %}

## Fonctionnement

Les cartes Wallet peuvent stocker un petit ensemble d’emplacements « pertinents ». 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.

The Wallet Crew renseigne ces emplacements à partir des magasins du locataire, dans **Données et intégrations → Magasins de données**. Voir [Comment The Wallet Crew sélectionne les emplacements par client](#how-the-wallet-crew-selects-locations-per-customer). Pour les lieux, le lieu est généralement modélisé comme un magasin afin de pouvoir ê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 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 « 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. Elle n’affiche pas le message rédigé dans The Wallet Crew.
{% endtab %}
{% endtabs %}

### Limites à prendre en compte dans la conception

Ces limites de plateforme s’appliquent :

* Jusqu’à **10 emplacements** par carte, sur les deux applications Wallet.
* Le rayon est défini par le Wallet, sans garantie. Apple Wallet utilise la plus petite des valeurs entre le **Distance maximale** du modèle et sa propre distance par défaut, qui est d’environ 250 m et contrôlée par Apple. Google Wallet utilise un rayon défini par Google.

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. Le système d’exploitation affiche généralement le message lorsque le client entre dans la zone configurée, peut le retirer lorsqu’il en sort, et peut l’afficher à nouveau lors de la prochaine entrée. Voir le [Afficher une carte sur l’écran de verrouillage](https://developer.apple.com/documentation/walletpasses/showing-a-pass-on-the-lock-screen).

### 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é.

Pour un message déclenché par le serveur, utilisez plutôt les notifications Wallet standard. Commencez par [Notifications push](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/automatisation/push-notifications.md) et la recette [Envoyer une notification ponctuelle](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/automatisation.md#send-a-one-off-notification).

## Prérequis

Les emplacements doivent être configurés dans The Wallet Crew. Chaque magasin a besoin d’une latitude et d’une longitude. L’adresse est affichée au détenteur mais n’est pas utilisée pour placer le magasin.

Les lieux sont également modélisés comme des magasins. Exemple : créez une entrée de magasin pour `Stadium - Gate A` ou `Concert hall - Main entrance`.

Les emplacements sont gérés dans **Données et intégrations → Magasins de données**. Lorsque les magasins ne sont pas encore configurés, commencez par [Magasins](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/platform/data-and-integrations/stores.md).

<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-5de7f35f8ce0d6450d60f7fcb594e5a0151f5660%2Fdata-stores-form-retake.png?alt=media" alt="New store form in Data &#x26; integrations → Data stores, with the address and the coordinates"><figcaption><p>Chaque magasin possède ses propres coordonnées (magasins ou lieux).</p></figcaption></figure></div>

## Configurez le message dans The Wallet Crew

Configurez le message pour un modèle de carte. Utilisez Liquid pour la personnalisation.

{% stepper %}
{% step %}

### Ouvrir les messages géorestreints

Ouvrir **Engagement → Messages géorestreints** et choisissez le modèle de carte.
{% endstep %}

{% step %}

### Rédiger le message

Rédigez le message dans **Contenu (multilingue)**. Ajoutez des variables Liquid si nécessaire. Restez concis : visez 120 caractères ou moins, comme l’indique le **Longueur recommandée** compteur. Un texte plus long est autorisé.

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-c779c1d24b438908a0068c3a3cd4387034f77ab0%2Fgeofenced-messages-editor-clean.png?alt=media" alt="Geofenced messages editor with the language tabs, the message field and the notification preview"><figcaption><p>L’éditeur de message géorestreint d’un modèle de carte, avec l’aperçu de la notification.</p></figcaption></figure>
{% endstep %}

{% step %}

### Configurer les traductions (facultatif)

Lorsque le modèle est traduit, sélectionnez chaque langue dans le sélecteur de langue au-dessus du champ et rédigez le message correspondant.
{% endstep %}

{% step %}

### Enregistrer et tester

Cliquez sur **Enregistrer**. L’enregistrement met à jour le modèle de carte et pousse une mise à jour vers chaque carte de ce modèle.

Testez ensuite avec un appareil proche d’un emplacement configuré. Validez à la fois le comportement de localisation et le rendu Liquid.
{% endstep %}
{% endstepper %}

## Comment The Wallet Crew sélectionne les emplacements par 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 de « magasin principal ». Les billets d’événement s’appuient généralement sur l’emplacement du lieu assigné à la carte.

Pour une configuration de type commerce de détail, la carte obtient les **10 magasins les plus proches du détenteur**:

* Lorsque le pays et le code postal du détenteur sont connus, les magasins les plus proches de ce code postal.
* Sinon, les magasins les plus proches du propre magasin du détenteur (le magasin principal), qui vient alors en premier.

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

Lorsqu’une mise à jour de carte est effectuée via The Wallet Crew, la liste des magasins les plus proches est recalculée lorsque le magasin, le pays ou le code postal du détenteur change. Des magasins ajoutés plus tard peuvent devenir l’un des magasins les plus proches.

## Emplacements dans l’éditeur de modèle

L' **Apple** onglet (**Emplacements** et **Balises**) et le **Google** onglet (**Emplacements**) de l’éditeur de modèle de carte contiennent aussi des emplacements : un libellé, une latitude et une longitude, et sur Apple une altitude et un **Distance maximale**. Voir [Emplacements et balises](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/apple-tab.md#locations-and-beacons) et le [onglet Google](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/google-tab.md).

Les emplacements saisis manuellement dans le modèle (une latitude fixe) sont conservés lorsque vous enregistrez un message géorestreint. Les emplacements des magasins remplissent les emplacements restants, jusqu’à 10 au total.

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

Utilisez Liquid pour personnaliser le message ou ne l’afficher qu’aux clients pertinents. Les données de magasin sur la carte ont ces champs :

* `data.store.*`: le magasin à proximité du client. L’enregistrement du message pointe chaque `{{data.store.…}}` sortie vers le magasin correspondant à son propre emplacement. Une `data.store` référence à l’intérieur d’une condition Liquid n’est pas réaffectée et lit toujours le magasin le plus proche.
* `data.associatedStore.*`: le propre magasin du détenteur.

Les deux contiennent `storeId`, `displayName`, `address`, `latitude`, `longitude`, et `altitude` lorsqu’elle est définie.

{% code title="Exemple 1 — nommer le magasin" %}

```liquid
Bienvenue chez {{data.store.displayName}}. N’oubliez pas de scanner votre carte de fidélité au moment du paiement.
```

{% endcode %}

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

```liquid
{%- if data.associatedStore.storeId == "STORE-A" -%}
Votre magasin a déménagé. Rendez-vous à notre nouvelle adresse à 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é, ou qui se trouve à l’intérieur du magasin ?</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, et 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 téléphone ?</strong></summary>

Commencez par les réglages du téléphone listés en haut de cette page.

Puis validez les données de la carte. La carte doit inclure des coordonnées de localisation, et le client doit être suffisamment proche du rayon configuré.

</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 les coordonnées GPS.

Apple Wallet prend également en charge les déclencheurs de balises. 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/engage-and-animate/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.
