Branch

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

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

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

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

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

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

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

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

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

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

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

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

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

  do {
      // Adapty SDK 4.x
      try await Adapty.setIntegrationIdentifier(.branchId(<BRANCH_IDENTITY_ID>))
      // Adapty SDK 3.x
      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 SDK 4.x
                  Adapty.updateAttribution(data, source: .branch)
                  // Adapty SDK 3.x
                  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;
```typescript showLineNumbers
import { adapty, AttributionSource } from 'react-native-adapty';
import branch from 'react-native-branch';
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"
  }
}

Где: