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.

Note:

Meta refers to SAN campaign managers as Preferred Marketing Developers (PMDs).

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

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

  1. Under Campaign Lab, select Partners.
  2. Select New partner > SplitMetrics Acquire. Select Next to move to the next screen.
  3. In the App selection screen, choose the app for which you want to set up SplitMetrics Acquire.
  4. Select Next.

Enable data sharing

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

  1. 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:

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

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.

Uninstalls or reinstalls

Sharing uninstalls or reinstalls lets SplitMetrics Acquire 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.

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.

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.

Under Map events, follow these steps to choose the in-app events you want to directly send to SplitMetrics Acquire.

  1. Select Map event.
  2. In the Adjust event list, choose the Adjust event that you want to share with SplitMetrics Acquire.
  3. In the Partner event list, choose or enter a custom event name that you want to map the Adjust event to. You might have to map an event to several values.
  4. Select Apply.

Now SplitMetrics Acquire will receive in-app event data for each of 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:

PlaceholderInformation
{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