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
- Android SDK version 4.33.0 and later - Install the Samsung install referrer plugin in your app.
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)
- Under AppView, select All apps.
- Select New app.
- Enter a unique App name and choose the Reporting currency.
- Select Add app.
- Select Add platform, and choose Add platform > Android: Google Play Store.
- Enter your App ID.
- 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.
- Share your app token and event tokens with your developers.
- 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.
- Under Campaign Lab, select Custom links.
- Select New link.
- In the App selection screen, choose the app for which you want to create the link, and select Next.
- In the Channel field, enter a name for the channel level of your link structure, and select Next.
- Under Add a redirect, select Custom URL.
- In the Redirect field, enter the Galaxy Store URL of the app, and select Next.
- 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
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
- Under Campaign Lab, select Custom links.
- Select New link.
- In the App selection screen, choose the app for which you want to create the link, and select Next.
- In the Channel field, enter a name for the channel level of your link structure, and select Quick create.
- 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
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 value | Use case |
---|---|
utm_source=galaxystore&utm_medium=organic | Organically 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_medium | An 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 |