招待キャンペーンの登録と管理

UA（ゲーム招待）は、より多くのゲームユーザーを引き付けるための効果的な機能です。この機能を使用するためのプロセスを以下で確認してください。

UAプロセス¶

1. UAを開発する¶

• UAのUIを開発する
• 招待実績キャンペーンと報酬を開発する
• UAを共有する方法を開発する
• ゲームイントロページを開発する

2. UAバックオフィスの登録¶

• アプリを登録する
• CPAを登録する（CPAを使用する場合）
• キャンペーンと報酬設定のためのプロモーションを登録する

3. UAを実装する¶

• UA開発を実装する
• UA APIを適用する

4. テストを実行する¶

• 招待のためのURLとQRコード情報が正常かどうかを確認してください。
• 招待完了回数などの結果が正常かどうかを確認してください。
• CPAログが適切に転送されているかどうかを確認してください。
• UAキャンペーンの完了に対して報酬が適切に支給されているかどうかを確認してください。

UAを開発する¶

この段階では、キャンペーンのコンテンツ、報酬、UA UIなどを開発できるようになります。

担当者: 開発チームまたはビジネスの担当者

[キャンペーン画像の例 – チェーンストライク]

招待の種類¶

• ゲームフレンドを招待: 招待リンクを通じて友達をゲームに招待し、報酬を受け取ることができます。招待リンクは招待者ごとに発行されます。
• 報酬リンク: リンクを通じてインストールしたユーザーに報酬が発行されます。別の招待者は必要なく、単一のURLが発行されます。
• 招待コードの発行: ゲームを開始した後、招待コードを入力して友達とマッチし、報酬を受け取ります。別のリンクは必要なく、招待者ごとに招待コードが発行されます。

招待リンクを発行する¶

招待キャンペーンを登録する前に、プロモーション設定メニューの基本設定とCPA設定に以下を最初に登録する必要があります。

基本設定¶

UAキャンペーン登録の事前作業について簡単に説明します。その他のアプリ設定の詳細については、プロモーション設定を参照してください。

まず、新しいゲームのためにアプリをApp Settingsで登録する必要があります。ゲームは市場タイプに関係なく一度だけ登録され、ゲーム管理名をクリックすることで登録されたゲーム情報を編集するページが表示されます。基本設定では、ゲーム名とゲームの方向が必須であり、残りは後で入力できます。UAを使用するためには、アプリIDを選択し、APP ID SettingsでダウンロードURLを入力する必要があります。

1. 基本設定でリファラURLを入力します
   • iOSおよび中国のAndroid URLにはスマートURLを使用できます。Androidの場合、ダウンロードURL（リファラ）ボックスに市場専用のURLを入力します。（例：Market://details?id…）
   • サービスが提供されていないOSがある場合は、対応するダウンロード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ユーザーに表示され、この機能はConsole>Promotion> App Settings> UA Settings Tabで設定できます。詳細についてはPromotion Settings カテゴリをご確認ください。

[情報ページの例]

CPA設定¶

デフォルト設定を保存し、CPAコードを発行するためにCPA設定タブに移動します。発行されたCPAコードは、開発のためにゲームチームに提供されます。

ディファードディープリンク¶

遅延ディープリンクは、すでにアプリをインストールしているユーザーのためにゲームを実行し、アプリを持っていないユーザーをそれぞれのストアに誘導します。 遅延ディープリンクを使用するには、GoogleにはSHA256を、AppleにはTeamIDを入力として使用します。この機能は、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 Prefixの値をそのまま入力します。

招待リンク使用時の注意事項¶

1. ゲームの友達を招待するプロモーションに関しては、各ゲームにつき1つのプロモーションしかアクティブにできません。非アクティブなプロモーションは機能しないことに注意してください。
2. 報酬を配布するURLプロモーションは、事前登録などに使用でき、ユーザーがゲームダウンロードURLを介してゲームをインストールして実行すると報酬が与えられます。
3. 報酬を配布するURLプロモーションを選択して保存すると、招待URLとQRコードが発行されます。
4. 報酬を配布するURLプロモーションでは、招待するユーザーの報酬を設定する必要はなく、招待を受け入れたユーザーの報酬のみを設定すればよいです。報酬支払いのプロモーションでは、招待ユーザーの報酬を設定する必要はなく、受け入れユーザーの報酬のみを設定します。

招待コードを発行する¶

招待キャンペーンの登録¶

1. キャンペーンリスト¶

ゲームを選択した後、キャンペーン登録ボタンをクリックして新しいキャンペーンを登録するか、キャンペーン管理名をクリックして既存のキャンペーンを修正します。

2. 登録と変更¶

詳細を入力して「保存」をクリックしてください。
<

• タイプを選択: 招待コードを発行する問題を選択します。これは、招待者ごとに招待コードを発行するキャンペーンです。
• アクティブ化: ゲームごとにアクティブなキャンペーンは1つだけです。非アクティブなキャンペーンで発行されたコードは一致せず、報酬もありません。

• 報酬を追加
  • 報酬の詳細: 報酬を説明する単語やフレーズを入力します。この値は、コンソールでの管理目的で入力されます。
  • 報酬 :  
    • アクション報酬: 招待された友達が指定されたアクションを実行したときに報酬が与えられます。報酬は招待者と受け入れ者の両方に与えられることがあります。
    • 達成目標報酬: 報酬アクションを実行した友達が設定された数に達したときに報酬が与えられます。このキャンペーンは招待者のみに報酬を与え、友達の継続的な保持とゲーム参加を促します。
  • 報酬アクション: 報酬を与えるために実行する必要があるアクションを設定します。
    • マッチング: 招待コードを入力した後、友達のマッチが成功したときに報酬が与えられます。アカウントが変更されてマッチした場合でも報酬が続けて与えられるため、最小限の報酬または受け入れ者のみの報酬を設定することをお勧めします。
    • インストール: 受け入れ者がコードマッチング日から7日以内にアプリをインストールした場合に報酬が与えられます。インストール報酬は、SDKバージョン4.25.0.0以降が適用されたゲームで可能です。
    • CPA達成: 受け入れ者が特定のアクション（CPA）を達成したときに報酬が与えられます。コンソール > プロモーション > プロモーション設定 > CPA設定に登録されたCPAが選択項目として表示されます。
  • 報酬受取人: 報酬の受取人と報酬アイテムを選択します。報酬する数量を数値として入力します（例: 1を入力すると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. その他のメッセンジャー流入インデックスは、個別モジュール、SDK v1 1.18.2、およびSDK v4 4.14.3が適用されたゲームの中でHiveによって提供されるUA共有ポップアップを使用する際に導入されます。

1. ETCインデックスは、他のメッセンジャーインデックスとして特定できない累積流入インデックスです。