Skip to content

문제 해결

기본 점검

한 사용자에 대한 인앱 메시지가 표시되지 않았습니다.

  1. SDK가 새 인앱 메시지를 요청할 때 사용자가 세션 시작 시점에 세그먼트에 있었나요?
  2. 사용자가 캠페인 타겟팅 규칙에 따라 인앱 메시지를 수신할 자격이 있거나 재자격이 있나요?
  3. 사용자가 주파수 제한의 영향을 받았나요?
  4. 사용자가 대조군에 속해 있었나요? 캠페인이 AB 테스트용으로 구성되어 있는지 확인하세요.
  5. 예상 메시지 대신 다른 우선순위가 높은 인앱 메시지가 표시되었나요?
  6. 내 디바이스가 캠페인에서 지정한 올바른 방향이었나요?
  7. SDK에서 시행하는 트리거 간 기본 30초의 최소 시간 간격으로 인해 메시지가 표시되지 않나요?

내 인앱 메시지가 이 플랫폼의 모든 사용자에게 표시되지 않았습니다.

  1. 캠페인이 모바일 앱 또는 웹 브라우저를 적절하게 타겟팅하도록 구성되어 있나요? 예를 들어, 캠페인이 웹 브라우저만 타겟팅하는 경우 Android 기기에는 전송되지 않습니다.
  2. 사용자 지정 UI를 구현했으며 의도한 대로 작동하고 있나요? 표시를 방해할 수 있는 다른 앱 측의 사용자 지정 처리 또는 억제 기능이 있나요?
  3. 이 특정 플랫폼 및 앱 버전에서 인앱 메시지를 성공적으로 표시한 적이 있나요?
  4. 트리거가 디바이스에서 로컬로 발생했나요? REST 호출은 SDK에서 인앱 메시지를 트리거하는 데 사용할 수 없다는 점에 유의하세요.

내 인앱 메시지가 모든 사용자에게 표시되지 않음

  1. 트리거 액션이 대시보드와 앱 통합에서 올바르게 설정되었나요?
  2. 예상 메시지 대신 다른 우선순위가 높은 인앱 메시지가 표시되었나요?
  3. 최신 버전의 SDK를 사용 중이신가요? 일부 인앱 메시지 유형에는 SDK 버전 요구 사항이 있습니다.
  4. 세션이 통합에 제대로 통합되었나요? 이 앱에서 세션 분석이 작동하나요?

인앱 메시지가 표시되는 데 시간이 많이 걸렸습니다.

  1. CDN에서 HTML 기반 인앱 메시지로 대용량 이미지 또는 동영상 파일을 전송하는 경우 파일이 최대한 작게 최적화되어 있는지, CDN의 성능이 정상인지 확인하세요.

  2. 대시보드에서 인앱 메시지에 delay 을 구성했는지 확인합니다.

  3. 상황에 따라 인앱 메시지는 표시되기 전에 디스크에서 관련 이미지를 다운로드하거나 로드합니다. 네트워크 연결 속도가 느리거나 성능이 매우 낮은 기기를 사용하는 경우 이 프로세스에 시간이 걸릴 수 있습니다. 이미지가 가능한 한 작게 최적화되었는지 확인하세요.

이러한 시나리오에 대해 자세히 알아보려면 고급 문제 해결 섹션을 참조하세요.

노출 및 클릭 분석 관련 문제

노출 수 및 클릭 수가 기록되지 않습니다.

메시지 표시 또는 클릭 작업을 수동으로 처리하도록 인앱 메시지 위임자를 설정한 경우 인앱 메시지에 대한 클릭 및 노출을 수동으로 기록합니다.

예상보다 적은 노출 횟수

  1. 트리거는 세션 시작 시 기기와 동기화하는 데 시간이 걸리므로 사용자가 세션 시작 직후 구매 또는 이벤트를 기록하면 경합 조건이 발생할 수 있습니다. 한 가지 가능한 해결 방법은 세션 시작 시 트리거하도록 캠페인을 변경한 다음, 의도한 이벤트 또는 구매를 세분화하는 것입니다. 이렇게 하면 이벤트가 발생한 후 다음 세션이 시작될 때 인앱 메시지가 전달됩니다.

  2. 캠페인이 세션 시작 또는 사용자 지정 이벤트에 의해 트리거되는 경우, 이 이벤트 또는 세션이 메시지를 트리거할 수 있을 만큼 자주 발생하는지 확인해야 합니다. 이 데이터는 개요 (세션 데이터의 경우) 또는 사용자 지정 이벤트 페이지에서 확인할 수 있습니다:

한 달 동안 즐겨찾기에 추가된 커스텀 이벤트가 발생한 횟수를 그래프로 보여주는 커스텀 이벤트 페이지

노출 수가 이전보다 감소했습니다.

  1. 론칭 이후 세그먼트나 캠페인을 의도치 않게 변경한 사람이 없는지 확인하세요. 세그먼트 및 캠페인 변경 로그를 통해 변경된 사항, 변경을 수행한 사람, 변경이 발생한 시점에 대한 인사이트를 얻을 수 있습니다.

사용자가 마지막으로 캠페인을 본 이후 7가지 변경 사항이 포함된 캠페인 세부 정보 페이지의 변경 로그 보기 링크

  1. 우선순위가 더 높은 별도의 인앱 메시지 캠페인에서 트리거 이벤트를 재사용하지 않았는지 확인하세요.

고급 문제 해결

대부분의 인앱 메시지 문제는 전달과 표시라는 두 가지 주요 카테고리로 분류할 수 있습니다. 예상 인앱 메시지가 기기에 표시되지 않는 문제를 해결하려면 인앱 메시지가 기기에 전달되었는지 확인한 다음 메시지 표시 문제를 해결하세요.

배달 문제 해결

SDK는 세션 시작 시 Braze 서버에 인앱 메시지를 요청합니다. 인앱 메시지가 기기에 전달되고 있는지 확인하려면 인앱 메시지가 SDK에 의해 요청되고 Braze 서버에 의해 반환되는지 확인해야 합니다.

메시지 요청 및 반환 여부 확인

  1. 대시보드에서 테스트 유저로 자신을 추가합니다.
  2. 사용자를 대상으로 인앱 메시지 캠페인을 설정합니다.
  3. 애플리케이션에서 새 세션이 발생하는지 확인합니다.
  4. 이벤트 사용자 로그)를 사용하여 세션 시작 시 기기에서 인앱 메시지를 요청하는지 확인하세요. 테스트 사용자의 세션 시작 이벤트와 연결된 SDK 요청을 찾습니다.
    • 앱에서 트리거된 인앱 메시지를 요청하는 경우 응답 데이터 아래 요청된 응답 필드에 trigger가 표시되어야 합니다.
    • 앱에서 원본 인앱 메시지를 요청하는 경우 응답 데이터 아래 요청된 응답 필드에 in_app이 표시되어야 합니다.
  5. 이벤트 사용자 로그 )를 사용하여 응답 데이터에서 올바른 인앱 메시지가 반환되고 있는지 확인하세요.
요청되지 않는 메시지 문제 해결

인앱 메시지가 요청되지 않는 경우 앱이 세션을 올바르게 추적하지 않을 수 있습니다. 인앱 메시지는 세션 시작 시 새로 고쳐지기 때문입니다. 또한 앱의 세션 제한 시간 의미에 따라 앱이 실제로 세션을 시작했는지 확인해야 합니다.

성공적인 세션 시작 이벤트를 표시하는 이벤트 사용자 로그에서 발견된 SDK 요청.

반환되지 않는 메시지 문제 해결

인앱 메시지가 반환되지 않는다면 캠페인 타겟팅에 문제가 있는 것일 수 있습니다:

  1. 세그먼트에 사용자가 포함되어 있지 않습니다.
    • 사용자의 [**참여](/docs/ko/user_guide/engagement_tools/segments/using_user_search/#engagement-tab) 탭에서 **세그먼트 아래에 올바른 세그먼트가 표시되는지 확인합니다.
  2. 사용자가 이전에 인앱 메시지를 받은 적이 있으며 다시 받을 자격이 없습니다.
    • 캠페인 작성기의 전달 단계 아래에서 캠페인 재자격 설정)을 확인하고 재자격 설정이 테스트 설정과 일치하는지 확인합니다.
  3. 사용자가 캠페인의 빈도 한도에 도달했습니다.
    • 캠페인빈도 제한 설정)을 확인하여 테스트 설정과 일치하는지 확인하세요.
  4. 캠페인에 대조 그룹이 있는 경우 사용자가 대조 그룹에 속했을 수 있습니다.
    • 캠페인 이형 상품이 컨트롤로 설정된 수신된 캠페인 이형 상품 필터로 세그먼트를 생성하고 사용자가 해당 세그먼트에 속하는지 확인하여 이 문제가 발생했는지 확인할 수 있습니다.
    • 통합 테스트 목적으로 캠페인을 생성할 때는 대조군 추가를 옵트아웃해야 합니다.

디스플레이 문제 해결

앱에서 인앱 메시지를 성공적으로 요청하고 수신하고 있지만 표시되지 않는 경우 기기 측 로직으로 인해 표시되지 않는 것일 수 있습니다.

  1. 트리거 이벤트가 예상대로 실행되고 있나요? 이를 테스트하려면 세션 시작과 같은 다른 동작을 사용하여 메시지가 트리거되도록 구성하고 메시지가 표시되는지 확인합니다.

  2. 트리거된 인앱 메시지는 트리거 사이의 최소 시간 간격을 기준으로 속도 제한이 적용되며, 기본값은 30초입니다.

  3. 이미지 다운로드에 실패하면 이미지가 포함된 인앱 메시지가 표시되지 않습니다. 디바이스 로그를 확인하여 이미지 다운로드가 실패하지 않았는지 확인하세요. 메시지에서 이미지를 일시적으로 제거하여 이미지가 표시되는지 확인해 보세요.

  4. 인앱 메시지 처리를 사용자 지정하기 위해 위임을 설정한 경우, 위임이 인앱 메시지 표시를 방해하지 않는지 확인합니다.

  5. 기기 방향이 인앱 메시지에 지정된 방향과 일치하지 않으면 인앱 메시지가 표시되지 않습니다. 디바이스의 방향이 올바른지 확인하세요.

  6. 인앱 메시지가 세션 시작 시 트리거되고 연장 세션 시간 제한을 설정한 경우 메시지를 표시할 수 있는 속도에 영향을 미칩니다. 예를 들어 세션 시간 제한이 300초로 설정된 경우 이 시간 내에 앱을 닫았다가 다시 열면 세션이 새로 고쳐지지 않으므로 세션 시작 시 트리거되는 인앱 메시지가 표시되지 않습니다.

자산 로딩 문제 해결(NSURLError 코드 -1008)

Braze를 서드파티 네트워크 로깅 라이브러리와 통합할 때 개발자는 일반적으로 도메인 코드 -1008과 관련된 NSURLError에 직면할 수 있습니다. 이 오류는 이미지 및 글꼴과 같은 자산을 검색할 수 없거나 캐시하는 데 실패했음을 나타냅니다. 이러한 사례를 해결하려면 해당 라이브러리에서 무시해야 하는 도메인 목록에 Braze의 CDN URL을 등록해야 합니다.

도메인

CDN 도메인의 전체 목록은 아래와 같습니다:

  • "appboy-images.com"
  • "braze-images.com"
  • "cdn.braze.eu"
  • "cdn.braze.com"

예시

다음은 Braze의 자산 캐싱과 충돌하는 것으로 알려진 라이브러리와 문제를 해결하기 위한 예제 코드입니다. 프로젝트에서 사용 불가능한 리소스 오류를 발생시키고 아래에 나열되지 않은 라이브러리를 사용하는 경우, 유사한 사용 API와 관련하여 해당 라이브러리의 설명서를 참조하세요.

Netfox
1

NFX.sharedInstance().ignoreURLs(["https://cdn.braze.com"])

1

[NFX.sharedInstance ignoreURLs:@[@"https://cdn.braze.com"]];
NetGuard
1

NetGuard.blackListHosts.append(contentsOf: ["cdn.braze.com"])

1
2
3

NSMutableArray<NSString *> *blackListHosts = [NetGuard.blackListHosts mutableCopy];
[blackListHosts addObject:@"cdn.braze.com"];
NetGuard.blackListHosts = blackListHosts;
XNLogger
1
2

let brazeAssetsHostFilter = XNHostFilter(host: "https://cdn.braze.com")
XNLogger.shared.addFilters([brazeAssetsHostFilter])

1
2

XNHostFilter *brazeAssetsHostFilter = [[XNHostFilter alloc] initWithHost: @"https://cdn.braze.com"];
[XNLogger.shared addFilters:@[brazeAssetsHostFilter]];
Github   GitHub 에서 이 페이지를 편집합니다.
이 페이지가 얼마나 도움이 되었나요?
New Stuff!