푸시 토큰 수명 주기

이 문서에서는 사용자에게 푸시 토큰이 할당되는 과정과 Braze가 사용자에게 푸시 메시지를 보내는 방법을 다룹니다.

푸시 토큰 정보

앱이 기기에 푸시 권한을 요청하면, 기기의 푸시 서비스 공급자가 해당 앱에 대한 푸시 토큰을 생성합니다. 각 앱에는 고유한 익명 푸시 토큰이 부여되며, 이를 통해 푸시 알림을 보낼 때 기기와 현재 앱 인스턴스를 식별합니다.

푸시 토큰은 영구적인 정적 식별자가 아닙니다—업데이트될 수 있으며 만료될 수도 있습니다.

포그라운드 푸시 vs. 백그라운드 푸시

푸시 토큰은 포그라운드 및 백그라운드 푸시 알림을 모두 보내는 데 사용됩니다.

유형	옵트인 필요 여부	설명
포그라운드 푸시	예	앱이 포그라운드에 있는 동안 사용자에게 알림이 표시됩니다.
백그라운드 푸시	아니요	알림이 표시되지 않고 백그라운드에서 조용히 전달됩니다. 제거 추적과 같은 기능에 자주 사용됩니다.

사용자가 앱의 푸시 알림에 옵트인하면 “푸시 등록됨”으로 간주되며, Braze에서 Foreground Push Enabled for App 세분화 필터를 사용하여 타겟팅할 수 있습니다.

하나의 기기에 여러 사용자

푸시 토큰은 기기와 앱 모두에 고유하므로, 여러 사용자가 동일한 기기를 사용하는 경우 푸시 토큰으로 특정 사용자를 타겟팅할 수 없습니다.

예를 들어, Charlie와 Kim이라는 두 명의 사용자가 있다고 가정합니다. Charlie가 자신의 휴대폰에서 앱의 푸시 알림을 활성화한 상태에서 Kim이 Charlie의 휴대폰을 사용하여 Charlie의 프로필에서 로그아웃하고 자신의 프로필로 로그인하면, 푸시 토큰이 Kim의 프로필로 재할당됩니다. 그러면 Kim이 로그아웃하고 Charlie가 다시 로그인할 때까지 해당 기기에서 푸시 토큰은 Kim의 프로필에 할당된 상태로 유지됩니다.

앱이나 웹사이트는 기기당 하나의 푸시 구독만 가질 수 있습니다. 따라서 사용자가 기기나 웹사이트에서 로그아웃하고 새 사용자가 로그인하면, 푸시 토큰이 새 사용자에게 재할당됩니다. 이는 사용자 프로필의 Engagement 탭에 있는 Contact Settings 섹션에 반영됩니다.

푸시 공급자(APNs/FCM)가 하나의 기기에서 여러 사용자를 구분할 방법이 없기 때문에, 마지막으로 로그인한 사용자에게 푸시 토큰을 전달하여 기기에서 푸시를 타겟팅할 사용자를 결정합니다.

푸시 토큰 등록

각 기기 플랫폼은 푸시 토큰 등록을 서로 다르게 처리합니다. 플랫폼별 세부 사항은 다음을 참고하세요:

• 웹
• android
• ios

사용자의 푸시 가입 상태 확인

Braze에서 사용자의 푸시 가입 상태를 확인하는 방법은 두 가지가 있습니다:

• 고객 프로필: Braze 대시보드의 사용자 검색 페이지에서 개별 고객 프로필에 접근할 수 있습니다. 사용자의 프로필을 찾은 후(이메일 주소, 전화번호 또는 외부 사용자 ID로), 인게이지먼트 탭을 선택하여 사용자의 가입 상태를 확인하고 수동으로 조정할 수 있습니다.
• REST API 내보내기: Segment별 사용자 또는 식별자별 사용자 엔드포인트를 사용하여 개별 고객 프로필을 JSON 형식으로 내보낼 수 있습니다. Braze는 기기별 푸시 활성화 정보를 포함하는 푸시 토큰 객체를 반환합니다.

푸시 등록 상태 확인

고객 프로필의 인게이지먼트 탭에서 Push Registered For 다음에 앱 이름이 표시됩니다. 해당 기기에 대한 앱 정보가 없는 경우 두 개의 대시(--)가 표시됩니다. 사용자에게 속한 모든 기기에 대해 항목이 있습니다.

기기 항목의 앱 이름 앞에 Foreground:가 붙어 있으면 해당 앱은 해당 기기에서 포그라운드 푸시 알림(사용자에게 표시됨)과 백그라운드 푸시 알림(사용자에게 표시되지 않음) 모두를 수신할 수 있는 권한이 있습니다.

반면에 기기 항목의 앱 이름 앞에 Background:가 붙어 있으면 해당 앱은 백그라운드 푸시만 수신할 수 있는 권한이 있으며, 해당 기기에서 사용자에게 표시되는 알림을 보낼 수 없습니다. 이는 보통 사용자가 해당 기기에서 앱의 알림을 비활성화했음을 나타냅니다.

동일한 기기에서 푸시 토큰이 다른 사용자로 이동되면 첫 번째 사용자는 더 이상 푸시에 등록되어 있지 않게 됩니다.

푸시 토큰 관리

사용자 프로필에서 푸시 토큰이 변경되거나 제거되는 작업에 대한 아래 차트를 확인하세요.

작업	설명
changeUser() 메서드 호출	Braze changeUser() 메서드는 SDK가 사용자 행동 데이터를 할당하는 사용자 ID를 전환합니다. 이 메서드는 일반적으로 사용자가 애플리케이션에 로그인할 때 호출됩니다. 특정 기기에서 changeUser()가 다른 또는 새로운 사용자 ID로 호출되면, 해당 기기의 푸시 토큰은 대응하는 사용자 ID가 있는 적절한 Braze 프로필로 이동됩니다.
푸시 오류 발생	토큰 제거로 이어지는 일반적인 푸시 오류에는 MismatchSenderId, InvalidRegistration 및 기타 유형의 푸시 바운스가 포함됩니다. 일반적인 푸시 오류의 전체 목록을 확인하세요.
사용자가 앱을 제거함	사용자가 기기에서 애플리케이션을 제거하면, Braze는 해당 프로필에서 사용자의 푸시 토큰을 제거합니다.

더 큰 규모에서는 어떻게 작동하나요?

사용자가 새 애플리케이션을 열고 푸시 프롬프트에서 푸시 액세스를 허용하면, Braze SDK에서 푸시 공급자로 호출이 전송됩니다. 해당 호출이 이루어지면 푸시 공급자는 모든 항목이 올바르게 설정되어 있는지 확인합니다. 설정이 올바른 경우, 푸시 토큰이 기기로 전달됩니다. 해당 토큰이 도착하면 SDK가 이를 Braze에 전달합니다. Braze가 푸시 공급자로부터 토큰을 받으면, 새로운 고객 프로필을 업데이트하거나 생성합니다. 이러한 사용자는 등록된 것으로 간주됩니다.

Campaign을 시작하려면 Braze에서 Campaign을 생성하여 푸시 공급자에게 보낼 푸시 페이로드를 생성합니다. 그러면 공급자가 사용자의 기기에 푸시 페이로드를 전달하고 SDK가 메시징 상태를 Braze에 전달합니다.

등록 단계	메시징 단계
1. 고객(기기)이 푸시 공급자에 등록 2. 공급자가 푸시 토큰을 생성하고 전달 3. Braze에 토큰 플러시	1. Braze가 공급자에게 푸시 페이로드 전송 2. 공급자가 기기에 푸시 페이로드 전달 3. SDK가 메시징 통계를 Braze에 전달

자주 묻는 질문

옵트인한 사용자가 앱을 삭제한 후 다시 다운로드하면 어떻게 되나요?

사용자가 푸시를 옵트인하고, 일부 푸시 메시지를 수신한 후 앱을 삭제하는 경우를 가정해 보겠습니다. 이 경우 기기 수준에서 푸시 동의가 제거됩니다. 이후 앱 제거 후 첫 번째 반송된 푸시가 발생하면 해당 사용자는 자동으로 향후 푸시 메시징에서 옵트아웃 처리됩니다. 이후 사용자가 앱을 다시 설치하더라도 실행하지 않으면, 앱에 대한 푸시 토큰이 다시 부여되지 않았기 때문에 Braze는 해당 사용자에게 푸시를 보낼 수 없습니다.

또한, 사용자가 포그라운드 푸시를 다시 활성화하는 경우 세션이 시작되어야 사용자 프로필에 해당 정보가 업데이트되고 푸시 메시징 수신이 시작됩니다.

푸시 토큰은 언제 만료되나요?

안타깝게도, APN과 FCM은 이에 대해 명확히 정의하고 있지 않습니다. 푸시 토큰은 앱이 업데이트되거나, 사용자가 데이터를 새 기기로 이전하거나, 운영 체제를 재설치할 때 만료될 수 있습니다. 대부분의 경우, 푸시 공급자가 특정 푸시 토큰을 만료시키는 이유에 대한 정확한 인사이트를 얻기 어렵습니다.

이러한 모호성을 고려하여, Braze의 SDK 푸시 통합은 항상 세션 시작 시 토큰을 등록하고 갱신하여 최신 토큰을 확보합니다.