> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Webプッシュ通知を配信する

> SDKまたはGoogle Tag Managerの導入を確認し、Webプッシュ通知の配信タイミング、配信対象、内容を設定します。

Webプッシュ通知を配信する前に、サイトにNotiflyを導入できているか確認します。

1. Webサイトに[NotiflyのGoogle Tag Managerテンプレート](https://docs.notifly.tech/ja/developer-guide/google-tag-manager.md)または[Notifly JavaScript SDK](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md)が導入されていることを確認します。
2. [Webプッシュ通知の連携テスト](https://docs.notifly.tech/ja/integration-test.md#5-webプッシュ通知をテストする)を実施します。

## 1. 配信タイミングを設定する

Webプッシュは、予約配信、イベントベースの配信、API経由の配信に対応しています。詳しくは[キャンペーンの配信タイミング](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-%E9%80%81%E4%BF%A1%E3%82%BF%E3%82%A4%E3%83%9F%E3%83%B3%E3%82%B0)を参照してください。

ユーザーが複数の端末やブラウザ（Chrome、Edgeなど）でWebサイトを利用している場合、配信方法によって通知先が異なります。

* 予約配信では、プッシュ通知の購読が有効なブラウザすべてに通知を送信します。
* API経由で配信する場合は、受信者ごとに`type`に`user-id`を指定し、`userId`にユーザーIDを設定します。そのユーザーのプッシュ通知の購読が有効なブラウザに配信します。
* イベントベースの配信では、該当するイベントが発生したブラウザにのみ通知を送信します。

## 2. 配信対象を設定する

Webプッシュの配信対象は、ユーザーグループの設定またはCSVのアップロードで指定できます。詳しくは[ユーザーグループの設定](https://docs.notifly.tech/ja/user-guide/campaigns/campaign-segments/segment.md#1-%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97%E8%A8%AD%E5%AE%9A)を参照してください。

## 3. 通知の内容とアクションを設定する

### 3-1. 通知の基本設定

タイトル、本文、画像、通知をクリックしたときのアクションを設定できます。

![Webプッシュキャンペーンの基本設定画面](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-push-notification/web-push-campaign-basic-settings.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=56327444cd78facef6e0ed7d207839db)

#### 3-1-1. タイトルと本文を設定する

タイトルと本文を入力すると、プレビューを確認できます。

* 実際に表示される文字数はブラウザや端末によって異なります。目安はタイトル75文字、本文225文字までです。
* 絵文字を使用できます。

#### 3-1-2. 画像を設定する（任意）

* PNGまたはJPEG（.jpg、.jpeg）ファイルに対応しています。ファイルサイズは200 KB以下を推奨します。
* 360 × 240ピクセル以上を推奨します。PCとモバイル端末では表示サイズや縦横比が異なるため、配信前に両方で表示を確認してください。
* アップロード済みの画像を使う場合は、画像のURLを入力する方法を選びます。

![Webプッシュキャンペーンの画像設定画面](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-push-notification/web-push-campaign-image.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=743141716dba241c0082c03909681956)

> [!NOTE]
>
> 詳しくは[ChromeのmacOSネイティブ通知への切り替えに関するお知らせ](https://developer.chrome.com/blog/native-mac-os-notifications?hl=ja)を参照してください。

#### 3-1-3. クリック時のアクションを設定する（任意）

* 初期設定では、Webプッシュ通知をクリックするとWebサイトのトップページが開きます。
* URLを指定すると、通知をクリックしたときに任意のページを開けます。

## 4. Webプッシュの通知許可をリクエストする

ユーザーがWebプッシュ通知を受け取るには、ブラウザで通知を許可する必要があります。サイトから許可を求めることができます。通知をブロックしたユーザーは、ブラウザの設定でそのサイトの通知を許可する必要があります。

### 4-1. 標準の通知許可リクエスト

標準の設定では、まずNotiflyの案内ポップアップを表示します。ユーザーがその案内で通知の受け取りに進むと、ブラウザが通知の許可を求めます。ユーザーが案内を閉じた場合は、後で再表示できます。案内の表示をサイトに合わせて調整する方法は、開発者ガイドの[プッシュ通知の許可をリクエストする](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md#3-プッシュ通知の権限をリクエストする)を参照してください。

### 4-2. Webポップアップのボタンで同意を取得する

独自のWebポップアップで受信同意を取得するには、ボタンのアクションに**Webプッシュの同意処理**を設定します。ログインしていないユーザーも対象です。サイトでWebプッシュを設定し、**JavaScript SDK 2.22.0以上**を使用してください。これより古いバージョンでは同意ボタンが無効になります。

![同意して通知を受け取るボタンを配置したWebポップアップの例](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-push-notification/popup-before-click.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=fc3497252d17651b51f80c23ed0a5a9a)

ユーザーがボタンをクリックすると、Notiflyは`$web_push_consent`と`$web_push_consented_at`を記録し、標準の案内ポップアップを表示せずにブラウザで通知の許可を求めます。

Webポップアップは、ユーザーの回答やプッシュ通知の購読手続きが完了する前に、ブラウザが許可を求めた時点で閉じます。ユーザーが通知を拒否したり、ブラウザのダイアログを閉じたりしても、Webポップアップは閉じたままです。

![サンプルサイトからの通知を許可するか尋ねるChromeのダイアログ](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/web-push-notification/browser-permission.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=c5185b9629d67cee191d206877aea7cc)

このポップアップからのみ許可を求める場合は、**設定 > SDK設定 > ウェブサイト設定 > 権限要求ポップアップ設定**で**自動表示を使用**をオフにします。設定手順と、ユーザーがブラウザの確認画面で選んだ項目ごとの動作は、[WebポップアップでWebプッシュの同意を取得する](https://docs.notifly.tech/ja/user-guide/channel/web-message/file.md#web%E3%83%97%E3%83%83%E3%82%B7%E3%83%A5%E3%81%AE%E5%8F%97%E4%BF%A1%E5%90%8C%E6%84%8F%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)を参照してください。

### 4-3. 受信同意とブラウザの権限を管理する

`$web_push_consent` は、ユーザーがWebポップアップの同意ボタンをクリックして通知の受信に同意したことを記録するユーザー属性です。ブラウザで通知を許可したかどうかとは別の情報です。ブラウザで通知を拒否したり、後からブロックしたりしても、保存済みの同意は自動で更新されません。Webプッシュ通知が届くには、ブラウザで通知が許可され、プッシュ通知の購読が有効になっている必要があります。

ユーザーが受信同意を取り消せるようにするには、サイトに配信停止画面を用意します。ユーザーが配信停止の手続きをしたら、連携処理で`$web_push_consent`を`false`に更新します。

キャンペーンの配信対象やユーザージャーニーの進入対象を条件で指定する場合は、**`$web_push_consent`が`true`のユーザー**に絞り込んでください。ジャーニーの進入条件は進入時にだけ確認されます。進行中のジャーニーで配信前に同意を確認するには、メッセージノードの直前にユーザーグループ分岐ノードを置き、同意済みのユーザーだけがメッセージノードに進むように設定します。属性を更新しても、ブラウザの通知権限やプッシュ通知の購読は解除されません。

配信停止の実装例は[JavaScript SDKガイド](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md#webポップアップのボタンで同意を取得する)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.