邀请活动注册和管理
UA(遊戲邀請)是一個有效的功能,可以吸引更多的遊戲用戶。請查看以下流程以使用此功能。
UA 流程¶
1. 開發 UA¶
- 為UA開發用戶介面
- 開發邀請成就活動和獎勵
- 開發分享UA的方法
- 開發遊戲介紹頁面
2. 註冊 UA 後台¶
- 註冊應用程式
- 註冊 CPA(使用 CPA 時)
- 為活動註冊促銷和獎勵設置
3. 實施 UA¶
- 實現UA開發
- 應用UA API
4. 執行測試¶
- 檢查邀請的 URL 和 QR 碼資訊是否正常。
- 檢查邀請完成次數等結果是否正常。
- 檢查 CPA 日誌是否正確轉移。
- 檢查完成 UA 活動後獎勵是否正確發放等。
開發 UA¶
在這個階段,您將能夠開發活動的內容、獎勵、用戶獲取界面等。
| 類別 | 描述 | UA服務 | 其他 |
|---|---|---|---|
| 活動 | 設置邀請完成的目標、完成邀請目標將發放的獎勵,以及獎勵的最大數量等。 |
• CPA: 在完成特定行動時發放獎勵 • 每個案例的獎勵活動: 當朋友完成CPI或CPA時發放獎勵 • 目標達成活動: 當完成CPI或CPA的朋友數量達到指定數量時發放獎勵 | • CPI在用戶通過安裝和玩遊戲獲得視頻時完成,並將發放獎勵 • 指定獲取獎勵的最大次數(必填) • 對於CPI,必須設置限制級別,以確保在任何人獲得獎勵的最大次數或收到金額時不會造成任何問題 |
| 分享方法 | 您需要計劃在遊戲中使用的分享功能的平台。Hive、Kakaotalk、Line和Facebook是最常用的平台。用戶需要邀請URL和/或QR碼發送給他們的朋友。 SDK 4.11.2及更高版本支持社交媒體分享功能,無需任何額外的遊戲特定實現。(Kakaotalk/LINE/Facebook/Facebook Messenger/WhatsApp/WeChat) 您還需要決定用戶實際分享時要發送的消息。 | • 發放個別邀請URL • 發放個別邀請QR碼 | • 實現用戶可以通過分享方法發送QR碼的功能,以及用戶可以將QR碼圖像保存在設備上的功能(推薦) • 實現用戶可以通過api發送邀請的功能,這是操作系統提供的基本分享方法(推薦) • 實現用戶可以通過社交網絡服務等外部分享方法發送邀請URL的功能(可選 – 需要由開發團隊實現) |
| UA UI | 需要開發UA屏幕。 需要發送邀請的活動和功能。您可以在一個屏幕中組合活動和邀請,或在不同的屏幕中進行。 | 1.活動標題 2.描述 3.圖像 4.當前已完成邀請的數量 5.邀請的最大數量(目標) (參考下面的活動示例) | 活動標題、描述和圖像是可選的,可以直接在遊戲中實現。 |
負責人:開發團隊或負責業務的人
Note
分享功能是在運行發送邀請鏈接的活動時必填的字段。設置為邀請遊戲朋友或通過鏈接分發獎勵的活動被視為邀請鏈接活動。
[活動圖片範例 – 鏈擊]
邀請類型¶
- 邀請遊戲好友:您可以通過邀請鏈接邀請朋友參加遊戲並獲得獎勵。每位邀請者會發出一個邀請鏈接。
- 獎勵鏈接:獎勵可以發放給通過鏈接安裝的用戶。沒有單獨的邀請者,並且發出一個單一的URL。
- 發放邀請碼:啟動遊戲後,輸入邀請碼以與朋友匹配並獲得獎勵。無需單獨的鏈接,每位邀請者會發出一個邀請碼。
發送邀請連結¶
在註冊邀請活動之前,必須先在促銷設置菜單的基本設置和CPA設置中註冊以下內容。
基本設定¶
讓我們簡要了解UA活動註冊的前期工作。請參考 促銷設置 以獲取有關其他應用設置的更多詳細信息。
首先,您需要在應用程式設定中註冊一個新遊戲的應用程式。無論市場類型如何,遊戲只會註冊一次,您可以通過點擊遊戲管理名稱來編輯已註冊的遊戲資訊,這將顯示編輯頁面。在基本設定中,遊戲名稱和遊戲方向是必填項,您可以稍後填寫其餘部分。為了使用UA,您需要選擇一個應用程式ID並在應用程式ID設定中輸入下載URL。
Warning
您要为其注册UA活动的游戏的AppID状态值必须为Live。(设置: 应用中心> 管理AppID> AppID列表> AppID信息)
如果您在应用设置> 偏好设置> AppID设置中有两个相同市场的AppID,请将状态值更改为Live,因为用户点击UA链接时进入的实际市场下载URL需要确定。
- 在基本设置中输入引用者 URL
- 您可以使用适用于 iOS 和中国 Android 的智能 URL。对于 Android,请在下载 URL(引用者)框中输入市场专属 URL。(例如:Market://details?id…)
- 如果有不在服务中的操作系统,请在相应的下载 URL 框中输入“http://ua.withhive.com/ua/block/not_support”,以便用户可以看到页面不可用。
- 保存基本设置,然后转到 CPA 设置以发放 CPA 代码。将发放的 CPA 代码分享给游戏开发团队,以便进行开发。

- 完成应用设置的预工作后,转到 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 或更高版本中可用。
- 點擊促銷 > 應用設置。從列表中選擇一個遊戲。
- 移動到 UA 設置標籤。請選擇在延遲深層鏈接使用設置中使用。
- 在默認設置標籤中,輸入應用 ID 的 SHA256(Android)或 TeamID(iOS)以使用延遲深層鏈接。 iOS 的 TeamID 可以在 Apple Developer 控制台中找到,如下所示。

如果市場是 Google,請輸入 SHA256。對於 SHA256,請輸入 SHA 證書指紋 的值。
如果您的市場是 Apple,請輸入您的 TeamID。對於 TeamID,只需輸入 應用程式 ID 前綴 的值。 
使用邀請鏈接的注意事項¶
- 您只能为每个游戏激活1个邀请游戏朋友的促销活动。请注意,未激活的促销活动将无法使用。
- 分发奖励的URL促销活动可用于预注册等,当用户通过游戏下载URL安装并运行游戏时,将会发放奖励。
- 当您选择分发奖励的URL促销活动并保存时,将会发放邀请URL和二维码。
- 对于分发奖励的URL促销活动,您不必为邀请的用户设置奖励,只需为接受邀请的用户设置奖励。补偿支付的促销活动不需要设置邀请用户的补偿,只需设置接受用户的补偿。
發送邀請碼¶
註冊邀請活動¶
1. 活動列表¶
選擇遊戲後,點擊註冊活動按鈕來註冊新活動,或點擊活動管理名稱來修改現有活動。
2. 註冊和修改¶
輸入詳細信息並點擊“保存”。
<
- 選擇類型:選擇發放邀請碼。這是一個每位邀請者發放一個邀請碼的活動。
- 啟用:每個遊戲只能有一個活動處於啟用狀態。在非啟用活動中發放的代碼將無法匹配或獎勵
- 添加獎勵
- 獎勵詳情:輸入描述獎勵的詞語或短語。此值在控制台中用於管理目的。
- 獎勵 :
- 行動獎勵:當被邀請的朋友執行指定的行動時,將給予獎勵。獎勵可以同時給予邀請者和接受者。
- 成就目標獎勵:當執行獎勵行動的朋友達到設定的數量時,將給予獎勵。此活動僅獎勵邀請者,鼓勵持續的朋友保留和遊戲參與。
- 獎勵行動:設置必須執行的行動以給予獎勵。
- 匹配:當朋友匹配成功後輸入邀請碼時,將給予獎勵。由於如果更改帳戶並匹配,獎勵可以繼續給予,因此建議設置最小獎勵或僅對接受者給予獎勵。
- 安裝:如果接受者在基於代碼匹配日期的7天內安裝應用,則將給予獎勵。安裝獎勵在應用移動SDK版本25.0.0或更高版本,以及PC SDK版本25.3.0或更高版本的遊戲中是可能的。
- CPA成就:當接受者達成特定行動(CPA)時,將給予獎勵。在控制台 > 推廣 > 推廣設置 > CPA設置中註冊的CPA將顯示為選擇項目。
- 獎勵接收者:選擇獎勵的接收者和獎勵項目。輸入要獎勵的數量作為數字(例如,輸入1將獎勵一個項目)。
- 獎勵金額限制:邀請者可以獲得獎勵的次數可以被限制。即使邀請了更多朋友,邀請者也僅能獲得設定次數的獎勵。
- 物品獎勵發放消息:設置在郵箱中收到獎勵物品時出現的消息。要註冊消息,請轉到控制台 > 計費 > 物品 > 物品發放消息。
- 目標數量:在選擇成就目標獎勵時設置的值。當接受者確保接受者達到設定的目標數量時,將給予獎勵。
- 刪除:刪除已註冊的獎勵。
- 重置:如果符合獎勵的朋友數量超過最大值,將不會給予額外的獎勵。在這種情況下,使用重置功能來重置獎勵頻率。
Note
條款詳情
* 邀請者 : 發送邀請的用戶。邀請者創建並分享一個獨特的邀請代碼,並可以有多個接受者。
* 接受者 : 接收邀請的用戶。接受者可以在遊戲運行後通過輸入共享的邀請代碼與邀請者成為朋友。每個接受者只有一個邀請者。
CPA 設定¶
移至控制台 > 推廣 > 推廣設定 > CPA 設定標籤以發出 CPA 代碼。發出的 CPA 代碼將提供給遊戲團隊進行開發。
發放邀請碼,輸入邀請碼¶
如果您在控制台中註冊了邀請碼活動,您現在需要用戶可以接收邀請碼和輸入邀請碼的頁面。 您可以通過將邀請碼頁面鏈接到橫幅或自定義視圖來向用戶公開這些頁面。
註冊橫幅/自定義視圖以鏈接邀請碼頁面。¶
- 前往控制台 > 推廣 > 活動活動 > 活動註冊。
- 點擊註冊。
- 在導航路徑中,選擇邀請碼。
- 如果您想顯示發放邀請碼的頁面,請選擇發放邀請碼並選擇要鏈接的邀請碼活動。從控制台 > 推廣 > 用戶邀請 > 註冊邀請活動註冊的邀請碼活動名稱將顯示。
- 如果您想顯示輸入邀請碼的頁面,請選擇輸入邀請碼。
Note
您也可以通过参考API指南>Hive服务器API>推广>基于邀请代码的匹配直接开发邀请代码发行页面和邀请代码输入页面。
使用邀請碼的注意事項¶
- 為了防止濫用,對接收獎勵的帳戶進行帳戶驗證。
- 匹配獎勵應設置為最低或僅給予接受者。
- 只有在輸入邀請碼進行匹配時,才會給予匹配獎勵。
建議給予最低獎勵,因為存在濫用的擔憂,例如在同一設備上更改帳戶並嘗試匹配。
由於接受者每個帳戶只能獲得一次匹配獎勵,因此對濫用的擔憂相對較少,因此僅為接受者設置獎勵也是一個選項。
- 只有在輸入邀請碼進行匹配時,才會給予匹配獎勵。
- 安裝獎勵僅在移動SDK版本25.0.0或更高版本,以及PC SDK版本25.3.0或更高版本上可用。
- 根據設備暴露條款的遊戲會根據帳戶收集安裝日誌,並可以在移動SDK版本25.0.0或更高版本,以及PC SDK版本25.3.0或更高版本上給予安裝獎勵。如果您在25.0.0之前的SDK版本或PC的25.3.0之前設置安裝獎勵,則獎勵將失敗。
- 在基於帳戶的條款曝光遊戲中,無論版本如何,都可以獲得安裝獎勵。
- 如果您更改運營活動的獎勵信息,則已給予的獎勵數量和達成的目標數量將保持不變。
- 如果您想重置獎勵數量和目標數量,請點擊重置按鈕。
- 獎勵頻率限制僅適用於邀請者。
- 隨著朋友數量的增加,可以無限制地給予邀請者獎勵,因此這是一個設置可獲得獎勵數量的功能。
- 無論此設置值如何,接受者只能第一次獲得獎勵一次。
UA 匹配註冊¶
當 UA 匹配失敗時,您可以通過輸入被邀請用戶和接受用戶的信息來直接匹配。 點擊促銷-> UA 匹配註冊。 邀請碼不支持手動匹配。
- 輸入被邀請用戶和接受用戶的信息。VID、PlayerID 和 DID 是必填項。輸入邀請類型。

- 如果您搜索,則會顯示接受用戶的設備識別值(廣告 ID/IMEI/IP+OS 版本)確認的日誌詳細信息。您可以檢查與 UA 匹配相關的日誌詳細信息。 例如:檢查使用相同 IP+OS 版本安裝的下載歷史記錄 → 由於重複安裝而匹配失敗

- 如果您點擊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匹配註冊。
- 輸入遊戲標題、國家和日期。
-
您可以按日期查看活動的詳細索引。
- 點擊:點擊UA邀請鏈接的人數。
- 匹配:一旦受邀者安裝並運行遊戲後,VID創建完成,匹配將完成。如果按國家篩選,結果將根據受邀者顯示。
- 獎勵:作為CPI或CPA完成的獲獎者人數。
- CPI:狀態為僅完成設備匹配,因為受邀者安裝並運行了遊戲,但在VID創建之前結束了遊戲。
-
您可以將搜索到的信息下載為 Excel。下載後,您可以查看所有國家的結果。
每個階段的累積索引¶
- 這是一個有關自活動創建以來整個期間的累積指數。將搜索截至前一天的累積數據。
流入路徑指示器¶
您可以根据日期检查受邀者如何点击UA邀请链接的路线。
1. 路线可以分为Kakao、LINE、Facebook(包括FB Messenger)和WeChat。通过其他路线访问的受邀者将被归类为其他,您还可以查看相应的累积数据。 2. 在使用Hive提供的UA分享弹出窗口时,其他消息传递流入指标会在应用了单独模块的游戏中引入,SDK v1 1.18.2和SDK v4 4.14.3。
- 該ETC指數是一個累積流入指數,無法被識別為其他消息指數。
Note
主要訊息指標和其他訊息流入指標的累積標準是不同的。主要訊息指標是受邀者點擊UA邀請URL的來源社交媒體的指標,而其他訊息則是邀請者選擇在Hive SDK彈出窗口中分享邀請URL的社交媒體。

















