Благодаря интеграции с 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

Если интеграция с SplitMetrics Acquire не работает, несмотря на правильные настройки:

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

access_level_updated отображается как неудача в Event Feed

access_level_updated — это событие только для вебхуков. Adapty не отправляет его в эту интеграцию. Однако 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).