邀请活动注册和管理

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

UA 流程¶

1. 開發 UA¶

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

2. 註冊 UA 後台¶

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

3. 實現 UA¶

• 實現UA開發
• 應用UA API

4. 執行測試¶

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

開發 UA¶

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

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

[活動圖片範例 – 鏈擊]

邀請類型¶

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

發送邀請鏈接{ #list03 }¶

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

基本設定¶

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

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

輸入詳細資訊並點擊“保存”。

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

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

• [暴露的文本範例]

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

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

資訊頁面¶

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

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

[資訊頁面的範例]

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+OS版本）確認的日誌詳細信息。您可以檢查與UA匹配相關的日誌詳細信息的具體內容。 例如：檢查使用相同IP+OS版本安裝的下載歷史記錄 → 由於重複安裝而匹配失敗
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指數是一個累積流入指數，無法被識別為其他消息指數。