> ## 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でユーザーが受信に同意しているかを記録します。キャンペーンでは、その記録を使って配信対象を絞り込みます。

## 1. 広告通知の受信同意をユーザー属性に保存する

ユーザーが配信停止ページやアプリ内の通知設定画面で受信設定を変更したら、変更後の同意の有無をアプリのSDKでNotiflyに保存します。

以下は、ユーザーが受信に同意したことを記録する例です。

> [tab] iOS
>
> ```swift title="iOS" theme={null}
> let userProperties = [
>     "mkt_push_agreed": true
> ] as [String: Any]
>
> Notifly.setUserProperties(userProperties: userProperties)
> ```

> [tab] Android
>
> ```kotlin title="Android" theme={null}
> Notifly.setUserProperties(
>     context,
>     mapOf("mkt_push_agreed" to true)
> )
> ```

> [tab] React Native
>
> ```js title="React Native" theme={null}
> notifly.setUserProperties({
>   mkt_push_agreed: true,
> });
> ```

> [tab] Flutter
>
> ```dart title="Flutter" theme={null}
> await NotiflyPlugin.setUserProperties({
>   'mkt_push_agreed': true,
> });
> ```

## 2. 配信対象の基本条件を追加する（任意）

**設定 > 製品とプロジェクト情報 > キャンペーンの基本ユーザー条件**で、アプリプッシュチャネルに条件を追加します。

画面例では`mkt_push_agreed`を使っています。サービスで広告通知の受信同意を保存しているキーを選んでください。

![アプリプッシュの基本ユーザー条件の設定画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/app-push-default-user-condition.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=20f22ada7b357c64d5ba4a8982453ccc)

## 3. マーケティング情報の配信停止ページを登録する

単一言語の通知で標準の配信停止ボタンを使うには、**設定 > チャネル設定 > プッシュ通知 (App)** を開き、**マーケティング配信停止ページ**にURLまたはディープリンクを入力します。

ユーザーが広告目的のプッシュ通知で配信停止ボタンをタップすると、指定したページが開きます。アプリ内の通知設定画面を開くには、アプリが対応しているディープリンクを指定します。

韓国で広告目的のアプリ通知を配信する場合は、配信停止の手順が要件を満たすか確認してください。KISAは、配信停止の際にログインなどの手間がかかる手順を求めないよう案内しています。[KISAの迷惑メッセージ対策ガイド（韓国語）](https://spam.kisa.or.kr/spam/na/ntt/selectNttInfo.do?bbsId=1002\&mi=1020\&nttSn=3001)を参照してください。

![マーケティング配信停止ページの設定画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/marketing-unsubscribe-page-register.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=f65290f0964df8e617eb7bce6c539f8c)

> [!WARNING]
>
> 通知に配信停止ボタンを表示するには、次のバージョン以上のSDKが必要です。
>
> * iOS SDK：`2.6.0`以上
> * Android SDK：`1.21.0`以上
> * React Native SDK：`4.2.0`以上
> * Flutter SDK：`2.3.0`以上
>
> これより古いSDKを使うアプリでは、配信停止ボタンは表示されません。

### プラットフォーム別の表示例

![AndroidとiOSのアプリプッシュ通知に表示される配信停止ボタンの例](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/app-push-unsubscribe-preview-platforms.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=7415199e76bbc714dfcce8cfc0957b85)

## 4. 広告目的のアプリプッシュキャンペーンを設定する

**送信対象 > ユーザーグループ設定**で**条件設定**を選びます。アプリプッシュの受信同意を基本ユーザー条件として保存済みの場合は、**デフォルトユーザー条件**をオンにします。保存していない場合は、受信に同意したユーザーだけを含む条件を設定します。**全ユーザー対象配信**やCSVには基本ユーザー条件が適用されません。CSVを使う場合は、受信に同意したユーザーだけを含めてください。

![キャンペーンの配信対象設定で基本ユーザー条件をオンにした画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/app-push-campaign-default-user-condition.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=812bc97a1a821a7a08fb2e0fe7a6fc7a)

単一言語のメッセージでは、メッセージ作成画面で**広告メッセージかどうか**をオンにします。

![アプリプッシュを広告メッセージに指定する設定画面](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/app-push-notification/app-push-ad-message-option.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=a82e707cfb494b2e0948a1600a9ed0f1)

手順3でマーケティング配信停止ページを登録している場合、Notiflyは配信停止ボタンの表示に必要な情報を通知に含めます。

多言語メッセージでは、[広告メッセージの作成手順](https://docs.notifly.tech/ja/user-guide/campaigns/localized-messages.md#2-4-広告メッセージを作成する)に沿って、言語ごとに必要な広告表記と配信停止の案内を追加します。

> [!TIP]
>
> 本番配信の前に、社内テスト用のキャンペーンを実行します。予約配信またはイベントベースの配信では、受信同意の条件を適用したまま、**送信対象 > ユーザーグループ設定**で**テストモード**をオンにします。
>
> **テスト対象者リスト**には、受信に同意した社内テスターの外部ユーザーIDを入力します。実行前に、リストにIDが1件以上あり、該当する社内テスターだけが含まれていることを確認します。
>
> * **単一言語のメッセージ**：テスト通知に配信停止ボタンが表示されることを確認します。ボタンをタップして、登録したページが開くことを確認します。
> * **多言語メッセージ**：言語ごとに必要な広告表記が表示され、記載した手順で配信を停止できることを確認します。

## FAQ

> [accordion] 配信停止URLを登録すると、配信を停止したユーザーは次回から自動的に除外されますか？
>
> 登録したURLは、配信停止ボタンのリンク先です。ユーザーが配信を停止したら、同意の変更をNotiflyに保存してください。キャンペーンでは、受信に同意しているユーザーだけを配信対象にします。

> [accordion] お知らせなどの通知にも、マーケティング情報の受信同意の条件を適用する必要がありますか？
>
> 広告目的のプッシュ通知には受信同意の条件が必要です。お知らせなどの通知にこの条件を適用しない場合は、キャンペーンの**デフォルトユーザー条件**をオフにするか、別の条件を設定します。


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