概要
「プロンプト」とは、メッセージを送信する許可をユーザーに求めるプロセスを指します。プロンプトは、ブラウザまたはモバイルアプリに表示されるポップアップメッセージであり、サブスクライブしてメッセージを受信するには、ユーザーが「許可」をクリックする必要があります。このガイドでは、さまざまなタイプのWebプロンプトとその設定方法について説明します。 Webプッシュはデスクトップ、Android、iOSで動作しますが、iOSのWebプッシュには追加の手順が必要です。モバイルアプリをお持ちの場合は、アプリ内メッセージでプッシュ権限をプロンプトする方法をご覧ください。 ブラウザは独自のネイティブなシステムレベルの権限プロンプトを提供しており、ユーザーがWebサイトでプッシュ通知にサブスクライブするには、これが表示され「許可」がクリックされる必要があります。ブラウザは現在、ネイティブ権限プロンプトを表示する際にWebサイトがより選択的であることを強く推奨しています。これが、ネイティブプロンプトの前にOneSignalプロンプトまたは独自のカスタム「ソフトプロンプト」を使用することが推奨される理由です。OneSignalプロンプト(ソフトプロンプト)
OneSignalソフトプロンプトは、ブラウザのネイティブ権限プロンプトの前に表示される、ユーザーフレンドリーでカスタマイズ可能なプロンプトです。これらのプロンプト自体はユーザーをメッセージにサブスクライブさせません。代わりに、次のような役割を果たします:- メッセージ(プッシュ、メール、またはSMS)へのサブスクライブの価値を説明します。
- ブラウザが権限リクエストを自動的にブロックするのを防ぎます。
- ユーザーが関心を示した後にのみ、ネイティブブラウザプロンプトを起動します。
プロンプトアイコン
Settings > Push & In-App > WebでDefault Iconを設定します。このアイコンは、メッセージごとに上書きしない限り、Webプッシュ通知とプロンプトに表示されます。- 受け入れられる形式:PNG、JPG、または非アニメーションGIF
- 推奨サイズ:
256×256ピクセル - 設定されていない場合、OneSignalは汎用のベルアイコンを使用します

Webプッシュ設定のSite setupセクション
権限プロンプトの設定
サイトに表示したいプロンプトを設定します。OneSignalダッシュボードで、Settings > Push & In-App > Web Settings > Permission Prompt Setupに移動します。 そこから、Add Promptをクリックして、OneSignalの利用可能なプロンプトタイプから選択します。リストに既に表示されている既存のプロンプトを編集することもできます。
新しいプロンプトを追加するか、編集したいプロンプトを選択します
- Slidedown:プッシュ通知とオプションのカテゴリ選択に使用される、視覚的に目立つプロンプト。
- Email/Phoneプロンプト:ユーザーのメールアドレス、電話番号、またはその両方を収集するために使用されます。
- Subscription bellプロンプト:プッシュサブスクリプション用の永続的なフローティングウィジェット。通常、サイトの下隅に配置されます。
- Custom linkプロンプト:サイトに埋め込まれたカスタマイズ可能なボタンまたはリンクで、ネイティブブラウザプロンプトをトリガーします。
- Native permission prompt:ユーザーがプッシュ通知を受信するために承認する必要がある、必須のブラウザレベルのプロンプト。
Slidedown & category
SlideおよびCategoryプロンプトは、デスクトップでは画面の上部中央に、モバイルでは下部中央に目立つように表示されます。これらは、必須のnative permission promptの前に表示される、高い視認性を持つソフトプロンプトです。これら自体がユーザーをサブスクライブさせるわけではありませんが、サブスクリプションフローを開始し、ユーザーの関心を捉えるのに役立ちます。
カテゴリタグ付きのSlideプロンプト
- Settings > Push & In-App > Web Settings > Permission Prompt Setupに移動します
- Add Prompt > Push Prompt > Push Slide Promptを選択します
initコード内のpromptOptionsオブジェクトで、slidedownプロパティを使用します。詳細については、Web SDK Referenceをご覧ください。

プッシュスライドプロンプトのオプション
Slideプロンプトテキスト
スライドプロンプトに表示されるテキストをカスタマイズできます:- アクションメッセージ:最大90文字
- ボタンラベル:各最大15文字
- フォント、サイズ、または色のカスタマイズは現在サポートされていません

スライドプロンプトのテキストオプション
initコード内のpromptOptionsオブジェクトで、textプロパティを使用します。詳細については、Web SDK Referenceをご覧ください。カテゴリ
Slidedownプロンプトにカテゴリを追加することで強化できます。カテゴリは、特定のメッセージトピック(例:ニュース、セール、更新)への関心をユーザーが示すことができるチェックボックスです。- 最大10個のカテゴリが許可されます
- 各カテゴリは、
1(選択済み)または0(未選択)のData Tagとして保存されます - ユーザーの好みによるセグメンテーションとメッセージのターゲティングに役立ちます
- Label:ユーザーがプロンプトで見るもの。最初の文字を大文字にすることをお勧めします。
- Tag Key:OneSignalのタグになるもの。
cat_<category>という命名規則(小文字、スペースの代わりにアンダースコア)を使用します — 例:cat_breaking_news、cat_sports、cat_apparel。これはOneSignalの業界別ガイド全体で使用されている規則と一致し、同じタグの名前空間をページ訪問の行動から自動的に設定できるようにします。自動タグパターンについては、ページトピックでユーザーにタグを付けるを参照してください。 - Update Instructions、PositiveおよびNegativeボタン:ユーザーがすでにプッシュにサブスクライブした後にカテゴリプロンプトを再度表示することを選択した場合、アクションメッセージの代わりに更新手順が表示されます。これにより、ユーザーにカテゴリを更新できることを通知できます。

ラベルとタグキーによるカテゴリ設定
initコード内のpromptOptionsオブジェクトで、categoriesプロパティを使用します。詳細については、Web SDK Referenceをご覧ください。Email & phone number prompt
Email & Phoneプロンプトは、Slidedown内で直接オプションのユーザー連絡先情報を収集します。各フィールドには、正しい形式を保証する組み込みの検証があります。 送信されると:- ユーザーのために新しいEmailおよび/またはSMSサブスクリプションが作成されます
- これらのチャネルを介してメッセージングを開始できます
- Settings > Push & In-App > Web Settings > Permission Prompt Setup > Add Prompt > Email/Phone Promptに移動します。

メールと電話番号のプロンプト設定

メールと電話番号のプロンプトオプション
initコード内のpromptOptionsオブジェクトに、typeをemail、sms、またはsmsAndEmailのいずれかに追加します。詳細については、Web SDK Referenceをご覧ください。Subscription bell prompt
Subscription Bell Promptは、Webサイトの下隅に表示される小さな永続的なウィジェットです。サブスクライブしていないユーザーがクリックすると、Native Browser Promptがトリガーされます。 最小限のフットプリントのため、ベルは常に表示したままにすることができ、継続的なオプトイン機会のための受動的でありながら効果的なオプションとなります。却下を必要とせず、ユーザーにサブスクライブするタイミングをコントロールする権限を提供します。
Subscription bellプロンプトウィジェット
Typical Site & WordPress Setup: Subscription Bell Prompt
Typical Site & WordPress Setup: Subscription Bell Prompt
- 色
- サイズ
- 下部位置(左または右)
- テキストとラベル

ダッシュボードのSubscription bell設定
Custom Code Setup: Subscription Bell Prompt
Custom Code Setup: Subscription Bell Prompt
notifyButtonパラメータを使用します。Bell Promptのカスタマイズのために、さまざまな例を切り替えることができます。非表示: ユーザーがサブスクライブした後にサブスクリプションベルを非表示にするか、特定のページでのみ表示するには、初期化中のdisplayPredicate関数で値false または 値falseに解決されるPromiseを返すようにしてください。この関数は、サブスクリプションベルが表示される前に評価されます。サブスクリプションベルを表示するには、他の値を返すことができます。Custom link prompt
Custom Link Promptは、Webサイトのどこにでも埋め込むことができる、ユーザーがトリガーするボタンまたはリンクです。クリックすると、プッシュ通知のNative Browser Promptが表示されます。
Custom linkプロンプトの例
- ブログ投稿の下:「この記事が気に入りましたか?投稿後すぐに更新を受け取りましょう!」
- サイトのフッター内
- 固定ヘッダーまたはフローティングツールバー内
Typical Site & WordPress Setup: Custom Link Prompt
Typical Site & WordPress Setup: Custom Link Prompt

ダッシュボードのCustom link設定
Custom Code Setup: Custom Link
Custom Code Setup: Custom Link
initコード内のpromptOptionsオブジェクトに、customlinkオブジェクトとその利用可能なプロパティを追加します。Typical & Custom Code Setup: Additional Styling
Typical & Custom Code Setup: Additional Styling
onesignal-resetがあり、要素から以前のスタイリングを削除して、当社の内部スタイルとの競合がなく、ダッシュボードで定義したとおりに見えるようにします。OneSignalのスタイルを再定義する必要がある場合は、Custom Linkウィジェットで使用されるクラスの簡単なリファレンスを次に示しますNative permission prompt
ネイティブ権限プロンプトは、ユーザーがWebサイトからプッシュ通知にサブスクライブするために承認する必要がある、ブラウザによって制御されるダイアログです。このプロンプトは:- サブスクリプションに必須
- OneSignalソフトプロンプトの後に自動的にトリガーされます
- 外観、テキスト、または動作はカスタマイズできません

ChromeのNative permission prompt
ブラウザのネイティブプロンプト動作
さまざまなブラウザは、スパムの権限リクエストを減らすために独自の動作と制限を課します。スパムと悪いユーザー体験に対抗する取り組みとして、OneSignalは以下に挙げる特定のケースで自動的にSlideプロンプトをデフォルトにします。 Slideプロンプトを表示せず、ネイティブ権限プロンプトを直接使用したい場合は、Auto Promptオプションをオフにして、Web SDKrequestPermission()メソッドを使用する必要があります。 以下で説明するとおり、ネイティブ権限プロンプトを直接表示することは、すべてのブラウザで機能するとは限りません。
Chrome
Chrome 80+は、完全なプロンプトの代わりに静かなUIを表示する場合があります:- プロンプトを頻繁に拒否するユーザーに自動的に適用されます
- 拒否率が高いサイトにも適用されます

Chromeデスクトップの静かな通知UI
- プロンプトを表示する機会は3回あります
- 3回目の却下後、プロンプトは7日間抑制されます(ソース)。
Firefox
Firefox 72+は、ネイティブ権限プロンプトをトリガーするためにユーザージェスチャーを必要とするようになりました。Firefoxでネイティブ権限プロンプトを自動的に表示しようとすると、次のようなアイコンがブラウザ内に表示され、ユーザーはネイティブ権限プロンプトを表示するためにこのアイコンをクリックする必要があります。
Firefoxの通知権限アイコン
Safari
Safari 12.1+は、ネイティブ権限プロンプトをトリガーするためにユーザージェスチャーを必要とするようになりました。Edge
Edgeは信頼ベースのモデルを使用します:- サイトが信頼されていない場合、プロンプトは抑制され、ブラウザバーのベルアイコンに置き換えられます:

Edgeで信頼されていないサイトに表示されるベルアイコン
- サイトが信頼されている場合、ネイティブプロンプトは通常どおり表示されます:

Edgeで信頼されているサイトのネイティブプロンプト
自動プロンプトと表示設定
エンゲージメントを最大化し、ユーザーを中断させないために、サイトでしばらく過ごした後にプロンプトを表示することをお勧めします。OneSignalでは、2つの遅延条件を使用してユーザーの動作に基づいてプロンプトを自動的に表示できます:- Page Views:ユーザーがサイトの任意のページを読み込んだ回数
- Seconds on Page:ユーザーがページで過ごす必要がある時間
Typical Site & WordPress Setup: Auto Prompt
Typical Site & WordPress Setup: Auto Prompt
- Settings > Push & In-App > Web Settings > Permission Prompt Setupに移動します
- プロンプトを選択するか、新しいプロンプトを作成します
- Auto Promptを有効にします
- 遅延の設定(ページビューと時間遅延)を設定します

自動プロンプトの遅延設定
- Done、次にSaveをクリックします
Custom Code Setup: Auto Prompt
Custom Code Setup: Auto Prompt
initコード内のpromptOptionsオブジェクトで、autoPromptおよびdelayオプションを使用します。目的のslidedownまたはnativeプロンプトを直接トリガーするメソッドもあります。詳細については、Web SDK Referenceをご覧ください。Manual Triggering (Instead of Auto Prompt)
Manual Triggering (Instead of Auto Prompt)
- Auto Promptを無効にします
- SDKのSlidedownまたはNative Promptメソッドを使用して、コードを介してプロンプトを表示します
Slidedownプロンプトのバックオフロジック
Slidedown(Push、Category、またはEmail/Phone)プロンプトが表示されて却下されると(Allow、Cancel、またはダイアログを閉じることによって)、定義されたスケジュールでバックオフして再表示されます:Webプッシュ権限をリクエストするためのベストプラクティス
ユーザーにWebプッシュ権限を許可してもらうには、タイミング、信頼、およびユーザーフレンドリーなデザインが必要です。サイト上でのポジティブな体験を維持しながらオプトイン率を最大化するには、次のベストプラクティスに従ってください。尋ねるタイミングを戦略的に
頻度よりもタイミングが重要です。ユーザーがすでにエンゲージしているか、意図を示しているときに権限プロンプトを表示します。例:- カートに商品を追加した後、または投稿やコメントにエンゲージした後
- プロフィールを更新したとき、またはアカウントにサインインしたとき
- ブランドへのコミットメントを示すアクションを完了したとき
Subscription Bell Promptを使用する
Bell Promptは、ユーザーがいつでもサブスクライブできる、永続的で邪魔にならない方法です。このフローティングベルアイコンは、次の理由から長期的なエンゲージメントに最適です:- ブラウジングを中断することなく、サブスクリプションオプションを常に表示します。
- ユーザーが選んだタイミングでサブスクライブできるようにします。
- 即時の権限リクエストを強制しないことで信頼を築きます。
カテゴリでユーザーにサブスクリプションをパーソナライズさせる
Category Promptを使用すると、ユーザーは「セール」「製品アップデート」「ブログ投稿」など、希望するトピックやメッセージタイプを選択できます。このアプローチは:- プロンプトの押しつけがましさを軽減し、関連性を高めます
- エンゲージメントとメッセージのクリック率を向上させます
- 期待値を早期に設定することで、後のオプトアウトを減らします
継続的にテストして最適化する
単一の戦略に頼らないでください。さまざまなプロンプトタイプ、メッセージ、タイミングをテストして、オーディエンスに何が響くかを確認してください。 次のアプローチを試してください:- 数か月間ネイティブブラウザプロンプトから始めて、ベースラインのオプトイン率を測定します。
- データを収集した後、スライドダウンプロンプトまたはカスタムプロンプトフローを試して、ブラウザとオーディエンスセグメント全体でコンバージョンを改善します。
- SDKの
permissionPromptDisplayおよびpermissionChangeイベントとslidedownイベントを使用してパフォーマンスを追跡します。
FAQ
プロンプトの表示に関する問題
次の条件のいずれかが真である場合、ブラウザのネイティブ権限プロンプトが表示されない場合があります: 1. ブラウザがプロンプトの表示をブロックした。 ブラウザの設定に移動し、「通知」の権限設定を確認してください。Chromeの例:chrome://settings/content/notifications

Chromeの通知設定
- ユーザーが「サイトに通知の送信を許可しない」を選択しており、これによりネイティブ権限プロンプトの表示が妨げられます。ネイティブ権限プロンプトを表示できるようにするには、「サイトが通知の送信を求めることができる」と表示されている必要があります。
- ユーザーが
https://yoursite.comを「通知の送信を許可しないサイト」リストに追加しており、これによりネイティブ権限プロンプトの表示が妨げられます。ネイティブ権限プロンプトを表示できるようにするには、これをリストから削除する必要があります。
- Chrome - このページでは、設定 > プライバシーとセキュリティ > サイトの設定 > 通知に移動して、Chromeで通知を管理する方法を説明しています。ここでは、デフォルトの動作を制御し、個々のWebサイトの権限を管理できます。
- Firefox - このガイドでは、FirefoxのWebプッシュ通知について説明しており、設定 > プライバシーとセキュリティ > 通知から通知権限を管理する方法と、アドレスバーのサイト情報アイコンから特定のサイトの権限を制御する方法を説明しています。
- Safari - このAppleのガイドでは、Safari > 環境設定 > Webサイト > 通知から、MacでSafariの通知をカスタマイズする方法を説明しています。ここでは、どのサイトが通知を送信できるかを管理し、システム環境設定から通知の動作を制御できます。
- Edge - この記事では、設定 > プライバシー、検索、サービス > サイトのアクセス許可 > 通知に移動するか、アドレスバーのサイト情報アイコンをクリックして、Edgeの通知を管理する方法を詳しく説明しています。
ソーシャルメディアアプリのWebビューでプロンプトを表示するには?
ソーシャルメディアアプリ(Instagram、TikTok、Facebookなど)で使用されるWebビューは、Webプッシュ通知をサポートしていません。アプリは、Webプッシュをサポートする完全なブラウザでWebサイトを開く必要があります。スライドプロンプトが表示され続けるのはなぜですか?
一般的な原因は2つあります:- シークレットモード、プライベートブラウザモード、またはゲストブラウザモードになっている。
- Auto Promptオプションを使用せずに、プログラムでプロンプトをトリガーしている。Web SDK Referenceを参照して、使用しているプロンプトメソッドを確認してください。
プロンプトを却下した後、いつ再度表示されますか?
OneSignalプロンプトについては、Slidedownプロンプトのバックオフロジックをご覧ください。ネイティブ権限プロンプトについては、Browser native prompt behaviorをご覧ください。ネイティブブラウザプロンプトではなくスライドプロンプトが表示されるのはなぜですか?
特定のブラウザでは、ネイティブプロンプトを表示する前にユーザージェスチャーが必要です。これらのケースでは、OneSignalは自動的に最初にスライドプロンプトを表示します。詳細については、Browser native prompt behaviorをご覧ください。プロンプトを翻訳またはローカライズするには?
Custom Code Setupを使用して、ユーザーのブラウザ言語をプログラムで検出し、異なるテキストでOneSignal SDKを初期化します。ネイティブ権限プロンプトは、ブラウザの設定言語に自動的に翻訳されます。プロンプトをA/Bテストできますか?
はい。Custom Code Setupを使用して、異なるプロンプトオプションでOneSignalを初期化できます。A/Bテストをトリガーする独自の方法を設定する必要があります。Subscription Changeイベントを使用してユーザーがサブスクライブしたことを検出し、どのバリアントが勝ったかに基づいてタグを追加します。サブスクライブしたページに基づいてサブスクリプションをセグメント化できますか?
はい。Auto-Segment By Subscription Pageガイドをご覧ください。ベルアイコンを変更できますか?
いいえ。ベルの画像は変更できませんが、色、テキスト、位置(左下または右下)はカスタマイズできます。アクセシビリティ監査でサブスクリプションベルがフラグされるのはなぜですか?
現在のバージョンのWeb SDKは、ベルボタンにデフォルトのアクセシブル名「Manage notifications」を付与するため、Lighthouse、PageSpeed Insights、axeで使用される「ボタンには識別可能なテキストが必要」チェックに合格します。ラベルを変更またはローカライズするには、Custom Code Setupを使用して、notifyButton.textのlauncher.button.aria-labelキーを設定します。
ページに基づいてカテゴリを変更できますか?
はい、2つの方法があります。異なるページで異なるカテゴリチェックボックスを表示するには、Custom Code Setupを使用して、ページごとにcategories promptOptionsを設定します。読者がブラウジングする際に(プロンプトを表示せずに)cat_<category>タグを自動的に適用するには、ページトピックでユーザーにタグを付けるを参照してください — 自動タグパターンはCategory Promptと同じタグの名前空間を使用するため、2つのアプローチをきれいに組み合わせることができます。
スライドプロンプトのイベントを追跡するには?
OneSignal Web SDKには、プロンプトが表示されたとき、閉じられたとき、「Allow」または「Cancel」アクションを受け取ったときを検出するためのSlide Prompt Event Methodsがあります。特定のページでのみプロンプトを表示するには?
Auto Promptを無効にし、プロンプトを表示したい特定のページでSlidedown prompt SDKメソッドを使用します。Bellプロンプトはページごとに無効にすることはできません。モバイルでネイティブプロンプトではなくスライドプロンプトが表示されるのはなぜですか?
Chrome for Androidは、ブラウジング体験を妨げるフルスクリーンのネイティブプロンプトを表示します。OneSignalは、より良いユーザー体験を提供するために、最初にスライドプロンプトを表示します。これをバイパスするには、Prompt EditorでAuto Promptをオフにして、Web SDKrequestPermission()メソッドを使用します。