SplitMetrics Acquire

With SplitMetrics Acquire integration, you can see exactly how much money your Apple Search Ads make from subscriptions. And you can track your users for months to know how much money your ads make over time.

In addition, Adapty sends subscription events to SplitMetrics Acquire so that you can build custom dashboards and automation there, based on Apple Search Ads attribution.
It doesn't add any attribution data to Adapty, as we already have everything we need from ASA directly.

How to set up SplitMetrics Acquire integration

To integrate SplitMetrics Acquire go to Integrations > SplitMetrics Acquire and set credentials.

Open your SplitMetrics Acquire account, hover over one of the MMP logos, and click the Settings button. Find your Client ID in the dialog under item 5, copy it, and then paste it to Adapty as Client ID.

You will also have to set Apple App ID to use the integration. To find your App ID, open your app page in App Store Connect, go to the App Information page in the General section, and find the Apple ID in the left bottom part of the screen.

Events and tags

Below the credentials, there are three groups of events you can send to SplitMetrics Acquire from Adapty. Simply turn on the ones you need. Check the full list of the events offered by Adapty here.

We recommend using the default event names provided by Adapty. But you can change the event names based on your needs. Adapty will send subscription events to SplitMetrics Acquire using a server-to-server integration, allowing you to view all subscription events in your SplitMetrics dashboard.

SDK configuration

You don't have to configure anything on the SDK side, but we recommend sending customerUserId to Adapty for better accuracy.

warning

Make sure you've configured Apple Search Ads in Adapty and uploaded credentials, without them, SplitMetrics Acquire won't work.

Troubleshooting

If the integration with SplitMetrics Acquire isn't working despite the correct setup:

• Make sure you've enabled the Receive Apple Search Ads attribution in Adapty toggle is enabled in the App Settings -> Apple Search Ads tab, configured Apple Search Ads in Adapty, and uploaded credentials, without them, SplitMetric won't work.
• Ensure the profiles have non-organic ASA attribution. Only profiles with detailed, non-organic ASA attribution will deliver their events to Asapty.

SplitMetrics Acquire event structure

Adapty sends events to SplitMetrics Acquire via a GET request using query parameters. Each event is structured like this:

{
  "source": "Apple Search Ads",
  "app_id": "123456789",
  "name": "subscription_renewed",
  "type": "subscription_renewed",
  "revenue": 9.99,
  "currency": "USD",
  "tap_time": "2024-03-01 12:00:00",
  "open_time": "2024-03-01 12:05:00",
  "event_time": "2024-03-02 12:00:00",
  "adaccount_id": "123456",
  "campaign_id": "123456789",
  "adgroup_id": "123456789",
  "keyword_id": "123456789",
  "creative_set_id": "123456789",
  "Ad_id": "123456789",
  "country_or_region": "US",
  "conversion_type": "Download",
  "user_id": "user_12345",
  "att_status": "3",
  "device_type": "iphone",
  "app_version": "1.2.3",
  "sdk_version": "2.10.0",
  "ios_version": "17.2",
  "event_value": "{\"vendor_product_id\":\"yearly.premium.6999\",\"original_transaction_id\":\"GPA.3383...\"}",
  "event_id": "123e4567-e89b-12d3-a456-426614174000"
}

Where:

Parameter	Type	Description
source	String	Always "Apple Search Ads".
app_id	String	Apple App ID.
name	String	Event name (mapped from Adapty event).
type	String	Event type (same as name).
revenue	Float	Revenue amount.
currency	String	Currency code.
tap_time	String	Date and time of the ad tap.
open_time	String	Date and time of the app open (install).
event_time	String	Date and time of the event.
adaccount_id	String	ASA Organization ID.
campaign_id	String	ASA Campaign ID.
adgroup_id	String	ASA Ad Group ID.
keyword_id	String	ASA Keyword ID.
creative_set_id	String	ASA Creative Set ID.
Ad_id	String	ASA Ad ID.
country_or_region	String	Store country or region.
conversion_type	String	Conversion type (e.g., "Download").
user_id	String	Customer User ID or Adapty Profile ID.
att_status	String	Tracking usage status (0-3).
device_type	String	Device type (e.g., "iphone", "ipad").
app_version	String	Application version.
sdk_version	String	Adapty SDK version.
ios_version	String	iOS version.
event_value	String	JSON string containing all available event details.
event_id	String	Unique event ID (UUID).