Skip to main content
Web SDK を使用して Self-Handled オプトインオプションを統合できます。MoEngage アプリで Self-Handled オプトインを選択する必要があります。 詳細については、Web Push 設定の構成を参照してください。

Self-Handled オプトイン

特定のページや特定のアクションの後にのみ、ブラウザのオプトインを選択的に表示できる詳細設定です。プッシュ権限を表示するには、スクリプトから Moengage.callWebPush() 関数を呼び出す必要があります。
(必須)プッシュ権限を表示するには、スクリプトから Moengage.callWebPush() 関数を呼び出します。
サンプルコードの詳細については、サンプルコードを参照してください。

カスタム Soft-Ask を使用した Self-Handled オプトイン

Web サイト用にパーソナライズされた Soft-Ask を構築している場合、MoEngage では次の手順を推奨しています。 SOFTASK

カスタム Soft Ask を有効にする

  1. MoEngage アプリで Self-Handled オプトインの設定が選択されていることを確認します。
  2. Web サイト用にパーソナライズされた Soft-Ask の HTML を作成します。
  3. HTML 内の次のクラス属性を必ずメモしておきます。
    1. Soft-Ask の HTML 全体を囲む parent div
    2. Allow Button(s)
    3. Block Button(s)
  4. 親 div の display スタイル属性を none に設定します。
  1. すべてのページで、次のオブジェクト引数を指定して Moengage.callWebPush( {...} ) を呼び出します。
    (2 番目のステップでメモしたクラス属性を使用します)
  1. Soft Ask を表示するタイミングやその他すべての処理は SDK が行います。ユーザーの操作に対するコールバックが必要な場合は、完全に機能するカスタム Soft-Ask を参照してください。

カスタム Soft-Ask を有効にするための基本的なコードサンプル

カスタム Soft-Ask API の詳細リファレンス

Moengage.callWebPush 関数は、次のオブジェクトを引数として受け取ります。
  • soft_ask フラグが true に設定されている場合、Soft Ask が表示され(main_class が表示され)、ユーザーが Soft Ask を操作するのを待機し、操作されると対応するコールバックが実行されます。
  • ハードアスクがブロックされている場合、再度プロンプトは表示されません。

MoEngage カスタム Soft-Ask API の利点

  • MoEngage SDK が Web プッシュをサポートしているブラウザがどれかわからないため、push_token がないまま Soft Ask を表示してしまうことになります。
  • ユーザーがすでに必要な権限を付与していることがわからないため、不必要に Soft Ask を表示してしまう可能性があります。
  • ユーザーが最後に Soft Ask を閉じた時期がわからないため、(MoEngage ダッシュボードで)設定された optIn-reappear-time の経過後ではなく、次のページ読み込み時にすぐに Soft Ask を表示してしまい、ユーザーエクスペリエンスの低下につながります。
Web サイト用にパーソナライズされた Soft-Ask を構築している場合は、カスタム Soft-Ask API を使用することを強くお勧めします。

完全に機能するカスタム Soft-Ask

サイトの要素との干渉を避けるため、MoEngage では、レンダリングされるすべての Web ページで Moengage.callWebPush() 関数を呼び出すことを推奨しています。

Soft Ask の例

この例では、画面の左下に表示される「ベル」アイコンという別の Soft Ask を実装します。 Softaskexample 必要な HTML は次のとおりです。

Soft Ask を再表示するためのサンプルコード

このサンプルコードでは、次の内容について説明します。
  • ユーザーが「許可しない」をクリックした場合
  1. localstorage(MOE_DATA)で OPT_IN_SHOWN_TIME を検索します。
  1. softAskStatus が shown または dismissed であるかを確認し、optInShownTime に基づいて Soft Ask を表示するかどうかを決定します。

次のステップ

オプトインを設定した後、ユーザーが Web サイトにアクセスすると、オプトイン権限のリクエストを求めるプロンプトが表示されます。ユーザーがオプトインリクエストを承認すると、MoEngage のユーザープロファイルページで Web プッシュの到達可能性アイコンが緑色になります。詳細については、ユーザーの到達可能性を参照してください。

トラブルシューティング

オプトインが表示されない

次の手順に従ってください。
  1. MoEngage ダッシュボードでドメインタイプが http または https のどちらに設定されているかを確認し、それがアプリケーションのドメイン URL と同じであることを確認します。
  2. 他のプッシュ通知プロバイダーを使用しており、その serviceworker ファイルが MoEngage の serviceworker ファイルと重複している可能性があります。
  3. serviceworker ファイルを確認します。次のコードが含まれている必要があります。

プッシュのオプトインプロセスを変更するにはどうすればよいですか?

プッシュのオプトインには 3 つのオプションがあります。詳細については、Web Push 設定の構成を参照してください。

通知権限のオプトインバナーまたはナッジをカスタマイズしたいです。

時間(バナーまたはナッジを表示するまでの時間)、テキスト、フォント、フォントサイズをカスタマイズできます。詳細については、Web Push 設定の構成を参照してください。 さらにサポートが必要な場合は、MoEngage のカスタマーサクセスマネージャー(CSM)またはサポートチームにお問い合わせください。