Skip to content

푸시 토큰 수명 주기

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

푸시 토큰 정보

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

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

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

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

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

하나의 기기에 여러 사용자

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

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

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

사용자 프로필의 **Engagement** 탭에 있는 푸시 토큰 체인지로그로, 푸시 토큰이 다른 사용자에게 이동된 시점과 해당 토큰이 무엇인지 표시합니다.

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

푸시 토큰 등록

각 기기 플랫폼은 푸시 토큰 등록을 다르게 처리합니다. 플랫폼별 세부 정보는 다음을 참조하세요:

네이티브 브라우저 권한 대화 상자를 통해 사용자에게 명시적인 옵트인을 요청해야 합니다. 사용자가 옵트인한 후 토큰을 받게 됩니다. iOS 및 Android와 달리 앱이 언제든지 권한 프롬프트를 표시할 수 있는 것과 다르게, 일부 최신 브라우저는 ‘사용자 제스처’(마우스 클릭 또는 키 입력)에 의해 트리거된 경우에만 프롬프트를 표시합니다. 사이트가 페이지 로드 시 푸시 알림 권한을 요청하려고 하면, 브라우저에 의해 무시되거나 차단될 가능성이 높습니다.

앱이 설치되면 앱에 대한 푸시 토큰이 자동으로 생성됩니다—그러나 사용자가 명시적으로 옵트인할 때까지 백그라운드 푸시 알림에만 사용할 수 있습니다. 또한 Android 버전에 따라 등록이 다르게 처리됩니다:

iOS는 앱이 설치될 때 자동으로 푸시 토큰을 생성하지 않습니다. 또한 iOS 버전에 따라 등록이 다르게 처리됩니다:

사용자의 푸시 구독 상태 확인

푸시 구독 상태가 가입됨으로 설정된 John Doe의 사용자 프로필.

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

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

푸시 등록 상태 확인

사용자 프로필의 Engagement 탭에서 Push Registered For 뒤에 앱 이름이 표시됩니다. 해당 기기에 대한 앱 정보가 없으면 두 개의 대시(--)가 표시됩니다. 사용자에게 속한 모든 기기에 대한 항목이 있습니다.

기기 항목의 앱 이름 앞에 Foreground:가 붙어 있으면, 해당 앱은 해당 기기에서 포그라운드 푸시 알림(사용자에게 표시됨)과 백그라운드 푸시 알림(사용자에게 표시되지 않음)을 모두 수신할 수 있도록 승인된 것입니다.

예시 푸시 토큰이 있는 푸시 체인지로그.

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

푸시 토큰이 동일한 기기의 다른 사용자에게 이동되면, 첫 번째 사용자는 더 이상 푸시 등록 상태가 아닙니다.

푸시 토큰 관리

다음 차트에서 푸시 토큰 변경 또는 사용자 프로필에서 제거로 이어지는 동작을 확인하세요.

더 큰 규모에서는 어떻게 보이나요?

사용자가 새 애플리케이션을 열고 푸시 프롬프트에서 푸시 접근을 허용하면, Braze SDK에서 푸시 공급자로 호출이 이루어집니다. 해당 호출이 이루어지면, 푸시 공급자는 모든 것이 올바르게 설정되었는지 확인합니다. 설정이 올바르면, 푸시 토큰이 기기로 전달됩니다. 토큰이 도착하면, SDK가 이를 Braze에 전달합니다. Braze가 푸시 공급자로부터 토큰을 받으면, 새 사용자 프로필을 업데이트하거나 생성합니다. 이 사용자들은 이제 등록된 것으로 간주됩니다.

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

Braze, 고객, Apple 푸시 알림 서비스 또는 Firebase Cloud Messaging 간의 앞서 설명한 푸시 프로세스를 매핑한 흐름도.

자주 묻는 질문

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

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

또한, 사용자가 포그라운드 푸시를 다시 활성화하면, 푸시 메시징을 받기 시작하려면 세션 시작이 필요하여 사용자 프로필에서 이 정보를 업데이트해야 합니다.

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

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

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