Identification Settings

Settings

JavaScript API Documentation

Common Questions


Unique iPad ID

The ability to identify a specific kiosk in the field can be helpful in a number of scenarios. Kiosk Pro allows you to set a Unique iPad ID to identify each device in your deployment.

Default: blank

We recommend using an ID set in lowercase without spaces or special characters as these can trigger an error in certain use cases. As an example, correctly-formatted identifiers would include ‘lobby’, ‘opera-house-houston’, ‘houston-4’, or simply a numeric identifier like ‘4’.

This identifier can be used:

to identify which device is accessing your content. The Unique iPad ID can be accessed through our JavaScript API, allowing you to customize your page or tag data based on that identifier. More on this here.

to identify which device is sending an email alert. For instance, say you have an iPad with a Unique iPad ID of 'lobby' and another iPad labeled 'second-floor'; if power is lost to one iPad, the email notification sent out will contain the Unique iPad ID, indicating which iPad is in trouble.

to apply specific settings to a device. The Unique iPad ID can be used in combination with our Remote Settings Control .xml file to apply specific settings to one or more devices. More on this here.

as a variable placeholder within certain Kiosk Pro’s settings (Plus & Enterprise only). The Unique iPad ID can be used as a variable by inserting ‘$UniqueiPadID$’ (capitalized and spaced as shown, without the single quotes). This allows you, for example, to easily customize a URL for Remote Settings Control or to mirror the Unique iPad ID as the Kiosk ID when using the remote management server. More on this here.

We highly recommend setting a Unique iPad ID when you set up your kiosks, regardless of whether you see an immediate need for it. While you can add a unique ID through a remote settings update, it is significantly simpler to manually set the ID when the kiosk is deployed.

The remote process triggers Kiosk Pro to check if the device has an ID set and if not, to set a randomly-generated ID and email you any identifying information it is able to collect about each device.


Group IDs

The Group ID settings allow you to more easily group kiosks as needed for remote identification and configuration by labeling each device with up to six shared identifiers.

Default: blank

When choosing Group IDs, we recommend setting the ID in lowercase without spaces or special characters as these can trigger an error in certain use cases. For example, if setting an identifier to group all kiosks located in Texas, correctly-formatted identifiers would include ‘texas’, ‘texas-locations’, or a numeric identifier like ‘28’.

These group identifiers can be used:

to identify which group is accessing your content. Group IDs can be accessed through our JavaScript API, allowing you to customize your page or tag data based on that identifier. More on this here.

to apply specific settings to a group of devices. Group IDs can be used in combination with our Remote Settings Control .xml file to apply specific settings to a group of devices, without the need to list devices individually. More on this here.

as a variable placeholder within certain Kiosk Pro’s settings. Each Group ID can be used as a variable by inserting ‘$GroupID#$’ (so ‘$GroupID1$’, ‘$GroupID2$’, etc., capitalized and spaced as shown, without the single quotes). This allows you, for example, to easily customize a URL for Remote Settings Control or to use a Group ID as the secondary identifier Unit ID when using the remote management server. More on this here.

We highly recommend setting a Unique iPad ID when you set up your kiosks, regardless of whether you see an immediate need for it. Once a Unique iPad ID is set, you can then use it later to add or modify Group IDs on specific devices through Remote Settings Control update as needed.

Still stuck? How can we help? How can we help?