The mobileDevice item-descriptor tracks information about devices that connect to the system using the native application, .recording the unique device Id (for Apple, this is the vendorIndentifier), the APNS push token and information about the OS and mobile store app.

Repository

/atg/userprofiling/ProfileAdapterRepository

Table

crs_mobile_device

Name

Type

Required?

Description

uniqueId

String

Yes

The unique id of the device (for Apple, the vendorIndentifier).

pushToken

String

No

The APNS push token that has been allocated for this device.

profile

String

No

The optional id of the profile using the device if known.

os

enum

Yes

Either unknown, iOS, android, windows, or blackberry.

osVersion

String

Yes

The device's operating system version string.

app

enum

Yes

Either iua or asa.

appVersion

String

Yes

The app version string.

registeredOn

timestamp

Yes

The time the device was first seen by the system.

lastSeenOn

timestamp

Yes

The time the device was last seen by the system.

Components

/atg/commerce/locations/BeaconManager

The BeaconManager is the main business component that contains iBeacon-related business logic. It exposes methods to query iBeacons by UUID/major/minor, by repository id and methods which notify the server when a beacon range is entered or exited, a store entered or exited, if the shopper has requested or cancelled help and also updates the current state of beacon ranging on the client.

/atg/commerce/locations/BeaconMessageSource

The BeaconMessageSource component creates and sends Dynamo Messaging System events.

/atg/commerce/device/DeviceManager

The DeviceManager component manages the device repository. It contains business methods to tracking devices that are using the app, stores the push token for iBeacon alerts to be sent via push notification, associates a user profile with a device when the user logs in and to track the first and most recent times a device used the app.

Webservices

The REST API exposes the methods of the DeviceManager and BeaconMessageSource components. The BeaconManager actors and the DeviceManager actors are shown in the tables that follow..

/atg/commerce/locations/beaconManagerActor.xml

Many of the BeaconManager methods take a common set of parameters described in the following table:

Parameter

Description

deviceUID:String

The device’s unique identifier. This is the vendor identifier of the iOS device and is used to track the device as the user moves around the store. The deviceUID is always required.

UUID:String

This is the UUID for the iBeacon device. The UUID is always required.

major:String

This is the major value broadcast by the iBeacon which is typically used to segment a company’s iBeacons by store. Optional.

minor:String

This is the minor value broadcast by the iBeacon which is typically used to segment a store’s iBeacons into departments. Optional.


Copyright © 1997, 2018 Oracle and/or its affiliates. All rights reserved. Legal Notices