Set up web attribution in the classic dashboard

Follow the instructions in this article to set up web attribution for your app.

1. Send your web base URL to Adjust

Adjust needs to add your web base URL to our internal interface to set up your app. We also need to activate the Web Attribution package on your account. Both of these steps need to be done by Adjust. For more information, contact support@adjust.com.

2. Integrate the SDK

Follow our developer guides to integrate the web SDK into your web app. Once complete, test the integration.

Testing

There are 3 ways you can check the web SDK is functioning correctly.

Check the web SDK logs in your browser console.
Use the Adjust Testing Console.
Use the Device API.

To find your web_uuid in your Javascript Console:

Select Application (or Storage if using Safari)
Select IndexedDB
Select adjust-sdk -> as
Your web_uuid is displayed as u:<web_uuid>

3. Set up your app & update trackers

Tip:

After Adjust activates web attribution on your account, you can see the web icon

on your dashboard apps. The dashboard highlights this icon for your apps using web attribution.

There are 2 options to set up an app for web attribution in Adjust.

Add a new app with web as its only platform.
Use web as a platform for an existing mobile app.

To set up a new app in the Adjust dashboard with web as its only platform:

Select + NEW APP.
Enter your App ID (optional).
Enter your App Name.
Do not select any of the available platforms. Not selecting a platform designates the app as a web app.
Choose your reporting currency.
Select CREATE APP.

Your web app displays in the dashboard!

Note:

For web attribution to work, Adjust needs to add your web base URL to our internal interface. Contact your account manager or support@adjust.com to set this up for you. For this guide, we use https://www.mywebsite.com as an example for your website.

Depending upon your setup method, you can expect different behavior from both your new and existing trackers. Check the information below to see the applicable information for your setup.

Tracker behavior for single platform web apps

Tracker behavior for multiplatform apps

The web base URL is used as the default fallback. This means that if, for example, iOS and Web are set up for the app:

iOS users are sent to the App Store to download the app.
Non-iOS users are sent to the web base URL and web events are attributed to the tracker.

To determine which users should be sent where, append the following parameters to your tracker.

Users	Target	Parameter
All users	Web base URL or or a page of the website	`redirect`
Specific OS users	Web base URL or a page of the website	OS-specific redirect `redirect_ios` `redirect_macos` `redirect_android` `redirect_windows` `redirect_windows-phone`
Non-iOS users	A page other than the web base URL	`fallback`

Tracker behavior for cross-platform trackers

Cross-platform tracker deep link & redirect behavior

Trackers behave differently depending on whether a user has the app installed on their device when they interact with a deep link.

https://app.adjust.com/abc123_xyz456?deep_link=xxxxx&redirect=https://mywebsite.com

If an iOS user who does not have the app installed clicks a cross-platform tracker with both a deep_link and redirect parameter:

The user is sent to the web base URL.
The click is attributed to the iOS mobile tracker.
The web install/session is attributed to Organic of the Web.

If an iOS user who does have the app installed clicks a cross-platform tracker while eligible for reattribution, the reattribution is awarded to the iOS mobile tracker.

Additional tracker customization

You can change your web page destination at any times. There are 2 ways to do this:

Append the full website URL to a redirect-related parameter such as redirect, fallback, redirect_macos.

https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Fxmas%3Fproduct%3Dshoes%26category%3Dboots

Use the {base_url} placeholder with a redirect-related parameter. The placeholder is automatically replaced by your web base URL. This makes it quick and easy to change the URL when you want to.

https://app.adjust.com/abc123?redirect={base_url}%2Fxmas%3Fproduct%3Dshoes%26category%3Dboots

4. Set up dashboard reporting

In the dashboard, you can use the Platform filter to view your installs and sessions according to web or mobile app.

Important:

When you first integrate the Adjust web SDK, you may see a high volume of "new" users from web. This is because Adjust is seeing their web_uuid for the first time.

5. Set up reporting using APIs

Adjust offers 2 API suites to access your data. Use these to programatically report on your web attribution data.

Report service

The Report service API provides a set of endpoints to create bespoke reports on your Adjust data. To filter your web attribution information:

Choose your endpoint depending on which format you want to receive data in.
Use the dimensions filter and assign the value platform to group your information by platform: dimensions=platform
Add the platform dimension and assign the value webos to return only web results: platform=webos

curl \
--header 'Authorization: Bearer <adjust_api_token>' \
--location --request GET 'https://dash.adjust.com/control-center/reports-service/report?cost_mode=network&app_token__in={app_token1},{app_token2}&date_period=2021-05-01:2021-05-02&dimensions=platform&metrics=installs,network_installs,network_cost,network_ecpi&platform=webos'

KPI service

The KPI Service enables you to group your data by Platform.

To filter your web attribution information:

Use the grouping parameter and assign the value platforms to filter by platform: grouping=platforms.
Add the platforms parameter and assign the value of the platform you want to report on. The available options are:
- mobile_app
- web
- undefined

All KPIs relating to post-install activities are grouped under mobile_app or web. All other activities, such as impressions or clicks, fall under undefined.

curl --header 'Authorization: Token token={your_api_token}' \
--location --request GET 'http://api.adjust.com/kpis/v1/2eb2na2w54c3?start_date=2022-05-01&end_date=2022-05-31&grouping=platforms&platforms=web&kpis=sessions,installs&countries=de,gb'

6. Set up callbacks

There are 2 placeholders available for post-install activities. Add these to your callbacks to start receiving web attribution information in your raw data.

Placeholder	Return value
`{web_uuid}`	Gives the full device identifier Example: `4d1615ab-ee78-49aa-a10f-d57035322a42`
`{platform}`	Indicates if the activity happened on mobile or web Example: `web`