Skip to content

푸시 문제 해결

이 페이지를 사용하여 푸시 메시징 채널의 문제를 해결하세요.

누락된 푸시 알림

푸시 알림 전달에 어려움을 겪고 계신가요? 다음 항목을 확인하여 이 문제를 해결할 수 있습니다:

푸시 구독 상태

푸시는 구독하거나 옵트인한 사용자에게만 보낼 수 있습니다. 고객 프로필 섹션의 참여 탭에서 고객 프로필을 확인하여 테스트 중인 워크스페이스에 대해 푸시 등록이 되어 있는지 확인하세요. 여러 앱에 등록되어 있는 경우 푸시 등록 대상 필드에 해당 앱이 나열됩니다:

푸시 등록 대상

Braze 내보내기 엔드포인트를 사용하여 고객 프로필을 내보낼 수도 있습니다:

두 엔드포인트 모두 기기별 푸시 인에이블먼트 정보가 포함된 푸시 토큰 오브젝트를 반환합니다.

세그먼트

타겟팅하는 세그먼트에 속하는지 확인하세요(테스트가 아닌 라이브 캠페인인 경우). 고객 프로필에서 사용자가 현재 속해 있는 세그먼트 목록을 확인할 수 있습니다. 세분화는 실시간으로 업데이트되므로 계속 변화하는 변수라는 점을 기억하세요.

세그먼트 목록

세그먼트를 생성할 때 사용자 조회를 사용하여 사용자가 세그먼트에 포함되어 있는지 확인할 수도 있습니다.

검색 필드가 있는 사용자 조회 섹션.

푸시 알림 한도

글로벌 최대 게재빈도 설정을 확인하세요. 워크스페이스에 글로벌 최대 게재빈도 설정이 적용되어 있고 지정된 기간 동안 푸시 알림 한도에 이미 도달했기 때문에 푸시 알림을 받지 못했을 수 있습니다.

대시보드에서 글로벌 최대 게재빈도 설정을 확인하여 이를 수행할 수 있습니다. 캠페인이 최대 게재빈도 설정 규칙을 준수하도록 설정된 경우, 이러한 설정의 영향을 받는 사용자가 다수 발생할 수 있습니다.

캠페인 세부 정보

사용량 제한

캠페인 또는 캔버스에 사용량 제한이 설정되어 있는 경우 이 한도를 초과하여 메시징 수신이 중단될 수 있습니다. 자세한 내용은 사용량 제한을 참조하세요.

대조군 상태

단일 채널 캠페인이거나 캔버스에 대조군이 있는 경우 대조군에 속할 수 있습니다.

  1. 배리언트 분포를 확인하여 대조군이 있는지 확인합니다.
  2. 대조군이 있다면 캠페인 대조군 내 필터로 세그먼트를 생성한 다음 세그먼트를 내보내고 사용자 ID가 이 목록에 있는지 확인하세요.

유효한 푸시 토큰

푸시 토큰은 발신자가 푸시 알림으로 특정 기기를 타겟팅할 때 사용하는 식별자입니다. 따라서 기기에 유효한 푸시 토큰이 없는 경우 푸시 알림을 보낼 방법이 없습니다.

푸시 알림 유형

올바른 유형의 푸시 알림을 사용하고 있는지 확인하세요. 예를 들어, FireTV를 타겟팅하려는 경우 Android 푸시 캠페인이 아닌 Kindle 푸시 알림을 사용해야 합니다. 마찬가지로 Android를 타겟팅하려면 iOS 푸시 캠페인이 아닌 Android 푸시 알림을 사용하세요. Braze 워크플로우를 이해하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요:

현재 앱

내부 사용자를 대상으로 푸시 전송을 테스트할 때는 푸시 알림을 받으려는 사용자가 현재 관련 앱에 로그인되어 있는지 확인하세요. 이로 인해 사용자가 푸시를 받지 못하거나 세그먼트에 포함되지 않았다고 생각되는 푸시를 받을 수 있습니다.

푸시 알림을 클릭해도 앱이 열리지 않음

푸시 알림을 클릭해도 앱이 열리지 않는 경우 플랫폼에 따라 다음 사항을 확인하세요.

Android

  1. 클릭 시 동작을 확인합니다: 캠페인이 클릭 시 앱을 열도록 구성되어 있는지 확인합니다.
  2. 딥링크 처리를 확인합니다: braze.xml 파일에서 com_braze_handle_push_deep_links_automatically가 true로 설정되어 있는지 false로 설정되어 있는지 확인합니다.
    • true로 설정된 경우 Braze SDK가 딥링크를 직접 처리하며 앱이 예상대로 열립니다.
    • false로 설정된 경우 앱에서 푸시 수신 및 열기 의도를 수신하고 처리할 방송 수신기가 필요합니다. 이 수신기가 올바르게 구현되었는지 확인하세요.
  3. 상세 로그를 수집합니다: 상세 로깅을 활성화하고 문제를 재현한 다음 braze.xml 및 AndroidManifest.xml과 함께 로그를 Braze 고객지원에 제공하세요.

iOS

  1. 클릭 시 동작을 확인합니다: 캠페인이 클릭 시 앱을 열도록 구성되어 있는지 확인합니다.
  2. 푸시 통합을 확인합니다: 푸시에서 앱으로의 딥링킹은 Braze 표준 푸시 통합에 의해 자동으로 처리됩니다. 커스텀 델리게이트 처리를 포함하여 통합이 올바르게 구현되었는지 확인하세요.
  3. 상세 로그를 수집합니다: 상세 로깅을 활성화하고 문제를 재현한 다음 로그를 Braze 고객지원에 제공하세요.

푸시 클릭 시 예기치 않게 앱에서 열림

푸시 알림의 링크가 웹 브라우저가 아닌 앱에서 예기치 않게 열리는 문제가 발생하는 경우 캠페인 구성 또는 SDK 구현에 문제가 있을 수 있습니다. 다음 단계를 참조하여 도움을 받으세요.

클릭 시 동작 확인

캠페인 또는 캔버스 단계에서 모바일 앱 내에서 웹 URL 열기가 선택되어 있지 않은지 다시 확인하세요. 선택되어 있다면 선택을 해제하고 다시 시작하세요.

"클릭 시 동작" 필드에서 푸시를 구성할 때 "웹 URL 열기"가 선택되고 "모바일 앱 내에서 웹 URL 열기"가 선택 해제되어 있습니다.

클릭 시 동작 “웹 URL 열기”의 기본 상호 작용은 SDK 버전에 따라 다릅니다. SDK 버전 iOS 2.29.0 및 Android 2.0.0 이상의 경우 이 옵션이 기본적으로 선택되어 있으며 웹 URL이 앱 내 웹 뷰에서 열립니다. 이 버전 이전에는 이 옵션이 기본적으로 선택 해제되어 있으며 웹 URL이 기기의 기본 웹 브라우저에서 열립니다.

이 문제가 아니라면 푸시 구현에 문제가 있을 수 있습니다.

푸시 통합 재확인

푸시 알림의 링크가 앱에서 예기치 않게 열리는 경우 푸시 알림 통합 또는 커스텀 설정에 문제가 있을 수 있습니다. 다음 단계에 따라 문제를 해결하세요:

  1. 푸시 델리게이트 구현을 검토합니다: Braze 푸시 델리게이트가 올바르게 구현되었는지 확인합니다. 자세한 지침은 사용 중인 플랫폼의 푸시 알림 통합 가이드를 참조하세요.
  2. 커스텀 링크 처리를 검사합니다: 앱에 모든 https:// 링크에 대한 커스텀 처리가 포함되어 있는지 확인합니다. 커스텀 구성이 기본 동작을 재정의할 수 있습니다. 필요한 경우 개발팀과 협력하여 이러한 설정을 검토하고 조정하세요.
  3. iOS 푸시 등록을 확인합니다: iOS의 경우 푸시 통합 가이드의 1단계에서 APNs에 푸시 알림을 등록하는 방법을 참조하세요. 앱 실행이 완료되기 전에 델리게이트 오브젝트가 동기적으로 할당되었는지 확인하세요. 이 단계는 application:didFinishLaunchingWithOptions: 메서드에서 완료해야 합니다.
  4. 통합을 테스트합니다: 조정을 마친 후 iOS 및 Android 기기 모두에서 푸시 알림 동작을 테스트하여 문제가 해결되었는지 확인합니다.

.p8 인증 키로 마이그레이션

Apple .p8 인증 키는 Braze에서 APNs 푸시에 필요한 방식입니다. 레거시 인증서 파일 유형과 달리 .p8 키는 만료되지 않으며 단일 키로 모든 앱을 지원하므로 연간 인증서 갱신이 필요 없고 푸시 전달 실패 위험이 줄어듭니다.

현재 .p12 또는 .pem 인증서를 사용하고 있다면 가능한 한 빨리 .p8 키로 마이그레이션하세요. .p8 키를 생성하고 업로드하는 방법은 APNs 푸시 인증서 업로드를 참조하세요. 개발자 계정에서 .p8 키를 생성하는 방법에 대한 Apple의 안내는 인증 토큰을 사용하여 APNs와 통신을 참조하세요.

웹 푸시 알림이 예상대로 작동하지 않음

브라우저에서 푸시 알림에 문제가 있는 경우 사이트의 알림 권한을 재설정하고 사이트의 저장소를 지워야 할 수 있습니다. 다음 단계를 참조하여 도움을 받으세요.

데스크톱에서 Chrome 재설정

  1. Chrome 브라우저에서 URL 옆에 있는 사이트 정보 보기 슬라이더 아이콘을 선택합니다.
  2. 알림 아래에서 권한 재설정을 선택합니다.
  3. Chrome DevTools를 엽니다. 다음은 운영체제별 관련 단축키입니다.
  1. DevTools에서 Application 탭으로 이동합니다.
  2. 사이드바에서 Storage를 선택합니다.
  3. Clear site data를 선택합니다.
  4. Chrome이 업데이트된 설정을 적용하기 위해 페이지를 새로고침하라는 메시지를 표시합니다. Reload를 선택합니다.

푸시 권한이 이제 재설정되었습니다. 새 탭을 열어 사이트에 접속하여 시도해 보세요.

Android에서 Chrome 재설정

사이트에서 Android 알림 드로어에 알림이 표시되는 경우:

  1. 푸시 알림에서 을 탭하고 사이트 설정을 선택합니다.
  2. 사이트 설정에서 지우기 및 재설정을 탭합니다.

사이트에서 알림을 열지 않은 경우:

  1. Android에서 Chrome을 엽니다.
  2. 메뉴를 탭합니다.
  3. 설정 > 사이트 설정 > 알림으로 이동합니다.
  4. 알림이 전송 전에 요청(권장)으로 설정되어 있는지 확인합니다.
  5. 목록에서 사이트를 찾습니다.
  6. 항목을 선택하고 지우기 및 재설정을 탭합니다.

푸시 권한이 이제 재설정되었습니다. 새 탭을 열어 사이트에 접속하여 시도해 보세요.

데스크톱에서 Firefox 재설정

  1. 사이트 URL 옆에서 또는 을 선택합니다.
  2. 권한에서 알림 받기 옆에 있는 을 선택하여 알림 권한을 지웁니다.
  3. 같은 메뉴에서 쿠키 및 사이트 데이터 지우기를 선택합니다.
  4. 선택을 확인하는 대화 상자에서 확인을 선택합니다.

푸시 권한이 이제 재설정되었습니다. 새 탭을 열어 사이트에 접속하여 시도해 보세요.

Android에서 Firefox 재설정

Android에서 푸시 권한을 재설정하려면 이 Mozilla 지원 문서를 참조하세요.

macOS에서 Safari 재설정

  1. Safari를 엽니다.
  2. Mac의 메뉴 막대에서 Safari > 설정 > 웹사이트 > 알림으로 이동합니다.
  3. 목록에서 사이트를 선택합니다.
  4. 사이트에 대한 알림 권한을 삭제하려면 제거를 선택합니다.
  5. 그런 다음 개인정보 보호 > 웹사이트 데이터 관리로 이동합니다.
  6. 목록에서 사이트를 선택합니다.
  7. 제거를 선택하거나 모든 사이트 데이터를 제거하려면 모두 제거를 선택합니다.
  8. 완료를 선택합니다.

푸시 권한이 이제 재설정되었습니다. 새 탭을 열어 사이트에 접속하여 시도해 보세요.

푸시 오류 메시지

일반적인 푸시 오류 메시지(DEVICE_UNREGISTERED, Unregistered, NotRegistered 등)에 대한 자세한 내용은 일반적인 푸시 오류 메시지를 참조하세요.

아직도 도움이 필요하신가요? 고객지원 티켓을 여세요.
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!