邀请活动注册和管理

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

UA 流程¶

1. 開發 UA¶

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

2. 註冊 UA 後台¶

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

3. 實現 UA¶

• 實施UA開發
• 應用UA API

4. 執行測試¶

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

開發 UA¶

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

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

[活動圖片範例 – 鏈擊]

資訊頁面¶

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

該資訊頁面將顯示給 Android 和 iOS 用戶，您可以在控制台>推廣>應用設置> UA 設置標籤中設置此功能。請查看 應用設置 類別以獲取更多資訊。

[資訊頁面的範例]

UA 活動註冊¶

在註冊UA活動之前，必須先在應用程式設定菜單的UA設定和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活动设置菜单。

UA 活動設定¶

1. 活動列表¶

選擇一個遊戲並點擊“註冊”按鈕以註冊新的促銷，或點擊促銷管理名稱以修改現有的促銷。

2. 註冊和修改¶

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

• 選擇類型
  • 邀請遊戲好友：這是一項用於邀請朋友參加遊戲的促銷活動。
  • 發送獎勵的鏈接：這是一項促銷活動，向點擊發佈的網址並安裝遊戲的用戶發放獎勵。（用於預註冊等）
• 暴露文本基本語言
  • 當您為活動設置暴露文本時，選擇您希望預設暴露的語言。對於沒有任何文本可供暴露的遊戲，選擇“不要使用”。
• 個人成就活動
  • • 這是一項每當朋友達成活動時就會發放獎勵的活動。您可以使用“添加活動”按鈕安排多個活動，請注意，如果您刪除用於服務的活動，該活動將無法運作。
    • 選擇活動：通過選擇CPI或註冊的CPA來組成活動。即使沒有獎勵，也必須選擇CPI，因為這是檢查首次安裝遊戲後的遊玩情況的方法。
    • 您可以選擇多個用戶邀請獎勵。選擇要給予的獎勵並在輸入框中輸入數量。（例如，當您輸入1時，將給予1個項目。）
    • 您可以通過在獎勵限制中輸入數字來限制邀請用戶可以獲得的獎勵的最大數量。
    • 如果您打算直接在遊戲中實施暴露文本，則不需要暴露文本。您可以選擇僅輸入您想要的類別的資訊，包括標題、詳細資訊和圖片。然而，您必須為您設置的基本語言輸入三者之一。
    • 重置：如果您超過了可以獲得補償的好友最大數量，則不會給予額外的補償。在這種情況下，您可以使用重置功能來重置補償計數。重置功能將基於活動應用，而不是用戶基礎。
      例如，假設您想重置一個補償計數限制為30的活動。一旦計數重置，達到30補償計數限制的用戶和達到10補償計數的用戶的目標好友數量都將變為0。因此，兩位用戶都可以重新邀請朋友以獲得補償。 即使您重置了補償計數，現有的邀請資訊仍可通過日誌搜索菜單查看。

• [後台 - 曝露文本設置]

• [暴露的文本範例]

• 目標達成活動
  • 這是一個在您達到活動目標的朋友數量時給予獎勵的活動。您可以通過點擊“添加活動”按鈕來組合多個活動。

• • 選擇活動：您可以選擇多個活動以達成目標活動。使用“+/-”按鈕來添加或刪除活動。
  • 目標人數：輸入接受邀請以達成活動的用戶數量。
  • 獎勵金額限制：輸入邀請用戶可以獲得的最大獎勵數量。

延遲深層連結¶

延遲深度鏈接為已安裝應用的用戶運行遊戲，並將未安裝應用的用戶引導至各自的商店。 要使用延遲深度鏈接，請使用 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 前綴 的值。

UA 活動注意事項與通知¶

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

UA 匹配註冊¶

當 UA 匹配失敗時，您可以通過輸入被邀請用戶和接受用戶的信息來直接匹配。 點擊促銷-> UA 匹配註冊。

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

UA 活動統計¶

您可以查看有關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 匹配註冊。

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指數是一個累積流入指數，無法被識別為其他訊息指數。