# Set up Spotify

Spotify is an ad network integrated with Adjust. Our integration lets Spotify receive attribution and in-app event data through automated callbacks.

In this article, learn how to set up measurement with Spotify for your app. This includes activating the integration, creating a campaign link, and choosing what data Adjust can share with Spotify.

## [Before you begin](before-you-begin)



__Requirements__

- [Admin, Editor, or Custom Editor permissions](/en/article/permission-levels) in Adjust.
- Adjust SDK v4.0.0 and later to map SDK parameters to Spotify parameters. Follow the guides linked below to use this feature.

[iOS](https://dev.adjust.com/en/sdk/ios/features/events/#add-partner-parameters) | [Android](https://dev.adjust.com/en/sdk/android/features/events/#partner-parameters) | [Windows](https://github.com/adjust/windows_sdk#8-partner-parameters) | [Unity](https://dev.adjust.com/en/sdk/unity/features/events/#add-partner-parameters) | [React Native](https://dev.adjust.com/en/sdk/react-native/features/events/#add-partner-parameters) | [Flutter](https://dev.adjust.com/en/sdk/flutter/features/events/#add-partner-parameters) | [Adobe Air](https://github.com/adjust/adobe_air_sdk#partner-parameters) | [Cordova](https://github.com/adjust/cordova_sdk#partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://github.com/adjust/cocos2dx_sdk#partner-parameters) | [Titanium](https://github.com/adjust/titanium_sdk#partner-parameters) | [Corona](https://github.com/adjust/corona_sdk#partner-parameters)



## [Select Spotify and your app in Campaign Lab](select-network-in-campaign-lab)



1. Under __Campaign Lab__, select __Partners__.
2. Select __New partner > Spotify__. Select __Next__ to move to the next screen.
3. In the __App selection__ screen, choose the app for which you want to create the link, and enable the integration to share data with Spotify. 
4. Select __Next__.

## [Enable data sharing](enable-data-sharing)



Enable data sharing to activate the integration with Spotify. To enable data sharing:

1. Turn on Enabled



Once you enable data sharing with Spotify, Adjust automatically sends Spotify the following data, by default:
 - install


## [Set your data sharing options](set-your-data-sharing)



If you’re working with a multi-platform app with data sharing enabled for multiple platforms, you can:

1. Separate data sharing options at the platform-level by selecting __Use platform-specific settings__.
2. Set the same data sharing settings for multiple platforms by selecting __Use global settings__.

Now, under __What will be shared by default?__, review the activities that Adjust shares with Spotify by default.

 - install


### Send additional data



Choose the amount and type of data that you want to share with Spotify through callbacks. Spotify may use this information to optimize performance.


1. Under __What sources of data do you want to share?__, choose the attribution source of the data you are sharing with Spotify:

- Data from all attribution sources
- Only data attributed to Spotify

## [Configure your link and settings](configure-link-and-settings)

You have the option to set your:

- [Link structure](/en/article/link-structure-ad-network)
- [User destinations](/en/article/user-destinations-ad-network)
- [Attribution settings](/en/article/attribution-settings-ad-network)

## [Create your link and share it with Spotify](create-and-share-link)



In the __Setup review__ screen, you can review your choices. You can also go back and make changes to:

- Your selected app
- Data sharing options
- Link structure parameters
- User destinations
- Attribution settings

Select __Create link__ to create your click URL, impression URL, QR code and link token. Creating a link also enables data sharing and the integration with Spotify.

Once you’ve created your link, share it with Spotify for placement in campaigns.


## [List of all parameters forwarded to Spotify](list-of-all-parameters-forwarded)

Spotify requires Adjust to send the following parameters (data points) with your callbacks:

| Placeholder |	Information |
| ---------- | ---------- |
| `{activity_kind}` | Type of user activity |
| `{adgroup_name}` | Adgroup name, as taken from the tracker |
| `{campaign_name}` | Campaign name, as taken from the tracker |
| `{click_time}` | Attributed click timestamp |
| `{impression_time}` | Attributed impression timestamp |
| `{installed_at}` | Install (i.e., first app open) timestamp |

Spotify logo

# Set up {DisplayName}

{DisplayName} is an ad network integrated with Adjust. Our integration lets {DisplayName} receive attribution and in-app event data through automated callbacks.

In this article, learn how to set up measurement with {DisplayName} for your app. This includes activating the integration, creating a campaign link, and choosing what data Adjust can share with {DisplayName}.

## [Before you begin](before-you-begin)

<asset headerId="1" />

__Requirements__

- [Admin, Editor, or Custom Editor permissions](/en/article/permission-levels) in Adjust.
- Adjust SDK v4.0.0 and later to map SDK parameters to {DisplayName} parameters. Follow the guides linked below to use this feature.

[iOS](https://dev.adjust.com/en/sdk/ios/features/events/#add-partner-parameters) | [Android](https://dev.adjust.com/en/sdk/android/features/events/#partner-parameters) | [Windows](https://github.com/adjust/windows_sdk#8-partner-parameters) | [Unity](https://dev.adjust.com/en/sdk/unity/features/events/#add-partner-parameters) | [React Native](https://dev.adjust.com/en/sdk/react-native/features/events/#add-partner-parameters) | [Flutter](https://dev.adjust.com/en/sdk/flutter/features/events/#add-partner-parameters) | [Adobe Air](https://github.com/adjust/adobe_air_sdk#partner-parameters) | [Cordova](https://github.com/adjust/cordova_sdk#partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://github.com/adjust/cocos2dx_sdk#partner-parameters) | [Titanium](https://github.com/adjust/titanium_sdk#partner-parameters) | [Corona](https://github.com/adjust/corona_sdk#partner-parameters)

<if value="Tokens">

__Credentials__

<switch length="Tokens">
  <case length="1"> {Tokens}</case>
  <case length="2"> {Tokens} and {Tokens}</case>
  <case length="3"> {Tokens}, {Tokens}, and {Tokens}</case>
</switch> 

   - For help finding your credentials, contact your {DisplayName} representative.
   
</if>

<if value="NeedsActivationInstructions">

</if>   
   
<if value="PartnerUiSetup">

  __In your {DisplayName} dashboard:__

<parse html="PartnerUiSetup" />
</if>

## [Select {DisplayName} and your app in Campaign Lab](select-network-in-campaign-lab)

<asset headerId="2" />

1. Under __Campaign Lab__, select __Partners__.
2. Select __New partner > {DisplayName}__. Select __Next__ to move to the next screen.
3. In the __App selection__ screen, choose the app for which you want to create the link, and enable the integration to share data with {DisplayName}. 
4. Select __Next__.

## [Enable data sharing](enable-data-sharing)

<asset headerId="3" />

Enable data sharing to activate the integration with {DisplayName}. To enable data sharing:

<switch length="Tokens">
  <case length="0"> 1. Turn on Enabled</case>
  <case length="1"> 1. Enter your {Tokens}.</case>
  <case length="2"> 1. Enter your {Tokens} and {Tokens}.</case>
  <case length="3"> 1. Enter your {Tokens}, {Tokens}, and {Tokens}.</case>
</switch>

<if value="SendClicks">
Adjust does not automatically send click callbacks due to the high volume of clicks. To send clicks to {DisplayName}, enable the __Send clicks__ toggle.
</if>

Once you enable data sharing with {DisplayName}, Adjust automatically sends {DisplayName} the following data, by default:
<list value="Callbacks" />

<if value="NeedsOptionalSetupInstructions">
</if>

## [Set your data sharing options](set-your-data-sharing)

<asset headerId="4" />

If you’re working with a multi-platform app with data sharing enabled for multiple platforms, you can:

1. Separate data sharing options at the platform-level by selecting __Use platform-specific settings__.
2. Set the same data sharing settings for multiple platforms by selecting __Use global settings__.

Now, under __What will be shared by default?__, review the activities that Adjust shares with {DisplayName} by default.

<list value="Callbacks" />

### Send additional data

<asset headerId="5" />

Choose the amount and type of data that you want to share with {DisplayName} through callbacks. {DisplayName} may use this information to optimize performance.

<if value="IsAttributedOnly">
1. Under __What sources of data do you want to share?__, choose the attribution source of the data you are sharing with {DisplayName}:

- Data from all attribution sources
- Only data attributed to {DisplayName}
</if>

<if value="IsOrganicOnly">
Adjust sends {DisplayName} both organic and paid attribution data.
</if>

<if value="Ad_Spend_Forwarding__c">
#### [Ad spend](ad-spend)

Ad spend sharing lets {DisplayName} receive user ad spend data. This lets {DisplayName} use ad spend data to optimize your campaigns.

Adjust sends {DisplayName} the ad spend data received through callbacks only. This data comes from the following solutions that you’ve set up, as applicable for {DisplayName}:
- [Partner ad spend push API](/en/article/partner-ad-spend-push-api)
- [Ad spend on engagement](/en/article/ad-spend-on-engagement)

If {DisplayName} wants complete ad spend data, then you can set up [Ad spend third-party storage exports for {DisplayName}](/en/article/ad-spend-third-party-storage-exports).

:::{growthSolution}

This feature is available with Adjust’s SpendWorks package. To purchase our SpendWorks package, contact your sales representative.

:::

</if>

<if value="IsAdRevenueForwarding">
#### [Ad revenue (from ad views)](ad-revenue)

Ad revenue sharing lets {DisplayName} receive user ad revenue data. This lets {DisplayName} use ad revenue data to optimize your user targeting and campaigns.

:::{growthSolution}

This feature is available with Adjust’s Ad Revenue package. To purchase our Ad Revenue package, contact your sales representative.

:::

To share ad revenue to {DisplayName}, select one or more __Ad Revenue Sources__.
  - If you leave this field empty, we send ad revenue data from all integrated mediation sources.
</if>

<if value="IsSessionForwarding">
#### [Sessions](sessions)

Adjust does not automatically send session callbacks due to the high volume of sessions. Sharing sessions means {DisplayName} will receive your app’s session activity.
</if>

<if value="IsUninstallForwarding">
#### [Uninstalls or reinstalls](uninstalls-reinstalls)

Sharing uninstalls or reinstalls lets {DisplayName} receive your app’s uninstall and/or reinstall data measured by Adjust.

:::{note}

For iOS apps, you might expect a low record of uninstalls and/or reinstalls. For more information, visit [Uninstall and reinstall measurement](/en/article/uninstalls-reinstalls).

:::
</if>

<if value="IsRevenueForwarding">
#### [In-app revenue (from in-app purchases)](in-app-revenue)

Sharing in-app revenue lets {DisplayName} receive revenue amounts along with your revenue event data. You need to [map events](#map-events) that generate revenue to share this data.
</if>

<if value="EventLinking">

#### [Map events](map-events)

  Map events that you want to share to the values that {DisplayName} can receive. Data for unmapped events is not shared with {DisplayName}.
   
##### Map individual events

If you have a multi-platform app, you can choose to share different events per platform with {DisplayName}. This lets you:
- Set individual events to manage campaign strategies for each platform.
- Customize data sharing per platform.

Under __Map events__, follow these steps to choose the in-app events you want to directly send to {DisplayName}.

1. Select __Map event__.
2. In the __Adjust event__ list, choose the Adjust event that you want to share with {DisplayName}.
3. Under __Partner event__, you need to select the {DisplayName} event that corresponds to the Adjust event.
   1. For single platform apps and multi-platform apps with data sharing enabled for a single platform only, you map events for that platform only. For multi-platform apps with data sharing enabled for multiple platforms, you can:
      - Select __Use platform-specific mapping__ to map separate events at the platform-level or to not map events for certain platforms.
      - Select __Use global mapping__ to map the same events for all platforms.
   2. In the __Partner event__ list, choose or enter a custom event name, that you want to map the Adjust event to.
4. Select __Apply__.
   
Now {DisplayName} will receive in-app event data for each of your linked events.

##### Map all events

If {DisplayName} supports mapping all events automatically, under __Map events__, select __Map all events__. This saves time in mapping individual events.
   
Now {DisplayName} will receive in-app event data for all your linked events.

</if>

</if>

<if value="Map_Subscription_Events">

#### [Map subscription events](map-subscription-events)

Map subscription events that you want to share to the values that your network can receive. Data for unmapped events is not shared with your network.

If you have a multi-platform app, you can choose to share different events per platform with your network. This lets you:
- Set individual events to manage campaign strategies for each platform.
- Customize data sharing per platform.

Under Map subscription events, follow these steps to choose the subscription events you want to directly send to your network.

1. Select __Map event__.
2. In the __Adjust event__ list, choose the Adjust event that you want to share with your network.
3. Under __Partner event__, you need to select the partner event that corresponds to the Adjust event.
    1. For single platform apps and multi-platform apps with data sharing enabled for a single platform only, you map events for that platform only. For multi-platform apps with data sharing enabled for multiple platforms, you can:
        - Select __Use platform-specific mapping__ to map separate events at the platform-level or to not map events for certain platforms.
        - Select __Use global mapping__ to map the same events for all platforms.
    2. In the __Partner event__ list, choose or enter a custom event name that you want to map the Adjust event to.
4. Select __Apply__.

Now your network will receive subscription event data for each of your linked events.
    
+++>
### Subscription events - No revenue

- `billing_retry`
- `cancellation`
- `expiration`
- `grace_period`
- `on_hold`
- `paused`
- `price_accepted`
- `price_declined`
- `revoked`
- `trial_started `

===
    
### Subscription events - Positive revenue

- `activation`
- `discounted_offer`
- `reactivation`
- `renewal`
- `renewal_from_billing_retry`

+++<

</if>

<if value="IsPartnerParameterForwarding">
  #### [Map parameters](map-parameters)

You usually need to map parameters to share custom data with {DisplayName}.   
   
Partner parameters (available in Adjust SDK version 4.0+) let Adjust collect custom data points from your app and send them to {DisplayName}. This lets {DisplayName} receive custom event details for each of your linked events.

Before adding new partner parameters to the Adjust SDK, make sure no pre-existing partner parameters already fit your requirements.

To share partner parameters to {DisplayName}, follow these steps.
   
1. Set up partner parameters within the Adjust SDK.
   - Check [Before you begin](#before-you-begin) for all SDK development platform links.
2. Under __Set your data sharing options__, select __Parameters__.
3. Under __Map parameters__, you can specify how you want to send partner parameters defined in the SDK to the network:
   1. Select __Map parameter__.
   2. In the __SDK parameter__ field, enter the name of the SDK parameter you want to share with the network.
   3. In the __Partner parameter__ field, enter the network parameter that corresponds to the SDK parameter.

:::{note}

  If you set up partner parameters within the Adjust SDK without setting up parameter sharing in the dashboard, Adjust forwards the parameters as named in the Adjust SDK.

:::  

</if>
## [Configure your link and settings](configure-link-and-settings)

You have the option to set your:

- [Link structure](/en/article/link-structure-ad-network)
- [User destinations](/en/article/user-destinations-ad-network)
- [Attribution settings](/en/article/attribution-settings-ad-network)

## [Create your link and share it with {DisplayName}](create-and-share-link)

<asset headerId="6" />

In the __Setup review__ screen, you can review your choices. You can also go back and make changes to:

- Your selected app
- Data sharing options
- Link structure parameters
- User destinations
- Attribution settings

Select __Create link__ to create your click URL, impression URL, QR code and link token. Creating a link also enables data sharing and the integration with {DisplayName}.

Once you’ve created your link, share it with {DisplayName} for placement in campaigns.

<if value="PartnerSpecificSetup">
## [Partner specific setup instructions](partner-specific-setup-instructions)

<asset headerId="7" />   
   
<parse html="PartnerSpecificSetup" />
</if>

<if value="DataList">
## [List of all parameters forwarded to {DisplayName}](list-of-all-parameters-forwarded)

{DisplayName} requires Adjust to send the following parameters (data points) with your callbacks:

<table value="DataList" />
</if>


Take your growth to the next level with Adjust’s setup guides, best practices, and FAQs.

Marketer

Integrate our APIs and open-source SDKs with your apps and business analytics.


Developer

In-depth advice for our global Technology Partners on how best to work with Adjust.


Placeholder	Information
`{activity_kind}`	Type of user activity
`{adgroup_name}`	Adgroup name, as taken from the tracker
`{campaign_name}`	Campaign name, as taken from the tracker
`{click_time}`	Attributed click timestamp
`{impression_time}`	Attributed impression timestamp
`{installed_at}`	Install (i.e., first app open) timestamp