Geo-based push

Geozones are virtual markers on a map that trigger push notifications when a user enters a specified area. The range can be set between 50 and 1000 meters, with an adjustable cooldown period.

Geozones are particularly useful for marketing and sales teams at stores, restaurants, and other businesses looking to engage nearby users. For example, setting up a Geozone for your coffee shop ensures that users passing by receive notifications about special offers on croissants and coffee.

Note

If Geozones are not available in your account, please contact our support team for assistance.

Important

For Google Play apps, approval is required for background location access. Refer to the Google Play policy and submit the permissions declaration before collecting users’ locations.

Integration

Developer assistance needed

You’ll need assistance from your development team for proper integration of Geozones push notifications into your application.

iOS

To implement Geozones into your iOS app, please use this guide.

Android

For Android, follow this guide.

Note

Currently, geo-based messaging is not available for HMS (Huawei Mobile Services) devices as it’s built upon Google location services.

Setting up Geozones

Create a Geozone

To create a Geozone:

1. In the Pushwoosh Control Panel, navigate to Channels → Geo-based Push.
2. View existing Geozones or click Add Geozone to create a new one.

Configure a Geozone

1. Name the Geozone and enter the notification text.
2. Set the location by dropping a pin, entering an address, or specifying latitude and longitude.
3. (Optional) Define the range in meters (up to 1000m) and the cooldown period.

Cooldown Period is the silent period after sending a notification. If multiple locations exist in a neighborhood, users receive notifications when passing by each one, but no additional notifications will be sent during the cooldown time.

Geozone clusters

Combining multiple Geozones into a cluster applies a shared cooldown period to all Geozones in that cluster. If a user receives a notification from one Geozone, they won’t receive notifications from others in the cluster until the cooldown period expires.

Geozone timetable

Use the Geozone Timetable to schedule when your zones are active or disabled.

Message inbox

1. To store Geozone messages in users’ Inbox, check the Save to Inbox checkbox.

2. Set the retention period for messages in the inbox by adjusting the Days to leave field.

Note

The maximum period for keeping messages in the Inbox is 14 days.

3. To display a custom icon next to the Geozone message in the Inbox, enter the image URL in the Inbox icon field.

4. Click Save Geozone