NOMi 2617 Bluetooth Beacon User Manual Nomi iOS SDK pages
NOMi Corporation Bluetooth Beacon Nomi iOS SDK pages
NOMi >
Users Manual
SDK for iOS Overview Version 1.2 NOMi Mobile SDK for iOS Microlocation Marketing For The Enterprise BRING YOUR STORE TO LIFE ECommerce vendors continue to steal market share from brick-andmortar businesses by offering lower prices and convenient shipping. To remain competitive, offline retailers need to provide a more compelling shopping experience that stimulates each of the five senses. NOMi Mobile enhances the in store experience by allowing loyal customers to unlock rewards, product reviews and services in real time as they browse your aisles. To access proximity aware in-app messaging, retailers deploy Nomi’s Bluetooth LE beacons and integrate the company’s SDK into its mobile app. COMPETE ON CUSTOMER EXPERIENCE The NOMi SDK for iOS makes it easy for native iOS developers to collect location-based engagement data and interact with customers through SDK for iOS Overview Version 1.2 their mobile applications. NOMi partners can then leverage the NOMi Dashboard to: • Overlay application adoption and usage with other in-store metrics like the number of visits, visit duration and frequency. • Engage customers in-store using personalized, context-based notifications. NOMI DELIVERS A SOLUTION, NOT A FEATURE Nomi’s robust Location Platform offers interior analytics and proximity marketing in a single solution. Only NOMi provides the ability to analyze and optimize customers’ complete path to purchase. By integrating clients’ existing CRM, BI, and POS systems, NOMi provides a single, comprehensive view of the customer across all channels. ENTERPRISE-GRADE INFRASTRUCTURE Nomi’s team has spent the past decade building world class enterprise software at Salesforce.com and Buddy Media. Only NOMi offers secure, enterprise-grade beacon management tools that automatically alert you when sensors go down or battery life nears depletion. INFLUENCE DON’T ANALYZE Nomi’s real-time proximity aware messages offer the opportunity to influence purchase decisions before checkout. Traditional loyalty programs wait until a customer transacts out to offer incentives. By then, it’s often too late to upsell or cross-sell a customer. SDK for iOS Overview Version 1.2 FEATURES Messaging Management Proximity Marketing Geo-fencing Enrich the in store experience for your most loyal customers with inapp marketing triggered by proximity to products on the shelves. Nomi’s flexible geo-fencing allows you to define the radius of in-app messaging by inches, feet, or dozens of feet depending on the goal of your campaign. Real Time Interactivity Tap To Trigger Functionality Nomi’s unique design eliminates any delay in proximity based promotions. That means you reach customers with the right message at the right time, every time. Allow customers with your mobile application to unlock additional rewards by tapping their device to in store kiosks- register for sweepstakes or view product reviews. Rules Engine Easy Installation Nomi’s rules engine puts you in control of your proximity based promotions. You define who receives what message. NOMi designed the market’s smallest beacons to facilitate hassle free deployment. Place a beacon in POP signage, product display or at the cash wrap to offer enhanced in-app interactions. In-App Convenience Unified Reporting Reward customers who have downloaded your mobile app with additional in-app services such as reserving a fitting room or preorder for in-store pick up. NOMi reports the results of all your marketing campaigns, including proximity based promotions, in a single dashboard. Easily assess the performance of your overall marketing strategy in a single summary. SDK for iOS Overview Version 1.2 TABLE OF CONTENTS HOW IT WORKS! 5! INSTALLATION! 6! REGISTERING FOR EVENTS! 7! CLASS REFERENCE! 9! RULES & NOTIFICATIONS ! 10! TECHNICAL SPECIFICATIONS! 10! SUPPORT! 11 SDK for iOS Overview Version 1.2 HOW IT WORKS NOMi SDK Bluetooth Low Energy Beacons Cloud-based Dashboard The NOMi SDK for iOS is integrated to a branded apps and sends lightweight, secure (HTTPS) events to the NOMi Cloud for processing. When a mobile device with a mobile app powered by the NOMi SDK interacts with a beacon, the NOMi SDK for iOS may initiate context-based push notification. Store managers and stakeholders then securely access reports through a standard web browser with app usage overlays. BLUETOOTH LE HARDWARE You may want to turn beacons on and off to simulate enter and exit events during your tests. To turn on: Remove pull tab (highlighted) from beacon. Save pull tab to disable beacon in the future. To turn off: Re-insert pull tab to same slot until A fully in. Note: In order to conserve battery life, beacons are shipped in “off” mode and require activation upon receipt. There is a delay between start and enter events happening in the application (up to 10 minutes) - this is a result of IOS interactions SDK for iOS Overview Version 1.2 INSTALLATION Installing the NOMi Beacon SDK for iOS is easy and simple. After it has been configured in your application, the dashboard statistics will include an overlay of app usage. To get the NOMi SDK for iOS up and running an iOS application, follow these two simple steps: 1. Add NOMi headers and libraries to your project Download the NOMi Beacon SDK Framework (NomiBeaconSDK.Framework) for iOS, add it to your project directory, and add it to your application target’s linked libraries. The NOMi Beacon SDK for iOS uses the CoreLocation and CoreData frameworks, so you will need to add the following to your application target’s linked libraries: CoreLocation.framework CoreData.framework 2. Initialize the NOMi engine To initialize the engine, import the NomiBeaconSDK.h header, implement the NomiBeaconManagerDelegate protocol, and initialize the NomiBeaconManager with your delegate and NOMi App ID: #import@interface ViewController () @end … - (void)viewDidLoad { [super viewDidLoad]; // Initialize Nomi SDK NomiBeaconManager *beaconManager = [NomiBeaconManager sharedInstance]; [beaconManager setDelegate:self]; // Use the App ID supplied to you by Nomi for this application [beaconManager startBeaconMonitoringWithAppID:@" " authKey:@" "]; SDK for iOS Overview Version 1.2 // Recommended: You can submit user-specific data from your app to // Nomi to have more granular queries on your tracked data // Any data can be submitted but suggested // * user_id (email, or other unique user identifier) // * name // * dob (date of birth) // * gender NSDictionary *userInfo = @{ @"user_id" : @“nomi@suburban.com”, @"name": @"Nomi", @"dob": @"10/22/13", @"gender": @"male" }; [beaconManager submitUserInfo:userInfo]; REGISTERING FOR EVENTS To get the most of the NOMi Beacon SDK, you’ll want to take advantage of the callbacks provided by the NomiBeaconManagerDelegate. Simply adopt the NomiBeaconManagerDelegate protocol and implement any of the callbacks you are interested in receiving. Entering and Exiting a Location You will receive these callbacks when entering or exiting the range of Nomi’s beacon advertisements. These callbacks will fire even if the app is in the background or not running, causing the app to wake up and allowing for a short period of processing time. A common use might be to fire a local notification to say “Welcome” or “Farewell”. The exit callback also includes the amount of time spent within the region. Along with the message, comes data about the location as well as the user’s history with the location. #import @interface ViewController () @end SDK for iOS Overview Version 1.2 … #pragma mark - NomiBeaconManagerDelegate callbacks - (void)didEnterLocation:(NomiLocation*)location // Welcome user to a location with a notification UILocalNotification *notification = [[UILocalNotification alloc] init]; notification.alertBody = [NSString stringWithFormat:@"Welcome to %@!", location.name]; notification.soundName = UILocalNotificationDefaultSoundName; [[UIApplication sharedApplication] presentLocalNotificationNow:notification]; - (void)didExitLocation:(NomiLocation*)location afterTime:(NSTimeInterval)seconds // If this is the user’s first visit and she/he spent // more than five minutes at the location, say “Farewell” if (location.stats.visits.count == 1 && seconds > 300) UILocalNotification *notification = [[UILocalNotification alloc] init]; notification.alertBody = @"Farewell"; notification.soundName = UILocalNotificationDefaultSoundName; [[UIApplication sharedApplication] presentLocalNotificationNow:notification]; Ranging a Beacon You will receive the ranging callback under a couple conditions: 1. Your app is in the foreground and you are inside Nomi’s beacon region 2. The device is locked or your app is in the background and the device just entered a NOMi beacon region (will range for ~10 seconds) Ranging offers two valuable pieces of information provided by the NomiBeacon class: RSSI and proximity zones. The RSSI value is the signal strength between the device and the beacon. Proximity zones are defined as follows: • Unknown - iOS cannot determine where the device is in relation to the most recently ranged beacon (usually meaning the device is outside of range) SDK for iOS Overview Version 1.2 • Tap - The device is very close (within inches) to the beacon and can be used for tap interactions • Near - The device is within a few feet of the beacon • Far - The device is distant from the beacon but still within advertisement range Information about the user's current zone is available to you. Using this information, you can create an engaging experience for the app user. CLASS REFERENCE NomiLocationStats inherits from NSObject properties visits NSMutableArray NomiLocation inherits from NSObject properties name NSString address NSString stats NomiLocationStats NomiBeacon inherits from NSObject properties proximity BeaconProximity rssi NSInteger SDK for iOS Overview Version 1.2 RULES & NOTIFICATIONS Rules and notifications will be featured in a coming release due Q3 2014. TECHNICAL SPECIFICATIONS Dimensions 1.457 in. D x 0.551 in. H 37mm.Dx14mm.H Weight 16 g 0.564 oz (including standard battery) Range 100 feet 30 meters Broadcast Interval 1.5 seconds Battery Life 2 years Model: 2617 FCC ID: 2ADER-2617 IC: 11584A-2617 Pursuant to FCC 15.21 of the FCC rules, changes not expressly approved by NOMi Corporation, Inc might cause harmful interference and void the FCC authorization to operate this product. This product complies with FCC OET Bulletin 65 & Industry Canada’s RSS-102 radiation exposure limits set forth for an uncontrolled environment This device complies with Part 15 of the FCC Rules and Industry Canada license-exempt RSS standard(s). Operation is subject to the following two conditions: (1) This device may not cause harmful interference. and (2) this device must accept any interference received, including interference that may cause undesired operation. Cet appareil est conforme à des règlements d'Industrie Canada exempts de licence standard RSS (s). Son fonctionnement est soumis aux deux conditions suivantes: (1) Ce dispositif ne doit pas causer d'interférences nuisibles, et (2) cet appareil doit accepter toute interférence reçue, y compris les interférences pouvant entraîner un fonctionnement indésirable. SDK for iOS Overview Version 1.2 SUPPORT For more information, contact us at support@nomi.com
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.6 Linearized : Yes Encryption : Standard V4.4 (128-bit) User Access : Print, Extract, Print high-res XMP Toolkit : 3.1-702 Create Date : 2014:07:16 20:56:31Z Creator Tool : Pages Modify Date : 2015:02:12 10:15:32-06:00 Metadata Date : 2015:02:12 10:15:32-06:00 Producer : Mac OS X 10.9.4 Quartz PDFContext Format : application/pdf Title : Nomi iOS SDK.pages Document ID : uuid:1e3ca724-f29b-49ff-8f38-2f8955a96f94 Instance ID : uuid:650d6ebe-bd4f-488b-9f0a-db5a9fdd82ef Has XFA : No Page Count : 11 Creator : PagesEXIF Metadata provided by EXIF.tools