与Singular集成

词汇表

Singular

移动端归因和营销分析平台。Singular帮助应用程序开发者、营销人员和品牌跟踪、衡量和优化­其营销活动在各种渠道和设备上的有效性。

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

应用程序ID

移动应用程序ID，值对于每个移动平台（Android、iOS等）唯一。它对应于可以在Singular中­所需应用程序的Settings > Apps部分里找到的Bundle ID值。

应用内事件

应用程序内的用户操作。有关应用内事件的详细信息，请参阅Singular文档。在S2S集成情况下，网页商城中的用户操作也被视为应用内事件，并从艾克索拉后端发送到Singular。

用户获取

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

再营销

通过广告活动触达当前或过去的用户，指唤醒之前与您的应用程序或网站互动过的用户的策略。详细信息请参阅Singular文档。

客户用户ID (CUID)

由应用程序所有者在用户注册时生成和设置的用户ID。网页商城和Singular的СUID应当保持一致。­此参数用于用户匹配和归因。

注意

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

回传

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

SDK密钥

用于授权调用以向Singular发送事件数据的令牌。由Singular侧生成。详细信息请参阅Singular文档。

集成过程

Singular和艾克索拉支持移动应用S2S集成，该集成可以帮助您衡量和评估用户获取和再营销活动在将流量吸引到网页商城方面的效果。艾克索拉将网页商城购买信息以移动应用内事件的形式发送到Singular，随后Singular将其归因到相应的来源。

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

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

通过艾克索拉和Singular S2S集成可使用以下事件：

运行机制

集成包括艾克索拉和Singular之间的双向数据流。以下是用户进行购买时的系统交互场景。

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>Xsolla Backend: 3. Sends postback
    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->>Singular: 7. Sends xsolla-billing-payment event

1. 用户(玩家)注册或登录移动应用程序。
2. 应用程序向Singular发送应用内事件，例如login或任何其他包含CUID的事件。
3. Singular向艾克索拉发送回传，其中包含CUID和其他用户设备相关数据。
4. 用户使用CUID登录网页商城。
5. 用户在网页商城进行购买。
6. 购买事件发送到艾克索拉服务器并与从Singular接收的数据进行匹配。
7. 艾克索拉服务器向Singular发送一个应用内事件，其中包含映射所需的参数。

Singular将新事件、购买和收入归因到推动实现用户获取或用户回归的媒体来源。

如何在发布商帐户中设置

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

3. 在移动应用S2S集成面板中，单击配置。
4. 在打开的窗口中，确保勾选启用此集成复选框。
5. 提供以下数据：
   1. Singular SDK密钥。
   2. 应用程序ID，值对于每个移动平台（Android、iOS等）唯一。要添加平台，请单击添加应用程序ID。
6. 单击保存。
7. 在Singular中启用集成。

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

要更改已连接的集成：

1. 单击Singular窗格。
2. 在打开的窗口中进行所需更改。
3. 单击保存。

如何在Singular中设置

在Singular中，您需要：

1. 获取SDK密钥。
2. 激活与艾克索拉的集成。

获取SDK密钥

1. 登录您的Singular帐户。
2. 打开Developer Tools > SDK Integration部分。
3. 前往SDK Keys选项卡。
4. 单击Show Keys。
5. 复制SDK Key字段中的值。

激活与艾克索拉的集成

1. 登录您的Singular帐户。
2. 前往Attribution Setup > Partner Configuration部分。
3. 单击Add Partner。
4. 在搜索栏中输入并选择Xsolla。

5. 在打开的窗口中，选择要配置集成的应用程序。
6. 单击Next。
7. 确保在Events Postbacks区块中选择了Login事件。
8. 单击Save。

事件值结构

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

商品购买

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

其他数据

除了xsolla-billing-payment事件中传递的参数，艾克索拉还发送以下数据：