# Set up Upsight

Upsight is an analytics partner integrated with Adjust. Our integration lets Upsight receive data measured in Adjust through automated callbacks. Use this data with the partners' tools for analytics and insights.

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

## [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 Upsight 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#add-partner-parameters) | [Windows](https://dev.adjust.com/en/sdk/windows/features/events#add-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://dev.adjust.com/en/sdk/cordova/features/events#add-partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://dev.adjust.com/en/sdk/cocos2dx/features/events#add-partner-parameters) | [Titanium](https://github.com/adjust/titanium_sdk#partner-parameters) | [Corona](https://github.com/adjust/corona_sdk#partner-parameters)



__Credentials__

AUTHORIZATION TOKEN and APP TOKEN 

   - For help finding your credentials, contact your Upsight representative.
   


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

1. Under __Campaign Lab__, select __Partners__.
2. Select __New partner > Upsight__. 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 Upsight. 
4. Select __Next__.

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

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

1. Enter your AUTHORIZATION TOKEN and APP TOKEN.



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


## [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 Upsight by default:

 - install
 - reattribution


### Send additional data

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



To send additional data, you can review and customize the following:



## [Enable Upsight for your app](enable-partner) 

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

Select __Enable partner__ to enable Upsight for your app. Analytics partners don't work with links for campaigns. Once enabled, our integration sends attribution and in-app event data via automated callbacks.


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

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

| Placeholder |	Information |
| ---------- | ---------- |
| `{android_id}` | Android ID (Android only) |
| `{idfa\|\|gps_adid}` | IDFA, or GPS ADID if IDFA is empty |
| `{idfv}` | Uppercase iOS ID for vendors |
| `{os_name}` | Device operating system |
| `{campaign_name}` | Campaign name, as taken from the tracker |
| `{creative_name}` | Creative name, as taken from the tracker |
| `{network_name}` | Network name, as taken from the tracker |

Upsight logo

# Set up {DisplayName}

{DisplayName} is an analytics partner integrated with Adjust. Our integration lets {DisplayName} receive data measured in Adjust through automated callbacks. Use this data with the partners' tools for analytics and insights.

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

## [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 {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#add-partner-parameters) | [Windows](https://dev.adjust.com/en/sdk/windows/features/events#add-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://dev.adjust.com/en/sdk/cordova/features/events#add-partner-parameters) | [Marmalade](https://github.com/adjust/marmalade_sdk#partner-parameters) | [Xamarin](https://github.com/adjust/xamarin_sdk#partner-parameters) | [Cocos2d-x](https://dev.adjust.com/en/sdk/cocos2dx/features/events#add-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 value="PartnerUiSetup">

  __In your {DisplayName} dashboard:__

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

</if>

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

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)

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)

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

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">
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>

To send additional data, you can review and customize the following:

<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="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>

## [Enable {DisplayName} for your app](enable-partner) 

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

Select __Enable partner__ to enable {DisplayName} for your app. Analytics partners don't work with links for campaigns. Once enabled, our integration sends attribution and in-app event data via automated callbacks.

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

<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
`{android_id}`	Android ID (Android only)
`{idfa\|\|gps_adid}`	IDFA, or GPS ADID if IDFA is empty
`{idfv}`	Uppercase iOS ID for vendors
`{os_name}`	Device operating system
`{campaign_name}`	Campaign name, as taken from the tracker
`{creative_name}`	Creative name, as taken from the tracker
`{network_name}`	Network name, as taken from the tracker