Branch

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

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

Интеграция между Adapty и Branch работает двумя способами.

1. Получение данных атрибуции из Branch
   После настройки интеграции Adapty начнёт получать данные атрибуции из Branch. Просматривать эти данные можно на странице профиля пользователя.

   

2. Отправка событий подписок в Branch
   Adapty может отправлять все события подписок, настроенные в интеграции, в Branch. В результате вы сможете отслеживать эти события в дашборде Branch и связывать их с вашими рекламными кампаниями.

Настройка интеграции

Подключение Adapty к Branch

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

Чтобы получить значение для поля Branch Key, откройте настройки аккаунта Branch и найдите поле Branch Key. Используйте его в поле Key test (для песочницы) или Key live (для продакшена) в дашборде Adapty. В Branch переключайтесь между окружениями Live и Tests для получения нужного ключа.

Настройка событий и тегов

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

Вы можете отправлять события с выручкой после вычета комиссии Apple/Google или только с доходом. Также можно включить отчётность в валюте пользователя.

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

Adapty отправляет события подписок в Branch через server-to-server интеграцию, что позволяет просматривать все события подписок в дашборде Branch и связывать их с вашими рекламными кампаниями.

Подключение приложения к Branch

1. Вызовите метод SDK .setIntegrationIdentifier() для инициализации соединения. Вы можете передать Branch Identity ID в параметр customerUserId.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "branch_id", 
        value: <BRANCH_IDENTITY_ID>
    )
} catch {
    // handle the error
}

// login and update attribution and identifier
Branch.getAutoInstance(this)
    .setIdentity("YOUR_USER_ID") { referringParams, error ->
        referringParams?.let { data ->
            Adapty.updateAttribution(data, "branch") { error ->
                if (error != null) {
                    //handle the error
                }
            }
        }
    }

// logout
Branch.getAutoInstance(context).logout()

import 'package:flutter_branch_sdk/flutter_branch_sdk.dart';

FlutterBranchSdk.setIdentity('YOUR_USER_ID');

Branch.setIdentity("your user id");

import branch from 'react-native-branch';

branch.setIdentity('YOUR_USER_ID');

2. Используйте метод .updateAttribution() для сохранения данных атрибуции. Если вы не указали Branch user ID на предыдущем шаге, передайте его в параметр networkUserId здесь.

class YourBranchImplementation {
    func initializeBranch() {
        // Pass the attribution you receive from the initializing method of Branch iOS SDK to Adapty.
        Branch.getInstance().initSession(launchOptions: launchOptions) { (data, error) in
            if let data {
                Adapty.updateAttribution(data, source: .branch)
            }
        }
    }
}

//everything is in the above snippet for Android

try {
    await Adapty().setIntegrationIdentifier(
        key: "branch_id", 
        value: <BRANCH_IDENTITY_ID>,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

Branch.initSession(delegate(Dictionary<string, object> parameters, string error) {
    string attributionString = JsonUtility.ToJson(parameters);
    
    Adapty.UpdateAttribution(
      attributionString, 
      "branch", 
      (error) => {
        // handle the error
    });
});

import { adapty, AttributionSource } from 'react-native-adapty';

branch.subscribe({
  enComplete: ({
    params,
  }) => {
    adapty.updateAttribution(params, "branch");
  },
});

Структура события

Adapty отправляет выбранные события в Branch в соответствии с настройками в разделе Events names на странице интеграции Branch. Каждое событие имеет следующую структуру:

{
  "branch_key": "key_live_kaFuWw8WvY7n1ss7...",
  "name": "PURCHASE",
  "user_data": {
    "os": "iOS",
    "developer_identity": "user_12345",
    "country": "US",
    "ip": "192.168.100.1",
    "idfa": "00000000-0000-0000-0000-000000000000",
    "idfv": "00000000-0000-0000-0000-000000000000",
    "aaid": "00000000-0000-0000-0000-000000000000"
  },
  "event_data": {
    "transaction_id": "GPA.3383-4699-1373-07113",
    "revenue": 9.99,
    "currency": "USD"
  },
  "custom_data": {
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383-4699-1373-07113",
    "store": "play_store",
    "environment": "production"
  }
}

Где: