# Notifications géolocalisées

Les notifications géolocalisées affichent un message contextuel à proximité d’un lieu. Apple Wallet ou Google Wallet peut l’afficher lorsque un client se trouve à proximité. Utilisez-les pour des rappels (« n’oubliez pas votre Carte ») et des informations sur site (« porte changée »).

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FMiLr7PXaIn4oLiwNm781%2Fimage.png?alt=media&#x26;token=5b78349a-18e8-4e7e-8ccd-9620290d4e65" alt=""><figcaption></figcaption></figure>

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

<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 seulement 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/portail lorsqu’ils approchent du lieu.
* Affichez un message « votre billet est prêt » à proximité 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 de Google Wallet dans votre appareil **Paramètres** (la localisation doit être autorisée).
{% endhint %}

## Comment cela fonctionne

Les Pass de 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 le pass et son message.

The Wallet Crew configure ces emplacements sur le pass en fonction de votre jeu de données d’emplacements. 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 verront les clients (varie selon la plateforme)

{% tabs %}
{% tab title="Apple Wallet (iOS)" %}
iOS peut afficher une suggestion sur l’écran de verrouillage lorsque le client est proche d’un des emplacements configurés. La suggestion peut inclure le message que vous avez configuré.
{% endtab %}

{% tab title="Google Wallet (Android)" %}
Android peut afficher une expérience « pass à proximité » lorsque le client est proche d’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 dans votre conception

Ces limites de plateforme s’appliquent :

* Jusqu’à **10 coordonnées GPS** par pass.
* 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 la proximité.

Si vous avez besoin d’un message déclenché par le serveur, utilisez plutôt les notifications Wallet standard. Commencez par [Notifications push](https://docs.thewalletcrew.io/fr/engager-et-animer/push-notification).

## Prérequis

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

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

Si vous n’avez pas encore configuré d’emplacements, commencez par [Magasins](https://docs.thewalletcrew.io/fr/inscription/enrolment-form/stores).

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-a9d0ebfebdfac9a3abc4f5b263071d9f1ec3cba6%2Fgeolocated_notifications_1.png?alt=media" alt="The Wallet Crew back office showing store and address configuration"><figcaption><p>Les adresses sont utilisées pour calculer des 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 pass. Utilisez Liquid si vous avez besoin de personnalisation.

{% stepper %}
{% step %}

#### Ouvrez les paramètres de notification sur un modèle

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

{% step %}

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

Ouvrez la **Notification géo** onglet. Rédigez votre message. Ajoutez des variables Liquid si nécessaire.

Gardez-le court. Visez **≤ 140 caractères** pour éviter la troncature.
{% endstep %}

{% step %}

#### Configurez les traductions (optionnel)

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

{% step %}

#### Enregistrez et testez

Cliquez **Envoyer la notification** pour enregistrer. Puis testez avec un appareil proche 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://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-8f13190d544134531d045b124aa0372a2c895d49%2Fgeolocated_notifications_2.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 The Wallet Crew sélectionne les emplacements par client

La logique de sélection d’emplacement dépend de votre cas d’usage. Les programmes de fidélité reposent généralement sur la logique de « magasin domicile ». Les billets d’événement reposent généralement sur l’emplacement du lieu que vous attribuez au pass.

Pour une configuration de type retail, les notifications géolocalisées sont couramment calculées pour :

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

Cela maintient le pass dans la limite de 10 emplacements tout en couvrant les lieux à proximité.

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

Lorsque vous effectuez une mise à jour de pass via The Wallet Crew, les coordonnées d’emplacement peuvent être recalculées :

* Si le magasin domicile 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.
* Si vous ajoutez de nouveaux magasins (avec une adresse), ils peuvent devenir éligibles en tant qu’« emplacements les plus proches ».

Cela permet de maintenir les déclencheurs de localisation en accord avec vos dernières données d’emplacement.

## 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 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 est à 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éo n’a-t-elle pas apparu 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 du pass. Le pass doit inclure des coordonnées d’emplacement. Le client doit être suffisamment proche du rayon configuré.

</details>

<details>

<summary><strong>Pourquoi la notification géo n’a-t-elle pas apparu sur Android (Google Wallet) ?</strong></summary>

Commencez par les réglages Android. L’utilisateur 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 du pass. Le pass 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 en sort. Il peut réapparaître la fois suivante où il y entre.

Référence d’Apple : [Afficher un pass 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 emplacements sont-ils sélectionnés pour un client ?</strong></summary>

Chaque client a un magasin domicile. The Wallet Crew sélectionne les 9 emplacements les plus proches de ce magasin domicile, pour un total de 10.

</details>

<details>

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

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

Apple Wallet prend également en charge les déclencheurs par beacon. Si vous prévoyez de les utiliser, confirmez d’abord vos appareils cibles et les contraintes matérielles en magasin.

</details>