设置 Xsolla

Xsolla 是一家已与 Adjust 集成的数据分析合作伙伴。我们的集成允许 Xsolla 通过自动回传接收 Adjust 监测的数据。您可以使用合作伙伴的工具进行数据分析并获取洞见。

在本文中了解如何为您的应用设置 Xsolla 监测，其中包括激活集成，以及选择 Adjust 可以与 Xsolla 分享的数据。

操作前须知

要求​

iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

在 Campaign Lab 中选择 Xsolla 和应用

  1. 找到 Campaign Lab​ ，选择 合作伙伴​ 。
  2. 选择 新合作伙伴​ > Xsolla​ 。选择 下一步​ 进入下一界面。
  3. 在 应用选择​ 界面选择要创建链接的应用，启用集成来与 Xsolla 分享数据。
  4. 选择 下一步​ 。

启用数据分享

启用数据分享以激活与 Xsolla 的集成。要启用数据分享：

  1. 选择启用

启用与 Xsolla 的数据分享后，Adjust 会默认自动向 Xsolla 发送以下数据：

设置数据分享

如果您的多平台应用启用了多个平台的数据分享，那么可以：

  1. 通过选择 使用平台特定设置​ 来在平台层级区分数据共享设置。
  2. 通过选择 使用全局设置​ 来为多个平台应用相同的数据共享设置。

在 哪些数据会默认分享？​ 部分, 查看 Adjust 默认与 Xsolla 分享的活动：

发送额外数据

选择您想通过回传与 Xsolla 分享的数据量和数据类型。Xsolla 可能会使用此信息来优化表现。

要发送额外数据，您可以查看并自定义以下选项：

映射参数

要与 Xsolla分享自定义数据，您通常需要映射参数。

合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 Xsolla。借此，Xsolla 可以接收每个已关联事件的自定义事件详情。

在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。

如需与 Xsolla 分享合作伙伴参数，请遵循以下步骤。

  1. 在 Adjust SDK 中设置合作伙伴参数。

  2. 在 设置数据分享​ 下，选择 参数​ 。

  3. 打开 映射参数​ ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。

    1. 选择 映射参数​ 。
    2. 在 SDK 参数​ 字段中输入要与渠道分享的 SDK 参数名称。
    3. 在 合作伙伴参数​ 字段中输入 SDK 参数对应的渠道参数。
请注意:

如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享，那么 Adjust 会按照 Adjust SDK 中的名称发送参数。

为您的应用启用 Xsolla

在 设置概览​ 界面，您可以检查自己的选择，也可以返回并更改以下内容：

  • 所选应用
  • 数据分享选项

选择 启用合作伙伴​ ，为您的应用启用 Xsolla 。数据分析合作伙伴不使用推广活动链接。启用合作伙伴后，我们的集成会通过自动回传发送归因和应用内事件数据。

合作伙伴特定设置说明

Important: To ensure the data is sent correctly to Xsolla, please make sure the Parameters checkbox is selected.​

xsolla_cuid

Xsolla requires that the cuid​ be configured as a partner parameter​ in your Adjust SDK or S2S event implementations. Adjust will include this parameter in the callbacks sent to Xsolla. Xsolla then uses the provided cuid to correctly associate purchases with the specific device.

Please note: payloads lacking the cuid parameter will not be processed by Xsolla, as it would prevent proper purchase-to-device mapping.

For further details on this and any other setup requirements, you can refer to Xsolla documentation.

Sending the cuid to Xsolla​

The cuid should be set on the login event, signup or another low-frequency event. It must be sent to Adjust as a partner parameter​ . Adjust will include this parameter in the callbacks it forwards to Xsolla. On Xsolla’s side, the parameter is then used to associate purchases with the specific device.

You can send the cuid parameter in both SDK events​ and S2S events​ .

1. Sending cuid via SDK events​

To send the cuid​ as a partner parameter in SDK events, you can use the relevant SDK method for adding partner parameters. Define the key as xsolla_cuid​ and assign it the value of the cuid.

For details on how to add partner parameters in SDK events, you can refer to the guides linked below:

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

2. Sending cuid via S2S Events​

When sending S2S events, the cuid​ can be included as a partner parameter within the partner_params​ parameter. You can use the xsolla_cuid​ as the key and assign the cuid value accordingly.

For detailed instructions on sending partner parameters via S2S events, you can refer to the relevant section of S2S events documentation .

Xsolla requires you to setup the cuid as custom partner parameters in your Adjust SDK implementation. You can learn more about partner parameters here and here . Note, all payloads without the cuid parameter will not be processed by Xsolla since they'll be unable to attribute those users to the right profile. For more information about this and any other setup requirements, check out the Xsolla documentation