Set up web attribution

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 links

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 with web as its only platform:

Under AppView, select All apps.
Select New app.
Enter a unique App name and choose the Reporting currency.
Select Add app.
- Do not select any of the available platforms. Not selecting a platform designates the app as a web 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 links. Check the information below to see the applicable information for your setup.

Link behavior for single platform web apps

Link 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 link.

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

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`

Link behavior for cross-platform links

Cross-platform deep link & redirect behavior

Links 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 link 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 link.
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 link while eligible for reattribution, the reattribution is awarded to the iOS mobile link.

Additional link 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 reporting in Datascape

Use the Platform filter in Datascape to display only installs and sessions associated with web traffic.

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 the Report service API

Use the Report service API to programatically report on your web attribution data.

The Report service API provides a set of endpoints to create 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'

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`