С помощью интеграции Asapty вы можете оптимизировать кампании в Search Ads. Adapty отправляет события подписок в Asapty, чтобы вы могли строить там собственные дашборды на основе атрибуции Apple Search Ads.

Эта интеграция не добавляет данные атрибуции в Adapty, так как мы уже получаем всё необходимое напрямую из ASA.

Настройка интеграции

Подключение Adapty к Asapty

Чтобы подключить Asapty, перейдите в раздел Integrations > Asapty в дашборде Adapty и заполните поле Asapty ID.

Asapty ID можно найти в разделе Settings > General в вашем аккаунте Asapty.

Настройка событий и тегов

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

Рекомендуем использовать стандартные названия событий, предложенные Asapty. При необходимости вы можете изменить их под свои нужды.

Подключение приложения к Asapty

После выполнения описанных выше шагов Adapty автоматически начнёт получать данные атрибуции от Asapty. Явно запрашивать данные атрибуции в коде приложения не нужно. Для повышения точности атрибуции настройте Asapty так, чтобы customerUserId передавался вместе с данными каждого события.

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

Adapty отправляет события в Asapty через GET-запрос с query-параметрами. URL каждого события выглядит так:

https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7D

Query-параметры:

Параметр	Тип	Описание
source	String	Всегда “adapty”.
asaptyid	String	Asapty ID из ваших учётных данных.
keywordid	String	Keyword ID в Apple Search Ads (если доступен).
adgroupid	String	Ad Group ID в Apple Search Ads (если доступен).
campaignid	String	Campaign ID в Apple Search Ads (если доступен).
conversiondate	Long	Временная метка события в миллисекундах.
event_name	String	Название события (смаппированное из события Adapty).
install_time	Long	Временная метка установки в секундах.
app_name	String	Название приложения из Adapty (если доступно).
json	String	URL-кодированная JSON-строка с деталями события (см. ниже).

Параметр json — это URL-кодированная JSON-строка со следующими полями:

Параметр	Тип	Описание
af_revenue	String	Сумма дохода в виде строки.
af_currency	String	Код валюты (например, “USD”).
transaction_id	String	ID транзакции в сторе.
original_transaction_id	String	Оригинальный ID транзакции в сторе.
purchase_date	Long	Временная метка покупки в миллисекундах.
original_purchase_date	Long	Временная метка оригинальной покупки в миллисекундах.
environment	String	Production или Sandbox.
vendor_product_id	String	ID продукта в сторе.
profile_country	String	Код страны на основе IP-адреса пользователя.
store_country	String	Код страны стора пользователя.

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

• Убедитесь, что вы настроили Apple Search Ads в Adapty и загрузили учётные данные — без них Asapty работать не будет.
• Только профили с детальной неорганической атрибуцией ASA будут отправлять события в Asapty. Если атрибуция недостаточна, вы увидите сообщение “The user profile is missing the required integration data.”
• Профили, созданные до настройки интеграции, не смогут отправлять события в Asapty.
• Если интеграция с Adapty не работает, несмотря на корректную настройку, убедитесь, что переключатель Receive Apple Search Ads attribution in Adapty включён на вкладке App Settings -> Apple Search Ads.