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

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

UAプロセス¶

1. UAを開発する¶

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

2. UAバックオフィスを登録する¶

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

3. UAを実装する¶

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

4. テストを実行する¶

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

UAを開発する¶

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

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

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

情報ページ¶

UAはユーザーを追跡するためにIPアドレスを収集します。しかし、ユーザーはアプリをダウンロード中や招待リンクをクリックした後にマーケットに移動する前に、ネットワーク設定をIPからLTE、またはLTEからIPに変更すると報酬を受け取ることができません。したがって、招待リンクをクリックしたときにユーザーに通知する情報ページを表示する必要があります。

情報ページはAndroidおよびiOSユーザーに表示され、この機能はConsole>Promotion> App Settings> UA Settings Tabで設定できます。詳細についてはApp Settings カテゴリを確認してください。

[情報ページの例]

UAキャンペーン登録¶

UAキャンペーンを登録する前に、まずアプリ設定メニューのUA設定と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キャンペーン設定メニューに移動します。

UAキャンペーン設定¶

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

ゲームを選択し、「登録」ボタンをクリックして新しいプロモーションを登録するか、プロモーション管理名をクリックして既存のプロモーションを変更してください。

2. 登録と変更¶

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

• タイプの選択
  • ゲーム友達を招待: 友達をゲームに招待するためのプロモーションです。
  • 報酬を送るためのリンク: 発行されたURLをクリックしてゲームをインストールしたユーザーに報酬を与えるプロモーションです。（事前登録などに使用されます。）
• 公開テキスト基本言語
  • キャンペーンのために公開テキストを設定する際に、デフォルトで公開したい言語を選択してください。公開するテキストがないゲームには「使用しない」を選択してください。
• 個別達成キャンペーン
  • • 友達がキャンペーンを達成するたびに報酬を与えるキャンペーンです。「キャンペーン追加」ボタンで複数のキャンペーンを設定できますが、サービスに使用されているキャンペーンを削除するとキャンペーンは機能しませんのでご注意ください。
    • キャンペーンの選択: CPIまたは登録されたCPAを選択してキャンペーンを構成します。報酬がなくてもCPIを選択する必要があります。これは、ゲームを初めてインストールした後のゲームプレイを確認するための方法です。
    • 複数のユーザー招待報酬を選択できます。与える報酬を選択し、入力ボックスに数値で金額を入力してください。（例: 1を入力すると1アイテムが与えられます。）
    • 招待ユーザーが受け取ることができる報酬の最大数を制限するには、報酬制限に数値を入力してください。
    • 公開テキストは、ゲームに直接実装する場合は必須ではありません。タイトル、詳細、画像を含む、希望するカテゴリの情報のみを入力することができます。ただし、基本言語として設定した言語のうちの1つは必ず入力する必要があります。
    • リセット: 補償を受け取ることができる友達の最大数を超えた場合、追加の補償は与えられません。この場合、補償カウントをリセットするためにリセット機能を使用できます。リセット機能はキャンペーン単位で適用され、ユーザー単位では適用されません。
      たとえば、補償カウント制限が30のキャンペーンをリセットしたいとします。カウントがリセットされると、30の補償カウント制限を達成したユーザーと10の補償カウントを達成したユーザーの両方の対象友達の数は0になります。したがって、両方のユーザーは友達を再招待して補償を受け取ることができます。 補償カウントをリセットしても、既存の招待情報はログ検索メニューを通じて表示できます。

• [バックオフィス - 公開テキスト設定]

• [露出されたテキストの例]

• 目標達成キャンペーン
  • これは、キャンペーンを達成した友達の数の目標に到達したときに報酬を与えるキャンペーンです。「キャンペーンを追加」ボタンをクリックすることで、複数のキャンペーンを構成できます。

• • キャンペーンを選択: 目標達成キャンペーンのために複数のキャンペーンを選択できます。“+/-“ボタンを使用してキャンペーンを追加または削除します。
  • 目標数: キャンペーン達成のために招待を受け入れるユーザーの数を入力します。
  • 報酬金額制限: 招待ユーザーが受け取ることができる報酬の最大数を入力します。

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

ディファードディープリンクは、すでにアプリをインストールしているユーザーのためにゲームを実行し、アプリを持っていないユーザーをそれぞれのストアに誘導します。 ディファードディープリンクを使用するには、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の値を入力してください。

UAキャンペーンの注意事項と通知¶

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

UA マッチング登録¶

UAマッチングが失敗した場合、招待されたユーザーと受け入れたユーザーの情報を入力することで直接マッチングできます。 プロモーション-> UAマッチング登録をクリックしてください。

1. 招待されたユーザーと受け入れられたユーザーの情報を入力してください。VID、PlayerID、DIDは必須です。
2. 検索すると、受け入れられたユーザーのデバイス識別値（広告ID/IMEI/IP+OSバージョン）によって確認されたログの詳細が表示されます。UAマッチングに関連するログの詳細で具体的な内容を確認できます。 例) 同じIP+OSバージョンでインストールされたダウンロード履歴を確認 → 重複インストールのためマッチング失敗
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を含む）、WeChatに区別できます。他のルートからアクセスした招待者は「その他」として区別され、対応する累積データも確認できます。 2. 他のメッセンジャー流入インデックスは、個別モジュール、SDK v1 1.18.2、SDK v4 4.14.3が適用されたゲームの中でHiveが提供するUA共有ポップアップを使用する際に導入されます。

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