Samsung referrer

The Samsung referrer plugin enables the Adjust SDK to read Samsung Galaxy store install referrer values on a device. The SDK sends this information to the Adjust servers as part of the install payload.

The Samsung install referrer is available on all devices that support the Samsung install referrer library.

Before you begin

Follow the get started guide to integrate the Adjust SDK in your app.

Install the Samsung referrer plugin

There are two ways to install the Samsung referrer plugin:

Maven

Add the following dependency to your build.gradle file under your Adjust SDK declaration.

implementation 'com.adjust.sdk:adjust-android:4.38.5'
implementation 'com.adjust.sdk:adjust-android-samsung-referrer:4.38.5'

JAR

The Samsung referrer plugin is available on the GitHub releases page.

Add the Samsung install referrer library

You must add the Samsung install referrer to your app to read the referrer value. For more information, reach out to your Samsung representative or contact support@samsungdevelopers.com

implementation  'store.galaxy.samsung.installreferrer:samsung_galaxystore_install_referrer:3.0.1'

Proguard settings

If you use Proguard, you must add rules to ensure that important classes aren’t removed during build.

Add the following rule to keep all Adjust classes.

-keep public class com.adjust.sdk.** { *; }

Add the following rule to keep the Samsung install referrer library.

-keep class com.sec.android.app.samsungapps.installreferrer.** { *; }

Use the plugin

The Samsung referrer plugin is enabled by default. You can toggle reading Samsung install referrer information on and off using the AdjustSamsungReferrer class methods.

To disable reading the install referrer, call AdjustSamsungReferrer.doNotReadSamsungReferrer() before you initialize the SDK.

AdjustSamsungReferrer.doNotReadSamsungReferrer();
//...
Adjust.onCreate(config);

AdjustSamsungReferrer.doNotReadSamsungReferrer()
//...
Adjust.onCreate(config)

To reenable reading the install referrer, call AdjustSamsungReferrer.readSamsungReferrer(applicationContext) before you initialize the SDK.

AdjustSamsungReferrer.readSamsungReferrer(applicationContext);
//...
Adjust.onCreate(config);

AdjustSamsungReferrer.readSamsungReferrer(applicationContext)
//...
Adjust.onCreate(config)