Интеграция с 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, скопируйте его и вставьте в поле Client ID в Adapty.

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

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

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

Рекомендуем оставить названия событий по умолчанию, предложенные Adapty. При необходимости их можно изменить. Adapty отправляет события подписок в SplitMetrics Acquire через серверную интеграцию (server-to-server), что позволяет просматривать все события подписок в дашборде 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. События в Adapty передаются только для профилей с детальной, неорганической атрибуцией ASA.

Структура событий 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).