如果满足以下条件，可以配置与Singular的Web SDK集成来获得高级事件分析：

• 使用Singular移动衡量平台
• 使用艾克索拉建站器

通过艾克索拉和Singular的Web SDK集成，可以使用以下事件：

运行机制

以下是实施用户获取和再营销活动时的系统交互场景。用户通过广告横幅进入网页商城并完成购买。通过在此过程中发送给Singular的事件数据可以跟踪：

• 每个横幅的点击用户数量及其来源
• 用户的支付金额
• 再营销活动的实际效果

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant SG as Singular
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>SG: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>SG: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>SG: 7. event

用户流程：

1. 用户点击广告活动横幅。
2. 用户被跳转到网页商城，此跳转的URL包含Singular参数和宏，指定了用户是从哪个横幅和网站被引导过来的。
3. 从网页商城的客户端侧向Singular发送访问事件。
4. 用户使用CUID登录网页商城。
5. 授权事件发送给Singular。
6. 用户在网页商城进行购买。
7. 购买事件发送给Singular。

如何在Singular中设置

1. 登录您的Singular帐户。
2. 前往设置(Settings) > 应用(Apps)部分。

3. 单击添加新应用(Add new app)。

4. 指定您的Web应用名称。

5. 选择Web作为操作系统。
6. 在URL字段中，填写您的网页商城域名，例如yourapp.yourcompany.com。
7. 在捆绑ID字段中，以反向DNS格式填写您的捆绑ID，例如com.yourcompany。
8. 单击保存。

如何在发布商帐户中设置

1. 在发布商帐户中打开您的项目。
2. 使用以下方法之一前往建站器：
   • 在侧边栏中，单击商店 > 网站，选择您的网站并单击配置。
   • 在侧边栏中，单击集成。在打开的部分中：
     1. 单击Singular窗格。

1. • 2. 在Web SDK（建站器）窗格中，单击配置。

2. • 3. 选择您的网站并单击配置。
     4. 在网站设置选项卡中，前往应用部分。
     5. 在Singular窗格中，单击连接。

3. 在Singular连接表单中，填写SDK密钥、SDK密钥和捆绑ID字段：

3. 要在Singular帐户中查找这些信息：
   1. 登录您的Singular帐户。
   2. 前往开发者工具 (Developer Tools) > SDK集成(SDK Integration)部分。
   3. 进入SDK密钥(SDK Keys)选项卡。
   4. 单击显示密钥(Show Keys)。
   5. 复制SDK密钥(SDK Key)字段中的值。
   6. 复制SDK密钥(SDK Secret)字段中的值。

3. 7. 要查找您的捆绑ID，请前往设置 > 应用 > Web应用并复制捆绑ID。

4. 单击连接。

如何为网页商城运营网页和应用内广告活动

请按照以下说明来运营和跟踪艾克索拉网页商城的用户获取和再营销广告活动。适用于两种情况：

• 网页到网页商城活动（将用户从网页来源引导至您网页商城的广告）
• 应用内到网页商城的再营销活动（针对您应用中的用户投放引导至网页商城的广告）

1. 登录您的Singular帐户。
2. 前往归因设置部分并选择创建Web链接(Create Web Link)。
3. 在目标（应用）(Target (App))字段中，选择与艾克索拉网页商城关联的Web应用。
4. 在合作伙伴(Partner)字段中，选择您的广告网络合作伙伴。

5. 如需要，输入着陆页路径（可选）。
6. 更新UTM字段以捕获活动详情（可选）。
7. 单击生成链接(Generate Link)。

系统将根据您的选择生成Web活动的最终目标URL。请为您的Web活动链接导流。

若需更精细的活动跟踪，您可以向生成的URL添加宏。请参考添加宏指南来附加Singular Web SDK的宏参数，以便捕获活动级数据。注意不要覆盖链接上的任何现有参数。

说明信息可能会根据所选的具体广告网络而有所调整。请始终遵循Web URL生成器中显示的广告网络具体说明。

如何在Singular中添加Web/网页商城事件

1. 登录您的Singular帐户。
2. 前往设置(Settings) > 事件(Events)部分。
3. 添加Web SDK捕获的事件：
   1. 选择应用特定事件(App specific Events)。
   2. 选择您的应用程序。
   3. 在群组事件(Cohort Events)部分，添加将在报告中显示的事件名称。
   4. 在事件映射到以下内容(Event maps to the following)字段中，选择SDK事件。
   5. 单击保存。

如何在Singular中获取网页商城广告活动的成效报告

要为网页到网页和应用内到网页广告活动生成报告：

1. 登录您的Singular帐户。
2. 前往Reports > Insights部分。
3. 配置筛选条件：
   • 设置所需日期范围。
   • 选择要分析的应用。

4. 添加维度来细分数据：
   • 来源
   • 活动名称
   • 根据需要添加其他维度

5. 选择Web指标：
   • Web新访客
   • Web再互动访客

6. 包含群组数据：
   • 收入
   • ROI
   • 之前在设置(Settings) > 事件(Events)页面上配置的任何自定义群组事件

7. 单击右上角的运行报告(Run report)。

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

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

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

运行机制

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

  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事件中传递的参数，艾克索拉还发送以下数据：