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

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が発行されます。
• 招待コードの発行: ゲームを開始した後、招待コードを入力して友達とマッチし、報酬を受け取ります。別のリンクは必要なく、招待者ごとに招待コードが発行されます。

招待リンクを発行する{ #list03 }¶

招待キャンペーンを登録する前に、プロモーション設定メニューの基本設定と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アイテムが与えられます。）
    • 招待ユーザーが受け取れる報酬の最大数を制限するには、報酬制限に数値を入力してください。最大報酬数に達すると、招待されたユーザーまたは招待者はこれ以上の報酬を受け取ることができません。
    • ゲームに直接実装する場合、公開テキストは必須ではありません。タイトル、詳細、画像など、希望するカテゴリの情報のみを入力することができます。ただし、基本言語として設定した言語の3つのうちの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. その他のメッセンジャー流入インデックスは、個別モジュールが適用されたゲームの中で、Hiveによって提供されるUA共有ポップアップを使用する際に導入されます。

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