Attribution For Pre-loaded Applications (APK Attribution)

Apsalar support for AndroidManifest.xml enabled APK tracking is available with Apsalar Android SDK 6.4 and above.

If your Android app is integrated with the Apsalar SDK and you are using APKs with 3^rd-party app stores, those installs will currently be attributed as organic installs in the Apsalar system. 

​Create a separate APK for each vendor you are working with for pre-loading applications on Android devices, and make the following update your AndroidManifest.xml file to include the following three tags under your <application> tag:

<meta-data android:name="APSALAR_PRELOAD_CAMPAIGN" android:value="YOUR_CAMPAIGN_NAME"/>
<meta-data android:name="APSALAR_PRELOAD_GROUP" android:value="YOUR_CAMPAIGN_GROUP_NAME"/>
<meta-data android:name="APSALAR_PRELOAD_SOURCE" android:value="YOUR_CAMPAIGN_SOURCE_NAME"/>

For example:

<application

...

<meta-data android:name="APSALAR_PRELOAD_CAMPAIGN" android:value="My Campaign Name"/>
<meta-data android:name="APSALAR_PRELOAD_GROUP" android:value="My_Campaign_Group_Name"/>
<meta-data android:name="APSALAR_PRELOAD_SOURCE" android:value="Generic Network 123"/>

...

</application>

APSALAR_PRELOAD_CAMPAIGN value maps to the "Campaign Name" in reporting
APSALAR_PRELOAD_GROUP value maps to the "Campaign Group" in reporting
APSALAR_PRELOAD_SOURCE value maps to the "Campaign Source" in reporting

A few things to note:

• Alphanumeric, underscores, and spaces are allowed in the values. Currently, numeric characters only are not supported (meaning, at least one letter should be used).
• If you are providing an APK to an already integrated campaign source for sending attributed postbacks, the value and case-sensitivity must match the postback recipient value.  For example if you would like attributed install postbacks to fire for a postback recipient named like "Generic Network 123", the "APSALAR_PRELOAD_SOURCE value must be "Generic Network 123" as well.
• All three tags are required with proper values in the AndroidManifest file under your <application> tag for APK tracking to function
• "Publisher" and "creative" dimensions are not available for Android APK tracking. 

 
For our legacy Android APK documentation, please see our support article here.