将Xsolla与AppsFlyer对接

概要: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中。

设置技术合作伙伴对接

请按以下方式启用或修改该对接:

  1. 启用方式:从AppsFlyer的侧边栏中选择协作 > Partner Marketplace
    修改方式:从AppsFlyer面板左侧的菜单栏中选择协作 > 活跃对接
  2. 搜索并选择相关渠道。
  3. 点击设置对接,界面会跳转到对接设置页。
  4. 进入渠道对接选项卡,选择需要对接的应用,并打开启用该渠道开关。
    请注意:在您与该渠道合作期间,请确保该开关总是处于打开(启用)状态。
  5. 请按照下文说明,在各个选项卡中完成相关的对接配置。

此时您仅可使用配置窗口中的对接选项卡。

如需进一步了合作伙伴配置页面中各选项卡的详细说明,请参考此文档

渠道对接选项卡

启用渠道

请在首次访问该页面时打开启用该渠道开关,然后就可以设置对接了。在您与Xsolla合作期间,请确保该开关总是处于打开状态。详情请见渠道启用说明。 

高级隐私保护

iOS应用的面板中会显示高级隐私开关,此开关打开时可限制渠道共享用户标识符。请注意:如果您在应用配置中打开了汇总层级的高级隐私开关,AppsFlyer会默认开启并锁定高级隐私(适用于iOS 14.5及以上版本)

默认回传

用户激活应用后,AppsFlyer会向Xsolla发送默认回传。详情请参考回传设置说明

  • 关闭:不向Xsolla发送激活回传。
    请注意:Xsolla与AppsFlyer的对接时不要求发送激活回调。因此,建议您将其设置为关闭。
  • 所有媒体渠道,包括自然流量:发送来自所有渠道以及自然流量的激活回传。

default_postbacks.png

应用内事件回传

这部分选项用于设置AppsFlyer事件与渠道之间的映射与回传。 

xsolla-af-login-3.jpg

  1. 打开应用内事件回传开关。
  2. 点击添加事件,将SDK事件或S2S事件添加到列表中。
  3. 请配置以下参数:
    参数名称 说明
    AppsFlyer事件

    事件的名称,即AppsFlyer从SDK侧接收到的事件名称或来自S2S事件的名称。

    请注意:

    • 对于Xsolla,请务必添加af_login事件,或其他能代表用户登录移动应用的事件(如上方截图所示)。
    • 建议您不要发送过于频繁的事件,并避免在此类事件中包含CUID(例如af_app_opened),否则可能会导致对接无法正常运行。
    渠道映射事件 请输入向Xsolla发送的事件名称。Xsolla在事件命名方面没有限制,你可以在此字段中使用任意名称。
    事件来源 选择所有媒体渠道,包括自然流量:发送来自所有渠道以及自然流量的激活回传。
    回传内容
    • 不发送值与收入:仅发送不带任何参数的事件本身(即没有值或收入)。
    • 仅发送值:发送收入以外的所有参数。
    • 发送值与收入:发送所有事件参数,包括收入(若有)。
    请注意: Xsolla与AppsFlyer的对接并不要求发送值或收入,因此上述任意选项均可使用。 
  4. 点击保存对接

归因链接选项卡

Xsolla不支持归因链接。

成本选项卡

Xsolla的渠道对接不支持成本数据。

广告收入选项卡

Xsolla的渠道对接不支持广告收入数据。

授权选项卡

权限设置不适用于Xsolla。

设置PBA Web SDK对接

对接后,您可以在PBA面板中查看LTV(数据与相关洞察,分析应用表现。

如需设置对接:

  1. 在AppsFlyer后台:添加Xsolla应用。将平台选择为Web(PBA),并填写以下信息:
    • 将你的Web Shop域名用作Web app URL,例如:如果你的Web Shop域名是www.webshop.com,则该URL即为你的Web app URL。
    • 应用名称可设置为任意值。
  2. 在AppsFlyer后台进行如下操作:添加Xsolla套件,详细信息如下:
    1.  
      1. 套件名称可设置为任意名称。
      2. 选择你在上一步创建的网页应用。
  3. 在Xsolla中进行如下操作:将AppsFlyer与您的Xsolla Publisher账户连接:
    1. Publisher账户中打开您的项目。
    2. 选择您的站点并单击配置
    3. 站点设置选项卡中,转到应用程序部分。
    4. AppsFlyer模块中,点击连接
      xsolla-connect.jpg
    5. AppsFlyer Dev Key字段中,输入 AppsFlyer 网络开发者密钥。请参见下文了解如何在 AppsFlyer 中获取密钥
    6. 点击连接

在AppsFlyer中查找网络开发者密钥

  1. 我的应用页面,点击查看品牌套件
  2. 点击Xsolla套件上的复制图标。

xsolla-brand-bundle2.jpg

在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或主机端应用。