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

# 送信対象を設定する

> ユーザーグループやCSVファイルで送信対象を指定し、分割送信で一度に送る件数を制限します。

ユーザーグループまたはCSVファイルで送信対象を指定できます。メッセージを複数回に分けて送信することもできます。

[APIベースの送信](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-3-api%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E9%80%81%E4%BF%A1)では、リクエストボディに送信対象を指定します。詳しくは、[Campaign Triggering APIのリファレンス](https://docs.notifly.tech/ja/api-reference/trigger-campaign.md)をご覧ください。

## 送信に必要な情報

チャネルによって、ユーザー情報に登録しておく項目が異なります。

* **プッシュ通知** には、[クライアントSDK](https://docs.notifly.tech/ja/developer-guide/index.md)で自動収集したデバイストークンが必要です。
* **カカオアリムトーク、カカオブランドメッセージ、SMS** には、携帯電話番号が必要です。ユーザー登録画面でCSVをアップロードするか、直接入力し、`$phone_number` に登録します。ユーザー登録画面の **特殊項目** をご覧ください。[ユーザー属性設定のHTTP API](https://docs.notifly.tech/ja/api-reference/set-user-properties.md)や[クライアントSDK](https://docs.notifly.tech/ja/developer-guide/index.md)からも登録できます。
* **メール** では、メールアドレスを `$email` に登録します。CSVのアップロード、ユーザー登録画面での直接入力、[ユーザー属性設定のHTTP API](https://docs.notifly.tech/ja/api-reference/set-user-properties.md)、または[クライアントSDK](https://docs.notifly.tech/ja/developer-guide/index.md)を使用できます。

## 1. ユーザーグループ設定

Notiflyに登録されたユーザーは、ユーザーリストで確認できます。ユーザー属性、デバイス情報、イベント履歴を使って送信対象を指定します。

### グループと条件

1. グループ同士は `OR` でつなぎます。いずれかのグループの条件を満たすユーザーが送信対象になります。
2. グループ内の条件は `AND` でつなぎます。そのグループに含めるには、すべての条件を満たす必要があります。詳しくは[条件の種類](#条件の種類)をご覧ください。

たとえば、グループ1に条件A、B、Cがあり、グループ2に条件D、Eがある場合、`([条件A] AND [条件B] AND [条件C]) OR ([条件D] AND [条件E])` で送信対象を絞り込みます。

### 条件で使えるデータ

1. ユーザー属性

* ユーザー登録画面でCSVをアップロードするか、値を直接入力します。[ユーザー属性設定のHTTP API](https://docs.notifly.tech/ja/api-reference/set-user-properties.md)や[クライアントSDK](https://docs.notifly.tech/ja/developer-guide/react-native-sdk.md#2-ユーザー情報を登録する)からも登録できます。

2. ユーザーのデバイス情報

* [クライアントSDK](https://docs.notifly.tech/ja/developer-guide/index.md)で収集したデバイス情報を使用します。

3. ユーザーのイベント履歴

* イベントを送信する方法は、[イベントベースの送信](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-2-%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E9%80%81%E4%BF%A1)をご覧ください。
* Notiflyは、発生したイベントをユーザーごとに記録します。ユーザーリストで該当する行を選択すると、詳細画面でイベントを確認できます。

### 条件の種類

グループには **ユーザー属性に基づく条件** と **イベントに基づく条件** を設定できます。

#### ユーザー属性に基づく条件

* ユーザー属性またはデバイス情報を使って条件を設定します。
* 次の4項目を入力します。
  1. 条件に使う属性名を入力するか、リストから選択します。
  2. 一致、不一致、以上、以下、より大きい、より小さいなどの演算子を選びます。選択できる演算子は、属性の型とチャネルによって異なります。
  3. 比較する値の型を選びます。文字列や数値などを指定できます。
  4. 属性と比較する値を入力します。

#### イベントに基づく条件

* イベント履歴を使って条件を設定します。
* 次の項目を入力します。
  1. イベントの発生回数を数える期間を設定します。
  2. 集計するイベント名を指定します。
  3. イベントの発生回数を設定し、一致、以上、以下、より大きい、より小さいから選択します。

> [!WARNING]
>
> 送信のトリガーとユーザーグループ条件で同じイベントを使う場合、送信時点の集計には、送信をトリガーしたイベントも含まれます。
>
> * たとえば、ユーザーが初めて購入した時点で送信するには、全期間で `purchase` がちょうど1回発生したことをグループ条件に設定します。最初の購入も発生回数に含まれます。

![送信対象の条件設定例](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/campaigns/campaign-build-segment-condition-example.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=a67d98decb55805e28a9d26d2d751478)

グループの条件に不備がなければ、カードの左上に緑色のチェックマークが表示されます。

![有効な送信対象の設定例](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/campaigns/campaign-build-segment-example-v2.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=a2be30f2a7493292219cf842a292afae)

### 送信要件とパーソナライズ

* **ユーザーグループ設定** では、Notiflyに登録されているユーザー情報を使います。メッセージのパーソナライズには、ユーザー情報、デバイス情報、イベントベース送信の場合はイベントパラメータを使用できます。詳しくは[メッセージのパーソナライズ](https://docs.notifly.tech/ja/user-guide/campaigns/personalization/basic.md)をご覧ください。
* [送信に必要な情報](#送信に必要な情報)がNotiflyのユーザーデータベースに登録されている場合に送信できます。

## 2. CSVファイルをアップロードする

**ファイルアップロード** を選択し、**サンプルファイルをダウンロード** からCSVテンプレートを取得します。ファイルに記載した宛先に直接送信するには、**アップロード方法** で宛先の種類に対応する項目を選びます。選択肢はチャネルによって異なります。

![CSVのサンプルファイルをダウンロードするボタン](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/campaigns/csv-sample-file-download.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=f738b13d16daefd5222b16547c3590cc)

* 1行目には列名を入力します。
* Notiflyは、空欄や空白文字だけの値を空の値として扱います。
* Notiflyは、値の先頭と末尾にある空白文字を取り除きます。

### チャネル別のCSV要件

* CSVには、チャネルごとの[送信に必要な情報](#送信に必要な情報)を含めます。
  * **プッシュ通知** では `user_id` 列が必要です。送信対象のユーザーはあらかじめユーザーリストに登録されている必要があります。CSV内のデータはプッシュ通知のパーソナライズには使用できません。
  * **カカオアリムトーク、カカオブランドメッセージ、SMS** で電話番号を指定する場合は、`phone_number` 列が必要です。
  * **メール** で宛先を指定する場合は `email` 列、**LINE** でLINEユーザーIDを指定する場合は `line_user_id` 列が必要です。
* Microsoft ExcelからCSVにエクスポートする場合は、文字コードにUTF-8を選択します。文字コードが異なると、送信したメッセージが文字化けすることがあります。

![Microsoft ExcelのUTF-8 CSVエクスポート設定](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/campaigns/csv-export.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=cd6d294ffa7ea1d155911d387343d4f9)

* CSVファイルに記載した宛先へ直接送る場合、対象者をNotiflyに事前登録する必要はありません。CSVの項目を使ったパーソナライズは、対応するチャネルで利用できます。LINEのメッセージはパーソナライズできません。**ユーザーIDに基づく** を選ぶと、`user_id` に対応する登録済みの宛先を使います。詳しくは[メッセージのパーソナライズ](https://docs.notifly.tech/ja/user-guide/campaigns/personalization/basic.md)をご覧ください。

## 分割送信

![分割送信の設定](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/campaigns/throttling.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=3def7d215aab6bcc94bad45ecb09d416)

* 短時間にサービスへのアクセスが集中するのを防ぐには、**分割送信** を設定します。
* **送信間隔（分）** と **一度に送信するメッセージ数** を設定します。
* 指定した間隔を空けて、メッセージを分けて送信します。
* メッセージ数は1回あたりの上限です。指定した数より少なく送信される場合があります。

### 設定例

* 送信時刻は18:00です。
* 送信対象の見込みは300人です。
* 送信間隔は5分です。
* 1回あたり最大100件です。
* 300件すべてが送信可能な場合、18:00、18:05、18:10の3回に分けて、各回最大100件を送信します。

## よくある質問

> [accordion] 送信対象の見込み人数はどのように計算されますか？
>
> 対象の条件を満たし、選択したチャネルで送信するために必要な情報を持つユーザーを集計します。
>
> Notiflyは、必要な項目が登録されているかを確認します。電話番号やメールアドレスなどが有効かどうかは確認しません。
>
> * アプリプッシュとWebプッシュには、デバイストークンが必要です。
> * SMSとカカオのメッセージには、携帯電話番号が必要です。
> * メールには、メールアドレスが必要です。
> * LINEには、LINEユーザーIDが必要です。
> * アプリ内ポップアップ、Webポップアップ、Webhookでは、追加の送信先情報は不要です。


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