Tenjin 集成

Tenjin 是一个面向应用开发者和营销人员的移动端归因与分析平台。它提供工具来衡量和优化用户获取活动，并对应用性能和用户行为提供深入洞察。凭借透明灵活的方式，Tenjin 汇聚来自广告网络和应用商店的数据，帮助团队分析 ROI、追踪转化并监控关键绩效指标。通过将订阅事件转发到 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 连接到 Tenjin

在 Adapty 看板中打开 Integrations -> Tenjin 页面。
启用开关以激活集成。
登录 Tenjin 看板。
在导航菜单中，前往 Configuration -> Apps。
选择对应平台（iOS 或 Android）的应用，然后切换到 App and SDK 标签页。
在 App and SDK 标签页中，点击 SDK Key 列的 Copy。如果你还没有 SDK 密钥，请点击 Generate SDK Key 按钮创建一个。
返回 Adapty 看板，将复制的 SDK Key 粘贴到对应平台的字段中：
- iOS 应用：粘贴到 iOS SDK Key 或 iOS Sandbox SDK Key 字段
- Android 应用：粘贴到 Android SDK Key 或 Android Sandbox SDK Key 字段
Tenjin 的服务端集成没有专门的沙盒模式。请使用单独的 Tenjin 应用，或对生产环境和沙盒事件使用同一个 Key。

如果你同时有两个平台的应用，请针对另一个平台重复步骤 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。


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.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
    });
});


// ...
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 为是，0 为否。
currency	String	ISO 货币代码（例如，USD 代表美元）。
platform	String	设备平台（例如，ios、android、windows、amazon）。
quantity	Integer	购买的数量。
bundle_id	String	应用的 Bundle 标识符（例如，`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` 文档。