Asapty
С помощью интеграции 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...%7DQuery-параметры:
| Параметр | Тип | Описание |
|---|---|---|
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 | Код страны стора пользователя. |
Устранение неполадок
События не доходят до Adapty
- Убедитесь, что вы настроили 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.
access_level_updated отображается как сбой в Event Feed
access_level_updated — это событие только для вебхуков. Adapty не отправляет его в эту интеграцию. Однако Adapty фиксирует результат для каждой активной интеграции, и неподдерживаемое событие отображается как ошибка.