Интеграция с Tenjin

Tenjin — это платформа мобильной атрибуции и аналитики для разработчиков приложений и маркетологов. Она предоставляет инструменты для измерения и оптимизации кампаний по привлечению пользователей, предлагая подробную информацию об эффективности приложений и поведении пользователей. Благодаря прозрачному и гибкому подходу Tenjin агрегирует данные из рекламных сетей и сторов, позволяя командам анализировать ROI, отслеживать конверсии и мониторить ключевые метрики эффективности. Передавая события подписок в Tenjin, вы можете точно видеть, откуда приходят конверсии и какие кампании приносят наибольшую ценность по всем каналам, платформам и устройствам. По сути, дашборды Tenjin предлагают расширенную аналитику маркетинговых кампаний.

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

Интеграция работает двумя способами:

1. Получение данных атрибуции от Tenjin После интеграции Adapty собирает данные атрибуции от Tenjin. Эту информацию можно просмотреть на странице профиля пользователя в дашборде Adapty.
2. Отправка событий подписок в Tenjin Adapty отправляет события покупок в Tenjin в режиме реального времени. Эти события помогают оценить эффективность рекламных кампаний непосредственно в дашборде Tenjin. | Характеристика интеграции | Описание | | -------------------------- | ------------------------------------------------------------ | | Расписание | В реальном времени | | Направление данных |

   Двусторонняя передача:

   • События Adapty: С сервера Adapty на сервер Tenjin
   • Атрибуция Tenjin: С SDK Tenjin на сервер Adapty
   | | Точка интеграции Adapty |
   • SDK Tenjin и Adapty в коде мобильного приложения
   • Сервер Adapty
   |

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

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

1. Откройте страницу Integrations -> Tenjin в дашборде Adapty.

2. Включите тогл, чтобы активировать интеграцию.

   

3. Войдите в Tenjin Dashboard.

4. Перейдите в Configuration -> Apps в меню навигации.

   

5. Выберите приложение для вашей платформы (iOS или Android) и перейдите на вкладку App and SDK.

6. На вкладке App and SDK нажмите Copy в столбце SDK Key. Если у вас ещё нет SDK-ключа, нажмите кнопку Generate SDK Key, чтобы создать его.

   

7. Вернитесь в дашборд Adapty и вставьте скопированный SDK Key в соответствующее поле платформы:

   • Для iOS-приложений: вставьте в поле iOS SDK Key или iOS Sandbox SDK Key
   • Для Android-приложений: вставьте в поле Android SDK Key или Android Sandbox SDK Key
   У Tenjin нет отдельного режима песочницы для серверной интеграции. Используйте отдельное приложение Tenjin или один и тот же ключ как для продакшн-, так и для sandbox-событий.

8. Если у вас есть приложения на обеих платформах, повторите шаги 5–7 для другой платформы.

9. (опционально) При необходимости настройте раздел How the revenue data should be sent. Подробное описание параметров см. в разделе Настройки интеграции.

10. Нажмите Save, чтобы завершить настройку.

Adapty начнёт отправлять события покупок в Tenjin и получать данные атрибуции. Вы можете настроить передачу событий в разделе Events names.

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

Tenjin принимает только события покупок и Trial started. В разделе Events names выберите, какие события следует передавать в Tenjin в соответствии с вашими целями отслеживания.

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

Используйте метод SDK Adapty.updateAttribution(), чтобы получить данные атрибуции от Tenjin и передать их в Adapty.

func updateTenjinId() {
    guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }

    do {
        // Adapty SDK 4.x
        try await Adapty.setIntegrationIdentifier(.tenjinAnalyticsInstallationId(tenjinId))
        // Adapty SDK 3.x
        try await Adapty.setIntegrationIdentifier(
            key: "tenjin_analytics_installation_id",
            value: tenjinId
        )
    } catch {
        // handle the error
    }
}

func updateTenjinAttribution() {
    let instance = TenjinSDK.getInstance("<YOUR_TENJIN_API_TOKEN>")
        
    instance?.getAttributionInfo { info, _ in
        guard let info else { return }

        Task {
            do {
                // Adapty SDK 4.x
                try await Adapty.updateAttribution(info, source: .tenjin)
                // Adapty SDK 3.x
                try await Adapty.updateAttribution(info, source: "tenjin")
            } catch {
                // handle the error
            }
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.getAnalyticsInstallationId(), error -> {
    if (error != null) {
        // handle the error
    }
});

tenjinSdk.getAttributionInfo(attribution -> {
    if (attribution == null) return;

    Adapty.updateAttribution(attribution, "tenjin", error -> {
        // handle the error
    });
});

try {
    final tenjinId = await TenjinSDK.instance.getAnalyticsInstallationId();
    
    if (tenjinId != null) {
        await Adapty().setIntegrationIdentifier(
            key: 'tenjin_analytics_installation_id', 
            value: tenjinId,
        );
    }

    final attribution = await TenjinSDK.instance.getAttributionInfo();
    if (attribution != null) {
        await Adapty().updateAttribution(attribution, source: 'tenjin');
    }
} catch (e) {
    // handle the error
}

using AdaptySDK;
using System.Linq;

BaseTenjin instance = Tenjin.getInstance("<SDK_KEY>");
var tenjinId = instance.GetAnalyticsInstallationId();

Adapty.SetIntegrationIdentifier(
    "tenjin_analytics_installation_id",
    tenjinId,
    (error) => {
        // handle the error
    });

instance.GetAttributionInfo((attribution) => {
    var dynamicAttribution = attribution.ToDictionary(
        kvp => kvp.Key,
        kvp => (dynamic)kvp.Value
    );
                
Adapty.UpdateAttribution(
    dynamicAttribution,
    "tenjin",
    (error) => {
        // handle the error
    });
});

// ...
const posthog = usePostHog()

// ...
try {
  await adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", await Tenjin.getAnalyticsInstallationId());
} catch (error) {
  // handle `AdaptyError`
}

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

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

{
  "price": 99.0,
  "locale": "en-US",
  "country": "ME",
  "postcut": "false",
  "currency": "USD",
  "platform": "ios",
  "quantity": 1,
  "bundle_id": "com.adapty.adaptydemoapp",
  "ip_address": "127.0.0.1",
  "os_version": "18.1.1",
  "product_id": "month.premium.99",
  "app_version": "3.2.0",
  "sdk_version": "server",
  "device_model": "iPhone 13 Mini",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "os_version_release": "18.1.1",
  "developer_device_id": "00000000-0000-0000-0000-000000000000",
  "analytics_installation_id": "00000000-0000-0000-0000-000000000000"
}

Where