---
title: "Asapty"
description: "Узнайте об Asapty и её роли в экосистеме подписок Adapty."
---

С помощью интеграции [Asapty](https://asapty.com/) вы можете оптимизировать кампании в Search Ads. Adapty отправляет события подписок в Asapty, чтобы вы могли строить там собственные дашборды на основе атрибуции Apple Search Ads.

Эта интеграция не добавляет данные атрибуции в Adapty, так как мы уже получаем всё необходимое напрямую из [ASA](apple-search-ads).

## Настройка интеграции \{#set-up-integration\}

### Подключение Adapty к Asapty \{#connect-adapty-to-asapty\}

Чтобы подключить Asapty, перейдите в раздел [Integrations > Asapty](https://app.adapty.io/integrations/asapty) в дашборде Adapty и заполните поле Asapty ID.

  <img src="/assets/shared/img/895de2b-CleanShot_2023-08-14_at_18.57.462x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

### Настройка событий и тегов \{#configure-events-and-tags\}

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

  <img src="/assets/shared/img/58ddf41-CleanShot_2023-08-15_at_15.11.072x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

### Подключение приложения к Asapty \{#connect-your-app-to-asapty\}

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

## Структура событий Asapty \{#asapty-event-structure\}

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 | Код страны стора пользователя.                       |

## Устранение неполадок \{#troubleshooting\}

- Убедитесь, что вы настроили [Apple Search Ads](apple-search-ads) в Adapty и [загрузили учётные данные](https://app.adapty.io/settings/apple-search-ads) — без них 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**](https://app.adapty.io/settings/apple-search-ads).