Samsung referrer plugin

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 backend 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

JAR

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.

Adjust SDK v4.33.4 and above
Adjust SDK v4.33.3 and below
Important:
Adding the Samsung install referrer library via Maven is available only in Adjust SDK v4.33.4 and above.

To install the Samsung install referrer library, you must add the following dependency to your build.gradle file under your Adjust SDK declaration:

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 are not 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.

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

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

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