Webプッシュセットアップ

Webプッシュ通知は、ユーザーがWebサイトを積極的に閲覧していないときでも、タイムリーなコンテンツで再エンゲージする方法です。テキスト、画像、アクションボタン、サウンドを含むリッチコンテンツをサポートします。 Webプッシュが機能するには：

• HTTPSウェブサイト：Webプッシュは、有効なSSL証明書を持つセキュアなサイトでのみ機能します
• サービスワーカー：OneSignalサービスワーカーをウェブサイトに追加できる必要があります
• 単一ドメインオリジン：同一オリジンポリシーに従う必要があります
• ユーザー権限：ユーザーは通知を受信するために明示的に権限を付与する必要があります
• サポートされているブラウザー：ほとんどの最新ブラウザー（Chrome、Firefox、Safari、Edge）で動作します

このガイドでは、SDKのセットアップからパーソナライズされたプッシュメッセージの送信まで、OneSignalプッシュ通知を正常に実装するためのすべてのステップを説明します。

---

​

Webプッシュ開発者ガイド

Webプッシュ通知を送信する前に、開発者は次の手順を完了する必要があります。

---

​

構成オプション

OneSignalダッシュボードのSettings > Push & In-App > WebでWebサイトをWebプッシュ用に設定します。 サイトに一致する統合タイプを選択します： サイトの詳細：

• サイト名：デフォルトの通知タイトルで使用されます
• サイトURL：ドメインオリジンと完全に一致する必要があります（パスやwwwの不一致はありません）
• 自動再サブスクライブ：推奨 - ブラウザーデータをクリアした再訪問ユーザーを自動的に再サブスクライブします
• デフォルトアイコンURL：通知に表示される256x256pxの画像（設定されていない場合、デフォルトのベルアイコンが使用されます）

​

自動再サブスクライブ

ユーザーがブラウザーデータをクリアすると、プッシュ通知の受信が停止します。このオプションを有効にすると、ユーザーがサイトに戻ったときに自動的に再サブスクライブされます。詳細については、サブスクリプションを参照してください。

---

​

Web権限プロンプト

通知権限のプロンプトは、オプトインにとって重要です。セットアップに基づいて、権限リクエストの動作と外観をカスタマイズできます。

---

​

ウェルカム通知

ユーザーがサブスクライブした直後に送信されるオプションの確認プッシュを有効にできます。 通常のセットアップとWordPress統合では、ダッシュボードでこれを設定できます。 カスタムコード統合では、OneSignal.init関数のwelcomeNotificationオブジェクトを使用します。詳細については、Web SDKリファレンスを参照してください。 ウェルカム通知を送信する理由：

• ユーザーにサブスクリプションが成功したことを知らせる
• 今後の通知がどのように表示されるかを示す
• オンボーディングコンテンツまたは次のステップを提供する

---

​

ユーザーとサブスクリプション

ユーザーがプッシュにサブスクライブすると、OneSignalは自動的にブラウザー/デバイスに関連付けられた一意のサブスクリプションを作成します。 Webプッシュサブスクリプションは、次の場合に作成されます：

• 特定のブラウザーとデバイスを使用して、Webサイトでプッシュ通知の権限を付与する
• ブラウザーデータをクリアした後にサイトに戻る（自動再サブスクライブが有効な場合）
• 新しいブラウザーまたはデバイスからサブスクライブする

​

iOSサポート

Appleは、iOS 16.4+を実行しているiPhoneとiPad向けにWebプッシュのサポートを追加しましたが、より厳しい要件があります：

• ユーザーはサイトをホーム画面に追加する必要があります
• 権限プロンプトはそのステップの後にのみ表示されます
• 有効にすると、通知はネイティブアプリのアラートのように動作します

---

​

Webプッシュ通知のデザイン

効果的なプッシュ通知を作成するには、テキストを書くだけでは不十分です。カスタマイズ可能な要素とその効果的な使用方法を学びましょう。

1. タイトル：注目を集める見出し（推奨：50文字未満）
2. メッセージ：メインの通知コンテンツ（推奨：120文字未満）
3. アイコン：ブランドアイコンまたは通知固有の画像（推奨：256x256px PNGまたはJPG）
4. 大きな画像：目を引くビジュアルコンテンツ
5. アクションボタン：コールトゥアクションボタン
6. ブラウザー：プッシュを表示するブラウザー/アプリ
7. ドメイン：ブラウザーによって自動的に設定されるサイトのオリジン
8. タイムスタンプと閉じる：ブラウザーがこれらのコントロールを追加します
9. その他のオプション：ブラウザー固有の追加コントロール

​

メッセージのパーソナライゼーションとローカライゼーション

各ユーザーの設定と言語に合わせてプッシュメッセージをカスタマイズできます。

---

​

Webプッシュの動作を構成

プッシュメッセージが送信された後の動作（表示されるタイミング、保存期間、ユーザーとの対話方法）を制御します。

​

配信、表示、閉じる設定

​

クリック動作

ユーザーが通知をクリックしたときに何が起こるかを制御します。 デフォルト： クリックするとホームページが開きます。 カスタマイズ：

• ユーザーを特定のURLに誘導する
• UTMトラッキングを使用する
• ?_osp=do_not_openでデフォルトの動作を抑制する

---

​

セットアップのテスト

起動前に、デバイスとブラウザー全体でWebプッシュ実装を徹底的にテストします。

​

起動前チェックリスト

• SDKがエラーなしで正しく読み込まれている
• 権限プロンプトが表示され機能する
• テスト通知が送信され受信される
• アイコンと画像が正しくレンダリングされる
• サービスワーカーが登録され最新の状態になっている
• HTTPS証明書が有効である

​

プッシュ分析とトラブルシューティング

通知のパフォーマンスを測定し、一般的な配信問題を解決します：

---

​

次のステップ

---

​

よくある質問

​

iOSのユーザーはWebプッシュに登録できますか？

はい、iOS 16.4+から可能です。ユーザーはまずウェブサイトをホーム画面に追加してから、通知の許可を付与する必要があります。完全なセットアップ手順については、iOS用Webプッシュを参照してください。

​

ユーザーがWebプッシュ通知を受信しなくなったのはなぜですか？

最も一般的な原因は、ユーザーがブラウザーデータをクリアしたことで、プッシュサブスクリプションが削除されることです。Webプッシュ設定で自動再サブスクライブを有効にすると、再訪問ユーザーを自動的に再サブスクライブできます。詳細については、サブスクリプションを参照してください。

​

Webプッシュ通知はシークレットまたはプライベートブラウジングモードで機能しますか？

いいえ。ユーザーはシークレットまたはプライベートブラウジングモードではWebプッシュに登録できません。通常のセッションで作成されたサブスクリプションはプライベートモードではアクセスできません。

​

Webプッシュ通知をサポートするブラウザーはどれですか？

Chrome、Firefox、Safari（macOSおよびiOS 16.4+）、Edgeはすべてwebプッシュをサポートしています。各ブラウザーはプロンプトの動作や通知の表示が異なる場合があります。ブラウザー固有の詳細については、WebプッシュFAQを参照してください。

​

サブドメインでWebプッシュを使用できますか？

各サブドメイン（例：app.example.com と shop.example.com）は別々のオリジンです。ブラウザーはWebプッシュに同一オリジンポリシーを適用するため、各サブドメインには独自のOneSignalアプリが必要です。サービスワーカーも購読ページと同じオリジンでホストする必要があります——CDNや他のサブドメインは許可されていません。セットアップオプションについては、複数サイト＆サブドメインを参照してください。

​

Webプッシュに複数のドメインを登録するにはどうすればよいですか？

各ドメインまたはサブドメインには個別のOneSignalアプリが必要です。単一のOneSignalアプリは1つのオリジンのみに対応できます。複数のドメインを管理するには、サブスクリプションのためにユーザーを単一のオリジンにリダイレクトするか、オリジンごとに個別のOneSignalアプリを作成してください。詳細な戦略については、複数サイト＆サブドメインを参照してください。

​

Webプッシュプロンプトが表示されないのはなぜですか？

一般的な原因には、サイトがHTTPS経由で配信されていない、サービスワーカーが正しく登録されていない、ユーザーがすでに許可または拒否している、またはユーザーがシークレットモードにあるなどが含まれます。ブラウザーのコンソールでエラーを確認し、完全なチェックリストについては通知が表示されないを参照してください。