테스트 및 게시

Amplitude를 사용하면 가이드 및 설문조사를 게시하기 전에 테스트할 수 있습니다. 테스트를 통해 설정이 확인되었으며, 동작이 사용자의 기대에 부합함을 확인했습니다.

가이드 및 설문조사를 테스트하는 방법에는 두 가지가 있습니다.

• 미리보기 모드: 가이드 또는 설문조사의 모양을 빠르게 확인하고 설정을 확인할 수 있는 첫 번째 방법입니다.
• 테스트 상태: 출시 전에 특정 사용자와 실시간 테스트를 진행합니다.

미리보기 모드

미리보기 모드는 가이드 및 설문조사가 예상대로 작동하는지 확인합니다. 가이드 또는 설문조사의 모양만 확인하려면 Amplitude에서 해당 가이드를 엽니다. 런타임 동작을 확인하려면 미리보기 모드에서 테스트하세요.

Amplitude는 출시 전에 철저한 테스트를 통해 다음을 확인할 것을 권장합니다.

• 버튼 동작은 사용자가 의도한 대로 작동합니다.
• 다단계 가이드 및 설문조사는 올바른 속도로 진행됩니다.
• 핀과 툴팁은 해당 위치에 표시됩니다.

빌더에서 미리보기 모드를 열려면 다음과 같이 하십시오.

1. 가이드 또는 설문조사를 엽니다.
2. 미리보기를 클릭합니다.
3. 웹의 경우 가이드 및 설문조사 SDK가 설치된 페이지의 URL을 입력합니다. 모바일의 경우 QR 코드를 스캔하거나 미리보기 URL을 엽니다.
4. Amplitude는 SDK가 사용 가능한지 확인합니다. 웹의 경우 URL은 미리보기 막대가 표시된 상태로 새 탭에서 열립니다. 모바일의 경우 미리보기가 앱에서 열리고 미리보기 막대가 표시됩니다.

기본적으로 미리보기 창은 사용자가 닫을 때까지 열려 있습니다. app.Amplitude.com이 애플리케이션의 G&S SDK와 통신할 때까지 10초 동안 기다린 후 미리보기 창을 닫으려면 미리보기 창을 자동으로 닫지 마십시오.

미리보기 모드에서 가이드 또는 설문조사 편집

미리 보는 동안 가이드나 설문조사를 변경할 수 있으며, 빌더로 다시 전환할 필요가 없습니다. 편집 내용은 저장하는 즉시 대시보드와 미리 보기 모두에 적용되므로 카드 삽입과 같이 위치 조정이 중요한 작업의 속도가 향상됩니다.

1. 미리보기 모드에서 가이드 또는 설문조사를 엽니다.
2. 미리보기 막대에서 편집을 클릭합니다.
3. 폼 팩터, 위치 또는 기타 속성을 변경합니다.
4. 저장을 클릭합니다.

Amplitude는 변경 사항을 대시보드와 미리보기에 즉시 적용합니다. 이 기능은 핀과 같은 앵커된 가이드와 배너, 모달, 체크리스트, 팝오버와 같은 앵커되지 않은 폼 팩터 모두에 적용됩니다.

테스트 사용자 모드

테스트 사용자 모드를 사용하면 프로덕션 분석에 영향을 주지 않고 실제 장치에서 가이드 및 설문조사를 미리 보고 디버깅할 수 있습니다. SDK는 테스트 사용자 모드의 사용자를 일반 사용자와 다르게 취급하므로 가이드 및 설문조사는 다른 모든 사용자에게 동일한 방식으로 렌더링되지 않습니다.

다음 중 하나를 수행할 때는 테스트 사용자 모드를 사용하십시오.

• Amplitude SDK 설치하기.
• 보고된 문제를 재현합니다.
• 가이드 또는 설문조사가 올바르게 트리거되는지 확인합니다.

_프로젝트 설정 > 가이드 및 설문조사_로 이동하여 사용자 테스트 모드를 구성합니다.

디버깅을 완료한 후 끕니다. 장기간 테스트 사용자 모드로 장치나 계정을 유지하면 예상되는 렌더링 동작에 대해 혼란을 야기할 수 있습니다.

미리보기 모드에서 확인된 조건

미리보기 막대는 Amplitude가 가이드 표시 또는 설문조사 표시 여부를 결정하는 데 사용하는 세 가지 조건의 상태를 보여줍니다.

• 트리거
• 제한
• 스로틀

조건 상태

각 조건에는 세 가지 가능한 상태가 있습니다.

미리보기 모드의 작동 방식

미리보기 모드는 브라우저 메시징을 사용하여 Amplitude 대시보드 대상 구간 애플리케이션 간에 통신합니다. 미리 보기를 시작할 때:

1. Amplitude 대시보드에서 애플리케이션 URL이 새 탭에 열립니다.
2. 대시보드는 페이지에서 실행 중인 가이드 및 설문조사 SDK의 메시지를 약 10초 동안 기다립니다.
3. SDK가 메시지를 전송하면 대시보드가 가이드 또는 설문조사 ID를 비롯한 미리보기 정보를 사용하여 응답합니다.
4. SDK는 미리보기 정보를 수신하고 미리보기를 표시합니다.

이 통신은 브라우저의 window.postMessage API에 의존하여 대시보드와 애플리케이션 간에 메시지를 전달합니다.

미리보기 모드 문제 해결

가끔 가이드나 설문조사가 미리보기에 나타나지 않을 수도 있습니다. 계측이 올바른 경우 다음 사항을 확인하십시오.

• 미리 보기 사용자가 아직 가이드 또는 설문조사를 보지 않았는지 확인하십시오. 사용자가 이를 본 경우, 미리보기 막대에 제한 조건에 대한 노란색(경고) 상태가 표시됩니다. 조건 위에 마우스를 올려 놓고 사용자 기록 재설정을 클릭합니다.
• 스로틀 제한에 도달하지 않았는지 확인하십시오. 제한에 도달하면 스로틀 조건이 노란색(경고) 상태로 표시됩니다. 조건 위에 마우스를 올려 놓고 스로틀 제한 무시를 토글합니다.
• 트리거 조건이 On event tracked일 경우 이벤트가 발생하는지 확인하십시오. 이벤트가 발생하지 않은 경우 트리거 조건은 파란색 상태를 표시합니다. 트리거 조건 위에 마우스를 올리고 이벤트를 수동으로 트리거를 클릭합니다.

오류 메시지는 없지만 미리 보기가 나타나지 않습니다.

Amplitude 대시보드에 오류가 표시되지 않지만 미리보기가 나타나지 않는 경우:

• 대시보드가 SDK로부터 초기 메시지를 받았습니다.
• SDK가 대시보드에서 응답 메시지를 수신하지 못합니다.

문제를 해결하려면 다음과 같이 하십시오.

• 브라우저 콘솔에서 메시지 전달과 관련된 오류를 확인하십시오.
• 브라우저 확장 기능이나 보안 설정이 교차 창 메시징을 차단하지 않는지 확인하십시오.
• 디버깅을 위해 창을 열어 두도록 미리 보기 모달에서 미리 보기 창을 자동으로 닫지 않음 옵션이 활성화되어 있는지 확인하십시오(기본값).

오류 메시지 및 미리 보기가 나타나지 않습니다.

약 10초 후에 Amplitude 대시보드에 오류가 표시되면 대시보드가 SDK로부터 메시지를 받지 못한 것입니다. 원인은 다음 중 하나입니다.

• SDK가 페이지에 로드되지 않습니다.
• SDK가 대시보드와 통신할 수 없습니다.

문제를 해결하려면 다음과 같이 하십시오.

• 브라우저 콘솔에서 window.engagement를 사용하여 SDK가 올바르게 설치되었는지 확인하십시오.
• 대기 시간을 10초 이상 연장하려면 미리보기 창을 자동으로 닫지 않음 옵션이 활성화되어 있는지 확인하십시오(기본값).
• 애플리케이션 URL이 올바른지 그리고 액세스할 수 있는지 확인하세요.

알려진 문제점: Cross-Origin-Opener-Policy 헤더

애플리케이션이 Cross-Origin-Opener-Policy(COOP) 헤더를 same-origin로 설정한 경우 COOP 헤더는 Amplitude 대시보드와 애플리케이션 간에 메시지가 전달되는 것을 방지하며, 이는 미리보기 모드를 차단합니다.

해결하려면 다음 중 하나를 수행하십시오.

• COOP 헤더를 same-origin가 아닌 same-origin-allow-popups로 설정하십시오.
• 테스트를 위해 COOP 헤더를 일시적으로 비활성화하십시오.

COOP 헤더에 대한 자세한 내용은 MDN 문서를 참조하세요.

모바일: 미리 보기가 앱을 열지 않습니다

Chrome 확장 프로그램, window.postMessage및 COOP 검사는 웹에만 적용됩니다. 모바일의 미리보기 모드는 QR 코드와 사용자 지정 URL 체계를 사용합니다.

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

앱이 열리지만 가이드가 나타나지 않는 경우, 화면 하단의 Amplitude 로고를 탭하고 Super Debugger Details 탭을 사용하여 트리거, 제한 및 조절 조건을 검사하십시오.

테스트 상태 기능

미리보기 모드는 귀하의 가이드나 설문조사가 사용자에게 어떻게 표시되는지를 대략적으로 나타냅니다. 실시간 환경에서 테스트하려면 테스트 상태를 사용하여 더 많은 대상에게 영향을 주지 않고 특정 사용자와 함께 가이드나 설문조사를 테스트하세요.

가이드 또는 설문조사를 테스트 상태로 설정할 때:

• 지정된 모든 테스트 사용자(장치 ID, 사용자 ID 또는 코호트)는 가이드 또는 설문조사를 볼 수 있습니다.
• Amplitude는 글로벌 스로틀(예: '하루에 최대 1개의 가이드 표시')을 무시하지만 완료 및 닫기 기록과 같은 사용자별 제한을 여전히 적용합니다. 테스트 사용자의 제한 기록을 재설정하려면 해당 사용자의 프로필에서 기록 지우기를 사용하십시오.
• 가이드 또는 설문조사는 프로덕션 사용자에게 숨겨진 상태로 유지됩니다.

테스트 상태를 사용하려면:

1. 가이드 또는 설문조사를 엽니다.
2. 테스트 사용자 섹션에서 장치 ID, 사용자 ID 또는 코호트를 사용하여 테스트 사용자를 지정합니다.
3. 상태를 테스트중으로 변경합니다.

게시

가이드 또는 설문조사의 편집 및 테스트를 완료한 후 빌더에서 게시를 클릭하여 사용자에게 가이드 또는 설문조사를 릴리스합니다. 프로젝트가 게시되기 전에 검토자가 사인오프해야 하는 경우 승인 워크플로를 참조하십시오.

가이드를 게시한 후에도 여전히 변경을 수행할 수 있습니다. Amplitude는 사용자가 변경사항을 명시적으로 게시하기 전까지 변경사항을 "게시되지 않은" 상태로 저장합니다.

대시보드의 미리보기 창과 미리보기 모드에서는 게시되지 않은 전체 변경 사항을 포함하여 가이드 또는 설문조사를 확인할 수 있습니다. 버전 기록을 사용하여 마지막으로 게시한 이후 변경 사항이 얼마나 많은지 확인할 수 있습니다.

버전 기록

모든 저장은 버전을 생성합니다. 가이드 또는 설문조사 편집기에서 버전 기록을 열어 각 변경사항, 변경 주체, 변경 시점을 확인하세요.

이전 버전으로 되돌리려면 버전 항목에서 복원을 클릭하십시오. 복원하면 해당 버전의 기본 언어 필드가 초안에 덮어씌워집니다. 자동으로 게시되지 않으므로 준비가 되면 검토하고 게시하세요.

• 가이드 또는 설문조사를 편집할 수 있는 사용자는 누구나 버전을 복원할 수 있습니다. 보기 전용 액세스 권한을 가진 사용자는 복원을 볼 수 없습니다.
• 기본 언어 필드만 오버레이되므로 기본 로케일이 아닌 지역을 볼 때는 복원을 사용할 수 없습니다. 복원할 기본 언어로 전환하십시오. 자세한 내용은 현지화를 참조하십시오.