# 푸시 알림 설정

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

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

<figure><img src="/files/ZDZxMYzKIGNIe0EYS4hQ" alt=""><figcaption></figcaption></figure>

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

Android 및 iOS 푸시 발송을 위한 선행 필수 설정입니다. \ <img src="/files/QfqfGeIkJSrsoCrD18wP" alt="" data-size="line"> 버튼을 클릭하여 Firebase 콘솔에서 발급 받은 JSON 형식의 비공개 키 파일을 업로드해 주세요.

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

***

## **2. Android**

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

<figure><img src="/files/lhExP6zd7xGbRxPQ1NAC" alt=""><figcaption></figcaption></figure>

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

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

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

***

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

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

<figure><img src="/files/dUlEdE9ChUfvLy7EVEGG" alt=""><figcaption></figcaption></figure>

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

***

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

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

<figure><img src="/files/X3tZlLc2ueTGEcGOoLBF" alt=""><figcaption></figcaption></figure>

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

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

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

***

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

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

<figure><img src="/files/j1egkupnXOph2tIHa4Wy" alt=""><figcaption></figcaption></figure>

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

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

<details>

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

<figure><img src="/files/R6bCzSA50gL3HgTFe8Pq" alt=""><figcaption></figcaption></figure>

</details>

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

<img src="/files/apNmaJOKFFyCzPXNToVS" alt="" data-size="line"> 버튼을 클릭하여 새로운 언어별 광고 문구를 추가할 수 있습니다.

<figure><img src="/files/PnbgoqsgzimVv6Z8FHnc" 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="/files/r3M7BkeXMwnojzKf9hT1" alt=""><figcaption></figcaption></figure>

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

***

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

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

<figure><img src="/files/VFGDY0MEHQzKwWfmAOCa" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groobee.ai/new-admin/settings/push.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.