С интеграцией SplitMetrics Acquire вы можете точно видеть, сколько денег приносят ваши Apple Search Ads от подписок. А отслеживание пользователей на протяжении нескольких месяцев поможет понять, сколько денег ваша реклама приносит со временем.

Кроме того, Adapty отправляет события подписок в SplitMetrics Acquire, чтобы вы могли строить там кастомные дашборды и автоматизации на основе атрибуции Apple Search Ads.
Это не добавляет никаких данных атрибуции в Adapty, поскольку у нас уже есть всё необходимое напрямую из ASA.

Как настроить интеграцию SplitMetrics Acquire

Чтобы подключить SplitMetrics Acquire, перейдите в Integrations > SplitMetrics Acquire и введите учётные данные.

Откройте аккаунт SplitMetrics Acquire, наведите курсор на один из логотипов MMP и нажмите кнопку Settings. Найдите ваш Client ID в диалоге в пункте 5, скопируйте его и вставьте в Adapty в поле Client ID.

Также необходимо указать Apple App ID. Чтобы найти его, откройте страницу вашего приложения в App Store Connect, перейдите на App Information page в разделе General и найдите Apple ID в левом нижнем углу экрана.

События и теги

Под полями учётных данных расположены три группы событий, которые можно отправлять из Adapty в SplitMetrics Acquire. Просто включите нужные. Полный список событий, предоставляемых Adapty, можно найти здесь.

Рекомендуем использовать названия событий по умолчанию, предложенные Adapty. Однако при необходимости их можно изменить. Adapty будет отправлять события подписок в SplitMetrics Acquire через серверную интеграцию, что позволит вам просматривать все события подписок в вашем дашборде SplitMetrics.

Настройка SDK

Никаких настроек на стороне SDK не требуется, однако мы рекомендуем передавать customerUserId в Adapty для повышения точности.

Решение проблем

Если интеграция с SplitMetrics Acquire не работает несмотря на корректную настройку:

• Убедитесь, что переключатель Receive Apple Search Ads attribution in Adapty включён в App Settings -> Apple Search Ads tab, что вы настроили Apple Search Ads в Adapty и загрузили учётные данные — без них SplitMetrics работать не будет.
• Проверьте, что у профилей есть неорганическая ASA-атрибуция. Только профили с детальной неорганической ASA-атрибуцией будут доставлять свои события в Adapty.

Структура событий SplitMetrics Acquire

Adapty отправляет события в SplitMetrics Acquire через GET-запрос с использованием параметров запроса. Каждое событие имеет следующую структуру:

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

Где:

Параметр	Тип	Описание
source	String	Всегда «Apple Search Ads».
app_id	String	Apple App ID.
name	String	Название события (маппится из события Adapty).
type	String	Тип события (совпадает с name).
revenue	Float	Сумма дохода.
currency	String	Код валюты.
tap_time	String	Дата и время нажатия на рекламу.
open_time	String	Дата и время открытия приложения (установки).
event_time	String	Дата и время события.
adaccount_id	String	ID организации ASA.
campaign_id	String	ID кампании ASA.
adgroup_id	String	ID группы объявлений ASA.
keyword_id	String	ID ключевого слова ASA.
creative_set_id	String	ID набора креативов ASA.
Ad_id	String	ID объявления ASA.
country_or_region	String	Страна или регион стора.
conversion_type	String	Тип конверсии (например, «Download»).
user_id	String	Customer User ID или Adapty Profile ID.
att_status	String	Статус разрешения на отслеживание (0–3).
device_type	String	Тип устройства (например, «iphone», «ipad»).
app_version	String	Версия приложения.
sdk_version	String	Версия Adapty SDK.
ios_version	String	Версия iOS.
event_value	String	JSON-строка, содержащая все доступные детали события.
event_id	String	Уникальный ID события (UUID).