Skip to main content

Segment integration

Bluedot is a location platform that provides an accurate and simple geofencing platform for apps. After integrating the Bluedot SDK and setting geofences, customer’s can create personalised location-based experiences for their users.

Segment provides the customer data infrastructure that helps businesses put their customers first. Using Segment, companies can collect, unify and connect their first-party data to over 200 marketing, analytics and data warehouse tools.

With this integration, Bluedot’s first-party, accurate, and privacy-compliant location data can be connected and utilised across all of the platforms and apps supported by Segment.

Integration Overview

Before beginning the integration, please ensure you have an active customer account with Bluedot & Segment.

1. Decide on the custom data you’ll be passing from the Bluedot Events to Segment:

a. Custom Event Metadata (max. 20)
b. Custom Zone Data (max. 20)

2. Integrate the Bluedot SDK within your mobile app:

a. Android integration guide
b. iOS integration guide

3. Add a Bluedot source to your Segment workspace from the Sources Catalog.

4. Add your Segment writeKey via the Integrations > Segment section in Canvas.

Send events to Segment

To send events to Segment, you’ll need to include the Segment’s userId in the Custom Event Metadata of the Bluedot event. Make sure to name the property segment_userId.
An example will be:

"segment_userId": "<YOUR SEGMENT USER ID>"

For more details, check the Bluedot source documentation in Segment


The Custom Event Metadata is not persisted across SDK sessions. If the SDK is logged out the custom event metadata is cleared by the SDK. We suggest setting the custom data every time the SDK is authenticated in the app.


The table below lists events that Bluedot sends to Segment. These events appear as tables in Segment’s warehouse and as regular events in other Segment’s Destinations.

Entry GeofenceDevice breaches a geofence.
Exit GeofenceDevice exits a geofence
Tempo ETA UpdateTempo ETA update
Tempo StopTempo stops tracking ETA
Order RegisteredWave register order
Customer On The Way (Web)Wave event type onTheWay
Customer Arrived (Web)Wave event type arrival
Custom Web Event: { event type }Wave custom event types. (for example, eventType: "pickedComplete").

If you have any technical issues or questions, please reach us at