Set up SplitMetrics Acquire
SplitMetrics Acquire is a SAN campaign manager that manages campaigns for the following self-attributing networks (SANs):
- Apple Search Ads
To run a campaign with a SAN campaign manager, you don't need to create a link. Instead, you need to set up both the SAN whose platform your ads will run on, and the SAN campaign manager who is managing your campaign.
As soon as you start running campaigns with the SAN campaign managers, Adjust shares data for analysis and campaign optimization with both the SAN and SAN campaign manager.
Meta refers to SAN campaign managers as Meta Business Partners.
In this article, learn how to set up measurement with SplitMetrics Acquire for your app. This includes activating the integration and choosing what data Adjust can share with SplitMetrics Acquire.
Before you begin
Requirements
- Admin, Editor, or Custom Editor permissions in Adjust.
- Enable the SAN whose platform your ads will run on.
- Adjust SDK v4.0.0 and later to map SDK parameters to SplitMetrics Acquire parameters. Follow the guides linked below to use this feature.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credentials
CLIENT ID
- For help finding your credentials, contact your SplitMetrics Acquire representative.
Select SplitMetrics Acquire and app in Campaign Lab
- Under Campaign Lab, select Partners.
- Select New partner > SplitMetrics Acquire. Select Next to move to the next screen.
- In the App selection screen, choose the app for which you want to set up SplitMetrics Acquire.
- Select Next.
Enable data sharing
Enable data sharing to activate the integration with SplitMetrics Acquire. To enable data sharing:
- Enter your CLIENT ID.
Once you enable data sharing with SplitMetrics Acquire, Adjust automatically sends SplitMetrics Acquire the following data, by default:
- install
- session
- uninstall
- reattributionReinstall
- reattribution
- event
Set your data sharing options
If you’re working with a multi-platform app with data sharing enabled for multiple platforms, you can:
- Separate data sharing options at the platform-level by selecting Use platform-specific settings.
- 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 SplitMetrics Acquire by default:
- install
- session
- uninstall
- reattributionReinstall
- reattribution
- event
Send additional data
Choose the amount and type of data that you want to share with SplitMetrics Acquire through callbacks. SplitMetrics Acquire may use this information to optimize performance.
To send additional data, you can review and customize the following:
Sessions
Adjust does not automatically send session callbacks due to the high volume of sessions. Sharing sessions means SplitMetrics Acquire will receive your app’s session activity.
Uninstalls or reinstalls
Sharing uninstalls or reinstalls lets SplitMetrics Acquire receive your app’s uninstall and/or reinstall data measured by Adjust.
For iOS apps, you might expect a low record of uninstalls and/or reinstalls. For more information, visit Uninstall and reinstall measurement.
In-app revenue (from in-app purchases)
Sharing in-app revenue lets SplitMetrics Acquire receive revenue amounts along with your revenue event data. You need to map events that generate revenue to share this data.
Map events
Map events that you want to share to the values that SplitMetrics Acquire can receive. Data for unmapped events is not shared with SplitMetrics Acquire.
Map individual events
If you have a multi-platform app, you can choose to share different events per platform with SplitMetrics Acquire. 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 SplitMetrics Acquire.
- Select Map event.
- In the Adjust event list, choose the Adjust event that you want to share with SplitMetrics Acquire.
- Under Partner event, you need to select the SplitMetrics Acquire event that corresponds to the Adjust event.
- 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.
- In the Partner event list, choose or enter a custom event name, that you want to map the Adjust event to.
- 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 Apply.
Now SplitMetrics Acquire will receive in-app event data for each of your linked events.
Map all events
If SplitMetrics Acquire supports mapping all events automatically, under Map events, select Map all events. This saves time in mapping individual events.
Now SplitMetrics Acquire will receive in-app event data for all your linked events.
Enable SplitMetrics Acquire for your app
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 SplitMetrics Acquire for your app. This also enables data sharing, if you've set it up.
Set up your campaign with keyword in the SplitMetrics Acquire dashboard
Set up your campaign in the SplitMetrics Acquire dashboard. While setting up the campaign, you need to enter a keyword to the campaign name. Keywords are not case-sensitive.
If you do not add the keyword to the campaign name, Adjust cannot identify the campaigns that you're managing through SplitMetrics Acquire. This means the SAN still receives data for the campaign, but you can't see which campaigns are managed by SplitMetrics Acquire in your reporting and SplitMetrics Acquire will not receive any callbacks from Adjust.
Partner specific setup instructions
For SplitMetrics Optimize integration, please follow this guide.
List of all parameters forwarded to SplitMetrics Acquire
SplitMetrics Acquire requires Adjust to send the following parameters (data points) with your callbacks:
Placeholder | Information |
{adid} | Adjust device ID (all platforms) |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{iad_conversion_type} | Download status: first or subsequent app download |
{iad_creative_set_id} | Apple Search Ads creative set ID |
{iad_creative_set_name} | Apple Search Ads creative set name |
{iad_keyword_matchtype} | Apple Search keyword matchtype |
{is_reattributed} | 1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed |
{os_version} | Operating system version number |
{revenue_float} | Revenue, as sent from Adjust SDK, in whole currency units |
{sdk_version} | Adjust SDK version (per app) |
{activity_kind} | Type of user activity |
{adgroup_name} | Adgroup name, as taken from the tracker |
{app_id} | Store App ID or Google Play Store |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{campaign_name} | Campaign name, as taken from the tracker |
{click_time} | Attributed click timestamp |
{created_at} | Activity timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{network_name} | Network name, as taken from the tracker |
{iad_keyword_id} | Apple Search Ads keyword ID |
{iad_org_id} | Apple Search Ads organization ID |
{iad_country_or_region} | Apple Search Ads country or region |
{iad_ad_id} | Apple Search Ads adId |