Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

Envoyez des messages aux utilisateurs en fonction de l’endroit où ils se trouvent. OneSignal peut segmenter les utilisateurs par pays, coordonnées GPS ou balises personnalisées pour créer une sensibilisation opportune et pertinente basée sur l’emplacement physique. Au fur et à mesure que les utilisateurs interagissent avec votre application et que le suivi de localisation est activé, leurs coordonnées sont mises à jour périodiquement (environ toutes les 5 minutes pendant l’utilisation de l’application) et peuvent être utilisées pour envoyer des messages via Journeys ou n’importe quel outil de création de messages.
OneSignal ne suit pas la localisation GPS par défaut. Le SDK ne collecte la latitude et la longitude que lorsque les trois conditions suivantes sont remplies :
  1. Votre application dispose des autorisations et dépendances de localisation correctes.
  2. Votre application active explicitement le partage avec OneSignal. Sans cela, votre application peut collecter des données de localisation mais ne les partagera pas avec OneSignal.
  3. L’utilisateur accorde la permission de localisation à l’invite système.
Consultez la Configuration du suivi de localisation pour la configuration. Pour le contexte sur le comportement de localisation du SDK, consultez You’re in Control: How Location Actually Works in OneSignal’s SDK.

​
Cibler par pays

Le pays est déterminé par l’adresse IP de l’appareil et se met à jour automatiquement chaque fois que l’utilisateur ouvre votre application. La valeur utilise le code pays à deux lettres ISO 3166-1 Alpha-2 (par exemple, US, GB, CA). Ciblez par pays en utilisant le champ country dans Segments ou dans le paramètre filters de l’API Créer un segment : 
"filters": [
  { "field": "country", "relation": "=", "value": "US" }
]

​
Cibler par localisation (latitude, longitude et rayon)

Si votre application mobile collecte la localisation GPS et la partage avec OneSignal, le SDK met à jour les coordonnées de l’utilisateur environ toutes les 5 minutes (selon les autorisations et les règles du système). Si l’application est arrêtée de force, la localisation ne peut pas être suivie jusqu’à ce que l’utilisateur la rouvre.

​
Configuration du suivi de localisation

Le suivi de localisation est configuré dans le code de votre application mobile, pas dans le Dashboard OneSignal. Au minimum, votre application doit :
  • Ajouter les autorisations de localisation natives et les dépendances pour iOS et Android.
  • Activer l’indicateur Location.isShared pour partager les coordonnées avec OneSignal.
  • Demander la permission de localisation système, ou utiliser un message in-app comme soft pre-prompt pour de meilleurs taux d’opt-in.

Référence localisation Mobile SDK

Configuration complète et code par plateforme pour iOS, Android, React Native, Flutter, Unity et Cordova/Ionic.
Une fois le suivi de localisation activé, vous pouvez créer des segments ou envoyer des messages via notre API en utilisant le filtre location.
OneSignal segment builder showing the location radius filter with latitude, longitude, and radius fields

​
Suivi de latitude et longitude pour le push web

OneSignal ne collecte pas la latitude/longitude pour le web. Cependant, vous pouvez utiliser des balises pour définir la localisation depuis votre application web ou utiliser l’API Update User pour définir la localisation depuis votre serveur. Exemple de balisage :
  1. Demandez l’accès à la localisation dans votre application web en utilisant l’API Geolocation du navigateur.
  2. Utilisez JavaScript pour détecter les coordonnées de l’utilisateur.
  3. Envoyez ces coordonnées à OneSignal en utilisant des balises.
OneSignal.User.addTags({
  lat: "37.160",
  long: "-117.773"
});
Une fois les balises définies, créez un segment géorepéré en combinant des filtres de plage de balises. Par exemple, pour cibler les utilisateurs dans la zone 37° ≤ lat < 38° et -118° ≤ long < -117°, ajoutez ces quatre filtres dans le constructeur de segments :
  • Balise lat supérieure à 37
  • Balise lat inférieure à 38
  • Balise long supérieure à -118
  • Balise long inférieure à -117

​
Cibler par ville ou localisation personnalisée

OneSignal ne détecte pas nativement la ville ou les codes de zone. Pour cibler par ville ou localisation personnalisée :
  • Laissez les utilisateurs saisir une ville ou une région dans un formulaire.
  • Ou utilisez JavaScript avec le géocodage inverse (par exemple, API Google Maps) pour déduire la ville des coordonnées.
  • Envoyez le nom de la ville comme balise de données.
OneSignal.User.addTag("city", "San Francisco");

​
FAQ

​
Le suivi de localisation fonctionne-t-il sur le web ?

Pas nativement. Le Web SDK de OneSignal ne collecte pas de coordonnées GPS. Pour utiliser des segments basés sur la localisation avec le push web, collectez vous-même les coordonnées depuis l’API Geolocation du navigateur et envoyez-les à OneSignal comme balises, puis créez des segments avec des filtres de plage sur ces balises. Voir Suivi de latitude et longitude pour le push web.

​
Pourquoi mon application ne suit-elle pas la localisation ?

Vérifiez que les trois conditions de configuration sont remplies : votre application dispose des autorisations de localisation et dépendances correctes installées, Location.isShared est défini à true, et l’utilisateur a accordé la permission de localisation à l’invite système. Consultez la référence localisation Mobile SDK pour la configuration spécifique à la plateforme et les corrections courantes, y compris la dépendance Android play-services-location.

​
À quelle fréquence le SDK met-il à jour la localisation ?

Lorsque le suivi de localisation est activé, le SDK met à jour les coordonnées environ toutes les 5 minutes pendant l’utilisation de l’application. Si l’application est arrêtée de force, les mises à jour de localisation sont suspendues jusqu’à ce que l’utilisateur rouvre l’application.

​
Puis-je cibler des utilisateurs par ville ?

Pas nativement. OneSignal suit le pays (via l’adresse IP) et les coordonnées GPS (via le SDK), mais pas la ville ou le code de zone. Vous pouvez déduire la ville des coordonnées en utilisant un service de géocodage inverse et la stocker comme balise. Voir Cibler par ville ou localisation personnalisée.

​
Pages connexes

Invite d'opt-in de localisation

Utilisez un message in-app comme soft pre-prompt avant de demander la permission de localisation native.

Segments

Créez des segments d’audience en utilisant des filtres de localisation, des balises et des propriétés utilisateur.