# 푸시 알림 설정

{% hint style="info" %}
**\[Firebase 비공개 키, Android, 미리보기 기본 정보, 분석 리포트 전환 기여 기간]** 설정 기능은 준비 중인 기능으로, 추후 업데이트를 통해 제공될 예정입니다.
{% endhint %}

푸시 알림 발송에 필요한 **Firebase 비공개 키**를 등록하고, 캠페인 운영 시 적용될 **기본 환경**을 설정하는 페이지입니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fp7sxu56pHC1UVdb6s3bY%2Fimage.png?alt=media&#x26;token=ef20194f-fa92-4bd2-8660-574f48718607" alt=""><figcaption></figcaption></figure>

## **1. Firebase 비공개 키**

Android 및 iOS 푸시 발송을 위한 선행 필수 설정입니다. \ <img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FMQjv2H1kD9MAo5ttvmXE%2Fimage.png?alt=media&#x26;token=19aad5b8-22b0-4d0c-8d2d-0ebfd960e84b" alt="" data-size="line"> 버튼을 클릭하여 Firebase 콘솔에서 발급 받은 JSON 형식의 비공개 키 파일을 업로드해 주세요.

{% hint style="info" %}
비공개 키 발급 방법은 [**\[Firebase 비공개 키 발급 및 등록\]**](https://docs.groobee.ai/push/firebase#id-1.-firebase)을 참고해 주세요.
{% endhint %}

***

## **2. Android**

**Android** 푸시 알림 메시지에 표시되는 **기본 이미지**를 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fj44CIkhLYQFYvDQfxASm%2Fimage.png?alt=media&#x26;token=5f5f0650-6c50-4525-b671-0ae617da43f7" alt=""><figcaption></figcaption></figure>

* **기본 이미지:** Android 푸시 알림 우측에 공통으로 표시될 기본 이미지를 등록해 주세요.

{% hint style="warning" %}
**진행 중** 상태인 **푸시 알림(Android) 캠페인**이 하나라도 있을 경우, 기본 이미지를 수정하거나 삭제할 수 없습니다.\
이미지를 변경하려면 진행 중인 캠페인을 중지하거나 완료 처리한 후 시도해 주세요.
{% endhint %}

{% hint style="info" %}
기본 이미지를 등록해두면, 캠페인 생성 시 별도의 이미지 업로드 없이 자동으로 적용됩니다.
{% endhint %}

***

## **3. 미리보기 기본 정보**

푸시 알림 메시지 **미리보기**에 표시되는 **앱 이름 및 아이콘**을 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FA0pwbwfIFjg9Y0V35Lpq%2Fimage.png?alt=media&#x26;token=6bb0fde4-927e-4ed7-9f2e-d8365ed68033" alt=""><figcaption></figcaption></figure>

* **앱 이름:** Android 푸시 알림 메시지 미리보기에 노출할 앱 이름을 입력해 주세요.
* **앱 아이콘:** Android/iOS 푸시 알림 메시지 미리보기에 노출할 앱 아이콘을 설정해 주세요.

***

## **4. 수신거부 표기** <a href="#ban" id="ban"></a>

정보통신망법에 따라 **광고성** 목적으로 푸시 알림을 발송할 때, **메시지 하단에 필수로 명시**해야 하는 **수신 거부 방법(안내 문구)**&#xC744; 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2F9ECq4yDWvYHg3Gr875kd%2Fimage.png?alt=media&#x26;token=f6d158f4-c53c-40ad-b7e6-a53539a81fde" alt=""><figcaption></figcaption></figure>

* **문구 입력:** 수신자가 알림을 끄는 방법을 안내하는 문구를 입력해 주세요.

{% hint style="warning" %}
**새로 생성**하는 푸시 알림 캠페인부터 설정한 문구가 자동으로 반영됩니다.\
이미 작성 중이거나 발송 완료된 캠페인에는 소급 적용되지 않습니다.
{% endhint %}

{% hint style="success" %}
푸시 알림의 목적이 **광고성** 목적이라면 운영 리스크 관리를 위해 고정된 문구를 설정하여 사용하는 것을 권장합니다.
{% endhint %}

***

## **5. 광고 문구** <a href="#rate-limit" id="rate-limit"></a>

정보통신망법 및 각 국가별 광고 규정에 따라, **광고성 메시지** 발송 시 **필수적으로 표기해야 하는 문구**를 언어별로 설정할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2F290JrY55RdrvuY3YG2Wx%2Fimage.png?alt=media&#x26;token=cdde491c-ccdc-40ba-aca8-f5fa76a0f723" alt=""><figcaption></figcaption></figure>

* **표기 언어:** 기본적으로 **\[한국어 - (광고)]**&#xAC00; 제공되며, 다양한 언어를 추가할 수 있습니다.
* **표기 위치(기본값):** 광고성 메시지 발송 시, 문구가 표시될 위치(내용, 제목 등)의 기본 설정을 지정합니다.

{% hint style="info" %}
저장한 표기 언어(기본값), 표기 위치 값은 **\[푸시 알림 캠페인 만들기 > 2단계: 메시지 작성]** 화면 진입 시 자동으로 선택됩니다.
{% endhint %}

<details>

<summary><strong>[푸시 알림 캠페인 만들기 > 2단계: 메시지 작성 > 광고 문구 설정] 예시 화면</strong></summary>

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FgwJWcUlYN556Ab7Qx7TI%2Fimage.png?alt=media&#x26;token=18cdbccf-52f0-4c02-8d26-3c364a60f331" alt=""><figcaption></figcaption></figure>

</details>

### **5-1. 광고 문구 추가**

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2F7vmb8jQnUxA9WolNbpxL%2Fimage.png?alt=media&#x26;token=2e159cd8-a220-4242-aed8-f98c4b08c0cc" alt="" data-size="line"> 버튼을 클릭하여 새로운 언어별 광고 문구를 추가할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FlK8E4rJ6raCH5LjAljWC%2Fimage.png?alt=media&#x26;token=a57bffad-d76a-4288-94a9-89b885ebee3a" alt=""><figcaption></figcaption></figure>

* **언어:** 식별을 위한 언어 명칭을 입력해 주세요. (문자 구분 없이 최대 25Byte 입력 가능)
* **표기 문구:** 해당 언어에 맞춰 **실제 푸시 알림 메시지에 표시될 광고 안내 문구**를 입력해 주세요. (문자 구분 없이 최대 25Byte 입력 가능)
* **기본값으로 설정:** 해당 항목을 체크하면, **\[푸시 알림 캠페인 만들기 > 2단계: 메시지 작성]** 화면 진입 시 해당 언어가 자동으로 선택(Default)됩니다.

{% hint style="warning" %}
국가별로 광고 표기 문구에 대한 필수 준수 사항이 다를 수 있습니다. 반드시 타겟 국가의 법적 규제를 확인하여 설정해 주세요. 광고 표기 문구 설정과 관련된 법적 책임은 그루비에게 있지 않습니다.
{% endhint %}

***

## **6. 발송 속도 조절** <a href="#rate-limit" id="rate-limit"></a>

푸시 알림 발송 시 1분당 발송 요청 건수를 제한할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FLx2PyoeIVY3NF3MddxZQ%2Fimage.png?alt=media&#x26;token=a681b5ef-957c-458f-b2b1-369cd94a20ac" alt=""><figcaption></figcaption></figure>

* **설정 시:** 모든 푸시 알림 캠페인에 설정 값이 일괄 적용되어, **1분당 설정한 건수만큼** 나누어 순차적으로 발송됩니다. \
  (**선택 옵션:** 1,000 / 5,000 / 10,000 / 15,000 / 20,000)
* **미설정 시:** 별도의 제한 없이 시스템이 처리 가능한 **최대 속도**로 즉시 발송됩니다.

***

## **7. 분석 리포트 전환 기여 기간**

푸시 알림 캠페인의 분석 리포트 조회 시, **자동으로 적용될 전환 기여 기간**의 기본값을 설정합니다.\
설정한 값은 리포트 화면 진입 시 초기 선택값(Default)으로 반영됩니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2F35UQyseo4NW1uuDU9L5H%2Fimage.png?alt=media&#x26;token=99596496-7a12-4a35-b226-c1b3064ad9ef" alt=""><figcaption></figcaption></figure>

* **설정 옵션:** 3시간/6시간/발송 당일/3일/7일