与Tenjin集成

词汇表

Tenjin

移动归因和营销分析平台，帮助应用程序开发者和营销人员跨渠道、跨设备跟踪、衡量和优化营销活动。

有关该平台的详细信息，请参阅Tenjin文档。

应用程序ID

向Tenjin添加应用程序时自动生成的移动应用程序ID，对应Bundle ID。获取方式：

1. 在Tenjin帐户中，前往Configure > All apps部分。
2. 打开目标应用程序页面。
3. 在Add details部分复制Bundle ID。

SDK密钥

向Tenjin添加应用程序时自动生成的移动应用程序ID，对应Bundle ID。获取方式：

1. 在Tenjin帐户中，前往Configure > All apps部分。
2. 打开目标应用程序页面。
3. 在Add details部分复制Bundle ID。

注：

若您的应用程序同时发布在iOS和Android平台，需获取帐户级密钥，请联系您的Tenjin客户经理。

帐户级密钥

当应用程序同时发布在iOS和Android平台时，用于授权服务器到服务器(S2S)调用的令牌，由Tenjin手动生成。如需获取，请联系您的Tenjin客户经理。

请注意，每个平台的bundle ID均为唯一值。

Tenjin ID

由Tenjin生成的用户ID (analytics_installation_id)。

终生价值(LTV)

用户在使用您的应用程序期间产生的平均收入。有关LTV的详细信息，请参阅Tenjin文档。

广告支出回报率(ROAS)

衡量广告活动有效性的指标，通过计算每单位广告支出产生的收入得出。详细信息请参阅Tenjin文档。

投资回报率(ROI)

衡量投资回报的指标，通过计算利润占总成本的百分比得出。详细信息请参阅Tenjin文档。

应用内事件

应用程序内的用户操作。在S2S集成场景下，网页商城中的用户操作也属于应用内事件，由艾克索拉后端发送至Tenjin。

用户获取

通过营销活动吸引新用户到网站、服务、平台或应用程序的过程。

客户用户ID (CUID)

应用程序所有者在用户注册时生成并设置的用户ID。网页商城和Tenjin中的СUID应保持一致，以实现用户匹配和归因。

注意

如果网页商城和您的移动应用程序中的CUID不匹配，请联系您的客户成功经理或发送邮件至csm@xsolla.com以实现网页商城中的用户验证Webhook或通过深度链接进行身份认证。

回调

接收应用内事件数据的过程。详细信息请参阅Tenjin文档。

集成场景

Tenjin和艾克索拉支持移动应用程序S2S集成，可完整衡量应用程序内购买和网页商城购买的LTV、ROAS和ROI。艾克索拉将网页商城购买信息以移动应用内事件形式发送至Tenjin，Tenjin随后将其归因至移动应用程序安装量和用户获取活动。

如果符合以下条件，可以配置移动应用程序集成以获得高级事件分析：

• 拥有Android/iOS平台的移动应用程序
• 使用Tenjin
• 使用网页商城解决方案销售游戏内商品

艾克索拉与Tenjin S2S集成支持以下事件：

运行机制

该集成实现艾克索拉与Tenjin之间的双向数据流。用户购买时的系统交互流程如下。

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Tenjin: 7. Sends xsolla-billing-payment event

1. 用户注册或登录移动应用程序。
2. 您的应用程序向Tenjin发送包含CUID的应用内事件。
3. Tenjin向艾克索拉发送回调，包含应用程序ID、Tenjin ID、CUID及其他相关数据参数。
4. 用户使用CUID登录网页商城。
5. 用户在网页商城进行购买。
6. 购买事件发送至艾克索拉服务器，并与从Tenjin接收的数据进行匹配。
7. 艾克索拉服务器向Tenjin发送S2S应用内事件，包含Tenjin ID、应用程序ID及从Tenjin接收的其他参数。

Tenjin将新事件、购买和收入归因至媒体来源。

如何在发布商帐户中设置

1. 在发布商帐户中打开您的项目，前往集成部分。
2. 单击Tenjin窗格。

3. 在移动应用S2S集成面板中，单击配置。
4. 勾选启用此集成复选框。
5. 输入以下数据：
   • Tenjin侧为各平台生成的SDK密钥。若应用程序同时发布在iOS和Android平台，需指定从Tenjin获取的帐户级密钥。
   • 应用程序ID。
6. 单击保存。
7. 在Tenjin中启用集成。

保存设置后，S2S集成面板上将显示一个绿色指示器。

要修改已激活的集成：

1. 单击Tenjin窗格。
2. 在打开的窗口中进行必要修改。
3. 单击保存。

如何在Tenjin中配置

在Tenjin中需完成以下配置：

1. 配置向Tenjin传递CUID。
2. 将艾克索拉添加为广告渠道。
3. 配置回调。

传递CUID

调用setCustomerUserId方法，配置从移动应用程序向Tenjin传递CUID：

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

添加艾克索拉为广告渠道

1. 登录您的Tenjin帐户。
2. 前往Configure > Channels部分。
3. 单击Add a channel。

4. 在搜索栏中输入并选择Xsolla。
5. 单击Xsolla窗格。

6. 单击Add ad account。

配置回调

1. 登录您的Tenjin帐户。
2. 前往Configure > Channels部分。
3. 前往目标应用程序页面。
4. 前往Callbacks选项卡。
5. 在广告渠道下拉列表中选择Xsolla。

6. 在Channel callbacks部分，单击Add events并选择Xsolla login。

7. 在模态窗口中选择包含CUID的事件，然后单击Save。

事件值结构

如果想设置特定事件或当前集成方案无法满足您的需求，请联系您的客户成功经理或发送邮件至csm@xsolla.com。

商品购买

当用户在网页商城中进行购买时，艾克索拉向Tenjin发送xsolla-billing-payment事件。事件参数中传递以下购买信息：

其他数据

此外，您可以在回调中传递以下参数：