邀请活动注册和管理

UA（遊戲邀請）是一個有效的功能，可以吸引更多的遊戲用戶。請查看以下過程以使用該功能。

UA 流程¶

1. 開發 UA¶

• 為UA開發用戶界面
• 開發邀請成就活動和獎勵
• 開發分享UA的方法
• 開發遊戲介紹頁面

2. 註冊 UA 後台¶

• 註冊應用程式
• 註冊 CPA（使用 CPA 時）
• 為活動註冊促銷和獎勵設置

3. 實施 UA¶

• 實現UA開發
• 應用UA API

4. 執行測試¶

• 檢查邀請的 URL 和 QR 碼資訊是否正常。
• 檢查邀請完成次數等結果是否正常。
• 檢查 CPA 日誌是否正確傳輸。
• 檢查完成 UA 活動後獎勵是否正確發放等。

開發 UA¶

在這個階段，您將能夠開發活動的內容、獎勵、用戶獲取界面等。

負責人：開發團隊或負責業務的人

[活動圖片範例 – 鏈擊]

邀請類型¶

• 邀請遊戲朋友：您可以通過邀請鏈接邀請朋友參加遊戲並獲得獎勵。每位邀請者會發出一個邀請鏈接。
• 獎勵鏈接：獎勵可以發放給通過鏈接安裝的用戶。沒有單獨的邀請者，並且發出一個單一的URL。
• 發放邀請碼：啟動遊戲後，輸入邀請碼以與朋友匹配並獲得獎勵。無需單獨的鏈接，每位邀請者會發出一個邀請碼。

問題邀請連結¶

在註冊邀請活動之前，需要先在促銷設置菜單的基本設置和CPA設置中註冊以下內容。

基本設定¶

讓我們簡要了解UA活動註冊的前期工作。請參考 促銷設置 以獲取有關其他應用設置的更多詳細信息。

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

1. 在基本设置中输入引用者 URL
   • 您可以使用适用于 iOS 和中国 Android 的智能 URL。对于 Android，请在下载 URL（引用者）框中输入市场专属 URL。（例如：Market://details?id…）
   • 如果有不在服务中的操作系统，请在相应的下载 URL 框中输入“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，只需輸入 App ID 前綴 的值。

使用邀請連結的注意事項¶

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

問題邀請碼¶

註冊邀請活動¶

1. 活動列表¶

選擇遊戲後，點擊註冊活動按鈕註冊新活動，或點擊活動管理名稱修改現有活動。

2. 註冊和修改¶

輸入詳細信息並點擊“保存”。

• 選擇類型：選擇問題邀請碼。這是一個每位邀請者發放邀請碼的活動。
• 啟用：每個遊戲只能有一個活動。未啟用活動中發放的代碼將無法匹配或獎勵

• 添加獎勵
  • 獎勵詳情：輸入描述獎勵的詞語或短語。此值在控制台中用於管理目的。
  • 獎勵 :  
    • 行動獎勵：當被邀請的朋友執行指定的行動時，將給予獎勵。獎勵可以同時給予邀請者和接受者。
    • 成就目標獎勵：當執行獎勵行動的朋友達到設定的數量時，將給予獎勵。此活動僅獎勵邀請者，鼓勵持續的朋友留存和遊戲參與。
  • 獎勵行動：設置必須執行的行動以給予獎勵。
    • 匹配：當朋友在輸入邀請碼後成功匹配時，將給予獎勵。由於如果更改帳戶並匹配，獎勵可以繼續給予，因此建議設置最小獎勵或僅對接受者給予獎勵。
    • 安裝：如果接受者在基於代碼匹配日期的7天內安裝應用程序，則將給予獎勵。安裝獎勵在已應用移動SDK版本25.0.0或更高版本以及PC SDK版本25.3.0或更高版本的遊戲中是可能的。
    • CPA成就：當接受者達成特定行動（CPA）時，將給予獎勵。在控制台 > 推廣 > 推廣設置 > CPA設置中註冊的CPA將作為選擇項出現。
  • 獎勵接收者：選擇獎勵的接收者和獎勵項目。輸入要獎勵的數量作為數字（例如，輸入1將獎勵一個項目）。
  • 獎勵金額限制：邀請者可以接收獎勵的次數可以被限制。即使邀請了更多朋友，邀請者也僅會獲得設定次數的獎勵。
  • 物品獎勵分發消息：設置在郵箱中收到獎勵項目時出現的消息。要註冊消息，請轉到控制台 > 計費 > 物品 > 物品發放消息。
  • 目標數量：在選擇成就目標獎勵時設置的值。當接受者確保接受者達到設定的目標數量時，將給予獎勵。

• 刪除：刪除已註冊的獎勵。
• 重置：如果超過可獲得獎勵的朋友最大數量，將不會給予額外的獎勵。在這種情況下，使用重置功能來重置獎勵頻率。

CPA 設定¶

移至控制台 > 推廣 > 推廣設定 > CPA 設定標籤以發佈 CPA 代碼。發佈的 CPA 代碼將提供給遊戲團隊進行開發。
 

發放邀請碼，輸入邀請碼¶

如果您已在控制台完成邀請碼活動的註冊，現在需要開發一個頁面，讓用戶可以發放碼和輸入碼。 請參考API指南來開發邀請碼發放頁面和邀請碼輸入頁面。

[範例螢幕：邀請碼發放頁面]

[範例螢幕：邀請碼輸入頁面]  

使用邀請碼的注意事項¶

1. 為了防止濫用，對接收獎勵的帳戶進行帳戶驗證。
2. 匹配獎勵應設置為最低限度或僅給予接受者。
   • 匹配獎勵僅在通過輸入邀請碼進行匹配時給予。
     建議給予最低獎勵，因為存在濫用的擔憂，例如在同一設備上更改帳戶並試圖進行匹配。
     由於接受者每個帳戶只能獲得一次匹配獎勵，因此對濫用的擔憂相對較少，因此僅為接受者設置獎勵也是一種選擇。
3. 安裝獎勵僅在移動SDK版本25.0.0或更高版本，以及PC SDK版本25.3.0或更高版本上可用。
   • 根據設備暴露條款的遊戲每個帳戶收集安裝日誌，並可以在移動SDK版本25.0.0或更高版本，以及PC SDK版本25.3.0或更高版本上給予安裝獎勵。如果您在SDK版本25.0.0之前或PC的25.3.0之前設置安裝獎勵，則獎勵將失敗。
   • 在基於帳戶的條款暴露遊戲中，無論版本如何，都可以獲得安裝獎勵。
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）和WeChat。通过其他路线访问的受邀者将被归类为其他，您还可以查看相应的累计数据。 2. 当使用Hive提供的UA分享弹出窗口时，其他消息传递流入指标会在应用了单独模块的游戏中引入，SDK v1 1.18.2和SDK v4 4.14.3。

1. ETC指數是一個累積流入指數，無法被識別為其他訊息指數。