# 푸시 설정하기

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FGW23fqV6esIA8yCffdCe%2F15.%20%E1%84%91%E1%85%AE%E1%84%89%E1%85%B5%20%E1%84%89%E1%85%A5%E1%86%AF%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5%20%E1%84%83%E1%85%A2%E1%84%91%E1%85%AD%20%E1%84%8B%E1%85%B5%E1%86%AF%E1%84%85%E1%85%A5%E1%84%89%E1%85%B3%E1%84%90%E1%85%B3.png?alt=media&#x26;token=e8c66692-e852-4639-88e9-002242b1ef56" alt=""><figcaption></figcaption></figure>

각 플랫폼(Android, iOS) 마다 푸시 메시지 발송을 위한 부가 설정을 수행해야 합니다.<br>

## **Android 설정 관리**

안드로이드 푸시 발송을 위해서 Firebase의 FCM 인증 토큰을 등록합니다.\
인증서는 파이어베이스 콘솔에서 발급할 수 있습니다.

### **FCM 인증서 발급(Android)**

1. 서비스 계정에 접속합니다.
2. 프로젝트를 선택합니다. 프로젝트가 없는 경우 새로 생성합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FFPynTW1c7RuHKadVhXgf%2Fimage.png?alt=media&#x26;token=85528f5d-d27f-44db-bcb6-5bfbb65c8bfc" alt=""><figcaption></figcaption></figure>

3. 우측 하단의 작업에서 ⋮를 클릭합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FnFL7odYrUcm1PRuVQTeV%2Fimage.png?alt=media&#x26;token=02aefabe-ff7d-4a74-8ac9-2fef0145a0e2" alt=""><figcaption></figcaption></figure>

4. 드롭다운 메뉴에서 \[Manage keys]를 선택합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FEbGtZeO8fpTh9KHxyjF8%2Fimage.png?alt=media&#x26;token=783cd5d9-2365-439e-af12-44cf0b7ac864" alt=""><figcaption></figcaption></figure>

5. \[ADD KEY] 버튼을 선택하고 드롭다운 메뉴에서 \[Create new key]를 선택합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2Fv7DdKe8xru4bd1fM0jkR%2Fimage.png?alt=media&#x26;token=6412d1f3-8995-4158-a019-12911234390b" alt=""><figcaption></figcaption></figure>

6. Key type에서 JSON 을 선택하고 \[Create new key] 를 클릭합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FIo5NxUcuH0cAGgi1f0Dx%2Fimage.png?alt=media&#x26;token=193989ba-6133-462b-aa88-99e4e49104ab" alt=""><figcaption></figcaption></figure>

7. JSON 타입을 선택하고 \[CREATE] 버튼을 눌러서 인증서를 발급합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FRXnT647KEUxyoSzyV7wL%2Fimage.png?alt=media&#x26;token=2c25525b-3ef7-46e8-80d2-e31373ae589f" alt=""><figcaption></figcaption></figure>

### **발급받은 인증서 등록**

1. 부가설정 > 채널 부가 설정 > 푸시 > Android 설정 관리 화면으로 이동합니다.
2. \[파일 업로드] 버튼을 클릭하여 발급받은 FCM 인증서를 등록합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FGKDUU90ac02onM64bmwP%2Fimage.png?alt=media&#x26;token=a17efe94-dc00-4056-8b0e-64734b24213e" alt=""><figcaption></figcaption></figure>

***

## **iOS 설정 관리**

iOS 푸시 발송을 위해서 애플의 APNs 인증 키를 등록합니다.\
인증서는 애플 개발자 콘솔에서 발급할 수 있습니다.​

### **APNs 인증키 발급** <a href="#apns" id="apns"></a>

1. ​[애플 개발자 사이트](https://developer.apple.com/)에 접속하여 개발자 계정으로 로그인합니다.
2. Certificates, Identifier & Profiles 에서 \[키(영문)]을 선택합니다.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2FVXI9rnBjdaCIhPzOTjw1%2Fimage.png?alt=media&#x26;token=3d60d416-919e-41e2-a8b2-76c7148993f7" alt=""><figcaption></figcaption></figure>

3. 좌측 Keys 메뉴를 선택하고 \[Create a key] 를 선택하여 키를 발급 합니다.\
   Key Name 을 입력하고, Apple Push Notifications service(APNs)를 활성화합니다.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2FvKjxHfQWowU7JuV30yIJ%2Fimage.png?alt=media&#x26;token=2d49eb3b-774c-42af-a5b8-b12ad84f8bfd" alt=""><figcaption></figcaption></figure>

4. Register를 누르면 인증키가 발급됩니다.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2F7gQVa0bHfivtiOM6RDay%2Fimage.png?alt=media&#x26;token=2d4557d9-1566-4181-b45d-8def991a8daf" alt=""><figcaption></figcaption></figure>

5. 발급된 인증키를 다운로드 합니다.​

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2F1Iji7hKL9aykMDwZKFkm%2Fimage.png?alt=media&#x26;token=6f04840d-4cfd-4c4e-bc14-f67ac2ea0085" alt=""><figcaption></figcaption></figure>

### **발급받은 APNs 인증키 등록** <a href="#undefined-2" id="undefined-2"></a>

1. 부가설정 > 채널 부가 설정 > 푸시 > iOS 설정 관리 화면으로 이동합니다.
2. \[파일 업로드] 버튼을 클릭하여 발급받은 APNs 인증키를 등록합니다.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2FmH4YbW7Naik9rLNwMdZf%2Fimage.png?alt=media&#x26;token=199be257-93c1-4180-9ffb-356689b9926f" alt=""><figcaption></figcaption></figure>

3. 키ID, 팀ID, 번들ID를 모두 입력합니다.

​

## **유지 시간(TTL) 관리** <a href="#ttl" id="ttl"></a>

### **유지 시간(TTL)이란?**

유지 시간(TTL)은 기기가 오프라인 상태인 경우 메시지 발송을 보장하기 위해 대기하는 최대 시간을 의미합니다.\
유지 시간(Time to Live) 관리는 메시지 전송 유효 시간(hour)을 지정하여, 메시지 발송을 최적화할 수 있습니다.\
설정된 TTL 시간이 지나면 메시지는 더 이상 유효하지 않으며, 해당 기기로 전달되지 않습니다.

### **유지 시간(TTL) 글로벌 설정 조건 및 세부 사항**

{% hint style="success" %}

* TTL이 적용 가능한 채널은 푸시에만 해당되며, 각 플랫폼 마다 설정 가능합니다.
* TTL 설정 이후에 생성된 캠페인에 자동 적용됩니다.
* 모든 캠페인에 일괄 설정이 가능합니다.
* 변경된 설정값은 과거에 생성된 캠페인에는 적용되지 않습니다.
* 캠페인 별로 유지 시간을 개별 조정할 수 있습니다.
* 디폴트 값은 168 시간이며, 플랫폼 별로 수정 가능합니다.
* 유지 시간은 최소 1시간부터 최대 168시간까지 적용할 수 있습니다.
  {% endhint %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2pZrvzujQCHZjCe4vQCr%2Fuploads%2FkOdVZWAcart0H2RFTSjF%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-06-25%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%207.25.26.png?alt=media&#x26;token=2feace50-0ddf-43ec-971c-61bb42e6d21e" alt=""><figcaption></figcaption></figure>


---

# 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.dfinery.ai/user-guide/action/off-site-campaign/push-message/setting.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.