Introduction

The Koupon Media Android SDK v1.0 contains the most up-to-date frameworks for integrating the Koupon Media platform into your own Android applications. The Koupon Media SDK includes Android libraries, developer documentation and a sample project to get you up and running quickly and easily.

Additionally, Koupon Media has partnered with Qualcomm for the purpose of leveraging the GimbalTM context-aware platform and its Location-based Services (LBS). This document includes instructions on augmenting the Koupon Media SDK with the Gimbal SDK so that you can enhance your applications with geo-fence monitoring, as well as content delivery triggered by geo-fence events and/or time proximity.

Prerequisites

Before you get started with the Koupon Media SDK, let’s confirm that your system is set up correctly. Ensure that you are…

Location-based services (enabled by the Gimbal SDK), which engage a user based on his or her location.

We recommended familiarizing yourself with the terms below, as you will see them used throughout the documentation.

Clients

“Clients” are approved organizations that have been provisioned with access to the Koupon Manager (based upon their contracted services options). Clients are provided with an Authkey and AuthSecret, which are used as credentials to make API requests.

Consumers

“Consumers” are the recipients of a Client’s offer. Apps developed using the Koupon Media SDK can register a consumer’s identity whenever they are launched.

Offer

The Koupon Media SDK interfaces with the Koupon Manager and supports offer lifecycle management across the following states:

Accessed – Offer is accessed and presented within a list.

Viewed – Offer details such as terms and conditions.

Presented – Redemption assets delivered to the consumer.

Geo-fence

A Geo-fence is a virtual fence around a physical location (latitude and longitude) that, in conjunction with a geo-fence enabled mobile application, communicates arrival, departure and dwell times from the app-defined locations. Please refer to the documentation that is included with the Gimbal SDK for additional information.

Beacon

Proximity beacons leverage the Bluetooth Low Energy (BLE) standard to derive a consumers’ location at a micro-level. When a consumer’s device is within physical proximity to the beacon and detects it, a mobile application can notify the consumer of location-relevant content, promotions and offers. Please refer to the documentation that is included with the Gimbal SDK for additional information.