SplitMetrics Acquire

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

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

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

8255349-CleanShot_2023-08-14_at_17.39.422x.webp

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

4d0b2b6-Adapty.webp
4f8d0b8-AdaptyGuide.webp

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

61578ee-CleanShot_2022-04-20_at_17.55.03.webp

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

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

1b0c777-CleanShot_2023-08-11_at_14.56.362x.webp

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

Настройка SDK

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

Убедитесь, что вы настроили Apple Search Ads в Adapty и загрузили учётные данные — без них SplitMetrics Acquire работать не будет.

Устранение неполадок

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

  • Убедитесь, что в App Settings -> Apple Search Ads tab включён переключатель Receive Apple Search Ads attribution in Adapty, настроены Apple Search Ads в Adapty и загружены учётные данные — без них SplitMetrics работать не будет.
  • Убедитесь, что у профилей есть неорганическая атрибуция ASA. В Asapty будут передаваться события только тех профилей, у которых есть подробная неорганическая атрибуция 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"
}

The message appears to be incomplete. Please provide the MDX documentation you’d like me to translate from English to Russian.

ПараметрТипОписание
sourceStringВсегда “Apple Search Ads”.
app_idStringApple App ID.
nameStringНазвание события (маппинг из события Adapty).
typeStringТип события (совпадает с name).
revenueFloatСумма дохода.
currencyStringКод валюты.
tap_timeStringДата и время нажатия на рекламу.
open_timeStringДата и время открытия приложения (установки).
event_timeStringДата и время события.
adaccount_idStringID организации ASA.
campaign_idStringID кампании ASA.
adgroup_idStringID группы объявлений ASA.
keyword_idStringID ключевого слова ASA.
creative_set_idStringID набора креативов ASA.
Ad_idStringID объявления ASA.
country_or_regionStringСтрана или регион стора.
conversion_typeStringТип конверсии (например, “Download”).
user_idStringCustomer User ID или Adapty Profile ID.
att_statusStringСтатус разрешения на отслеживание (0–3).
device_typeStringТип устройства (например, “iphone”, “ipad”).
app_versionStringВерсия приложения.
sdk_versionStringВерсия Adapty SDK.
ios_versionStringВерсия iOS.
event_valueStringJSON-строка со всеми доступными деталями события.
event_idStringУникальный ID события (UUID).