자주 묻는 질문
이 문서에서는 푸시 채널에 대해 자주 묻는 질문에 대한 답변을 제공합니다.
푸시 알림이 지연되는 이유는 무엇인가요?
전달은 일반적으로 세 단계를 거칩니다: Braze 처리(세분화, 스케줄링, 공급자에게 전달), Braze에서 APNs 또는 FCM으로의 전송, 공급자에서 기기로의 전달. 각 단계에서 지연이 발생할 수 있습니다. Braze는 공급자 또는 기기 대기줄에 대한 가시성이 없으므로, 기기 측 타이밍을 좁혀야 할 경우 클라이언트에서 상세 로깅을 사용하세요.
여러 사용자가 하나의 기기에 로그인하면 어떻게 되나요?
사용자가 기기 또는 웹사이트에서 로그아웃하면, 다른 사용자가 로그인할 때까지 해당 사용자에게 푸시를 보낼 수 있는 상태가 유지됩니다. 다른 사용자가 로그인하면 푸시 토큰이 새 사용자에게 재할당됩니다. 이는 각 기기가 앱 또는 웹사이트당 하나의 활성 푸시 구독만 가질 수 있기 때문입니다.
푸시 토큰이 재할당되면, 해당 변경 사항이 고객 프로필의 Push Changelog에 반영됩니다. 고객 프로필에서 인게이지먼트 탭으로 이동하세요.
테스트 푸시를 보내면 모든 기기에 전송되나요?
네. 테스트 푸시는 선택한 고객 프로필에 연결된 푸시 활성화 기기 모두에 전송됩니다. 동일한 사용자로 로그인한 휴대폰이나 태블릿이 여러 대 있는 경우, 유효한 푸시 토큰이 있는 각 기기에서 알림을 수신합니다.
테스트 푸시를 한 기기에만 보내려면, 테스트 전에 고객 프로필에서 다른 기기의 푸시 토큰을 제거하면 됩니다. 또는 /messages/send 엔드포인트를 사용하여 전송하는 경우, apple_push 또는 android_push 오브젝트에서 send_to_most_recent_device_only를 true로 설정하면 가장 최근에 활성화된 기기만 푸시를 수신합니다.
“페이로드가 유효하지 않아 푸시 전송 오류 발생”은 무엇을 의미하나요?
이 메시지는 유효하지 않은 페이로드(예: 빈 페이로드 또는 너무 큰 페이로드)로 인해 APN이 푸시 요청을 거부했음을 나타냅니다.
자세한 내용 및 다음 단계는 일반적인 푸시 오류 메시지를 참조하세요.
옵트인한 사용자에게 푸시 토큰이 없는 이유는 무엇인가요?
이는 사용자의 푸시 토큰이 동일한 기기를 사용한 다른 사람에게 재할당된 경우 발생할 수 있습니다.
- 영향을 받은 사용자 프로필의 인게이지먼트 탭에서 Push Changelog로 이동합니다.
- 푸시 토큰이 다른 사용자에게 이동되었다는 메시지를 찾습니다.
- 푸시 토큰을 복사하여 사용자 검색 바에 붙여넣습니다.
- 푸시 토큰이 아직 존재하는 경우, 해당 기기에서 가장 최근에 로그인한 사용자로 이동됩니다.
푸시 토큰을 원래 사용자에게 재할당하려면 다음을 수행합니다.
- 원래 사용자가 누락된 푸시 토큰이 있는 프로필에 로그인하도록 합니다.
- 새 푸시 전송을 트리거합니다. 이렇게 하면 기기 수준에서 푸시가 여전히 활성화되어 있는 경우 토큰이 해당 계정으로 다시 이동됩니다.
테스트 중인 초안 Campaign에서 “모바일 앱 내에서 웹 URL 열기”를 탭하면 항상 앱이 열리는 이유는 무엇인가요?
Campaign이 아직 초안 상태일 때 테스트 푸시를 보내면, 모바일 앱 내에서 웹 URL 열기 옵션의 선택 여부와 관계없이 알림을 탭하면 항상 앱이 먼저 열립니다. Campaign이 라이브 상태가 되면 클릭 시 동작이 설정대로 작동합니다.
웹 URL 열기를 앱 내 옵션 없이 선택한 경우, 링크는 기기의 기본 브라우저에서 바로 열립니다. 모바일 앱 내에서 웹 URL 열기를 선택한 경우, 링크는 인앱 웹 뷰에서 열립니다.
iOS 푸시 인증서에서 “프로덕션으로 보내기”와 “개발로 보내기”의 차이점은 무엇인가요?
Braze에서 Apple 푸시 인증서를 추가할 때, 프로덕션으로 보내기와 개발로 보내기 옵션은 Braze가 푸시 알림을 전달할 때 사용하는 APN(Apple 푸시 알림 서비스) 게이트웨이를 결정합니다.
- 개발로 보내기: Xcode에서 개발 모드로 빌드하고 개발 프로비저닝 프로필로 서명한 앱인 경우 선택합니다. 푸시 알림은 Apple의 개발(샌드박스) 게이트웨이를 통해 라우팅됩니다.
- 프로덕션으로 보내기: Apple의 TestFlight, 앱 스토어 또는 엔터프라이즈 배포를 통해 배포된 앱인 경우 선택합니다. 푸시 알림은 Apple의 프로덕션 게이트웨이를 통해 라우팅됩니다.
잘못된 옵션을 선택하면 푸시 토큰 유형이 게이트웨이와 일치하지 않아 푸시 알림이 자동으로 실패합니다. 일반적으로 TestFlight 또는 앱 스토어를 통해 배포된 앱은 프로덕션으로 보내기를 사용해야 합니다.
Braze는 가져온 푸시 토큰을 앱과 환경에 대한 유효한 포그라운드 푸시 토큰으로 간주합니다.
iOS 토큰을 가져올 때, Braze는 해당 토큰에 대한 Apple Push Notification service(APNs) 게이트웨이(development 또는 production)를 저장하지 않습니다. Braze는 앱에 구성된 게이트웨이를 통해 이러한 토큰으로 전송합니다. 다른 환경용으로 생성된 토큰인 경우, APNs가 BadDeviceToken으로 거부하며 전송이 반송됩니다.
Braze는 나중에 SDK가 동일한 토큰을 등록하고 게이트웨이를 보고하는 경우에만 해당 토큰에 대한 게이트웨이를 저장합니다.
“포그라운드 푸시 활성화”와 “백그라운드 또는 포그라운드 푸시 활성화” 필터의 차이점은 무엇인가요?
이 세분화 필터는 서로 다른 조건을 확인합니다:
| 필터 | 확인 내용 | 사용 사례 |
|---|---|---|
| Foreground Push Enabled | 사용자에게 유효한 포그라운드 푸시 토큰이 있고 푸시 가입 상태가 Opted-In 또는 Subscribed인 경우입니다. |
표시되는 푸시 알림을 수신할 수 있는 사용자를 타겟팅합니다. |
| Background or Foreground Push Enabled | 사용자에게 푸시 토큰(포그라운드 또는 백그라운드)이 있고 푸시 가입 상태가 Opted-In 또는 Subscribed인 경우입니다. 여기에는 표시되는 푸시 알림을 비활성화했지만 백그라운드 푸시 토큰은 보유한 사용자도 포함됩니다. |
제거 추적, 사일런트 푸시 알림, 지오펜싱에 사용됩니다. |
사용자가 Foreground Push Enabled가 아니면서 Background or Foreground Push Enabled일 수 있습니다. 이는 사용자가 기기 설정에서 표시되는 푸시 알림을 비활성화했지만 앱이 여전히 백그라운드 푸시 토큰을 보유하고 있는 경우에 발생합니다. 자세한 내용은 푸시 사용자 및 가입을 참조하세요.
Braze는 푸시 메시지가 성공적으로 전송되었는지 어떻게 판단하나요?
메시지는 푸시 서비스 공급자가 수신하는 즉시 전송된 것으로 기록됩니다. 이것이 반드시 사용자가 메시지를 수신하거나 확인했다는 것을 의미하지는 않습니다.
iOS의 경우 푸시 서비스 공급자는 Apple Push Notification Service(APNs)이고, Android의 경우 일반적으로 Firebase Cloud Messaging(FCM)입니다. 푸시 서비스 공급자는 성공 또는 실패로 즉시 응답합니다. 실패에는 바운스 또는 네트워크 장애로 인한 재시도가 포함될 수 있습니다.
성공 메시지가 반환되면 Braze에서 전송이 기록된 후 푸시 서비스가 기기로 전달을 시도합니다. 기기에 즉시 도달할 수 없는 경우, 서비스는 Braze에서 설정된 만료 옵션(Android의 경우 TTL, iOS의 경우 Expiry)까지 재시도합니다. 메시지가 시간 초과되면 푸시 서비스가 푸시를 폐기하지만 바운스로 간주되지는 않습니다.
- 실행 기반 전달 푸시 Campaigns의 경우, 사용자가 Campaign을 트리거하는 액션을 수행하는 즉시 메시지 전송이 기록됩니다.
- 예약된 Campaigns의 경우, 전송 시간은 메시지가 대기열에 추가되어 푸시 서비스 공급자에게 전달된 시간입니다.
- 두 전달 유형 모두 메시지는 Braze에서 그리고 고객 프로필의 Campaigns Received 아래에 “전송됨”으로 표시되며, 사용자가 아직 푸시를 확인하거나 수신하지 않았을 수도 있습니다.
대시보드에서 푸시의 “전달” 지표는 페이지 로드 시 전송 수에서 바운스를 뺀 값으로 계산됩니다.