AppsFlyer factory preinstall using manifest (Android)

Use SDK version V4.0+.

This method is recommended because it is the most robust of all; however, consider that for all subsequent app installs, the pre-install media source is always attributed. This is regardless of whether the install is new or a reinstall. 

The system properties method requires actions on both the developer and the manufacturer's side.

Developer

You need to provide the manufacturer or media source with the APK. The default APK is provided. This method doesn't require a separate APK.

Create a file called pre_install.appsflyer. In the file, add a key-value pair:

<package_name>=<media_source>

com.appsflyer.sampleapp=huawei

To specify additional pre-install parameters:

In the pre_install.appsflyer file, pass the additional parameters in JSON format. For example:

com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}

Once you have the pre_install.appsflyer file, give it to the media source or manufacturer together with the APK.

Manufacturer

The manufacturer places the pre_install.appsflyer in a file path of its choosing. The pre_install.appsflyer file permissions should be set to 744.

The manufacturer then edits the system properties file in order to point to the pre_install.appsflyer file. To do so, the manufacturer needs to add a key-value pair to system properties.

Adding a Key-Value Pair to Android System Properties:

adb shell su
setprop ro.appsflyer.preinstall.path /data/pre_install.appsflyer

An alternative method is to retrieve the system-properties-file from the android file system, edit it, and push it back:

adb root
adb remount
adb pull /system/build.prop
echo ro.appsflyer.preinstall.path=/data/pre_install.appsflyer >> build.prop
adb push build.prop /system/build.prop
adb shell chmod 744 /system/build.prop
adb reboot

Advantages

No need to maintain different APKs for each media source or manufacturer. No need to make changes and add paths to the app on Google Play. Manufacturers can use custom paths and there are no dependencies between multiple preinstalled apps running on different devices.

This method ensures attribution to preinstall campaigns and media sources. Even if a user updates the app before launching it or installs the app after clicking an ad, the preinstall is still attributed to the preinstall media source or manufacturer.

Disadvantages

Some responsibility is transferred over to the media source or manufacturer. The developers need to be sure that the manufacturer or media source takes the necessary steps. Moreover, this method might be a little harder for the app developer to test.

The SDK API method provides a native way to specify the manufacturer or media source name to which the pre-install is attributed.

To use this method, add the following method call in the AFApplication class before initializing the SDK:

setPreinstallAttribution(String mediaSource, String campaign, String siteId)

When working with a media source

AppsFlyerLib.getInstance().setPreinstallAttribution("MEDIA_SOURCE_NAME", "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

When working with a manufacturer

AppsFlyerLib.getInstance().setPreinstallAttribution(android.os.Build.MANUFACTURER, "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

Advantages

The SDK API method lets you retrieve the manufacturer name programmatically. No matter the manufacturer, the SDK method retrieves the name directly from the device. This means that you can maintain one APK for all manufacturers that you collaborate with.

The setPreinstallAttribution method allows you to specify the campaign name. You can separate each manufacturer or media source into different campaigns, rather than have all of them set under the "Pre-install" campaign.

Disadvantages

If you are working directly with manufacturers, you have to maintain two versions of your APK, one for manufacturers and another for Google play. In either case, more than one APK is required.

If you are working with several media sources that communicate with the manufacturer on your behalf, you need to maintain a separate APK for each media source.

In some cases, the install might not be attributed to the pre-install media source:

• A user with a new device updates the pre-installed app directly from Google Play without first launching it, the install is considered organic.
• A user with a new device updates the app from Google Play after clicking an ad, the install is attributed to the media source that serves the ad.

The name in the manifest method requires you to add a metadata tag to the app's manifest file. You need to repeat this step for every media source or manufacturer that you collaborate with.

Add a metadata tag before the closing application tag:

...
    <meta-data android:name="AF_PRE_INSTALL_NAME" android:value="market_name"/>
  </application>
</manifest>

When the app launches for the first time, the AppsFlyer SDK detects this metadata tag in the manifest file and attributes the install accordingly.

Advantages

The name in the manifest method is considered an easy method for attributing pre-install campaigns. There is only one tag to add to the manifest. In addition, the media source or manufacturer doesn't have to do anything on their end in order to enable campaign measuring.

Disadvantages

Since the metadata tag specifies the media source or manufacturer name, you need to maintain different sets of APKs, one for each media source or manufacturer.

In some cases, the install might not be attributed to the pre-install media source:

• A user with a new device updates the pre-installed app directly from Google Play without first launching it, the install is considered organic.
• A user with a new device installs the app from Google Play after clicking an ad, the install is attributed to the media source that serves the ad.

This method requires both the developer and the manufacturer to perform some actions on their end.

Developer

The pathway method allows you to specify a path to a file that holds the name of the media source or manufacturer. There are three steps that you need to complete:

1. Create a file that contains a key-value pair. The file should be called pre_install.appsflyer. In the file, specify the key-value pair in the format of <PACKAGE_NAME>=<MEDIA_SOURCE> For example, com.appsflyer.sampleapp=my_media_source.
   
   

   Passing additional pre-install parameters

   You can specify additional pre-install parameters in the file using JSON. For example, you can add the following key-value pair in the pre_install.appsflyer file:

   com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}
   

    Important!

   It's important to note the following behaviors when using this option:

   1. It sets "Pre-install" as af_channel
   2. If pid is not present in the JSON, the Media Source appears as "None".
   3. In the JSON configuration, if c is not present then the campaign name is set to "Pre-install"
   4. If the JSON is malformed, the passed string is treated as the Media Source name

   Once you have the pre_install.appsflyer file, give it to the media source or manufacturer together with the APK.

2. Talk to the media source or manufacturer and agree with them on a path where they put the file. The recommended path is "/data/local/tmp/pre_install.appsflyer".
3. Once a path is agreed upon, specify it in the manifest file. Place the following snippet before the closing application tag:
   

   <meta-data android:name="AF_PRE_INSTALL_PATH" 
         android:value="/data/local/temp/pre_install.appsflyer" />
   

Manufacturer

The manufacturer needs to put the file in the path that is agreed upon. The pre_install.appsflyer file permissions should be set to 744.

Once the app launches, the SDK looks inside the manifest file, sees the specified path and looks for the file there. When it finds it, it attributes the install according to the media source that is specified in it.

Advantages

AppsFlyer looks for the pre_install.appsflyer file in two default paths:

/data/local/tmp/pre_install.appsflyer
OR 
/etc/pre_install.appsflyer

Some manufacturers prefer to put the file in a non-default path. In such case you can specify this non-default path in the manifest file.

Disadvantages

You need to maintain separate pre_install.appsflyer files for different media sources or manufacturers.

The manufacturer might want to put the pre_install.appsflyer file in a non-default path. In this case, you need to maintain separate APKS for each non-default path.

If a non-default path is used, the install might not be attributed to the pre-install media source:

• A user with a new device updates the pre-installed app directly from Google Play without first launching it, the install is considered organic.
• A user with a new device installs the app from Google Play after clicking an ad, the install is attributed to the media source that serves the ad.

Build your application in Android Studio and install it on the test device. Once the application launches, open the Logcat in Android studio and filter by "AppsFlyer". You should see the attributed install with all the details. See the screenshots below for illustration:

If the configuration is successful, a non-organic install that is attributed to a manufacturer or media source appears in the dashboard. The install event is also listed under the "Pre-install" campaign.

Head over to your AppsFlyer account and open the dashboard for the app that you are testing. Follow the steps below:

1. In the overview page, filter by media sources and choose the media source:
   
   

   

2. In the Breakdown By Campaign graph, you can see that the install that is attributed to "my media source" comes from a Pre-install campaign:
   
   
   You can also verify that the install is attributed correctly by viewing the Aggregated Performance Report. In it, you can see the media source and campaign. See the screenshot below where "My Media Source" is the media source and the campaign is Pre-install:
   
   
3. Repeat the process for all manufacturers or media sources that you collaborate with for pre-install campaigns.

If you have campaigns for several apps that are installed on the same device, you can measure attribution using each of the four methods:

• Name in manifest method - for each app, specify the media source or manufacturer in the Manifest.xml of each app.
• SDK API method - for each app, specify the media source or manufacturer in the SDK API method for pre-install.
• For system properties or pathway methods - can specify the apps and their corresponding media source in the pre_install.appsflyer file. Each app info should be added in a new line in the file. For example:

  com.appsflyer.tester=market_name
  com.newapp.newapp=market_name
  com.game.king=market_name

If the media source or manufacturer that you collaborate with is an AppsFlyer partner, you can enable postbacks for installs.

To do so, make sure that the media source name is equivalent to the media source pid as it is configured by AppsFlyer.

For example, if you are collaborating with market_name, its pid is market_name_int. You can see the pid by examining the attribution link of an integrated partner.

Currently, agencies cannot be attributed with pre-installs. 

If the af_prt (parameter for agency name) is a part of the pre-install data, and the user launches the pre-installed app:

• The user is attributed to the media source used by the agency (pid=).
• The client can access the full user-level data.
• The user is NOT attributed to the agency.
• The agency can't access the user-level data.