Интеграция атрибуции

Adapty может обмениваться информацией со сторонними сервисами, чтобы привязывать события подписки к конкретным маркетинговым кампаниям. Это позволяет:

Выяснить, какие маркетинговые стратегии приносят больше всего дохода
Фильтровать графики подписок Adapty по атрибуции
Использовать возможности стороннего сервиса для анализа данных подписок Adapty

Настроить это можно одним из двух способов:

Интегрированная атрибуция требует минимальной настройки и позволяет Adapty обмениваться данными с 9 популярными платформами.
Ручная атрибуция требует самостоятельного получения данных атрибуции из API сторонних сервисов перед отправкой в Adapty.

Tip

Включите Adapty Attribution для полного обзора экономики вашего приложения.

Adapty Attribution — это простой в настройке веб-дашборд, который консолидирует данные из разных источников для выявления эффективных стратегий привлечения пользователей.

Warning

Следите за чистотой данных: избегайте дублирования событий и конфликтов атрибуции. Следуйте рекомендациям из раздела Предотвращение проблем с данными, чтобы новый источник данных не засорял вашу аналитику.

Интегрированная атрибуция

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

У каждой платформы свой процесс, но шаги везде примерно одинаково просты:

Настройте автоматический обмен данными. Авторизуйте Adapty для работы с выбранной платформой.
Интегрируйте SDK. Некоторые платформы требуют дополнительного кода для передачи данных атрибуции.
Отключите другие сервисы отправки событий и источники атрибуции, чтобы избежать дублирования событий и конфликтов данных.

Ознакомьтесь с гайдом по конкретной платформе для подробного обзора интеграции:

Note

Если вы хотите, чтобы Adapty расширил этот список, создайте запрос на добавление функции и выразите интерес к конкретному сервису.

Ручная атрибуция

Если Adapty не предлагает интегрированную атрибуцию с нужным вам сервисом, вам потребуется написать собственный код для обмена данными с источником атрибуции.

Получите данные от сервиса атрибуции. Используйте API сервиса для запроса данных атрибуции.
Создайте словарь с полученными данными атрибуции.

Словарь может содержать следующие ключи:
- status (organic, non-organic или unknown)
- channel
- campaign
- ad_group
- ad_set
- creative

Important

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

Пример:

let attribution = [
    "status": "non_organic",
    "channel": "Google Ads",
    "campaign": "Christmas Sale",
    "ad_group": "ad group 1",
    "ad_set": "ad set 1",
    "creative": "creative id 1"
]

Установите данные атрибуции: Передайте словарь атрибуции в метод updateExternalAttribution (до версии SDK 4.1 назывался updateAttribution). После того как Adapty сохранит значение атрибуции, его нельзя будет переопределить:
```
Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}
```

Info

Успешный результат означает, что бэкенд принял данные атрибуции для асинхронной обработки — не то, что они уже применены к профилю. Не ожидайте, что провайдер сразу появится в AdaptyProfile.appliedExternalAttributionProviders после успешного вызова; дождитесь обновления профиля.

Параметры:

attribution (required): словарь с данными атрибуции.
- provider (required; named source before SDK version 4.1): провайдер атрибуции. Используйте .custom (SDK 4.1 и выше), если ваш провайдер атрибуции не поддерживает интегрированную атрибуцию. В более ранних версиях передавайте строку "custom".

Отключите другие сервисы передачи событий и источники атрибуции, чтобы избежать дублирования событий и конфликтов данных.

Предотвращение проблем с данными

Выберите один источник атрибуции

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

Если подключено несколько источников атрибуции, Adapty выберет тот, у которого больше данных — но не обязательно лучших. Например, неорганическая атрибуция Apple Search Ads всегда имеет приоритет на iOS. Чтобы отключить атрибуцию Apple Search Ads, откройте App Settings -> вкладку Apple Search Ads и переключите тумблер Receive Apple Search Ads attribution.

Избегайте дублирования событий

Если вы используете Adapty для передачи данных о подписках в реальном времени в сервисы атрибуции, необходимо отключить другие сервисы, выполняющие ту же функцию. Если вы подключили аккаунт Facebook к AppsFlyer, Adjust или Branch, эти сервисы будут автоматически пересылать ваши события, если вы явно не откажетесь от этого.

Дублирование событий может исказить аналитику и затруднить интерпретацию данных. После настройки передачи событий через Adapty отключите функцию пересылки событий в сторонних сервисах.