Skip to main content
高度なセクションでは、特定の要件またはカスタム実装を持つ顧客向けの専門的な構成と通知動作について説明します。

WebプッシュWebhook

OneSignalは、通知イベントを処理するための専用のWebプッシュWebhookを提供します。完全な実装の詳細については、WebプッシュWebhookを参照してください。 重要:WebプッシュWebhookはイベントWebhookとは別の実装であり、互換性がありません。

サービスワーカーの構成

OneSignalはデフォルトでルートスコープのサービスワーカーを自動的にチェックします。ただし、セキュリティを向上させ、既存のサービスワーカーとの競合を回避するために、ルート以外のスコープを使用するように統合をカスタマイズすることを強くお勧めします カスタムスコープ構成を実装するには、OneSignalサービスワーカーセットアップガイドに従ってください。 ルート以外のスコープを使用する理由:
  • 既存のサービスワーカーとの競合を防止します
  • OneSignalのスコープを制限することでセキュリティを向上させます
  • サイトのサービスワーカーアーキテクチャをより適切に制御できます

ローカル開発とテスト

開発およびテストの目的で、次をカバーする包括的なローカルテストガイドを参照してください:
  • ローカルホスト環境のセットアップ
  • SSL証明書なしでの通知のテスト
  • 一般的な開発問題のデバッグ

通知クリック動作

OneSignalは、ユーザーが通知をクリックしたときの複数のブラウザー動作をサポートしています。高度なURL処理やクリックアクションを完全に無効にするなどのオプションについては、ディープリンクとURLを参照してください。

デフォルトの動作

ユーザーが通知をクリックし、サイトを開いていない場合、ブラウザーは新しいタブを開き、通知のURLに移動します。

サイトがすでに開いている場合

ユーザーが1つ以上のブラウザータブでサイトを開いている場合、ブラウザーの応答方法を構成できます: Exact Navigate(デフォルト)
  • 通知の正確なURL(例:example.com/product)を開いているタブに一致させます
  • その一致するタブで通知のURLに移動します
  • 特定のページターゲティングに最適
Origin Navigate
  • 通知のオリジン(例:example.com)をサイトの任意の開いているタブに一致させます
  • 一致したタブで通知のURLに移動します
  • 一般的なサイトナビゲーションに便利
Exact Focus
  • 通知の正確なURLを開いているタブに一致させます
  • ページを更新せずにそのタブにフォーカスします
  • ユーザーの現在のページ状態を中断したくない場合に最適
Origin Focus
  • 通知のオリジンをサイトの任意の開いているタブに一致させます
  • ページを更新せずにそのタブにフォーカスします
  • ナビゲーションなしでサイトに注意を向けるのに最適

通知の永続性

デフォルトでは、通知は約5秒間表示された後、通知履歴に移動し、オペレーティングシステムによって自動的に削除される前に1週間そこに残ります。

永続的な通知の有効化

ChromeとEdgeブラウザーのサブスクライバーに対して、ユーザーが操作するまで通知を画面に表示し続けることができます。
すべてのブラウザーとオペレーティングシステムが永続的な通知をサポートしているわけではありません。有効にすると、対象ユーザーにのみ影響し、文字数が減少したり、画像/ボタンの表示に影響を与えたりすることで、通知の外観に影響を与える可能性があります。
重要な考慮事項:
  • 現在のサブスクライバーは、この設定を有効にした後、変更を確認するためにサイトに再度アクセスする必要があります
  • 永続的な通知を過度に使用すると、ユーザーを苛立たせる可能性があります
  • 重要度の高い通知(例:タスク管理アプリ)にのみ推奨されます
  • ユーザーは通知の上にカーソルを合わせて、読むために表示し続けることができます

実装方法

1

ダッシュボード構成

OneSignalダッシュボードの「Persistence」トグルを使用して、この機能を有効/無効にします。

通知の永続性トグル

2

カスタムコード実装

WebプッシュSDKの初期化にpersistNotificationプロパティを追加します:
persistNotification: true,
OneSignal initコードにこれを含めて、サポートされているブラウザーとオペレーティングシステムの永続性を有効にします。

ブラウザーの互換性

サポートされているブラウザー:
  • Chrome(完全サポート)
  • Edge(完全サポート)
サポートされていないブラウザー:
  • Firefox(設定は効果なし)
  • Safari(設定は効果なし)

ベストプラクティス

  • 控えめに使用:ユーザーのフラストレーションを避けるために、本当に重要な通知にのみ有効にします
  • 徹底的にテスト:さまざまなブラウザーとデバイスで動作を確認します
  • ユーザーのフィードバックを監視:通知疲れを示す可能性のあるオプトアウト率の増加に注意してください
  • コンテキストを考慮:永続的な通知は、時間に敏感またはアクション可能なコンテンツに最適です
次のステップ:
  • 永続性が適切かどうかを判断するために通知戦略を確認します
  • 完全な展開の前に、小規模なユーザーセグメントで機能をテストします
  • 実装後のエンゲージメントメトリクスを監視します
  • 異なる通知タイプに対して異なる永続性設定の実装を検討します