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

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

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

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

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

Tip

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

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

Warning

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

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

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

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

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

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

Adjust, AppsFlyer, Branch и Singular также могут получать синтетические события — сигнал о том, что триал или подписка пережили первые несколько дней. Для кампаний в Meta и TikTok Adapty Attribution предлагает Квалифицированные триалы.

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" ]
val attribution = mapOf( "status" to "non_organic", "channel" to "Google Ads", "campaign" to "Christmas Sale", "ad_group" to "ad group 1", "ad_set" to "ad set 1", "creative" to "creative id 1" )
const attribution = { status: 'non_organic', channel: 'Google Ads', campaign: 'Christmas Sale', ad_group: 'ad group 1', ad_set: 'ad set 1', creative: 'creative id 1', };
final attribution = <String, String>{ 'status': 'non_organic', 'channel': 'Google Ads', 'campaign': 'Christmas Sale', 'ad_group': 'ad group 1', 'ad_set': 'ad set 1', 'creative': 'creative id 1', };
Unity принимает данные атрибуции в виде сериализованной JSON-строки, поэтому создайте словарь и сериализуйте его:
using System.Collections.Generic; using Newtonsoft.Json; var attribution = new Dictionary<string, object> { ["status"] = "non_organic", ["channel"] = "Google Ads", ["campaign"] = "Christmas Sale", ["ad_group"] = "ad group 1", ["ad_set"] = "ad set 1", ["creative"] = "creative id 1" }; var attributionJson = JsonConvert.SerializeObject(attribution);
val attribution = mapOf( "status" to "non_organic", "channel" to "Google Ads", "campaign" to "Christmas Sale", "ad_group" to "ad group 1", "ad_set" to "ad set 1", "creative" to "creative id 1" )
const 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
    }
}

Adapty.updateExternalAttribution(attribution, AdaptyExternalAttributionProvider.CUSTOM) { error ->
    if (error == null) {
        // attribution data accepted for processing
    }
}

await adapty.updateExternalAttribution(attribution, 'custom');

await Adapty().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.custom);

Adapty.UpdateExternalAttribution(
    attributionJson,
    AdaptyExternalAttributionProvider.Custom,
    (error) => {
        // handle the error
    });

Adapty.updateExternalAttribution(
    attribution,
    AdaptyExternalAttributionProvider.CUSTOM
).onSuccess {
    // attribution data accepted for processing
}.onError { error ->
    // handle the error
}

await adapty.updateExternalAttribution({ attribution, provider: 'custom' });

Info

appliedExternalAttributionProviders сообщает об атрибуции только от Apple Ads. Атрибуция от других провайдеров отображается в профилях пользователей и доступна в фильтрах сегментов, но здесь пока не отображается. :::

Параметры:

attribution (required): словарь с данными атрибуции.
provider (required; named source before SDK version 4.1): поставщик атрибуции. Используйте значение custom, если ваш поставщик атрибуции не поддерживает интегрированную атрибуцию — .custom на iOS, AdaptyExternalAttributionProvider.CUSTOM на Android и Kotlin Multiplatform, AdaptyExternalAttributionProvider.Custom на Unity, AdaptyExternalAttributionProvider.custom на Flutter, и строку 'custom' на Capacitor и React Native. До версии SDK 4.1 передавайте строку "custom".

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

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

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

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

Если вы включите несколько источников атрибуции, Adapty выберет тот, у которого больше данных — но не обязательно более качественных.

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

После того как у профиля появляется атрибуция, данные атрибуции, которые поступают в Adapty более чем через 15 минут после создания профиля, не изменяют эту атрибуцию — даже если ваш провайдер атрибуции впоследствии переатрибутирует установку на своей стороне. Чтобы атрибуция профиля была полной, отправляйте все данные атрибуции в Adapty сразу, как только SDK атрибуции вернёт их.

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

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

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