プッシュキャンペーン登録
実際のプッシュメッセージを送信するためのキャンペーンを作成できます。リストのキャンペーン登録ボタンをクリックして、対応するページに入ります。キャンペーンの配信に必要な要素は、上から順に登録する必要があり、必要な情報が多いため、事前に入力されたテキストを読み込むなどの便利な機能を提供しています。
すべてのエリアで右の[top]ボタンをクリックすることでページのトップに戻ることができます。必須フィールドを入力せずに保存しようとすると、ページは自動的にその空のフィールドまでスクロールします。
キャンペーンタイトル¶
キャンペーンタイトルを入力してください。韓国語で最大50文字まで入力できます。
事前に登録されたタイトルテンプレートがある場合は、右側のタイトルテンプレート読み込みボタンをクリックしてテキストをインポートできます。
入力したタイトルテキストをタイトルテンプレートとして保存するには、「タイトルテンプレートとして保存」ボタンを押してください。
アプリ(ゲーム)¶
キャンペーンを送信するアプリ(ゲーム)を選択してください。1つのキャンペーンは、1つのアプリ(ゲーム)にのみメッセージを送信できます。ゲームタイトルに登録されているすべてのアプリのリストを表示するには、アプリ(ゲーム)タイトルを検索して選択してください。AndroidとiOSのアプリを同時に選択することも、1つ以上のアプリを選択することもできます。
特定のバージョンの選択したアプリにのみキャンペーンを送信したい場合は、アプリ情報の右側にあるバージョンボタンをクリックしてください。デフォルトでは、アプリのすべてのバージョンにキャンペーンを送信するため、バージョンを指定したくない場合は、何も調整する必要はありません。
ボタンをversionクリックすると、バージョンを選択するためのエリアが下に展開され、希望するバージョンを入力できます。希望するバージョンのテキストを直接入力する必要があるため、送信したいバージョン情報を事前に確認してください。
配送ターゲット¶
配達タイプを選択してください。
バンドルを選択すると、そのアプリのすべてのトークンに対してキャンペーンが送信されます。
ターゲティングを選択すると、事前に登録されたターゲティングデータを選択してターゲティングプッシュを送信できます。ターゲティングデータは、プッシュ > ターゲティングデータを登録メニューで別途登録する必要があります。事前に抽出されたターゲティングデータがある場合は、ターゲティングデータを登録メニューで登録し、キャンペーンの詳細を入力できます。登録日を基にターゲティングデータを検索すると、ターゲティングデータを登録メニューに登録されたデータが表示されます。使用したいターゲティングデータを見つけて選択してください。
Analytics v2> セグメント> ターゲティングキャンペーンメニューに移動して登録すると、配信タイプはターゲティングとして固定され、セグメントで生成されたターゲティングデータが自動的に登録されます。この場合、ターゲティング情報は変更できません。
配送先¶
配達場所を選択してください。['+'] または ['-'] をクリックして、すべての下位カテゴリを選択するか、すべてを解除します。
サーバー/国/タイムゾーンごとにキャンペーンを同時に送信できます。
国/タイムゾーンで送信する場合は、送信先の大陸名をクリックして、下にある個々の国のリストを展開してください。
サーバー情報は、そのアプリ(ゲーム)内のサーバーのリストを自動的に表示します。特定のサーバーを選択し、国/タイムゾーンを指定した場合、選択したサーバー内に国/タイムゾーンに一致するユーザー情報がないと、メッセージは送信されない場合があります。言い換えれば、「韓国」サーバーを選択し、国を「アメリカ > アメリカ合衆国」と指定した場合、ターゲットが存在しない可能性があります。対照的に、「U.S.」サーバー内の「アジア/韓国」ユーザーに特定のプッシュメッセージを送信したい場合は、別途ターゲティングを行わずに上記を指定することでメッセージを送信できます。配信とターゲットの目的に適した位置情報の値を指定してください。
Note
配信機能をサーバー経由で使用するには、実際のアプリでサーバーIDとトークンを送信して、対応するサーバーのユーザーにプッシュ通知を送信する必要があります。Hive SDKは、サーバー情報に関連するAPIをすでに提供しています。この機能を使用したいゲームがサーバー情報を提供しているかどうかを確認する必要があります。ゲームがサーバー情報を送信しているかどうか、または情報を送信する方法を確認するには、設定ガイドを参照してください。ガイド内の「Hive設定ファイル(hive_config.xml)」カテゴリの「ServerId」設定が必要です。
配達予約¶
キャンペーンを送信したい日時を指定してください。
最初に繰り返すかどうかを選択してください。繰り返すを選択すると、繰り返しの間隔を「毎日」または「毎週」と設定でき、繰り返す日付の間隔も選択できます。「毎週」を選択し、7日すべてを選択すると、キャンペーンは「毎日」を選択したかのように毎日送信されます。キャンペーンを繰り返したいが特定の日にキャンペーンを送信したくない場合は、「スキップ日付」フィールドで希望の日付を選択して追加できます。
日付、バンドル配信の使用有無、時間を選択してください。時間は韓国標準時(UTC +9)に基づいています。バンドル配信を使用する場合、キャンペーンは入力された時間(KST)に基づいて一度に送信され、宛先の現地時間は考慮されません。この場合、メッセージを入力する際に“%hh:mm%”変換コードを使用できます。
バンドル配信が使用されていない場合、配信は宛先のタイムゾーンに基づいてローカルタイムを考慮します。つまり、午後3時を入力すると、キャンペーンはローカルタイムに基づいて午後3時に順次送信されます。 %hh:mm% 変換コードは使用できません。
Note
中央の世界時間計算機は、配信機能に影響を与えない簡単な便利機能です。時間差を知りたいときは、ここで時間差を計算し、上部に情報を入力できます。時間差の計算は、キャンペーン登録オプションや配信に影響を与えません。
分散配信を希望する場合は、指定された時間ごとに配信する件数を送信できます。1分あたり10,000件を送信するように設定すると、指定された時間に最初に10,000件が送信され、その後残りのターゲットに対して1分あたり10,000件が送信されます。ターゲットが多すぎて単位が小さい場合、最後の人がキャンペーンを受け取るまでに長い時間がかかることがあります。送信する件数や時間の単位に制限はありません。全ての受信者が同時にプッシュメッセージを受け取ることを望まない場合のみ、この機能を使用してください。
メッセージ¶
キャンペーンの送信内容を入力してください。各入力フォームの詳細な機能は以下の通りです。(iOSの機能はAndroidと同じですが、iOSはフォーマットが簡素であるため、ガイドはAndroidに基づいて記述されています。)
タイトルの通り、事前に登録されたメッセージテンプレートがある場合は、右側のメッセージテンプレートを読み込むボタンをクリックすることで、テキストを一度に読み込むことができます。また、入力したメッセージテキストをそのままテンプレートとして保存することもできます。
また、事前に登録されたファイルをアップロードしてメッセージを登録することもできます。フォームをダウンロードするには、フォームダウンロードボタンをクリックして、事前にメッセージを入力してください。
テンプレートを初めてダウンロードすると、内容は空で、テンプレートにはヘッダーのみが含まれます。上のサンプルに示されているように、必須フィールドを記入してください。最も右の“isDefault”列は、どの言語をデフォルト値として指定するべきかを示しており、いずれかの言語にYを入力するだけで済みます。
Warning
isDefault列に複数のYを入力すると、デフォルト言語は最後に入力されたYに基づいて設定されます。これにより、意図しない言語がデフォルト言語として設定される可能性があるため、複数のYを入力しないように注意してください。
メッセージは合計16の言語でサポートされています。韓国語、中国語、中国語、英語、日本語の5つの主要な言語はデフォルトで展開され、他の11の言語は「他の言語を表示」ボタンをクリックすることで展開できます。
韓国語(ko) | 簡体字中国語(zh-hans) | 繁体字中国語(zh-hant) | 英語(en) | 日本語(ja) | - |
アラビア語(ar) | フランス語(fr) | ドイツ語(de) | スペイン語(es) | ポルトガル語(pt) | タイ語(th) |
イタリア語(it) | ロシア語(ru) | インドネシア語(id) | ベトナム語(vi) | トルコ語(tr) |
複数の言語を入力する場合、デフォルトの言語以外の言語が含まれていると、その言語がサーバーの受信者トークンに保存されている言語値と一致する限り、プッシュがその言語に送信されます。受信者トークンに保存されている言語値と一致する言語を入力していない場合、デフォルトフィールドに入力されたメッセージが送信されます。したがって、デフォルト値は必須です。言い換えれば、地域に関係なく英語でグローバルにプッシュを送信したい場合は、デフォルトフィールドに英語のテキストを入力し、他の言語は空白のままにしてください。英語フィールドに入力されたテキストは、トークンの言語値が英語に設定されているユーザーのみが受信できることに注意してください。
Note
言語値をトークンに保存するための基準は次のとおりです。まず、ゲーム言語がSDKを通じて別々に転送され、保存できる場合、ゲームのゲーム言語値が保存されます。 (最優先、ゲーム言語) ゲームがSDKにゲーム言語を別々に送信しない場合は、デバイスの言語値をインポートし、トークンに保存します。 (2番目の優先順位、デバイス言語)
例えば、すべてのユーザーに英語でプッシュを送信したいが、韓国のユーザーを除外したい場合は、デフォルトフィールドに英語を追加し、韓国フィールドに韓国語のテキストを追加できます。
AndroidとiOSアプリの両方を選択すると、一度に送信するメッセージを入力できます。AndroidとiOSアプリにプッシュメッセージを送信するために必要なフォームは異なるため、送信したいプッシュメッセージの形式を確認してください。AndroidとiOSの両方について、タイトルとショートMSG(メッセージ)フィールドを記入する必要があります。
メディアについては、Android用にJPG/JPEG/PNG/GIFファイルのいずれか1つ(画像のみ、最大10MB)を送信できます。iOSの場合、iOS 10以上のデバイスでは画像だけでなく音声や動画ファイルも送信できます。iOSでのメディア転送については以下を参照してください。
Warning
ただし、プッシュバックオフィスからメディアファイルを直接アップロードすることはできません。別の場所にファイルをアップロードし、リンクURLを登録する必要があります。
また、セキュリティ上の理由から、HTTPSプロトコルのアドレスのみが使用できます。(https://...形式)プレビュー¶
メッセージの入力が完了したら、実際のデバイスでメッセージがどのように表示されるかをプレビューエリアで確認できます。左側の画像はAndroidのプレビューで、右側の画像はiOSのプレビューです。デバイスの上部にあるカラー ピッカー ボタンをクリックすると、プッシュ通知 UI の背景色を変更できます。フォントカラーを適用している場合、この機能を使用して特定の背景色の上でテキストがよく見えるかどうかを事前に確認できます。
メディアが添付されている場合は、プレビューすることもできます。無効なメディアが挿入されているかどうかを再確認できます。
Warning
通知UIは各デバイスで異なり、すべての通知がデバイス間で同じようには見えません。行間、フォントカラー、メディアが正しく挿入されているかどうかなど、参考目的で使用してください。また、HTMLタグ以外のプッシュメッセージに<,>記号を含める必要がある場合は、<を<に、>を>に変更してください。
さらに、暫定承認は、Hive SDK v4.11.4以降を適用している場合、iOS 12以降のデバイスで自動的に適用されるため、通知はユーザーのデバイス設定によっては即座に表示されない場合があります。オプション¶
配達に関連するオプションを選択してください。すべて任意です。必要な機能がある場合のみ適用してください。
通知音の指定¶
プッシュ通知を受信したときに聞こえる通知音を設定します。ゲームクライアントに含まれるリソース名を入力してください。
プッシュアイコンの指定¶
ユーザーがプッシュ通知を受け取ったときに画面に表示されるアイコンを変更できます。
無効にすると、アプリのアイコンはデフォルトで左側の画像として表示されます。ただし、この機能を使用することで、右側の画像のようなアイコンを指定することができます。
機能を有効にするには、ゲームクライアントに含まれているリソース名を入力するか、画像のウェブURLを入力してください。
振動¶
ユーザーがプッシュ通知を受信したときにデバイスを振動させるかどうかを設定できます。
上書き¶
ユーザーがプッシュ通知を受信する際に、上書き機能を使用するかどうかを選択してください。1から99のコード値のいずれかを指定すると、上書き機能が自動的に有効になります。
上書き機能は、ユーザーがプッシュ内容を確認しているかどうかに関係なく、プッシュコードに基づいて新しいプッシュで以前のプッシュを上書きする機能です。ユーザーが以前に送信されたメッセージを確認していない場合、新しいプッシュを送信し、以前のプッシュメッセージを上書きし、ユーザーのデバイスに新しい通知を追加することなく送信します。この機能の主な目的は、ユーザーにプッシュ通知でスパムを送信するのを防ぎ、実際にユーザーが読んだプッシュメッセージの量を増やすことです。ただし、特に1日で補償が切れる日次プッシュメッセージなど、ユーザーに以前のプッシュメッセージを読んでほしくない場合にも使用できます。
上書き機能の使い方は次のとおりです:前日にキャンペーンの「ゲームA」に対してコード番号「1」を使用してプッシュを送信した場合、次の日に送信されるキャンペーンに対しても同じ条件(「ゲームA」に対してコード番号「1」を使用)でプッシュを送信する必要があります。このようにして、上書き機能が有効になり、新しいプッシュが前日に送信されたプッシュを上書きします。(ただし、上書き機能はユーザーがプッシュを読んでいない場合にのみ機能します。ユーザーがすでに読んだプッシュは上書き機能とは関係ありません。)
上書き機能を使用する目的や、必要に応じてコメントを入力してください。コメントを使用すると、上書き機能が使用されたプッシュメッセージを検索できます。コメントの入力は必須ではありません。
ユーザーエンゲージメント¶
ユーザーエンゲージメントを使用するかどうかを設定できます。
ユーザーエンゲージメントは、プッシュ内のディープリンクをサポートするために、Hive SDK v1.10以上でサポートされている機能です。
テキスト(SMS)またはプッシュ通知で送信されたメッセージにリンクを挿入することで、ユーザーがゲーム内の特定の場所にアクセスできるようにすることができます。また、ディープリンクにクーポンの値を挿入して送信することで、ユーザーがそれをタップしたときにゲームの受信箱から直接報酬を請求できるようにすることもできます。
ゲーム内ディープリンクを使用するには、ゲーム名/APPID/発行されたダウンロードURL/ターゲット場所を入力してリンクを作成し、生成されたURLをプッシュに挿入してください。
Note
ユーザーエンゲージメント機能を使用するには、以下の準備が必要です:
1. Hive SDK v1.10以上のアプリケーションが必要です。 個別のモジュールはサポートされていません。
2. スキーマURLを登録する必要があります。 対応するゲームにアクセスするために、各ゲームクライアントにスキームが登録されているか確認してください。
3. 自動分岐するゲームダウンロードURLが必要です。 バックオフィスでディープリンクを作成するには、OSによって自動的に分岐できるゲームダウンロードURLを発行する必要があります。
スキームオプションの値は次のとおりです。
未使用は、機能を使用しないときに選択される値です。ユーザーエンゲージメント機能を有効にしたい場合は、UEを選択してください。
上記は、前のコンボボックスで選択したUEが表示されます。「ゲーム」を選択すると、ゲームで指定されたフォーマットに基づいてコンテンツを入力できるようになります。これは、ゲームの内部機能に誘導されるための設定で、事前に定義されたパス値が必要です。パス値については、該当するゲームチームにお問い合わせください。「 Hive」を選択すると、Hiveで事前に定義されたフォーマットに基づいてコンテンツを入力できるようになります。選択すると、2番目のコンボボックスが有効になり、プリセット値を選択できるようになります。
スキームオプションによる利用可能なパスリストの詳細なリストは以下の通りです。
Hive内の住所について
AppID://hive/authlogin | Hive のログインページに移動します。ゲストとしてログインしている場合は、公式ログインページに移動します。公式 Hive アカウントでログインしている場合は、ページを表示することなく自動的にログインします。 |
AppID://hive/socalinquery | 1:1お問い合わせページに移動します。 |
AppID://hive/socialmyinquiry | Hiveメンバーとしてログインしたユーザーのみが「マイお問い合わせ」に移動します。 |
AppID://hive/promotionshow?type={number} | 入力されたタイプ値に対応するビューを持つカスタムビューページに移動します。 |
AppID://hive/offerwallsh | オファーウォールページに移動します。(Android専用) |
AppID://hive/promotioncoupon?couponid={couponid} | Couponidで入力されたクーポンを消費します。結果はC2SModuleApi_EngagementConsumeCouponにコールバックとして配信されます。 |
AppID://hive/socialmessage?uid={uid}&text={message} | uidフィールドにユーザーのuid情報を入力し、メッセージフィールドに詳細を入力して、Hiveメッセージの詳細を確認します。 |
AppID://hive/socialinvitation?uid={uid} | uidフィールドにユーザーのuid情報を入力すると、対応するユーザーに招待メッセージが送信されます。 |
ゲーム内のアドレスについて
AppID://game/{path}?{query} | ゲームの内部機能に移動するために使用されるスキーマです。ゲームで定義されたパス値を入力します。(パス値についてはゲームチームにお問い合わせください) “C2SModuleApi_EngagementProcessScheme”コールバックが発生します。このコールバックが発生した場合は、配信されたイベント日付を確認し、対応するアクションを実行する必要があります。 |
時間に敏感な¶
iOS 15以降でのみ利用可能です。ユーザーは、アプリを「時間に敏感を許可」に設定している場合、通知を受け取ることができます。広告付きの一括プッシュ通知はサポートされていません。ただし、「時間に敏感な通知」のみで使用してください。
例) 即時確認が必要なアカウントセキュリティ通知、特定の期間内に受け取る必要がある製品など。
Note
Time sensitive Notifications機能を使用するには、以下の準備が必要です。
1. OSはiOSのみが適用され、OSはiOS 15以降である必要があります。
2. 適用されるSDKはSDK 1.19.4以降およびSDK 4.15.4以降である必要があります。
3. iOS 15以降 > 設定 > 通知 > アプリを選択 > Time sensitive Notificationsのトグルをオンにする必要があります。
4. iOS 15以降 > 設定 > フォーカスモード > アプリを選択 > Time sensitive Notificationsのトグルをオンにする必要があります。
5. ただし、フォーカスモードのTime sensitive Notificationsのトグルがオンになっていなくても、通知が受信されるのは、通知のTime sensitive Notificationsのトグルがオンになっている場合です。
6. OSがiOS 15未満であるか、上記の条件が満たされていない場合、プッシュ通知は受信されますが、通知の概要として表示されます。
7. UIは、キャンペーンを登録する際に「ターゲティングプッシュ」を選択した場合のみ表示されます。
iOS 15以降のOS設定フローを参照してください
未使用は、機能を使用しないときに選択される値です。これがデフォルトです。
「時間に敏感な通知」機能を使用したい場合は、「使用」を選択してください。時間に敏感な通知のオプション値は次のとおりです。
注意¶
iOS通知サービス拡張とは何ですか?¶
これは、iOS 10で追加された新しいUserNotiTcations.framework機能を利用する機能です。これにより、プッシュ通知エリアにメディア(画像、音声、動画)を追加および転送することができます。
この機能は、Xcode 8.0 以上がインストールされたデバイス、または iOS 10 以上のデバイスで利用可能です。これらのバージョンよりも低いデバイスでは、この機能を使用してもユーザーは以前と同じプッシュを受け取ります。
許可されているメディアタイプと容量は以下の通りです:
カテゴリ | タイプ | 最大制限 |
オーディオ | WAV, MP3, MP4(オーディオ) | 5MB |
画像 | JPG, JPEG, PNG, GIF | 10MB |
ビデオ | MP4, AVI | 50MB |
iOSの仮の認証とは?¶
iOS 12以降の新しいプッシュ通知受信機能です。
この機能が適用されたOSバージョンでは、プッシュ通知は受信時にすぐには表示されません。むしろ、ユーザーは上部のiOS通知センターから下にスワイプしてプッシュ通知を表示する必要があります。この方法で受信したすべての通知は、ユーザーにデフォルトで同じ方法で通知を受け取り続けるかどうかを尋ねます。
ユーザーは、「保持」ボタンをタップすることで、アプリからの通知をどのように受け取りたいかを指定できます。ユーザーがアプリの通知を便利だと感じた場合、「目立って配信」をタップすることで、アプリが通常通り通知を送信するようになります。そうでない場合は、「静かに配信を続ける」をタップして、静かに通知を受け取り続けることができます。
ユーザーは「‘通知をオフにする…」をタップして、対応するアプリの通知をオフにできる画面に移動できます。