Начало работы с Adapty Attribution

Adapty Attribution помогает связать расходы на рекламу с доходами от подписок в кампаниях web-to-app, давая полное представление об экономике приложения в одном месте.

Чтобы видеть данные о доходах в Adapty Attribution, сначала нужно включить интеграцию в дашборде Adapty. Передавать API-ключи, токены или идентификаторы не требуется. Просто обновите и настройте SDK.

Прежде чем начать

Чтобы связать данные о доходах с эффективностью кампаний, позвольте Adapty отслеживать ваши покупки:

• Если вы уже реализовали встроенные покупки с помощью Adapty, на этом этапе ничего дополнительно делать не нужно.
• Если вы ещё не реализовали встроенные покупки и хотите использовать Adapty, выполните шаги из руководства по быстрому старту, чтобы делегировать обработку покупок Adapty.
• Если вы уже реализовали встроенные покупки без Adapty и не планируете переходить на Adapty, установите SDK для вашей платформы в режиме наблюдателя. На этом этапе нужно только добавить SDK в проект, активировать его с включённым режимом наблюдателя и передавать транзакции: Эта настройка обеспечивает атрибуцию из веба в приложение:
• Когда пользователи устанавливают ваше приложение, SDK получает детали установки из параметров ссылки, чтобы Adapty Attribution мог получить данные о кампании
• SDK знает обо всех событиях, связанных с доходом внутри приложения, и может атрибутировать их к веб-кампаниям.

Шаг 1. Включите Adapty Attribution в SDK

Начиная с версии Adapty SDK 4.1, Adapty Attribution отключена по умолчанию. Чтобы SDK регистрировал установки и передавал сведения об установке в ваше приложение, включите её при активации SDK:

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(adaptyAttributionEnabled: true)

val config = AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build()

Adapty.activate(applicationContext, config)

AdaptyConfig config = new AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build();

Adapty.activate(getApplicationContext(), config);

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    adaptyAttributionEnabled: true,
  }
});

В версиях SDK ниже 4.1 Adapty Attribution включается автоматически — никаких изменений в коде не требуется.

Шаг 2. Откройте Adapty Attribution

Нажмите на логотип Adapty в шапке и выберите Attribution.

События подписок начнут поступать в Adapty Attribution автоматически. Данные о кампаниях появятся после подключения источника данных на шаге 3.

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

Поддерживаемые события

По умолчанию Adapty отправляет в User Acquisition три группы событий:

• Пробные периоды (Trials)
• Подписки
• Проблемы (Issues)

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

Шаг 3. Подключите рекламную платформу и добавьте ссылки для отслеживания

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

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

Adapty взаимодействует с рекламными платформами двумя способами:

• Нативные интеграции (Meta Ads, TikTok Ads). Adapty подключается напрямую к рекламной платформе. Трекинговые ссылки генерируются автоматически, а параметры кампании заполняются динамически в зависимости от того, где используется ссылка. Одну и ту же ссылку можно применять в разных кампаниях, группах объявлений или креативах — Adapty автоматически получит корректные данные о кампании и расходах на рекламу.

• Только трекинговые ссылки (все остальные рекламные платформы). Adapty не подключается к рекламной платформе. Трекинговые ссылки создаются вручную, и все параметры кампании должны быть заданы явно при создании ссылки. Данные о расходах на рекламу для этих платформ недоступны.

Чтобы создать трекинговую ссылку для Meta Ads:

1. Перейдите в Integrations > Meta в дашборде Adapty Attribution и нажмите Continue with Facebook.

2. Войдите с помощью аккаунта Facebook и нажмите Continue.

3. Ознакомьтесь с запрашиваемыми разрешениями и нажмите Save.
4. Перейдите на вкладку Web campaigns и нажмите Create campaign. Выберите приложение и нажмите Save.

5. На вкладке General раскройте раздел iOS и/или Android и вставьте URL приложения из App Store и/или Google Play. Затем нажмите Save.

6. Скопируйте значение поля Click link для одной ссылки или для ссылки под конкретную платформу. Затем откройте ваше объявление в Meta Ads Manager и вставьте эту ссылку в качестве URL назначения.

Important

В поле Website URL вставьте https://api-ua.adapty.io/api/v1/attribution/click. Остальную часть ссылки вставьте в поле URL parameters в разделе Tracking. Это поможет вашему объявлению в Meta пройти модерацию. Подробнее см. рекомендации по настройке объявлений в Meta Ads Manager.

7. Теперь, когда вы запустите рекламу в Meta Ads, её данные станут доступны для анализа в дашборде Adapty Attribution.

Чтобы создать ссылку отслеживания для TikTok for Business:

1. Перейдите в Integrations > TikTok Ads в дашборде Adapty Attribution и нажмите Continue with TikTok.

   

2. Войдите с помощью вашего аккаунта TikTok и нажмите Continue.

3. Ознакомьтесь с запрашиваемыми разрешениями и нажмите Save.

   

4. Переключитесь на вкладку Web campaigns и нажмите Create campaign. Выберите приложение и нажмите Save.

   

5. На вкладке General раскройте раздел iOS и/или Android и вставьте URL приложения из App Store и/или Google Play. Затем нажмите Save.

   

6. Скопируйте значение поля Click link для одной ссылки или для ссылки под конкретную платформу. Затем в TikTok Ads Manager при создании объявления вставьте это значение в поле Tracking URL в разделе Advanced Settings. Это позволит Adapty связывать установки и покупки с объявлениями в TikTok. Смотрите гайд по настройке кампании в TikTok Ads.

   

7. После запуска объявления в TikTok for Business его данные станут доступны для анализа в дашборде атрибуции Adapty.

Чтобы создать трекинговую ссылку для других рекламных платформ:

1. В дашборде Adapty Attribution откройте Integrations и выберите карточку Custom в группе Network. Затем нажмите Create link.

   

2. Выберите приложение из списка и нажмите Next.

   

3. Заполните параметры ссылки, чтобы связать её с нужной кампанией и рекламным объявлением.

4. По умолчанию создаётся One Link. Он автоматически определяет платформу пользователя и перенаправляет его в App Store или Google Play после отслеживания клика.

   Если вы предпочитаете использовать отдельные URL перенаправления для каждой платформы, снимите флажок One Link и укажите ссылки на сторы для каждой платформы вручную.

   

5. Нажмите Create.

6. Откройте страницу отслеживающей ссылки и скопируйте Click link из одного из разделов:

   • One link — используйте эту ссылку для отслеживания кликов с автоматическим перенаправлением пользователей в нужный стор.
   • iOS link или Android link — опциональные версии ссылок для конкретной платформы, если нужны отдельные ссылки для каждого стора.

7. Перейдите на платформу управления рекламой и вставьте ссылку в объявление в качестве URL-адреса назначения.

Шаг 4. Запустите кампанию web-to-app и посмотрите результаты

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

В дашборде аналитики атрибуции Adapty вы увидите метрики на уровне кампании:

• Установки и конверсии
• Доходы от подписок и покупок
• Разбивка по рекламным платформам, кампаниям, группам объявлений и креативам

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

Узнать больше

Продолжите изучение с подробной документацией по аналитике атрибуции Adapty и практическими гайдами по запуску кампаний на крупнейших рекламных платформах:

• Аналитика в Adapty Attribution: Как эффективно использовать дашборд аналитики.
• Метрики в Adapty Attribution: Метрики, доступные для анализа привлечения пользователей.
• Интеграции: Рекламные платформы и интеграции, поддерживаемые Adapty Attribution.
• Запуск рекламы в Meta Ads Manager: Как настроить и запустить кампании в Meta Ads Manager.
• Запуск рекламы в TikTok for Business: Как настроить и запустить кампании в TikTok for Business.