Dynamic Placeholders for Android Applications – Esper Help

A managed configuration allows users to apply additional settings to supported Android applications. In addition, users can apply dynamic placeholders, also known as custom attributes or key value pairs, to expose specific device information. For example, these configurations can be used to identify devices out in the field with their console counterparts and to link devices with certain locations via their unique identifiers.

Work with your app developer to surface dynamic placeholder values in the app experience.

Dynamic placeholders are also available for iOS applications.

In this article:

Supported Dynamic Placeholders
Example Usage
Applying a Managed Configuration

Requirements:

Android Esper Agent v8.00.0764+

Supported Dynamic Placeholders

The following dynamic placeholders are supported on Android devices. You may need to discuss with your app developer about the values supported by your application.

Placeholder	Description	Example Value
${esper.deviceName}	Esper Device name	ESP-ID-AAAAW
${esper.serialNumber}	Device serial number	SN123456789
${esper.uuid}	Unique Device Identifier	811a2d27-13fd-4358-8dc3-aed049e73ce7
${esper.imei1}	IMEI 1	453551143250391
${esper.imei2}	IMEI 2	534201965378051
${esper.macAddress}	Device’s mac address	00:1A:2B:3C:4D:5E

Example Usage

The input configuration is a managed config.

Example Input

{
  "device_name": "${esper.deviceName}",
  "device_details": {
    "serial": "${esper.serialNumber}",
    "imei": "${esper.imei1}",
    "mac": "${esper.macAddress}"
  }
}

Example Output

{
  "device_name": "ESP-ID-AAAAW",
  "device_details": {
    "serial": "SN123456789",
    "imei": "453551143250391",
    "mac": "00:1A:2B:3C:4D:5E"
  }
}

Applying a Managed Configuration

Blueprint

In a blueprint, go to the Apps & Configuration section and click on the Android tab. In Manage Applications, add a new application or identify an existing one that supports managed configurations. Then click on the ellipsis button next to the application and select Managed Configuration.

The actions ellipsis(...) selected in a bluperint under the apps section. Managed configurations is highlighted.

Then paste the configuration in the input box.

The manage application menu with dynamic placeholders such as device name, serial number, and imei1.

Click on Apply Changes. Then save and publish the blueprint.

When you converge a device to that blueprint, the managed configuration will be applied to the application currently on the device or will be installed with the application.

Individual Device Action

To apply dynamic placeholders to a single device, Click on the device in Devices & Groups and go to its Apps section. Locate the application and click on Manage to apply the dynamic placeholder values.

In an individual device's app section with manage highlighted next to an app.

Then press Apply Changes.

manage andi's coffee configurations with dynamic placeholders such as device name, serial, imei, and mac address

You can check the device’s details from the managed configuration section as well.

managed configurations with the actual values of mac, imei, device name, and serial

Remember to converge the device to update these values. Use dynamic placeholders with managed configurations to unlock further customization for your Android fleet.

Learn more about Managed Applications Configurations from Android Developer Documentation.