Measure installs from Samsung Galaxy Store

Adjust can record installs from Samsung's Galaxy Store. Based on what you want to measure, your setup differs.

Before you begin

Here's what you need to know before getting started.

Requirements

Record organic installs only

You need to create a specific APK version that automatically assigns installs to a predefined link URL, written directly into the Adjust SDK. For more information, see Measure third-party installs and preinstalled apps with an APK and default link.

Record paid installs and organic installs

To record installs from Galaxy Store, you need to set up a new app or add a link to an existing Android app/multi-platform app. This ensures that Adjust is able to differentiate between data measured and attributed for Galaxy Store apps, from other Google Play Store apps.

When adding an app in Adjust, the Galaxy Store is not an available platform. However, Adjust’s servers measure data from Galaxy Store apps in the same way as for Google Play Store apps. This means you should select Google Play Store as the platform when prompted.

Set up a new app (Recommended)

  1. Under AppView, select All apps.
  2. Select New app.
  3. Enter a unique App name and choose the Reporting currency.
  4. Select Add app.
  5. Select Add platform, and choose Add platform > Android: Google Play Store.
  6. Enter your App ID.
  7. Turn on Redirect all clicks to a custom URL and enter the Galaxy Store URL of the app.
    • This ensures that all links generated for the app redirect to the Galaxy Store app’s page, by default.
  8. Share your app token and event tokens with your developers.
  9. Confirm your attribution setup:
    • For Android SDK version 4.33.0 and later - Verify if you have the Samsung referrer plugin integrated in your app. Adjust can only attribute based on the reftag passed through the referrer.
    • For Android SDK version 4.33.0 and lower - Select the Attribution settings tab, and turn ON probabilistic modeling.

Use an existing app

You can create a link for your single-platform Android app or multi-platform app, which includes Android as one of the platforms.

  1. Under Campaign Lab, select Custom links.
  2. Select New link.
  3. In the App selection screen, choose the app for which you want to create the link, and select Next.
  4. In the Channel field, enter a name for the channel level of your link structure, and select Next.
  5. Under Add a redirect, select Custom URL.
  6. In the Redirect field, enter the Galaxy Store URL of the app, and select Next.
  7. Confirm your attribution setup:
    • For Android SDK version 4.33.0 and later - Verify if you have the Samsung referrer plugin integrated in your app. Adjust can only attribute based on the reftag passed through the referrer.
    • For Android SDK version 4.33.0 and lower - Select the Attribution settings tab, and turn ON probabilistic modeling.

Use this link to specifically target Samsung apps users.

Record S2S clicks with Samsung referrer

Note:
This method works only if you're using Android SDK version 4.33.0 and later and have integrated the Samsung referrer plugin in your app.

Use the external_click_id parameter to send server-to-server clicks. This lets Adjust match the click ID we receive with that sent to Samsung using the Samsung referrer plugin.

Create a link

  1. Under Campaign Lab, select Custom links.
  2. Select New link.
  3. In the App selection screen, choose the app for which you want to create the link, and select Next.
  4. In the Channel field, enter a name for the channel level of your link structure, and select Quick create.
  5. Copy the link URL and append the s2s=1 parameter.

Example: https://s2s.adjust.com/xxxxxxx?s2s=1

Send S2S click request to Adjust

Include external_click_id parameter populated with a unique value in the newly generated link URL to send an S2S click. This is used to pass a click ID value to Adjust. Adjust uses this to match an install to a click.

Example: https://s2s.adjust.com/xxxxxxx?external_click_id=1234567890&s2s=1

Send S2S click request to the Galaxy Store

On the Galaxy Store URL you use to redirect users to the store and download the app, append the referrer parameter. Populate this referrer parameter with adjust_external_click_id%3D<UNIQUE_VALUE> with <UNIQUE_VALUE> being the same unique value sent on click. Make sure that everything within the referrer parameter is encoded.

Example: http://apps.samsung.com/appquery/appDetail.as?appId=com.my.app&referrer=adjust_external_click_id%3D1234567890

Supported Galaxy Store links for referrer

Unsupported Galaxy Store link for referrer

Values populated for referrer

The Galaxy Store referrer passes the reftag and performs attribution over it. Additionally, the following UTM parameters are also automatically appended to the referrer and populated as follows:

utm_source={network_name}&utm_campaign={campaign_name}&utm_content={adgroup_name}&utm_term={creative_name}

The following table provides referrer values for different use cases:

Referrer valueUse case
utm_source=galaxystore&utm_medium=organicOrganically searched and installed apps from the Galaxy Store.
utm_source=(not%20set)&utm_medium=(not%20set)An app downloaded via a link that has no referrer or ads tag.
Example: https://apps.samsung.com/appquery/appDetail.as?appId=com.my.app
utm_source=test_source&utm_medium=test_mediumAn app downloaded via a link that has only the referrer tag.
Example: https://apps.samsung.com/appquery/appDetail.as?appId=com.my.app&referrer=utm_source%3Dtest_source%26utm_medium%3Dtest_medium