与Adjust集成

词汇表

Adjust

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

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

应用令牌

每个平台（Android、iOS等）独有的移动应用程序ID。在向Adjust添加应用程序时自动生成。您可以在Adjust的AppView > All apps部分中对应应用程序名称旁找到此值。

Adjust ID

由Adjust生成的用户ID。

终生价值(LTV)

用户在使用您的应用程序期间产生的平均收入。有关LTV的详细信息，请参阅Adjust文档。

广告支出回报率(ROAS)

通过计算每单位广告支出所获得的收入来衡量广告活动有效性的指标。有关ROAS的详细信息，请参阅 Adjust文档。

应用内事件

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

用户获取

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

客户用户ID (CUID)

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

注意

您需要参照说明，将CUID通过xsolla_cuid合作伙伴参数形式传递。

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

回调

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

服务器对服务器(S2S)安全令牌

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

集成场景

Adjust和艾克索拉支持移动应用S2S集成，可完成应用程序内和网页商城购买的完整LTV和ROAS衡量。艾克索拉将网页商城购买信息作为移动应用内事件发送给Adjust，然后Adjust将其归因于移动应用程序安装数量、用户获取和再互动营销活动。

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

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

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

运行机制

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    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->>Adjust: 7. Sends xsolla-billing-payment event

1. 用户(玩家)注册或登录移动应用程序。
2. 应用程序向Adjust发送应用内事件 — 例如login、signup或其他包含CUID的事件。
3. Adjust向艾克索拉发送回调，其中包括应用令牌、Adjust ID、CUID和其他相关数据参数。
4. 用户使用CUID登录网页商城。
5. 用户在网页商城中进行购买。
6. 购买事件发送到艾克索拉服务器并与从Adjust接收的数据进行匹配。
7. 艾克索拉服务器向Adjust发送S2S应用内事件，其中包含Adjust ID、应用令牌和从Adjust接收的其他参数。

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

如何在发布商帐户中设置

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

3. 在移动应用S2S集成面板中，单击配置。
4. 在打开的窗口中，确保勾选启用此集成复选框。
5. 输入以下数据：
   • Adjust S2S安全令牌。
   • 发布平台(Android/iOS)的应用令牌。要添加平台，请单击添加应用令牌。
6. 单击保存。
7. 在Adjust中启用集成。

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

要更改已连接的集成：

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

如何在Adjust中设置

在Adjust中，您需要：

1. 配置以合作伙伴参数形式传递CUID。
2. 获取S2S安全令牌。
3. 激活与艾克索拉的集成。

以合作伙伴参数形式传递CUID

请按照说明自行配置CUID传输。为此，请调用addGlobalPartnerParameter方法并传递以下数据：

• 己侧的用户ID
• forKey: “xsolla_cuid”

示例：

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

获取S2S安全令牌

要获取S2S安全令牌：

1. 登录您的Adjust帐户。
2. 打开AppView > All apps部分并前往您的应用程序页面。
3. 前往Protection选项卡。
4. 在S2S security区块中，单击Open S2S security。
5. 在包含所需S2S令牌的行中，单击复制图标。

如果还没有S2S令牌，请按照说明创建一个。

激活与艾克索拉的集成

1. 登录您的Adjust帐户。
2. 前往Campaign Lab > Partners部分。
3. 单击New partner。

4. 在搜索栏中输入并选择Xsolla。
5. 单击Next。

6. 选择要配置集成的应用程序。
7. 单击Next。
8. 启用数据共享。为此，请在Enable data sharing区块中单击Edit，将切换开关设为打开状态，然后单击Enable。

9. 配置事件映射：

1. 1. 在Map your events区块中，单击Map event。

1. 2. 在Adjust event部分，选择xsolla-billing-payment。
   3. 在Partner event部分，选择Xsolla billing payment。
   4. 单击Apply。

10. 单击Next。
11. 检查设置并单击Enable partner。如需要，可以返回之前的步骤来更新设置。

事件值结构

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

商品购买

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

其他数据

此外，您可以在回调中传递以下参数：