This guide explains the steps required to start using Bluetooth low energy (BLE) beacons to provide proximity-based experiences for your users.
Obtain and configure beacons
To get beacons and set them up, take the following steps:
1. Get some beacons
Visit our partners to get Eddystone supported beacon hardware:
2. Configure your beacons
Before a beacon can be used, you must provision it to set the frame type, broadcast intervals and power levels. Currently you must use the software that was provided by your beacon manufacturer to do this.
With Eddystone-UID and Eddystone-EID, you can:
- Associate one or more data or URL attachments with a beacon.
- Remotely update beacon attachments.
- Monitor beacons using the Google Beacon Dashboard.
Eddystone-EID also lets you control who can access your beacons; only services that share an encryption key with an Eddystone-EID beacon can resolve message data from that beacon. For more information, see Eddystone Ephemeral Identifier.
Eddystone-URL lets you advertise a URL (HTTP or HTTPS), and is designed for interacting with the Physical Web. Nearby Notifications can also show HTTPS URLs broadcast from Eddystone-URL devices, although Eddystone-URL does not support app intent or app install URLs. We recommend using a URL redirector to enable the use of longer URLs, and to make it possible to update the URL after the beacon is deployed. When using this frame type, you cannot register the beacon with Google. Once you have provisioned the beacon, no further steps are required.
If you provisioned your beacons using Eddystone-UID or Eddystone-EID, continue to the next step. If you provisioned your beacons using Eddystone-URL, you're done!
3. Register your beacons with Google
To register the beacon:
- Launch the app and select the Google Developer project you want to use.
- Position your device near the beacon. You should see a list of beacons.
- Select the beacon you want to register, then tap Register Beacon. The beacon should then appear under the Registered tab.
4. Add an attachment
These are the options for associating attachments with beacons (choose one):
Use the Google Beacon Dashboard
The Google Beacon Dashboard is the easiest way to associate attachments with your beacons.
Follow these steps to add an attachment using the Google Beacon Dashboard:
- Go to the Google Beacon Dashboard.
- Select your project from the list of Google Developers Console projects.
- Select your beacon from the list.
- Enter details for your beacon in the provided form.
- Click View beacon details and select Nearby Notifications.
- Enter a Title and two-letter language code.
- Select either Production mode or Debug mode.
- Click Web URL and choose the type of URL to add (Web URL, App intent, or Free-form App Intent).
- Fill in the corresponding fields for the selected URL type.
- (Optional) Add targeting rules to limit visibility based on device context.
- Click Create to add the attachment.
Note that you can add multiple attachments to a beacon. For more information about how to format attachments and URLs for Nearby Notifications, see Attachment Data Format.
Use the Proximity Beacon API
You can also use the Proximity Beacon API to associate attachments with beacons. Note that this will require you to base64 encode your request body.
The Python sample scripts make adding attachments from the command line much easier.
You can also add attachments by hand by making a POST request to:
BEACON_NAME is a string of the form:
and the request body includes the namespaced type and base64 encoded data as shown in the following example:
If the request succeeds, you'll receive a
200 OK status code, and the
For more information about how to format attachments and URLs for Nearby Notifications, see Attachment Data Format.