Ignite Services allows you to determine whether an app present on a device is the latest version available in the Ignite app repository. If the app is not the latest version, you can then offer the user an opportunity to update the app.

To use the App Update feature, ensure that you have met the following requirements:

• You have implemented SingleTap, the Ignite feature that provides seamless, one-tap installation of apps from any type of ad unit (ad banner, button, hyperlink, etc.) with a call-to-action. If you have not implemented SingleTap, please contact your DT representative.
• You must use a SingleTap link (containing updateApp=true) presented as a call-to-action in your Update Experience UI.

App Update process

To ensure that you can update apps, confirm that your SingleTap link contains updateApp=true.

To update apps:

1. Determine if the app on the device is the latest version available in the Ignite repository. Query the Ignite server using the packageName and versionCode of the app on the device. The Ignite server responds with a True or False boolean flag.

   Note

   • If the versionCode you passed is greater than or equal to the versionCode in Ignite repository, Ignite returns a boolean flag of TRUE. This means the versionCode of the app present on the device is the same or greater than the version in the Ignite repository, and an update from Ignite is not needed.
   • If the versionCode you passed is less than the versionCode in the Ignite repository, Ignite returns a boolean flag of FALSE. This means that the versionCode of the app present on the device is less than the version in the Ignite repository, and the should be updated. Continue to Step 2.
2. If you receive a FALSE response from your version query, present your Update experience UI to the user, and place the SingleTap link (containing updateApp=true) as a call-to-action.

Query Ignite for latest version

To determine if an app present on a device is the latest version available in the Ignite repository, call the Ignite https endpoint, and pass the packageName and versionCode of the app as query parameters. For example, the following query could be sent to determine if version code 12266010 of “FunGame” by XYZ is the latest available from the Ignite repository:

https://apk-fetch-api.digitalturbine.com/v1/apk/latest_version?packageName=com.XYZ.FunGame&versionCode=12260010

Ignite Response

Successful queries should return a 200 OK response from the Ignite server along with relevant version information. For example, if version code 1226610 of “FunGame” is the latest available from the Ignite repository, you would receive the following response:

{
  "version": 12266010,
  "latest_version": true
}

Demo App

The attached file contains a demo app that shows how you can implement the App Updates feature.