> ## 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.

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

> SDKの組み込みを確認し、Notiflyでアプリプッシュ通知を設定します。

1. アプリに[Notifly SDK](https://docs.notifly.tech/ja/developer-guide/index.md)が導入されていることを確認します。
2. [アプリプッシュ通知の連携テスト](https://docs.notifly.tech/ja/integration-test.md#3-アプリプッシュ通知をテストする)を実施します。

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

アプリプッシュは、予約配信、イベントベースの配信、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)を参照してください。

ユーザーが複数の端末でアプリを利用している場合、配信方法によって通知先が異なります。

* 予約配信とAPI経由の配信では、ユーザーがアプリを利用するすべての端末に通知を送信します。
* イベントベースの配信では、該当するイベントが発生した端末だけが通知の対象です。

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

アプリプッシュの配信対象は、ユーザーグループの設定または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. 通知の基本設定

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

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

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

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

* 実際に表示される文字数は端末によって異なります。Androidではタイトル65文字、本文240文字、iOSでは全体で4行または178文字が目安です。
* 絵文字を使用できます。

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

* PNGまたはJPEG（.jpg、.jpeg）ファイルに対応しています。
* 画像は横2：縦1の比率を推奨します。
* 画像は幅と高さをそれぞれ1024px以下、ファイルサイズを150KB以下にしてください。

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

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

* 初期設定では、通知をタップするとアプリが開きます。
* タップ時にWebページを開くには、ページのURLを指定します。アプリ内の特定の画面を開くには、アプリ側で設定済みのディープリンクを指定します。

> [!WARNING]
>
> ディープリンクでアプリを開く場合は、`appName://`のようにアプリ固有のURLスキームを使用してください。

### 3-2. 通知の詳細設定（任意）

![アプリプッシュキャンペーンの詳細設定画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/app-push-campaign-advanced-settings.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=612dee35902ba96babb0cdecc23ba929)

#### 3-2-1. 通知の重要度を設定する（Androidのみ）

Androidでは、重要度によって通知の表示方法や音の有無が変わります。ヘッドアップ通知を表示するには、**高**を選択します。

#### 3-2-2. 通知バッジを無効にする（Androidのみ）

バッジはアプリアイコンに表示される目印です。Androidでバッジを表示しない場合は、**通知バッジを無効化**をオンにします。

#### 3-2-3. カスタムメッセージデータを追加する

プッシュ通知の`data`フィールドにデータを追加できます。たとえば、アプリ内の通知一覧への追加や、通知の種類に応じた処理に使えます。

## 4. 広告目的のアプリプッシュ通知を配信する

アプリのSDKで、ユーザーが広告通知の受信に同意しているかを記録します。配信停止ページを用意し、受信に同意したユーザーだけを配信対象にします。単一言語のメッセージでは、**広告メッセージかどうか**をオンにします。多言語メッセージでは、言語ごとに必要な広告表記と配信停止の案内を追加します。同じ受信同意の条件を複数のキャンペーンで使う場合は、配信対象の基本条件に追加できます。

詳しくは[広告目的のアプリプッシュ通知と配信停止の設定](https://docs.notifly.tech/ja/user-guide/channel/app-push-notification/marketing-push-compliance.md)を参照してください。

## 5. Webhookで配信結果を受け取る

Webhookを使うと、Notiflyのアプリプッシュ通知の配信結果をリアルタイムで受け取れます。**設定 > チャネル設定 > プッシュ通知 (App)** を開き、**発信結果受信Webhook URL**にエンドポイントを入力します。

![配信結果を受け取るWebhook URLの設定画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/notification-webhook-url.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=27b53408792440c78b0191cfeca40c4f)

Webhookが有効な場合、アプリプッシュ通知の送信が成功するたびに、Notiflyが`POST`リクエストを送信します。以下のキャンペーンとユーザージャーニーの例では、`platform`の値は`"ios"`です。Androidの場合は`"android"`になります。

**\[キャンペーン]**

```json theme={null}
{
  "userId": "user-example",
  "resourceType": "campaign",
  "campaignId": "campaign-example",
  "platform": "ios",
  "token": "example-fcm-token",
  "title": "通知タイトル",
  "body": "通知本文",
  "url": "appName://inbox",
  "sent_time": 1772787674021
}
```

**\[ユーザージャーニー]**

```json theme={null}
{
  "userId": "user-example",
  "resourceType": "user_journey",
  "userJourneyId": "journey-example",
  "userJourneyNodeId": "node-example",
  "sessionId": "session-example",
  "platform": "ios",
  "token": "example-fcm-token",
  "title": "通知タイトル",
  "body": "通知本文",
  "url": "appName://inbox",
  "sent_time": 1772787674021
}
```

プロジェクトにWebhookのURLを設定すると、新規のアプリプッシュキャンペーンと、ジャーニービルダーで追加するアプリプッシュのメッセージノードでは、Webhookがデフォルトで有効になります。キャンペーンで無効にするには、キャンペーン設定で**プッシュ送信結果のWebhook受信**をオフにします。ノードごとに無効にするには、メッセージノードの設定で**プッシュ配信結果Webhook受信**をオフにします。

![配信結果のWebhook受信を切り替えるキャンペーン設定](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/enable-notification-webhook.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=024afa81519de87b4a531f80d87ab5d1)

Webhookで受け取った配信結果は、アプリ内の通知一覧に表示するメッセージの記録などに使えます。Notiflyは[Webhookチャネル](https://docs.notifly.tech/ja/user-guide/channel/webhook/guide.md)経由で配信結果を通知します。Webhookを有効にする前に、プロジェクトに適用される料金を確認してください。

## FAQ

> [accordion] プッシュ通知が届かない場合は、何を確認すればよいですか？
>
> [アプリプッシュ通知の連携テスト](https://docs.notifly.tech/ja/integration-test.md#3-アプリプッシュ通知をテストする)を実施してください。


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