跳转至

邀请活动注册与管理

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

UA 过程

1. 开发 UA

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

2. 注册 UA 后台

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

3. 实现 UA

  • 实现UA开发
  • 应用UA API

4. 运行测试

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

开发 UA

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

类别 描述 UA服务 其他
活动 设置邀请完成的目标、完成邀请目标后将发放的奖励以及最大奖励数量等。
    • CPI: 安装并玩游戏时发送奖励
    • CPA: 完成特定操作时发送奖励
    • 每个案例的奖励活动: 当朋友完成CPI或CPA时发送奖励
    • 目标达成活动: 当完成CPI或CPA的朋友数量达到指定数量时发送奖励
 • CPI在用户通过安装和玩游戏获取视频时完成，奖励将被发送
• 指定获取奖励的最大次数（必填）
• 对于CPI，需要设置限制级别，以确保在任何人获取奖励的最大次数或收到金额时不出现问题
分享方式 您需要计划在游戏中使用的分享功能的平台。Hive、Kakaotalk、Line和Facebook是最广泛使用的平台。用户需要发送邀请URL和/或二维码给他们的朋友。
SDK 4.11.2及更高版本支持社交媒体分享功能，无需任何额外的游戏特定实现。(Kakaotalk/LINE/Facebook/Facebook Messenger/WhatsApp/WeChat)
您还需要决定用户实际分享时发送的消息。		 • 发放个人邀请URL
• 发放个人邀请二维码		 • 实现用户可以通过分享方式发送二维码的功能，以及用户可以将二维码图像保存在设备上的功能（推荐）
• 实现用户可以通过api发送邀请的功能，这是操作系统提供的基本分享方式（推荐）
• 实现用户可以通过社交网络服务等外部分享方式发送邀请URL的功能（可选 - 需要开发团队实现）
UA UI 需要开发UA屏幕。
需要一个发送邀请的活动和功能。您可以在一个屏幕中组合活动和邀请，或在单独的屏幕中。		 1.活动标题
2.描述
3.图像
4. 当前已完成邀请的数量
5. 最大邀请数量（目标）
(请参阅下面的活动示例)		 活动标题、描述和图像是可选的，可以直接在游戏中实现。
 

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

[活动图片示例 – 链击]

 

邀请类型

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

 

问题邀请链接

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

基本设置

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

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

Warning

您要为其注册UA活动的游戏的AppID状态值必须为Live。（设置：应用中心> 管理AppID> AppID列表> AppID信息）
如果您在应用设置> 偏好设置> AppID设置中有两个相同市场的AppID，请将状态值更改为Live，因为用户点击UA链接时进入的实际市场下载URL需要确定。

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

注册邀请活动

1. 活动列表

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

 

2. 注册与修改

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

 

  • 选择类型
    • 邀请游戏好友：这是用于邀请朋友参加游戏的促销活动。
    • 发送奖励的链接：这是一个促销活动，向点击发布的 URL 并安装游戏的用户发放奖励。（用于预注册等。）
  • 暴露文本基本语言
    • 选择您希望在为活动设置暴露文本时默认暴露的语言。对于没有任何文本可供暴露的游戏，选择“不要使用”。
  • 个人成就活动
      • 这是一个每当朋友完成活动时就会发放奖励的活动。您可以通过“添加活动”按钮安排多个活动，请注意，如果您删除用于服务的活动，则该活动将无法正常工作。
      • 选择活动：通过选择 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. 活动列表

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

campaign_list_en

2. 注册与修改

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

registration_en

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

add_reward_en

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

delete_reset_en

  • 删除：删除已注册的奖励。
  • 重置：如果符合奖励的朋友最大数量被超过，将不会给予额外的奖励。在这种情况下，请使用重置功能来重置奖励频率。
Note

术语详情
* 邀请者 : 发送邀请的用户。邀请者创建并分享一个独特的邀请代码，并可以有多个接受者。
* 接受者 : 接收邀请的用户。接受者可以通过在游戏运行后输入共享的邀请代码与邀请者成为朋友。一个接受者只有一个邀请者。

 

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匹配按钮，您可以直接将输入的被邀请用户与接受用户进行匹配。
Warning

如果直接匹配失败
- 如果被邀请的用户从未创建过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 参与者的日志和统计信息。

Note

邀请码不支持用户邀请统计。

每日指数详情

您可以查看有关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 指数是一个累积流入指数，无法被识别为其他消息传递指数。
Note

主要消息传递指标和其他消息传递流入指标的累积标准是不同的。主要消息传递指标是受邀者点击UA邀请URL的源社交媒体的指标，而其他消息传递则是邀请者选择在Hive SDK弹出窗口中分享邀请URL的社交媒体。