概要:Xsolla是AppsFlyer的对接合作伙伴,专注于游戏电商技术,尤其擅长处理非传统应用商店平台的支付流程。通过与AppsFlyer的对接,Xsolla可将Web Shop中的购买与收入数据自动回传至AppsFlyer,呈现完整ROAS和LTV数据,包括在Xsolla Web Shop中完成的交易。
重要提示!
部分渠道限制第三方的数据共享。 这时,我们不会向渠道发送受限事件的回传,不论您是否在回传配置部分选择了该事件。
对接类型
您可采取两种方式与Xsolla对接:
- 技术合作伙伴对接:通过此方式,Xsolla可将Web Shop中的购买与收入数据作为移动端应用内事件发送至AppsFlyer,从而在标准应用商店购买之外,进一步提升移动端广告活动的ROAS和LTV表现。
- PBA Web SDK对接;通过此方式,Xsolla可将Web Shop中的购买与收入作为网页事件发送至AppsFlyer,对网页端广告活动效果进行衡量,并将游戏用户直接引导至Web Shop。
前期准备:
- 设置对接前,请务必先联系该渠道并在其平台上开设账户。
- 为确保对接正常运行,请将Customer User ID(CUID)与AppsFlyer共享,并确保CUID与提供给Xsolla的用户ID一致。只有完成这一步骤,用户才能成功登录Xsolla的Web Shop,其数据才能被准确归因并同步到AppsFlyer中。
设置技术合作伙伴对接
请按以下方式启用或修改该对接:
-
启用方式:从AppsFlyer的侧边栏中选择协作 > Partner Marketplace。
修改方式:从AppsFlyer面板左侧的菜单栏中选择协作 > 活跃对接。 - 搜索并选择相关渠道。
- 点击设置对接,界面会跳转到对接设置页。
- 进入渠道对接选项卡,选择需要对接的应用,并打开启用该渠道开关。
请注意:在您与该渠道合作期间,请确保该开关总是处于打开(启用)状态。 - 请按照下文说明,在各个选项卡中完成相关的对接配置。
此时您仅可使用配置窗口中的对接选项卡。
如需进一步了合作伙伴配置页面中各选项卡的详细说明,请参考此文档。
渠道对接选项卡
启用渠道
请在首次访问该页面时打开启用该渠道开关,然后就可以设置对接了。在您与Xsolla合作期间,请确保该开关总是处于打开状态。详情请见渠道启用说明。
高级隐私保护
iOS应用的面板中会显示高级隐私开关,此开关打开时可限制渠道共享用户标识符。请注意:如果您在应用配置中打开了汇总层级的高级隐私开关,AppsFlyer会默认开启并锁定高级隐私(适用于iOS 14.5及以上版本)。
默认回传
用户激活应用后,AppsFlyer会向Xsolla发送默认回传。详情请参考回传设置说明。
-
关闭:不向Xsolla发送激活回传。
请注意:Xsolla与AppsFlyer的对接时不要求发送激活回调。因此,建议您将其设置为关闭。 - 所有媒体渠道,包括自然流量:发送来自所有渠道以及自然流量的激活回传。
应用内事件回传
这部分选项用于设置AppsFlyer事件与渠道之间的映射与回传。
- 打开应用内事件回传开关。
- 点击添加事件,将SDK事件或S2S事件添加到列表中。
- 请配置以下参数:
参数名称 说明 AppsFlyer事件 事件的名称,即AppsFlyer从SDK侧接收到的事件名称或来自S2S事件的名称。
请注意:
- 对于Xsolla,请务必添加af_login事件,或其他能代表用户登录移动应用的事件(如上方截图所示)。
- 建议您不要发送过于频繁的事件,并避免在此类事件中包含CUID(例如af_app_opened),否则可能会导致对接无法正常运行。
渠道映射事件 请输入向Xsolla发送的事件名称。Xsolla在事件命名方面没有限制,你可以在此字段中使用任意名称。 事件来源 选择所有媒体渠道,包括自然流量:发送来自所有渠道以及自然流量的激活回传。 回传内容 - 不发送值与收入:仅发送不带任何参数的事件本身(即没有值或收入)。
- 仅发送值:发送除收入以外的所有参数。
- 发送值与收入:发送所有事件参数,包括收入(若有)。
- 点击保存对接 。
归因链接选项卡
Xsolla不支持归因链接。
成本选项卡
Xsolla的渠道对接不支持成本数据。
广告收入选项卡
Xsolla的渠道对接不支持广告收入数据。
授权选项卡
权限设置不适用于Xsolla。
设置PBA Web SDK对接
对接后,您可以在PBA面板中查看LTV(数据与相关洞察,分析应用表现。
如需设置对接:
-
在AppsFlyer后台:添加Xsolla应用。将平台选择为Web(PBA),并填写以下信息:
- 将你的Web Shop域名用作Web app URL,例如:如果你的Web Shop域名是www.webshop.com,则该URL即为你的Web app URL。
- 应用名称可设置为任意值。
-
在AppsFlyer后台进行如下操作:添加Xsolla套件,详细信息如下:
-
- 套件名称可设置为任意名称。
- 选择你在上一步创建的网页应用。
-
-
在Xsolla中进行如下操作:将AppsFlyer与您的Xsolla Publisher账户连接:
- 在Publisher账户中打开您的项目。
- 选择您的站点并单击配置。
- 在站点设置选项卡中,转到应用程序部分。
- 在AppsFlyer模块中,点击连接。
- 在AppsFlyer Dev Key字段中,输入 AppsFlyer 网络开发者密钥。请参见下文了解如何在 AppsFlyer 中获取密钥。
- 点击连接。
在AppsFlyer中查找网络开发者密钥
- 在我的应用页面,点击查看品牌套件。
- 点击Xsolla套件上的复制图标。
在AppsFlyer中识别Xsolla的事件
技术合作伙伴 (S2S) 对接方式:
Xsolla会向AppsFlyer发送2类应用内事件:
- xsolla-billing-payment - 代表用户完成了一项购买
- xsolla-billing-refund - 代表用户发起了购买退款
这两个事件都会作为应用内事件出现在AppsFlyer中。
Web SDK对接方式:
Xsolla会根据具体广告主的业务活动,向AppsFlyer发送多个网页事件。其中最重要的事件是名为 "PURCHASE" 的事件,该事件包含收入信息。
Xsolla的网页事件将展示在PBA的网页归因数据中,并可在DataLocker的“网页事件”原始数据报告中查看。
特点与局限性
PC / 主机端 - 目前,AppsFlyer与Xsolla的对接不支持PC或主机端应用。