Pre-install tracking

Much like ad campaigns, pre-installs are a good way to tap into new audiences. You can arrange with a device manufacturer or a retailer about the pre-installation of your app on their devices. MyTracker is here to help you gauge the effectiveness of that approach.

  • how many pre-installs resulted in the launch of your app;
  • what kind of audience the manufacturer brought in (age, activity, LTV, etc.);
  • how much money each pre-install and the manufacturer overall generated.

Pre-install tracking is available only for Android devices

How it works

MyTracker offers several methods for tracking pre-installs:

  • PAI (Google Play Auto Install) when apps are automatically loaded and installed from the cloud after users activate the devices.

    This method is available only for apps published on Google Play

    To track pre-installs, generate referrer with PAI parameters in the MyTracker interface and share it with a device manufacturer to insert it in the utm_campaign parameter. When a user launches your app for the first time, MyTracker queries the Google Play Install Referrer API and retrieves pre-install data.

  • System Properties when apps are installed on devices before they go on sale.

    To track pre-installs, generate key-value in the MyTracker interface and share it with a device manufacturer to insert it in the device’s system properties. When a user launches your app for the first time, MyTracker retrieves pre-install data.

  • System Properties (additional method) is an outdated method. A manufacturer places key-value in the special file and specifies the path to the file in the device's system properties.

Where to start

  1. Make sure MyTracker SDK has been integrated into your app.
  2. In MyTracker, add an ad campaign listing Pre-install as Campaign type and the device manufacturer as Partner.
  3. Add a separate tracking link to the campaign for every app to be pre-installed:
    • On the Tracking links tab, click Add.
    • Enter the link title (for MyTracker lists and reports) and select the Android app that you need to pre-install.
    • Click Add. MyTracker will generate parameters for pre-install tracking.
  4. Optionally, you can add additional parameters to get more information about the campaign with the pre-install event. For example, a factory name or a campaign launch time.
    • Click Add parameters.
    • In the opened window, enter the values for the parameters SubID. At the bottom of the window, you will see the resulting parameters you need to share with your partner.
  5. Be sure to copy the result, because the entered parameters will be deleted when you close the window

  6. Provide the manufacturer with obtained parameters. Depending on the tracking method you choose, follow the instruction below: PAI, System Properties, System Properties (additional method).

PAI

The Google Play Auto Install (PAI) method allows you to track the pre-install performed when a user activates a new device.

This method is available only for apps published on Google Play

  1. Provide the manufacturer with referrer obtained by the instructions above, for example:
  2. mt_link_id=abc123&mt_sub1=factory1&mt_campaign=summer2023
  3. Ensure that the manufacturer inserted referrer in the utm_campaign parameter.

When a user launches your app for the first time, MyTracker can query the Google Play Install Referrer API, retrieve referrer, and attribute the pre-install to your ad campaign and the manufacturer.

System Properties

The System Properties method allows you to track the pre-install performed before a device goes on sale.

  1. Make sure MyTracker SDK that supports pre-installs (v2.1.1 or higher) has been integrated into your app.
  2. Give the manufacturer key-value obtained by the instructions above.
  3. Maximum value length is 91 symbols.

  4. Ensure that the manufacturer placed the key name and value in system properties (build.prop) and granted all users the read permission (644). For example:
  5. adb root
    adb remount
    adb pull /system/build.prop
    echo ro.mtpi.00000000000000000000={"mtLinkId":"aaaaa0", "sub1":"factory1", "campaign":"summer2023"} >> build.prop
    adb push build.prop /system/build.prop
    adb shell chmod 644 /system/build.prop
    adb reboot

When a user launches your app for the first time, MyTracker can read key-value and attribute the pre-install to your ad campaign and the manufacturer.

Some device manufacturers run app in a background mode (without the user interface) to test the pre-install. This muddies the data on user launches for MyTracker.

For installs to be counted only on the first launch by the user, additional logic needs to be implemented in the app: if the app is launched for the first time, do not initialize the MyTracker SDK until the graphical interface is loaded.

System Properties (additional method)

You can use the System Properties (additional method) method if the main System Properties method is not suitable for you.

We recommend using the main System Properties method, because the additional method involves editing of a key-value file, what can cause errors and loss of keys.

  1. Make sure MyTracker SDK that supports pre-installs (v2.1.1 or higher) has been integrated into your app.
  2. Crete a special pre-install.mytracker file.
  3. Add key-value obtained by the instructions above to the pre-install.mytracker file.
  4. Share this file with the manufacturer for the further placement in devices.
  5. Ensure the manufacturer copied the file to the device and specified the file path in the system properties (build.prop) by using the ro.mytracker.preinstall.path key. If the file had already been copied, ensure the manufacturer enhanced it by adding a new line.

When a user launches your app for the first time, MyTracker reads the patch to the pre-install.mytracker file along with key-value and attribute the pre-install to your ad campaign and the manufacturer.

Pre-install reports

MyTracker retrieves pre-install data after a user launches your app.

To analyze pre-install campaigns, use Report builder. For example, Select from list → Dimensions → Traffic source → Campaign → Partner to compare data by different manufacturers.

For details, refer to the Reports section

Was this article helpful?