Tenjin 集成

Tenjin 是一款面向应用开发者和营销人员的移动归因与分析平台。它提供工具来衡量和优化用户获取活动，深入分析应用性能和用户行为。凭借透明灵活的方式，Tenjin 整合来自广告网络和应用商店的数据，帮助团队分析投资回报率、追踪转化并监控关键绩效指标。

通过将订阅事件转发至 Tenjin，您可以精确了解转化来源，以及哪些广告系列在所有渠道、平台和设备上带来了最高价值。本质上，Tenjin 看板为营销活动提供了高级分析能力。

通过将 Tenjin 的归因数据转发至 Adapty，您可以为 Adapty 分析数据添加额外的筛选条件，用于同期群和转化分析。

本集成以两种主要方式运作：

从 Tenjin 接收归因数据 集成后，Adapty 将收集来自 Tenjin 的归因数据。您可以在 Adapty 看板的用户画像页面上查看这些信息。
向 Tenjin 发送订阅事件 Adapty 实时向 Tenjin 发送购买事件。这些事件有助于直接在 Tenjin 看板中评估广告活动的效果。

集成特性	描述
调度方式	实时
数据方向	双向传输： Adapty 事件：从 Adapty 服务器到 Tenjin 服务器 Tenjin 归因：从 Tenjin SDK 到 Adapty 服务器
Adapty 集成点	移动应用代码中的 Tenjin 和 Adapty SDK Adapty 服务器

集成特性

描述

调度方式

实时

数据方向

双向传输：

Adapty 事件：从 Adapty 服务器到 Tenjin 服务器
Tenjin 归因：从 Tenjin SDK 到 Adapty 服务器

Adapty 集成点

移动应用代码中的 Tenjin 和 Adapty SDK
Adapty 服务器

设置集成

将 Adapty 连接到 Tenjin

在 Adapty 看板中打开 Integrations -> Tenjin 页面。
启用开关以激活集成。
登录 Tenjin 看板。
在导航菜单中前往 Configuration -> Apps。
选择您平台（iOS 或 Android）对应的应用，然后导航至 App and SDK 标签页。
在 App and SDK 标签页中，点击 SDK Key 列中的 Copy。如果您尚未有 SDK 密钥，请点击 Generate SDK Key 按钮创建一个。
返回 Adapty 看板，将复制的 SDK 密钥粘贴到对应平台的字段中：
- 对于 iOS 应用：粘贴到 iOS SDK Key 或 iOS Sandbox SDK Key 字段
- 对于 Android 应用：粘贴到 Android SDK Key 或 Android Sandbox SDK Key 字段
Tenjin 没有针对服务器到服务器集成的专用沙盒模式。请使用独立的 Tenjin 应用，或对生产环境和沙盒事件使用相同的密钥。
如果您在两个平台上都有应用，请对另一个平台重复步骤 5-7。
（可选）根据需要调整 How the revenue data should be sent 部分。有关其设置的详细说明，请参阅集成设置。
点击 Save 完成设置。

Adapty 现在将向 Tenjin 发送购买事件并接收归因数据。您可以在 Events names 部分调整事件共享设置。

配置事件和标签

Tenjin 仅接受购买事件和 Trial started 事件。在 Events names 部分，选择要与 Tenjin 共享的事件，以符合您的追踪目标。

将应用连接到 Tenjin

使用 Adapty.updateAttribution() SDK 方法从 Tenjin 获取归因数据，并将其传递给 Adapty。

import TenjinSDK

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

    do {
        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 {
                try await Adapty.updateAttribution(info, source: "tenjin")
            } catch {
                // handle the error
            }
        }
    }
}

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

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

    Adapty.updateAttribution(attribution, "tenjin") { error ->
        if (error != null) {
            // 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
    });
});

import { adapty } from 'react-native-adapty';
import Tenjin from 'react-native-tenjin';

// ...
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"
}

其中

参数	类型	描述
price	Float	所购商品以货币标准单位计价的单价（例如，USD 以美元报告）。
locale	String	设备的区域设置。Android：`Locale.getDefault().toString()`。iOS：`[[NSLocale currentLocale] localeIdentifier]`。
country	String	ISO 区域国家代码标准（例如，US 代表美国）。
postcut	String (Boolean)	指示购买是否在扣除平台分成后发送。1 为 true，0 为 false。
currency	String	ISO 货币代码（例如，USD 代表美元）。
platform	String	设备平台（例如，ios、android、windows、amazon）。
quantity	Integer	购买的单位数量。
bundle_id	String	应用的包标识符（例如，`com.example.app`）。
ip_address	String (IPv4)	用户的 IP 地址，用于查找国家。
os_version	String	设备的操作系统版本。Android：`String.valueOf(Build.VERSION.SDK_INT)`。iOS：`[[UIDevice currentDevice] systemVersion]`。
product_id	String	所购产品的唯一标识符。
app_version	Float, Decimal	应用版本。Android：`context.getPackageManager().getPackageInfo()`。iOS：`[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"]`。
sdk_version	String	使用的 SDK 版本，始终设置为 `server`。
device_model	String	设备型号。Android：`Build.MODEL`。iOS：`sysctl("hw.machine")`。
advertising_id	UUID	设备的广告 ID。Android 必填。iOS 可为空或全零。
os_version_release	String	操作系统发行版本。Android：`String.valueOf(Build.VERSION.RELEASE)`。iOS：`[[UIDevice currentDevice] systemVersion]`。
developer_device_id	UUID	供应商标识符（仅 iOS）。
analytics_installation_id	UUID	分析安装 ID。详情请参阅 `https://docs.tenjin.com` 上的文档。