App Embed 상세 가이드: NudgeAI 기능 활성화의 핵심¶

NudgeAI의 강력한 팝업 기능들(AI Plus Pop-up, AI Lite Pop-up 등)이 Shopify 스토어에 정상적으로 표시되고 원활하게 작동하려면, Shopify 테마 설정에서 NudgeAI 앱 임베드(App Embed)를 활성화하는 것이 매우 중요합니다. 이 가이드에서는 App Embed가 무엇인지, 그리고 NudgeAI를 위해 어떻게 설정하는지 단계별로 자세히 안내합니다.

App Embed란 무엇인가요?¶

Shopify의 App Embed 기능은 앱 개발자들이 스토어의 테마 코드를 직접 수정하지 않고도, 앱의 사용자 인터페이스(UI) 요소나 스크립트를 스토어의 특정 부분(주로 테마 전체에 적용)에 안전하고 효율적으로 추가할 수 있도록 Shopify가 제공하는 표준 방식입니다.

NudgeAI는 이 App Embed 기능을 사용하여 스토어의 테마와 자연스럽게 통합되고, 고객에게 최적의 팝업 경험을 제공합니다. App Embed를 활성화하면 NudgeAI가 스토어 페이지에 필요한 코드(예: 팝업 표시 로직)를 삽입할 수 있게 됩니다.

NudgeAI App Embed 활성화 단계¶

NudgeAI 앱 설치 후 또는 초기 설정 단계에서 App Embed를 활성화하라는 안내를 받게 됩니다. 다음 단계를 따라 정확하게 설정해주십시오.

NudgeAI 앱 대시보드에서 시작:
- Shopify 관리자 패널 > 앱(Apps)에서 NudgeAI 앱을 실행합니다.
- NudgeAI 앱 대시보드의 "Quick Settings (빠른 설정)" 섹션 또는 별도의 안내 영역에 있는 "Enable app embed (앱 임베드 활성화)" 버튼을 클릭합니다.
Shopify 테마 편집기로 이동:
- 위 버튼을 클릭하면 Shopify 스토어의 현재 활성화된 테마의 편집기 화면으로 자동으로 이동됩니다. 테마 편집기 왼쪽 사이드바 메뉴가 표시됩니다.
'앱 임베드 (App embeds)' 섹션 찾기:
- 테마 편집기 왼쪽 사이드바에서 '앱 임베드 (App embeds)' 라고 표시된 섹션(지구본 모양 아이콘 옆)을 찾아 클릭합니다. 이 섹션은 스토어에 설치된 앱 중 App Embed 기능을 사용하는 앱들의 목록을 관리하는 곳입니다.
NudgeAI 앱 임베드 활성화:
- '앱 임베드' 섹션이 열리면, 설치된 앱 목록 중에서 "NudgeAI Email" (또는 "NudgeAI" 등 유사한 이름) 항목을 찾습니다.
- 해당 항목 오른쪽에 있는 토글 스위치를 클릭하여 켭니다 (파란색 또는 활성화된 상태로 변경).
Shopify 테마 편집기 > 앱 임베드 > NudgeAI Email 활성화 예시
변경사항 저장:
- NudgeAI 앱 임베드 스위치를 켠 후, 매우 중요합니다: 테마 편집기 화면의 오른쪽 상단에 있는 '저장 (Save)' 버튼을 반드시 클릭하여 변경사항을 최종 적용합니다. 이 저장 버튼을 누르지 않으면 App Embed 활성화가 완료되지 않습니다.

App Embed 활성화 확인¶

App Embed가 올바르게 활성화되고 저장되었다면, NudgeAI 앱 대시보드의 App Embed 관련 안내가 "활성화됨" 또는 초록색 체크 표시 등으로 변경될 수 있습니다. (앱 인터페이스에 따라 다를 수 있음)

가장 확실한 방법은 실제 스토어에 방문하여 NudgeAI 팝업이 정상적으로 노출되는지 확인하는 것입니다.

특정 테마에서의 주의사항 및 문제 해결¶

테마 구조: 대부분의 최신 Shopify 테마는 '앱 임베드' 기능을 표준적으로 지원합니다. 하지만 매우 오래된 테마나 비표준적인 방식으로 크게 커스텀된 테마의 경우, '앱 임베드' 섹션의 위치가 약간 다르거나 예상치 못한 문제가 발생할 수도 있습니다. 자세한 내용은 App Embed: 특정 테마 참고사항 페이지를 확인해주세요.
캐시 문제: App Embed 설정을 변경한 직후에는 브라우저 캐시의 영향으로 스토어에 즉시 반영되지 않는 것처럼 보일 수 있습니다. 몇 분 정도 기다리거나, 브라우저의 시크릿 모드 또는 캐시 삭제 후 확인해보는 것이 좋습니다.
문제 발생 시: 위 단계를 모두 따랐음에도 App Embed 활성화가 어렵거나 NudgeAI 기능이 정상 작동하지 않는다면, 주저하지 마시고 NudgeAI 고객 지원팀에 문의해주십시오. 스토어 정보와 함께 문제 상황을 알려주시면 신속하게 지원해 드리겠습니다.

NudgeAI의 모든 기능을 원활하게 사용하기 위해 App Embed 설정은 필수적인 단계입니다. 위 가이드를 통해 정확하게 설정하여 NudgeAI의 효과를 최대한 경험해보세요!