iBeacon tracking

iBeacon tracking allows you to measure and target micro locations using iBeacon and Low Energy Bluetooth.

The following beacon data is sent to Analytics and Target when trackBeacon is called:

  • a.beacon.uuid - ProximityUUID of the beacon
  • a.beacon.major - Major number of the beacon (such as store number)
  • a.beacon.minor - Minor number of the beacon (such as a unique number within a store)
  • a.beacon.prox - Number 0-3 representing how close the user is to the beacon. 0 unknown, 1 immediate, 2 near, 3 far.

This section contains the following information:

How to Track

Prerequisites: Add the library to your project and implement lifecycle.

  1. Import the library:
    #import "ADBMobile.h"
  2. when a device is within proximity of a beacon, call trackBeacon:
    [ADBMobile trackBeacon:beacon data:nil];
  3. When the user leaves the proximity of the beacon, clear the current beacon:
    [ADBMobile trackingClearCurrentBeacon];

Sending Additional Data

In addition to the timed action name, you can send additional context data with each track action call:

[ADBMobile trackBeacon:beacon data:@{@"myapp.ImageLiked" : imageName}];

Context data values must be mapped to custom variables in Adobe Mobile services:


Examples- (void)locationManager:(CLLocationManager *)manager didRangeBeacons:(NSArray *)beacons inRegion:(CLBeaconRegion *)region {

    if (beacons.count > 0) {
        CLBeacon *beacon = beacons[0];
        // Adobe - track when in range of a beacon
        [ADBMobile trackBeacon:beacon data:@{@"sampleContextData" : @"sampleContextDataVal"}];

// When the user leaves the proximity of the beacon, clear the current beacon
[ADBMobile trackingClearCurrentBeacon];

Parent topic: Location