가이드 또는 설문조사가 표시되지 않음

절대 표시되지 않는 가이드나 설문조사는 일반적으로 5가지 검사 중 하나에 실패합니다. SDK가 페이지나 앱에서 실행되고 있지 않거나, 경험이 올바른 프로젝트에 게시되지 않았거나, 사용자가 타겟팅과 일치하지 않거나, 트리거가 작동하지 않거나, 제한이나 스로틀이 표시를 차단합니다. 이 순서대로 검사를 수행하십시오. 왜냐하면 SDK 설정이 잘못되면 다른 모든 검사를 평가할 수 없기 때문입니다.

이 문서는 사용자가 안내서 또는 설문조사를 구성하는 방법을 알고 있다고 가정합니다. 복습이 필요한 경우 계속하기 전에 설정 및 타겟팅을 검토하십시오. 대신 해당 경험이 예상보다 더 자주 표시되는 경우, 너무 자주 표시되는 가이드 또는 설문조사로 이동하세요.

미리보기 모드 및 플랫폼 도구를 사용한 디버깅

설정을 변경하기 전에 실패한 조건을 리포트하는 도구를 사용하십시오. 추측할 필요가 없습니다.

웹: Chrome 확장 프로그램 및 미리보기 모드

Amplitude Chrome 확장 프로그램은 표시되지 않는 웹 가이드 또는 설문조사를 진단하는 가장 빠른 방법입니다. 가이드 및 설문조사 탭에서는 다음과 같은 내용을 보고합니다.

SDK 설정: SDK가 설치되었는지, 초기화되었는지, 분석 SDK에 연결되었는지, 부팅되었는지 여부, Plus Show config의 API 키와 Show user info의 확인된 사용자도 포함됩니다.
트리거 조건: 프로젝트에 게시된 모든 가이드 및 설문조사에 대해 어떤 조건이 통과하고 어떤 조건이 표시를 차단하는지(내장 스로틀, 사용자 지정 스로틀, 제한, 페이지 타겟팅, 스누즈 및 사용자 타겟팅을 포함)를 확인할 수 있습니다.
전달된 이벤트: SDK가 관찰하는 모든 클라이언트측 이벤트입니다. 이벤트 이름을 입력하고 이벤트 테스트를 클릭하여 이벤트를 시뮬레이션하고 이벤트 기반 트리거 발생을 확인합니다.

이 확장 프로그램의 가이드 및 설문조사 탭은 실시간으로 업데이트되지 않으므로 페이지가 로드될 때까지 기다린 후 읽으세요.

미리보기 모드는 단일 경험을 실제 페이지와 비교하여 확인합니다. 미리보기 막대에는 트리거, 제한 및 스로틀 조건이 표시됩니다. 여기서 녹색은 조건이 통과했음을 의미하고 노란색은 표시를 차단함을 의미합니다. 미리 보기 막대에서 사용자 기록 재설정을 클릭하고, 스로틀 제한 무시를 토글하며, 트리거가 대기하는 이벤트를 수동으로 트리거할 수도 있습니다. 미리 보기 자체가 나타나지 않는 경우 window.postMessage오류 및 Cross-Origin-Opener-Policy헤더를 다루는 문제 해결 미리 보기 모드로 이동하십시오.

모바일: 슈퍼 디버거 및 미리보기 모드

모바일의 미리보기 모드는 QR 코드와 미리보기 URL을 표시합니다. 앱이 설치된 기기로 코드를 스캔하거나, 해당 기기에서 URL을 엽니다. SDK 및 URL 스키마를 구성한 후에는 앱이 화면 하단에 작은 Amplitude 로고와 함께 열립니다. 로고를 탭하여 슈퍼 디버거를 엽니다.

슈퍼 디버거 세부 정보 탭은 제한, 트리거(화면 조건 및 핀 대상 포함) 및 조절 기능을 보고합니다. 미리보기 중에 조절 기능을 우회하려면 제한 무시를 토글합니다. 설정 탭은 SDK 버전, 설치 유형, 사용자 ID 및 이벤트가 안내서 및 설문조사 SDK로 유입되거나 유출되는지 여부를 보고합니다. 전체 패널을 보려면 Super Debugger로 이동하십시오. Android, React Native 및 Flutter SDK에는 동일한 디버거가 포함되어 있습니다.

미리보기 모드가 앱에 도달하지 않는 경우:

iOS 표시 내용No usable data found: 기기에 미리보기 URL을 처리하는 앱이 없습니다. 해당 iOS 기기에 앱이 설치되어 있지 않거나, 설치된 빌드가 프로젝트의 모바일 URL 체계를 등록하지 않습니다. 가이드 및 설문조사 SDK와 URL 구성표가 포함된 빌드를 설치한 다음 해당 기기의 카메라로 QR 코드를 스캔하십시오.
Android의 액션 시트에는 앱이 나열되어 있지 않습니다. 동일한 원인입니다. OS에는 미리보기 URL을 처리하는 앱이 없으므로 공유 시트나 '열기' 시트에 아무 것도 표시되지 않습니다. SDK 및 URL 스키마에 대한 인텐트 필터가 포함된 빌드를 설치합니다. Android Preview 설정으로 이동합니다.
미리보기는 앱 대신 브라우저에서 열립니다. URL 체계를 등록하지 않았거나, 앱이 링크를 수신할 때 handleUrl(iOS) 또는 handleLinkIntent(Android)를 호출하지 않습니다.

미리보기 모드는 실제 전달이 아닌 렌더링과 조건을 확인합니다. 실제 사용자와 함께 제공을 테스트하려면 테스트 중 상태를 사용하십시오.

문제 해결 체크리스트

이 질문들을 체크리스트로 사용하십시오. 질문에 대해 "예"라고 대답할 수 있는 경우 해당 설정이 문제의 원인일 가능성이 낮습니다.

SDK가 페이지 또는 앱에 설치되고 부팅되었습니까?

웹에서 브라우저 콘솔을 열고 window.engagement를 입력합니다. undefined의 응답은 가이드 및 설문조사 SDK가 해당 페이지에 설치되어 있지 않음을 의미합니다. 그런 다음 window.engagement._debugStatus() 을 입력하고 user 객체가 존재하는지, apiKey 이(가) 설정되어 있는지, stateInitialized 및 decideSuccessful 이(가) 둘 다 true 인지, num_guides_surveys 이(가) 0보다 큰지 확인합니다.

일반적인 웹 설치 문제에는 일부 페이지에서는 로드되지만 다른 페이지에서는 로드되지 않는 SDK, 특정 환경이나 사용자 유형에 대해 조건부로 실행되는 boot 호출, 두 번 이상 실행되는 boot 호출, Amplitude Browser SDK 전에 로드되는 가이드 및 설문조사 SDK 등이 있습니다. 사용자 지정 HTML 태그를 사용하여 Google 태그 관리자를 통해 설치하는 경우 태그의 고급 설정에서 Support document.write를 활성화하십시오. 전체 목록을 보려면 설치 문제 해결으로 이동하십시오.

모바일에서는 브라우저 콘솔 대신 슈퍼 디버거 설정 탭을 사용하십시오. SDK 버전이 나타나는지, 사용자 ID가 예상한 사용자와 일치하는지, 이벤트가 가이드 및 설문조사 SDK로 흐르는지 확인하십시오. 미리보기 모드에서 Amplitude 로고가 표시되지 않는 경우, SDK가 미리보기 URL을 처리하지 않는 것입니다. 프로젝트의 URL 구성표를 추가했는지 확인하고 앱이 인바운드 링크를 SDK로 전달했는지 확인합니다.

API 키가 경험을 보유하고 있는 프로젝트와 일치합니까?

SDK는 해당 API 키와 연결된 프로젝트에 대한 가이드와 설문조사를 가져옵니다. 다른 프로젝트의 키를 사용하여 SDK를 초기화하는 경우 설정이 올바르게 보일지라도 경험이 로드되지 않습니다. 핵심 Amplitude SDK 및 가이드 및 설문조사 SDK에 동일한 API 키를 사용하고, 키가 경험을 게시한 프로젝트에 속하는지 확인하세요.

상태가 '게시됨'으로 설정되어 있고, 스케줄이 활성화되어 있습니까?

초안 경험은 사용자에게 나타나지 않으며, 테스트 경험은 테스트 사용자 섹션의 장치 ID, 사용자 ID 및 코호트에게만 나타납니다. 예약된 경험의 경우 현재 시간이 시작일과 종료 날짜 사이에 있는지 확인하고 해당 시간은 프로젝트의 시간대를 사용한다는 점을 기억하십시오. 또한 대량 게시 취소로 인해 해당 경험이 오프라인으로 전환되었는지 확인하세요.

사용자가 귀하의 타겟팅과 일치합니까?

타겟팅 세그먼트를 열고 영향을 받는 사용자가 그 중 적어도 하나와 일치하는지 확인하십시오. AmplitudeOR는 여러 세그먼트를 지원하므로 사용자는 하나만 일치시켜야 하지만 세그먼트 내의 모든 필터는 일치해야 합니다.

이러한 타겟팅 원인을 주의하십시오.

롤아웃 비율이 100% 미만이면 버킷 외부의 사용자는 제외됩니다. 버킷화 유닛은 해당 할당이 사용자의 디바이스 전체에서 일관성을 유지하는지 여부를 결정합니다.
배열 사용자 속성은 평가 시점에 평평하지 않으므로 점으로 된 경로와 같은 항목은 subscription.plan 해석되지 않습니다. 대신 평면 스칼라 속성을 대상으로 설정하십시오.
코호트 멤버십은 일정에 따라 데이터 동기화되므로 방금 자격을 갖춘 사용자는 아직 일치하지 않습니다. 동기화 규칙을 확인하려면 코호트 타겟팅으로 이동하세요.
필터가 읽은 사용자 속성은 평가 시점에 사용자의 프로필에 없을 수 있습니다.
프로젝트 전체의 기본 사용자 제외는 경험 자체의 타겟팅 외에도 적용됩니다. 프로젝트 전체 제외 세그먼트에 일치하는 사용자는 경험의 타겟팅과 일치하더라도 프로젝트에서 어떠한 가이드나 설문조사도 볼 수 없습니다.
그룹 코호트 타겟팅을 사용하려면 각 사용자에 대해 계측 도구가 호출을 수행해야 합니다setGroup. 그룹 속성을 이벤트에 연결하면 이벤트 수준의 그룹화가 생성되며, 이는 분석을 지원하지만 그룹 코호트 타겟팅에 대한 사용자의 자격을 부여하지는 않습니다. 자세한 내용은 그룹 코호트 타겟팅(Group cohort targeting) 사용 이벤트 수준 그룹으로 이동하세요.

이 사용자에 대해 트리거가 작동합니까?

트리거가 사용자가 실제로 수행하는 작업과 일치하는지 확인하십시오.

없음 트리거는 절대로 자체적으로 작동하지 않습니다. SDK, 다른 가이드의 콜 투 액션 또는 기타 외부 트리거를 기다립니다.
이벤트 추적에는 SDK가 관찰할 수 있는 클라이언트측 이벤트가 필요합니다. 서버측 이벤트, 레이블이 지정된 이벤트 및 사용자 지정 이벤트는 트리거로 작동하지 않습니다. 웹에서 확장 프로그램의 전달된 이벤트 목록을 확인하여 SDK가 해당 이벤트를 인식하는지 확인하세요. 모바일의 경우 슈퍼 디버거 설정 탭에서 이벤트 흐름을 확인하세요.
요소가 나타날 때 각 페이지 또는 화면이 로드될 때마다 한 번 발생하며, 요소가 뷰 밖으로 스크롤되어 다시 들어올 때에도 다시 트리거되지 않습니다.
요소를 클릭/탭하고 요소 기반 조건이 여전히 일치하는 선택기에 의존하는 경우. 웹에서 이는 현재 마크업에 대한 CSS 선택기 또는 XPath입니다. 클래스 이름을 변경하는 재설계는 선택기를 작동하지 않게 합니다. 모바일의 경우, 이는 대상 뷰의 고유 식별자입니다(iOS의 경우 accessibilityIdentifier; Android의 경우 tag, contentDescription 또는 resourceName; Jetpack Compose에서 .amplitudeView 또는 AmplitudeView에 전달되는 tag). 두 뷰가 하나의 식별자를 공유하거나 식별자가 누락된 경우 트리거가 실행되지 않습니다.
트리거 지연은 사용자가 지연 시간이 경과하기 전에 이동할 경우 표시를 취소하며, Amplitude는 트리거 시점이 아닌 지연 시간 후에 조건부 로직을 재평가합니다.
경험에서 세션 속성을 사용하는 경우 구성된 모든 세션 속성 조건은 표시 시에 일치해야 합니다.

현재 페이지 또는 화면이 Where 조건과 일치합니까?

Where 설정을 검토하고 일치 유형을 SDK가 실제로 보고하는 내용과 비교하여 테스트하십시오.

웹에서 질의 매개 변수와 후행 슬래시를 포함하여 규칙을 정확한 URL과 비교하십시오. 스테이징 URL에서 작동하는 정규표현식이나 패턴은 프로덕션 환경에서 누락될 수 있습니다.

모바일의 경우, 'Where' 조건은 웹 URL이 아닌 화면 이름과 일치합니다. 슈퍼 디버거 세부 정보 탭의 화면 필드에는 SDK가 보고하는 이름이 표시됩니다. 해당 문자열이 포함 규칙과 일치하지 않는 경우 경험은 표시되지 않습니다. _프로젝트 설정 > 가이드 및 설문조사_에서도 프로젝트 전체 기본 페이지 제외를 확인하십시오. 프로젝트 수준에서 한 번 설정된 제외 사항은 나중에 만드는 경험을 포함하여 모든 경험에 적용됩니다. 페이지 및 화면 타겟팅은 공유 링크에도 적용됩니다. 링크는 오디언스 타겟팅을 우선시하지만 Where 타겟팅은 우선시하지 않습니다.

사용자가 이미 이것을 보았습니까?

Amplitude는 기본적으로 Stop showing when completed 및 Stop showing when dismissed 을(를) 활성화하므로 경험을 한 번 완료하거나 종료한 사용자는 다시 해당 경험을 볼 수 없습니다. 재사용 대기시간은 만료될 때까지 표시를 차단하며, 해당 경험을 스누즈한 사용자는 스누즈 기간이 경과할 때까지 해당 경험을 다시 볼 수 없습니다. 사용자의 자격을 다시 부여하려면 사용자 프로필을 열고 가이드 또는 설문조사 탭으로 이동한 다음 해당 경험에 대한 기록 지우기를 선택하십시오.

스로틀이 디스플레이를 가로막습니까?

스로틀링 조절은 각 사용자가 하루, 주, 월 또는 세션에 볼 수 있는 가이드나 설문조사의 수를 제한하며, 가이드와 설문조사의 설정은 서로 다릅니다. 네 개의 레이어를 모두 확인하십시오.

글로벌 한도 및 기간입니다.
시간 간격 지연: 사용자가 가이드를 본 후 설정된 기간 동안 두 번째 가이드를 차단합니다.
고급 태그 기반 조절 기능으로, 가장 제한적인 수준이 우선합니다.
상호 배타성 그룹으로, 그룹에서 한 항목을 본 사용자는 다른 항목을 볼 수 없습니다.

다른 경험이 이미 화면에 있습니까?

Amplitude는 한 번에 하나의 핀, 팝오버 또는 모달만 표시하며 하나의 배너와 하나의 체크리스트만 표시합니다. 이러한 폼 팩터 중 하나가 이미 표시되고 다른 폼 팩터가 트리거되면 두 번째 폼 팩터는 표시되지 않으며 나중에 대기열에 올라가지 않습니다. 동시에 여러 경험에 해당하는 경우 우선 순위와 동점 결승 규칙에 따라 어느 경험이 선택될지가 결정됩니다.

단계가 렌더링될 때 앵커 요소가 존재합니까?

핀, 툴팁 및 카드 임베드는 요소에 부착됩니다. 해당 요소가 렌더링 시에 DOM(웹) 또는 뷰 계층(모바일)에 없는 경우 단계가 표시되지 않으며 가이드 및 설문조사에서는 해당 단계를 건너뛰거나 다른 위치로 폴백하지 않습니다. 웹에서 요소가 늦게 렌더링되거나, 느리게 로드되는 컴포넌트 뒤에 있거나, 섀도우 DOM 내에 존재하는 것이 일반적인 원인입니다. 모바일에서는 각 대상 보기가 고유한 식별자를 가지고 있는지, 그리고 동일한 화면에 있는 두 개의 카드 임베드가 식별자를 공유하지 않는지 확인하십시오. 또한 핀은 iOS 탭 바 항목이나 애니메이션 컨테이너 내부의 뷰를 대상으로 삼을 수 없습니다.

환경이 SDK를 차단하고 있습니까?

웹에서는 엄격한 콘텐츠 보안 정책이 SDK에 필요한 요청과 인라인 스타일을 차단합니다. script-src, connect-src, img-src, media-src 및 style-src 지시어에 대해 https://*.amplitude.com을(를) 허용하고, 정책이 인라인 스타일을 차단하는 경우 초기화 시 nonce을(를) 전달하십시오. 가이드 및 설문조사 역시 제한적인 iframe 지원을 제공합니다. 선택기는 iframe 경계를 넘을 수 없으므로 각 iframe은 어떤 것을 표시하려면 자체 SDK 인스턴스가 필요합니다.

모바일에서 SDK는 가이드 및 설문조사를 가져오려면 네트워크 연결이 필요합니다. 앱이 실행될 때 기기가 오프라인 상태인 경우 해당 세션에 대해 아무 것도 표시되지 않습니다. 네트워크에서 다시 시도한 다음 슈퍼 디버거 설정 탭에서 이벤트 흐름을 확인하십시오.

사용자의 SDK 버전이 이 기능을 지원합니까?

모바일 SDK는 자동 업데이트가 불가능하므로 이전 버전의 기기는 최신 기능에 의존하는 경험을 받을 수 없습니다. 예를 들어 세션 트리거에서 N 이벤트를 사용하려면 iOS, Android 및 React Native SDK v3.7.0 이상이 필요하며, 이를 사용하는 가이드는 이전 버전의 사용자에게 전혀 도달하지 않습니다. 모바일 SDK 변경 로그로 이동하여 버전 요구 사항을 확인하세요.

제공에 실패한 것처럼 보이는 상황

일부 예상되는 행동은 경험이 깨진 것처럼 느껴질 수 있습니다.

미리보기 모드에서는 작동하지만 프로덕션에서는 작동하지 않습니다.

미리보기 모드와 테스트 상태는 모두 실제 사용자에게 적용되는 규칙을 완화합니다. Amplitude는 테스트 사용자의 제한을 무시하며, 미리보기 모드를 사용하면 스로틀을 우회하고 트리거 이벤트를 수동으로 실행할 수 있습니다. 이러한 조건에서 표시되는 경험은 여전히 프로덕션에서 제한, 스로틀링 또는 타겟팅 확인에 실패할 수 있습니다. 웹에서는 프로덕션 페이지의 Chrome 확장 프로그램을 사용하여 어떤 조건이 해당 기능을 차단하는지 확인하세요. 모바일에서 사용자를 테스트 사용자에 추가하고 경험을 테스트로 설정하여 실시간 전송 규칙을 사용하여 재현할 수 있습니다. 트리거, 제한 및 조절 조건을 검사해야 할 경우 미리 보기 및 슈퍼 디버거 세부 정보 탭을 사용하십시오.

일부 사용자만 볼 수 있음

롤아웃 비율이 100% 미만인 것이 가장 일반적인 이유입니다. 장치 ID 버킷화를 사용하면 각 장치가 독립적으로 할당되므로 동일한 사용자가 다른 장치가 아닌 한 장치에 대해 자격을 갖출 수 있습니다. 로그인한 사용자가 여러 기기에 대해 일관된 경험을 제공해야 할 경우 사용자 ID 버킷화로 전환하거나, 조직 내 모든 사용자가 동일한 결과를 원할 경우 계정 ID로 전환하십시오.

사용자가 해당 항목을 닫은 후 누락되었다고 보고함

활성 가이드는 사용자가 완료하거나 닫을 때까지 페이지나 화면을 따라다닙니다. 사용자가 해당 경험을 해제한 후에는 기본 제한으로 인해 다시 표시되지 않으므로, 실수로 해제한 사용자는 이후 방문 시 아무것도 볼 수 없습니다. 기록에서 해당 경험을 삭제하여 다시 자격을 갖추게 하십시오.

모바일 장치가 테스트 사용자 모드에 머무르기

테스트 사용자 모드로 남아 있는 장치는 일반 사용자와 다르게 가이드 및 설문조사를 렌더링합니다. 모바일 테스터가 일관성 없는 동작을 보고하면 모드가 꺼져 있는지 확인한 후 다시 테스트하십시오.

미리보기 모드에서는 모바일 앱을 열지 않습니다.

모바일에서의 미리 보기는 새 브라우저 탭이 아닌 사용자 지정 URL 구성표에 따라 달라집니다. iOS에 No usable data found가 표시되거나 Android의 작업 시트에 앱이 나열되지 않은 경우 OS에 미리보기 URL에 등록된 앱이 없는 것입니다. 스캔을 시작하는 기기에 앱을 설치하고, URL 구성표가 _설정 > 프로젝트 > 일반 > URL 구성표(모바일)_와 일치하는지 확인한 다음 다시 스캔하십시오. 이것은 타겟팅 또는 트리거 실패가 아닙니다. OS는 앱에 대한 링크를 전달하지 않았으므로 SDK가 실행되지 않았습니다.

경험은 일시적으로 숨겨져 있습니다

조건부 논리는 temporarily hide if조건이 적용되는 동안 활성 안내선을 숨길 수 있습니다. 가이드는 활성 상태로 유지되며 해당 조건이 일치하지 않는 경우 다시 표시할 수 있습니다. 흐름 도중 가이드가 사라질 때 각 단계의 조건을 확인하십시오.

그룹 코호트 타겟팅은 이벤트 수준의 그룹을 사용합니다

계측이 개별 이벤트에 그룹 속성을 연결할 때 Amplitude는 이벤트 수준의 그룹화를 생성합니다. 이벤트 수준 그룹은 분석을 위해 올바르게 작동합니다. 차트는 정확한 데이터를 표시하며 사용자는 그룹 프로필의 사용자 탭에 표시됩니다. 그러나 이벤트 수준의 그룹은 사용자가 가이드, 설문조사 또는 실험에서 그룹 코호트 타겟팅에 적합하도록 해주는 것은 아닙니다.

그룹 코호트 타겟팅이 작동하려면 계측이 각 사용자에 대해 분석 SDK를 호출setGroup해야 합니다. 이 호출은 사용자의 프로필에 그룹을 설정하며, 타겟팅은 이벤트 수준의 그룹 속성이 아닌 프로필 수준의 그룹 멤버십을 평가합니다.

차트와 그룹 프로필 데이터가 올바르게 보이더라도 대상 사용자가 여전히 가이드를 받지 못하는 경우, SDK 구현에서 setGroup를 호출하는지 확인하십시오. 구현 세부 사항은 사용자 그룹으로 이동하십시오.

이 내용이 도움이 되었나요?