WordPress

​

概要

​

バージョン3+の新機能

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

​

セットアップ

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

​

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

OneSignalダッシュボードのWebsite BuilderオプションからWordPressを選択

​

サイトのセットアップ

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

正確なSite URLを入力してください。https://your-site.comとhttps://www.your-site.comは異なります—一貫して1つの形式のみを使用してください

​

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

• 基本的なプロンプトのセットアップ
• 上級：カテゴリベースのセグメンテーション

1

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

プッシュスライドプロンプトの設定にアクセスしてカスタマイズ

2

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

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

自動プロンプトのタイミングを設定し、プロンプトの外観をカスタマイズ

3

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

ユーザーの興味に基づいたターゲットメッセージングのために、カテゴリを設定します：

1

プロンプト設定でCategoriesを選択

2

各カテゴリを次のように設定：

• Label: ユーザーがプロンプトで見るもの
• Tag Key: セグメンテーション用の内部タグキー

3

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

例：NewsとDealsのカテゴリを設定すると、これらのオプションをチェックしたユーザーに対して「news: 1」と「deals: 1」のタグが作成されます

タグのロジック: チェックされたカテゴリはタグの値を1に、チェックされていないものは0に設定します。これらのタグにより、特定のユーザーの興味に対するターゲットメッセージングが可能になります。

​

ウェルカム通知

• 購読してくれたユーザーに感謝
• 通知がどのように表示されるかを実演
• エンゲージメントを高め、購読解除を減らす

​

2. WordPressプラグインを設定

OneSignalダッシュボードからApp IDとAPI Keyをコピー

WordPressプラグインのApp IDとREST API KeyがOneSignalダッシュボードと正確に一致していることを確認

​

詳細設定

拡張機能と分析トラッキングのための詳細設定

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. 移行を完了（アップグレードユーザーのみ）

Migration Completedをクリックしてプラグインのアップグレードを完了

​

セットアップのテスト

• 初期テスト
• 購読を確認
• テストメッセージを送信

1. ウェブサイトにアクセス（シークレット/プライベートブラウジングは避けてください—これらのモードではユーザーは購読できません） 2. 設定したスライドダウンプロンプトを探します

設定したスライドダウンプロンプトがタイミング設定に基づいて表示されるはずです

3. 購読ボタンをクリック（この例では「Subscribe」とラベル付けされています）
4. プロンプトが表示されたらブラウザのパーミッションを承認

Webプッシュ通知に必要なブラウザのパーミッションプロンプト（外観はブラウザによって異なります）

5. ウェルカム通知を確認（設定している場合）

購読が成功した直後にウェルカム通知が表示されます

1. OneSignalダッシュボードで、Audience > Subscriptionsに移動 2. Webプッシュ購読が「Subscribed」としてマークされているのが確認できるはずです

購読が成功するとOneSignalダッシュボードのオーディエンスに表示されます

1. OneSignalダッシュボードでMessages > Pushに移動 2. New Messageを作成 3. 自分宛てにテスト通知を送信 4. 通知が正しく表示されることを確認 詳細な手順については、Pushメッセージングガイドをご覧ください。

• 高度なカスタマイズについてはWebパーミッションプロンプトを確認
• EmailとSMS統合についてはチャネルセットアップを探索
• ターゲットメッセージングのためのセグメンテーション戦略をセットアップ

​

通知の公開

​

基本的な投稿通知

OneSignal Push Notificationsメタボックス—必要に応じてドラッグして位置を変更できます

• **「Send notification when post is published or updated」**にチェックを入れる
• その投稿の通知送信をスキップする場合はチェックを外す

​

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

​

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

​

特定のセグメントに送信

1. OneSignalダッシュボードでAudience > Segmentsに移動
2. タグキーを使用してセグメントを作成します。例：
   • News Segment: タグnewsが1
   • Deals Segment: タグdealsが1

タグは大文字と小文字を区別します！「news」と「News」は異なるタグです

3. セグメントを作成した後、WordPress投稿エディタを更新
4. ドロップダウンからターゲットセグメントを選択

関連するユーザーグループをターゲットにする特定のセグメントを選択

​

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

​

デフォルトの動作

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

​

カスタムコンテンツ

通知タイトル、コンテンツ、その他の要素をカスタマイズ

ユーザーに表示されるカスタマイズされたプッシュ通知

​

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

​

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

https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type

​

OneSignal設定に追加

1. WordPress管理画面でOneSignal > Settingsに移動
2. Advanced Settingsで、カスタム投稿タイプ名をCustom Post Typesフィールドに追加
3. 設定を保存

​

モバイルアプリ統合

1. プラグイン設定で**「Send notification to Mobile app subscribers」**を有効化
2. 投稿メタボックスで、ディープリンク用のMobile URLを追加
3. モバイルユーザーはWebブラウザの代わりにアプリに誘導されます

​

FAQ

特定のページでプロンプトを無効にするにはどうすればよいですか？

注意: この方法は、スライドダウンおよびネイティブパーミッションプロンプトでのみ機能し、ベルやカスタムリンクプロンプトでは機能しません。

1. OneSignalダッシュボードで、Settings > Push & In-App > Web Settingsに移動
2. Permission Prompt Setupテーブルからプロンプトを選択
3. Auto Promptのチェックを外し、Doneをクリック

Auto Promptを無効にして、プロンプトが表示されるタイミングを手動で制御

4. 下にスクロールしてSaveをクリックし、その後Finishをクリック
5. プロンプトを表示したい特定のページにカスタムJavaScriptコードを追加

これにより、プロンプトのタイミングと配置を完全に制御できます。実装の詳細についてはWebパーミッションプロンプトをご覧ください。

移行後、プロンプトが機能しないのはなぜですか？

キャッシュの問題: WordPressのキャッシュにより、移行の変更が遅延する場合があります。解決策：ステップ1: ウェブサイトを右クリックしてInspectを選択ステップ2: Networkタブに移動ステップ3: **「Disable cache」**にチェックを入れる

移行後に更新されたファイルを強制的に読み込むためにブラウザのキャッシュを無効化

ステップ4: ウェブサイトを更新して現在の設定を確認ステップ5: 該当する場合、WordPressキャッシュプラグインの設定をクリア

`A bad HTTP response code (404)`エラーはどういう意味ですか？

このエラーは、移行が不完全であることを示しています：

ブラウザコンソールの404エラーは、移行プロセスが不完全であることを示します

解決策：

1. OneSignalダッシュボードの設定を保存したことを確認
2. WordPressで、プラグイン設定の**「Migration Completed」**をクリック
3. Save Settingsをクリックしてアップグレードを完了

このエラーは、バージョン2.x.xからアップグレードするユーザーにのみ影響します。

<?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);