邀请活动注册与管理

UA（游戏邀请）是吸引更多游戏用户的有效功能。请查看以下流程以使用该功能。

UA 过程¶

1. 开发用户代理¶

• 为用户获取开发用户界面
• 开发邀请成就活动和奖励
• 开发分享用户获取的方法
• 开发游戏介绍页面

2. 注册 UA 后台¶

• 注册应用
• 注册CPA（使用CPA时）
• 为活动和奖励设置注册促销

3. 实现 UA¶

• 实现UA开发
• 应用UA API

4. 运行测试¶

• 检查邀请的URL和二维码信息是否正常。
• 检查邀请完成次数等结果是否正常。
• 检查CPA日志是否正确传输。
• 检查完成UA活动后奖励是否正确发放等。

开发 UA¶

在这个阶段，您将能够开发活动的内容、奖励、用户获取界面等。

负责人：开发团队或负责业务的个人

[活动图片示例 – 链击]

邀请类型¶

• 邀请游戏好友：您可以通过邀请链接邀请好友加入游戏并获得奖励。每位邀请者会发放一个邀请链接。
• 奖励链接：通过链接安装的用户可以获得奖励。没有单独的邀请者，发放一个统一的URL。
• 发放邀请码：启动游戏后，输入邀请码以与好友匹配并获得奖励。无需单独的链接，每位邀请者会发放一个邀请码。

问题邀请链接¶

在注册邀请活动之前，需要先在促销设置菜单的基本设置和CPA设置中注册以下内容。

基本设置¶

让我们简要了解UA活动注册的前期工作。有关其他应用设置的更多详细信息，请参阅 推广设置。

首先，您需要在应用设置中为新游戏注册一个应用。无论市场类型如何，游戏只需注册一次，您可以通过单击游戏管理名称来编辑注册的游戏信息，这将显示一个编辑页面。在基本设置中，游戏名称和游戏方向是必填项，您可以稍后填写其余信息。为了使用UA，您需要选择一个应用ID并在应用ID设置中输入下载URL。

1. 在基本设置中输入引用网址
   • 您可以使用适用于iOS和中国Android的智能网址。对于Android，请在下载网址（引用）框中输入市场专属网址。（例如：Market://details?id…）
   • 如果有不在服务中的操作系统，请在相应的下载网址框中输入“http://ua.withhive.com/ua/block/not_support”，以便用户可以看到页面不可用。
2. 保存基本设置并转到CPA设置以发放CPA代码。将发放的CPA代码分享给游戏开发团队，以便进行开发。
3. 完成应用设置的前期工作后，转到UA活动设置菜单。

注册邀请活动¶

1. 活动列表¶

选择一个游戏并点击“注册”按钮以注册新的促销，或点击促销管理名称以修改现有促销。

2. 注册和修改¶

输入详细信息并点击“保存”。

• 选择类型
  • 邀请游戏好友：这是用于邀请朋友加入游戏的促销活动。
  • 发送奖励的链接：这是一个促销活动，向点击已发出链接并安装游戏的用户发放奖励。（用于预注册等。）
• 暴露文本基本语言
  • 在为活动设置暴露文本时，选择您希望默认暴露的语言。对于没有任何文本可暴露的游戏，请选择“不要使用”。
• 个人成就活动
  • • 这是一个每当朋友完成活动时就会发放奖励的活动。您可以通过“添加活动”按钮安排多个活动，请注意，如果您删除用于服务的活动，则该活动将无法正常工作。
    • 选择活动：通过选择CPI或注册的CPA来组成活动。即使没有奖励，也必须选择CPI，因为这是检查首次安装游戏后游戏玩法的方法。
    • 您可以选择多个用户邀请奖励。选择要给予的奖励，并在输入框中输入数量。（例如，输入1时将给予1个物品。）
    • 您可以通过在奖励限制中输入数字来限制邀请用户可以获得的最大奖励数量。一旦达到最大奖励数量，邀请用户或邀请者都无法再获得奖励。
    • 如果您直接在游戏中实现暴露文本，则不需要暴露文本。您可以选择仅为您想要的类别输入信息，包括标题、细节和图像。但是，您必须为您设置为基本语言的三者之一输入。
    • 重置：如果您超过了可以获得补偿的最大好友数量，将不会给予额外的补偿。在这种情况下，您可以使用重置功能来重置补偿计数。重置功能将按活动进行，而不是按用户进行。
      例如，假设您想重置一个补偿计数限制为30的活动。一旦计数重置，目标好友的数量将对达到30补偿计数限制的用户和达到10补偿计数的用户变为0。因此，两个用户都可以重新邀请朋友以获得补偿。 即使您重置了补偿计数，现有的邀请信息仍可以通过日志搜索菜单查看。

• [后台 - 暴露文本设置]

• [暴露的文本示例]

• 目标达成活动
  • 这是一个在你达到活动目标的朋友数量时给予奖励的活动。你可以通过点击“添加活动”按钮来组合多个活动。

• • 选择一个活动：您可以选择多个活动以实现目标达成活动。使用“+/-”按钮添加或删除活动。
  • 目标人数：输入接受邀请以实现活动的用户数量。
  • 奖励金额限制：输入被邀请用户可以获得的最大奖励数量。

信息页面¶

UA 收集 IP 地址以跟踪用户。然而，如果用户在下载应用程序时或在点击邀请链接后被转移到市场之前，将网络设置从 IP 更改为 LTE 或从 LTE 更改为 IP，则无法收集奖励。因此，需要在用户点击邀请链接时显示一个信息页面。

信息页面将显示给Android和iOS用户，您可以在控制台>促销>应用设置> UA设置选项卡中设置此功能。有关更多信息，请检查促销设置类别。

[信息页面示例]

CPA 设置¶

保存默认设置并移动到CPA设置选项卡以发放CPA代码。发放的CPA代码将提供给游戏团队进行开发。

延迟深度链接¶

延迟深度链接为已经安装应用的用户运行游戏，并将没有应用的用户引导到相应的商店。 要使用延迟深度链接，请使用 SHA256 作为 Google 的输入，使用 TeamID 作为 Apple 的输入。此功能在 Hive SDK 4.15.8 或更高版本中可用。

1. 点击推广 > 应用设置。从列表中选择一个游戏。  
2. 移动到 UA 设置选项卡。请选择在延迟深度链接使用设置中使用。  
3. 在默认设置选项卡中，输入用于延迟深度链接的 appid 的 SHA256（Android）或 TeamID（iOS）。 iOS 的 TeamID 可以在 Apple Developer 控制台中找到，如下所示。

如果市场是 Google，请输入 SHA256。对于 SHA256，请输入 SHA 证书指纹 的值。
如果您的市场是 Apple，请输入您的 TeamID。对于 TeamID，只需输入 应用程序 ID 前缀 值。

使用邀请链接的注意事项¶

1. 关于邀请游戏朋友的促销活动，每个游戏只能激活1个促销活动。请注意，未激活的促销活动将无法使用。
2. 分发奖励的URL促销可以用于预注册等，当用户通过游戏下载URL安装并运行游戏时，将会给予奖励。
3. 当您选择分发奖励的URL促销并保存时，将会发放邀请URL和二维码。
4. 对于分发奖励的URL促销，您不必为邀请的用户设置奖励，只需为接受邀请的用户设置奖励。补偿支付的促销不需要设置邀请用户的补偿，只需设置接受用户的补偿。

问题邀请代码¶

注册邀请活动¶

1. 活动列表¶

选择游戏后，通过点击注册活动按钮注册新活动，或通过点击活动管理名称修改现有活动。

2. 注册和修改¶

输入详细信息并点击“保存”。

• 选择类型：选择问题邀请代码。这是一个每个邀请者发放一个邀请代码的活动。
• 激活：每个游戏只能有一个活动。未激活活动中发放的代码将无法匹配或奖励

• 添加奖励
  • 奖励详情：输入描述奖励的词语或短语。此值用于控制台的管理目的。
  • 奖励：  
    • 行动奖励：当被邀请的朋友执行指定的行动时，给予奖励。奖励可以同时给予邀请者和接受者。
    • 成就目标奖励：当执行奖励行动的朋友达到设定数量时，给予奖励。此活动仅奖励邀请者，鼓励持续的朋友留存和游戏参与。
  • 奖励行动：设置必须执行的行动以给予奖励。
    • 匹配：当朋友在输入邀请代码后成功匹配时，给予奖励。由于如果更改账户并匹配，奖励可以继续给予，因此建议设置最小奖励或仅给予接受者奖励。
    • 安装：如果接受者在基于代码匹配日期的7天内安装应用程序，则给予奖励。安装奖励适用于应用了SDK版本4.25.0.0或更高版本的游戏。
    • CPA成就：当接受者完成特定行动（CPA）时，给予奖励。在控制台 > 推广 > 推广设置 > CPA设置中注册的CPA将作为选择项出现。
  • 奖励接收者：选择奖励的接收者和奖励项目。输入要奖励的数量作为数字（例如，输入1将奖励一个项目）。
  • 奖励金额限制：邀请者可以获得奖励的次数可以被限制。即使邀请了更多朋友，邀请者也只会获得设定次数的奖励。
  • 物品奖励分发消息：设置在邮箱中收到奖励物品时出现的消息。要注册消息，请转到控制台 > 计费 > 物品 > 物品发放消息。
  • 目标数量：在选择成就目标奖励时设置该值。当接受者确保的接受者达到设定目标数量时，给予奖励。

• 删除：删除已注册的奖励。
• 重置：如果超过了有资格获得奖励的朋友的最大数量，将不再给予额外奖励。在这种情况下，请使用重置功能来重置奖励频率。

CPA设置¶

转到控制台 > 促销 > 促销设置 > CPA设置标签以发放CPA代码。发放的CPA代码将提供给游戏团队进行开发。
 

发放邀请码，输入邀请码¶

如果您已在控制台完成邀请码活动的注册，现在需要开发一个页面，供用户发放代码和输入代码。 请参考API指南来开发邀请码发放页面和邀请码输入页面。

[示例屏幕：邀请代码发行页面]

[示例屏幕：邀请代码输入页面]  

使用邀请码的注意事项¶

1. 为防止滥用，请对接收奖励的账户进行账户验证。
2. 匹配奖励应设置为最低限额或仅给予接受者。
   • 仅在输入邀请码进行匹配时给予匹配奖励。
     由于存在滥用的担忧，例如在同一设备上更换账户并尝试匹配，建议给予最低奖励。
     由于接受者每个账户只能获得一次匹配奖励，因此滥用的担忧相对较小，因此仅为接受者设置奖励也是一种选择。
3. 安装奖励仅在移动SDK版本4.25.0.0或更高版本上可用。
   • 根据设备暴露条款的游戏会按账户收集安装日志，并可以在移动SDK版本4.25.0.0或更高版本上给予安装奖励。如果您在4.25.0.0之前的SDK版本上设置安装奖励，奖励将会失败。
   • 对于基于账户的条款曝光游戏，无论版本如何，均可获得安装奖励。
   • 目前PC不支持安装奖励。未来计划支持。
4. 如果您更改运营活动的奖励信息，已经给予的奖励数量和达成的目标数量将保持不变。
   • 如果您想重置奖励数量和目标数量，请点击重置按钮。
5. 奖励频率限制仅适用于邀请者。
   • 随着朋友数量的增加，可以无限制地给予邀请者奖励，因此这是设置可能奖励数量的功能。
   • 无论此设置值如何，接受者只能首次获得一次奖励。

UA 匹配注册¶

当UA匹配失败时，您可以通过输入被邀请用户和接受用户的信息直接进行匹配。 点击推广-> UA匹配注册。 邀请码不支持手动匹配。

1. 输入被邀请用户和接受用户的信息。VID、PlayerID和DID是必需的。输入邀请类型。
2. 如果您搜索，接受用户的设备识别值（广告ID/IMEI/IP+操作系统版本）确认的日志详细信息将被公开。您可以检查与UA匹配相关的日志详细信息的具体内容。 例如：检查使用相同IP+操作系统版本安装的下载历史记录 → 由于重复安装匹配失败
3. 如果您点击UA匹配按钮，您可以直接将输入的被邀请用户与接受用户匹配。

搜索 UA 日志¶

您可以搜索有关UA参与者的详细信息。 点击促销-> UA日志。

1. 输入邀请者或被邀请者的信息。Hive ID、VID、PlayerID 和 DID 是必需的。
2. 基于 DID 的安装历史记录。除非您在搜索字段中输入 DID，否则不会搜索结果。
3. 基于 DID 的奖励历史记录。除非您在搜索字段中输入 DID，否则不会搜索结果。
4. 基于 Hive ID、VID 和 PlayerID 的匹配历史记录。当邀请者和被邀请者正确匹配时，您可以查看双方的信息。
5. 基于 Hive ID、VID 和 PlayerID 的奖励历史记录。当奖励正确发放时，您可以查看邀请者的日志。  

UA活动统计¶

您可以查看关于UA参与者的日志和统计信息。

每日指数详情¶

您可以查看有关UA统计的统计信息。 点击推广-> UA匹配注册。

1. 输入游戏标题、国家和日期。

2. 您可以按日期查看活动的详细索引。

   • 点击：点击UA邀请链接的人数。
   • 匹配：一旦被邀请者安装并运行游戏后，VID创建完成，匹配将完成。如果按国家过滤，结果将基于被邀请者显示。
   • 奖励：作为CPI或CPA完成后，收到奖励的邀请者人数。
   • CPI：状态为仅设备匹配完成，因为被邀请者安装并运行了游戏，但在VID创建之前结束了游戏。

3. 您可以将搜索到的信息下载为Excel文件。下载后，您可以查看所有国家的结果。  

每个阶段的累积索引¶

1. 这是关于自活动创建以来整个时期的累积索引。将搜索截止到前一天的累积数据。

流入路径指示器¶

您可以通过日期检查受邀者点击UA邀请链接的路线。 1. 路线可以区分为Kakao、LINE、Facebook（包括FB Messenger）和微信。通过其他路线访问的受邀者将被归类为其他，您还可以查看相应的累计数据。 2. 在使用Hive提供的UA分享弹窗时，其他消息传递流入指标会在应用了单独模块的游戏中引入，SDK v1 1.18.2和SDK v4 4.14.3。

1. ETC 指数是一个累积流入指数，无法被识别为其他消息传递指数。