メインコンテンツへスキップ

​
概要

このガイドでは、OneSignal WordPress Web Push Plugin v3+のセットアップと設定方法について説明します。
古いバージョン2.x.xのWordPressドキュメントについては、WordPress Legacy pluginをご覧ください。

​
バージョン3+の新機能

このリリースは、セットアップと設定プロセスを合理化する大幅なアップグレードです。バージョン3+では、すべてのプロンプト設定を1か所、つまりOneSignalダッシュボードで処理できます。
  • 🚀 SDKアップグレード: OneSignal Web SDKをバージョン15から16に更新
  • 💬 ダッシュボードプロンプト: すべてのパーミッションプロンプトをOneSignalダッシュボードで直接設定—カスタムコードは不要
  • ⏩ ワンクリック公開: 「投稿が公開されたときに通知を送信する」にチェックを入れると、プッシュ通知が自動的に送信されます
  • 🧑‍🤝‍🧑 オーディエンスターゲティング: 各投稿でどのセグメントが通知を受け取るかを選択
  • 📲 モバイルアプリ統合: オプションのディープリンクでモバイルアプリの購読者に送信
古いバージョン2.x.xのWordPressドキュメントについては、WordPress Legacy pluginをご覧ください。

​
セットアップ

始める前に、以下をご用意ください：
  • OneSignalアカウント（無料で作成可能）
  • プラグインをインストールおよび設定するためのWordPress管理者アクセス
  • HTTPS対応のウェブサイト（Webプッシュ通知に必要）

​
1. OneSignalダッシュボードでWordPressを設定

Settings > Push & In-App > Web > WordPress Plugin or Website Builderに移動します

​
サイトのセットアップ

  • Site Name: サイトの名前とデフォルトの通知タイトル。
  • Site URL: WordPressサイトの正確なURLと一致する必要があります（Same-origin policyに従う）
  • Auto Resubscribe: これを有効にすると、ブラウザデータをクリアしたユーザーがサイトに戻ったときに自動的に再購読されます（新しいパーミッションプロンプトは不要）
  • Default Icon URL: 通知とプロンプト用の正方形256x256pxのPNGまたはJPGファイル – MacOS Safariはアイコンがないと通知プロンプトを表示しません。
ローカルでテストしていますか？localhost開発についてはLocal Testing Guideをご覧ください

​
パーミッションプロンプト

Push、Email、および/またはSMSのパーミッションプロンプトをセットアップします。Push Slide Promptはデフォルトで有効になっていますが、カスタマイズしたり、追加のプロンプトを追加したりできます。
プロのヒント: シンプルなプロンプトから始めて、徐々に複雑さを追加してください。OneSignalダッシュボードからいつでもすべてのプロンプト設定を変更できます。Webパーミッションプロンプトで利用可能なすべてのオプションをご覧ください。
1

Push Slide Promptをクリックしてカスタマイズ

2

タイミングとテキストを設定：

  • Auto Promptを1ページビューと1秒に設定して初期テストを行います
    • プロンプトのテキストと外観をカスタマイズ
    • ローンチ後、ユーザーの行動に基づいてタイミングを調整
3

プロンプトの設定が完了したらDoneをクリック。

​
ウェルカム通知

ユーザーが最初に購読した後に送信される即時通知をセットアップします。これにより：
  • 購読してくれたユーザーに感謝
  • 通知がどのように表示されるかを実演
  • エンゲージメントを高め、購読解除を減らす
ウェルカムメッセージのテキストとタイミングを設定し、下にスクロールしてSaveをクリックします。
今のところOneSignalダッシュボードのAdvanced Push Settingsセクションはスキップしてください—これらはカスタムWeb SDKセットアップ用です。Saveをクリックして続行してください。

​
2. WordPressプラグインを設定

ダッシュボードの設定を保存すると、App IDとAPI Keyが表示されます。これらの値をWordPressプラグインにコピーします：
API Keyが表示されませんか？ Keys & IDsガイドに従って作成してください。
1

WordPress管理画面で、OneSignalプラグイン設定に移動

2

ダッシュボードに表示されているとおりにApp IDとREST API Keyを貼り付け

​
詳細設定

必要に応じて追加のプラグインオプションを設定します：
URLパラメータトラッキング トラッキングのために通知URLに分析パラメータを追加します。重要: 特殊文字をエスケープしてください—入力はそのままURLに追加されます。 Google Analyticsの例： 
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
特殊文字を含む例： 
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
追加設定
  • Custom Post Types: プラグインからの投稿タイプを追加して通知オプションを有効化
  • Automatically send notifications when a post is published: 投稿を公開するときに通知ボックスを自動的にチェックし、手動でチェックを入れなくても通知が送信されます
  • Automatically send notifications when a post is updated: 投稿を更新するときに通知ボックスを自動的にチェックし、手動でチェックを入れなくても通知が送信されます
  • Automatically send notifications when a page is published: ページを公開するときに通知ボックスを自動的にチェックし、手動でチェックを入れなくても通知が送信されます
  • Automatically send notifications when a page is updated: ページを更新するときに通知ボックスを自動的にチェックし、手動でチェックを入れなくても通知が送信されます
  • Automatically send a push notification when I publish a post from 3rd party plugins: 外部公開プラグインから通知を自動送信
  • Mobile App Integration: 同じOneSignal App IDを使用してモバイルアプリの購読者に通知を送信

​
3. 移行を完了（アップグレードユーザーのみ）

新規インストールの場合はこの手順をスキップできます。v2+からアップグレードする場合は、以下に従ってください…
期限付き: 移行中にユーザーが通知を見逃さないように、これらの手順をできるだけ早く完了してください。
1

OneSignalダッシュボードの設定を保存した後、WordPressに戻る

2

プラグイン設定でMigration Completedをクリック

3

Save Settingsをクリックしてアップグレードを完了

セットアップ完了！Save Settingsをクリックしてプラグインの設定を完了してください。

​
セットアップのテスト

  1. ウェブサイトにアクセス（シークレット/プライベートブラウジングは避けてください—これらのモードではユーザーは購読できません） 2. 設定したスライドダウンプロンプトを探します
  1. 購読ボタンをクリック（この例では「Subscribe」とラベル付けされています）
  2. プロンプトが表示されたらブラウザのパーミッションを承認
  1. ウェルカム通知を確認（設定している場合）
成功！ WordPressサイトがWebプッシュ通知用に設定されました。ユーザーが購読すると、Subscriptionsに表示され始めます。
次のステップ：
問題がありますか？ 一般的な解決策については、WordPressトラブルシューティングガイドをご確認ください。

​
通知の公開

投稿を公開するようにスケジュールすると、OneSignalは購読者に送信するプッシュ通知もスケジュールします。投稿を再スケジュールすると、プッシュ通知はキャンセルされ、新しい時間に新しいプッシュがスケジュールされます。 スケジュールされた通知とキャンセルされた通知は、OneSignalダッシュボードのDelivery > Scheduled Messagesで確認できます。詳細についてはPushメッセージレポートをご覧ください。

​
基本的な投稿通知

WordPress投稿を作成または編集する際、OneSignal Push Notificationsメタボックス（通常は投稿エディタの下部またはサイドバーにあります）を探します。
通知を送信するには：
  • **「Send notification when post is published or updated」**にチェックを入れる
  • その投稿の通知送信をスキップする場合はチェックを外す

​
オーディエンスターゲティング

​
すべての購読者に送信（デフォルト）

デフォルトでは、通知はすべてのプッシュ購読者に送信されます。

​
特定のセグメントに送信

OneSignal Dashboard > Audience > Segmentsで作成したセグメントを使用して特定のオーディエンスをターゲットにします。 ステップ3でカテゴリを設定した場合、対応するセグメントを作成します：
  1. OneSignalダッシュボードでAudience > Segmentsに移動
  2. タグキーを使用してセグメントを作成します。例：
    • News Segment: タグnewsが1
    • Deals Segment: タグdealsが1
  1. セグメントを作成した後、WordPress投稿エディタを更新
  2. ドロップダウンからターゲットセグメントを選択
高度なセグメンテーション: ユーザーの行動、場所、デバイスタイプなどに基づいてセグメントを作成します。タグは、カスタムユーザーデータとパーソナライゼーションに最も柔軟性を提供します。

​
通知コンテンツのカスタマイズ

​
デフォルトの動作

  • Title: WordPressサイトのタイトルを使用（Settings > General）
  • Message: 投稿タイトルを使用
  • Image: 投稿のアイキャッチ画像を使用（設定されている場合）
  • URL: 公開された投稿へのリンク

​
カスタムコンテンツ

**「Customize notification content」**にチェックを入れてデフォルトを上書き：
例の結果：

​
OneSignal WordPressプラグインにカスタム投稿タイプを追加

​
カスタム投稿タイプ名を見つける

新しい投稿を作成するときにブラウザのアドレスバーを見てください。URLは次のようになります： 
https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type
post_typeパラメータの値（例：your_custom_type）が、OneSignalプラグインの設定に追加する必要がある正確な名前です。

​
OneSignal設定に追加

  1. WordPress管理画面でOneSignal > Settingsに移動
  2. Advanced Settingsで、カスタム投稿タイプ名をCustom Post Typesフィールドに追加
  3. 設定を保存
一般的な例: product（WooCommerce）、tribe_events（Events Calendar）、portfolio

​
モバイルアプリ統合

同じOneSignal App IDを使用するモバイルアプリがある場合：
  1. プラグイン設定で**「Send notification to Mobile app subscribers」**を有効化
  2. 投稿メタボックスで、ディープリンク用のMobile URLを追加
  3. モバイルユーザーはWebブラウザの代わりにアプリに誘導されます
スケールアップの準備完了: 高度な通知キャンペーンのために高度なプッシュ戦略と自動化されたジャーニーを探索してください。
通知が表示されませんか？ 解決策についてはWebプッシュトラブルシューティングガイドをご確認ください。

​
FAQ

注意: この方法は、スライドダウンおよびネイティブパーミッションプロンプトでのみ機能し、ベルやカスタムリンクプロンプトでは機能しません。
  1. OneSignalダッシュボードで、Settings > Push & In-App > Web Settingsに移動
  2. Permission Prompt Setupテーブルからプロンプトを選択
  3. Auto Promptのチェックを外し、Doneをクリック
  1. 下にスクロールしてSaveをクリックし、その後Finishをクリック
  2. プロンプトを表示したい特定のページにカスタムJavaScriptコードを追加
これにより、プロンプトのタイミングと配置を完全に制御できます。実装の詳細についてはWebパーミッションプロンプトをご覧ください。
はい！モバイルアプリが同じOneSignal App IDを使用している場合：
  1. WordPressプラグイン設定で**「Send notification to Mobile app subscribers」**を有効化
  2. 投稿を公開するときは、OneSignalメタボックスのMobile URLフィールドを使用してディープリンクを指定
  3. カスタムMobile URLがない場合、ユーザーはウェブサイトに誘導されます
この機能により、単一のWordPressインターフェイスからクロスプラットフォームメッセージングが可能になります。
WordPressプラグインは現在、プッシュ通知のみをサポートしています。EmailとSMSについては：
  1. Email: Emailセットアップガイドに従い、その後Emailメッセージングツールを使用
  2. SMS: SMSセットアップガイドに従い、その後SMSメッセージングツールを使用
両方のチャネルは、プッシュ通知と一緒に同じOneSignalダッシュボードから管理できます。
キャッシュの問題: WordPressのキャッシュにより、移行の変更が遅延する場合があります。解決策：ステップ1: ウェブサイトを右クリックしてInspectを選択ステップ2: Networkタブに移動ステップ3: **「Disable cache」**にチェックを入れる
ステップ4: ウェブサイトを更新して現在の設定を確認ステップ5: 該当する場合、WordPressキャッシュプラグインの設定をクリア
このエラーは、移行が不完全であることを示しています：
解決策：
  1. OneSignalダッシュボードの設定を保存したことを確認
  2. WordPressで、プラグイン設定の**「Migration Completed」**をクリック
  3. Save Settingsをクリックしてアップグレードを完了
このエラーは、バージョン2.x.xからアップグレードするユーザーにのみ影響します。
はい、onesignal_send_notificationフィルターを使用できます。
カスタムPHPコードはwp-content/mu-plugins/onesignal-custom.phpに配置してください。これにより、正しく読み込まれ、更新によって上書きされることを防ぎます。
<?php

add_filter('onesignal_send_notification', function($fields, $post_id) {

  // Create Notification APIリファレンスで言及されているプロパティを含めます：
  // https://documentation.onesignal.com/reference/push-notification 例：

  // アクションボタンを追加
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Read More",
      "url" => get_permalink($post->ID)
    )

  // 変更されたfieldsアレイを返す
  return $fields;

}, 10, 2);