Shopify 커스텀 앱을 승인하고 확인 화면을 봤지만 감사 페이지나 주문 상태 페이지에서 아무것도 찾을 수 없습니다. 이 앱은 관리자에 나타나지만 고객은 주문 편집기, 업셀 또는 계정 기능을 볼 수 없습니다. 이러한 상황은 Shopify 커스텀 앱 설치가 원클릭 작업이 아니기 때문에 흔합니다. 두 가지 별도의 작업이 있습니다: 올바른 스토어에 대해 앱을 승인한 다음 앱 블록을 지원되는 Shopify 표면에 배치합니다.

목차

커스텀 앱 설치가 2단계 작업인 이유

Shopify는 승인과 프레젠테이션을 다른 작업으로 취급합니다. 승인 중에 판매자는 앱의 요청된 데이터 액세스 및 개인정보 보호정책을 승인한 다음 스토어 특정 설치 링크를 통해 설치합니다. Shopify의 공식 앱 설치 설명서에서 커스텀 앱 링크는 한 스토어에만 연결되며 다른 곳에서는 재사용할 수 없다고 설명합니다.

이 승인은 앱에 작동할 수 있는 권한을 부여합니다. 앱이 고객 경험에서 어디에 나타나야 하는지를 자동으로 결정하지는 않습니다. 구매 후 도구의 경우 중요한 작업은 일반적으로 체크아웃 및 고객 계정 편집기에서 발생하며, 판매자는 앱의 블록을 호환되는 대상에 추가합니다.

Shopify 커스텀 앱 설치에는 두 단계가 필요함을 설명하는 다이어그램: 스토어 인증 및 테마 배치.

1단계는 스토어 인증입니다

개발자는 Shopify의 Dev Dashboard에서 커스텀 앱을 만들거나 구성합니다. 그런 다음 판매자는 의도한 스토어에 로그인한 상태에서 생성된 설치 링크를 열고, 요청된 범위를 검토한 후 앱 설치를 선택합니다. 이것이 보안 경계입니다. 판매자가 요청된 액세스를 승인하지 않으면 앱이 필요한 권한을 받지 못합니다.

2단계는 앱 블록 배치입니다

인증 후 판매자는 관련 편집기를 열고, 설치된 앱을 찾아 지원되는 페이지에 해당 블록을 추가합니다. Shopify의 결제 커스터마이징 옵션에서 설치된 앱 검색 및 각 블록이 지원하는 목적지 확인을 포함한 이 블록 기반 모델에 대해 설명합니다.

실용적인 규칙: 앱이 설치되었지만 고객 대면 페이지에 없다면 다시 설치하기 전에 배치를 확인하세요.

가장 신뢰할 수 있는 정신 모델은 간단합니다: 인증은 Shopify에서 앱을 사용 가능하게 하고, 배치는 고객에게 기능을 표시합니다. 따라서 성공적인 1단계는 2단계가 완료될 때까지 실패한 설치처럼 보일 수 있습니다.

전제 조건, 요금제 및 직원 권한

설치 링크를 열기 전에 스토어, 앱, 그리고 관련된 사람들이 준비되어 있는지 확인하세요. Shopify의 결제 및 고객 계정 커스터마이징 문서에 따르면 지원되는 앱 커스터마이징은 Basic Shopify 요금제 이상에서 사용 가능하며, 일부 기능은 Shopify Plus에서도 사용 가능합니다. 정확한 목적지는 여전히 앱 확장 및 지원하는 페이지에 따라 달라지므로 요금제 적격성만으로는 모든 블록이 나타나는 것을 보장할 수 없습니다.

커스텀 앱은 이미 Shopify Dev Dashboard에 존재해야 하며, 개발자는 기능에 필요한 액세스 범위 및 확장 지점을 구성해야 합니다. 예를 들어, 구매 후 주문 편집기는 지원되는 주문 상태 또는 고객 계정 표면이 필요합니다. 테마 다시 작성은 누락된 결제 또는 고객 계정 확장을 대체할 수 없습니다.

사람과 권한을 확인하세요

스토어 소유자가 가능한 한 항상 인증을 수행해야 합니다. 직원 액세스는 워크플로의 일부에 충분할 수 있지만, 계정에는 관련 앱 설치 및 구성 권한이 있어야 합니다. 직원 액세스 권한이 있는 개발자는 앱을 준비하고 문제를 해결할 수 있지만 판매자를 대신하여 인증할 수 있다고 가정해서는 안 됩니다.

두 가지 인증은 맞춤 앱 개발 및 설치 워크플로우에도 필요합니다. 설치 링크를 열기 전에 스토어 URL을 신중하게 확인하세요. Shopify는 맞춤 앱 설치 링크를 의도한 스토어에 바인딩하므로, 한 스토어용으로 생성된 링크는 다른 스토어의 범용 링크로 기능하지 않습니다.

팀에서 운영 워크플로우와 구매 후 경험을 모두 관리하는 경우 설치, 블록 배치 및 테스트의 소유자를 문서화하세요. 유용한 참고 자료는 이 Shopify 주문 워크플로우 구성 가이드입니다.

직원 역할 및 설치 권한

역할 맞춤 앱 설치 가능 앱 블록 배치 가능 참고 사항
스토어 소유자 예 예 권한 부여를 검토하고 판매자 승인 단계를 완료할 수 있습니다.
앱 권한이 있는 직원 일반적으로 스토어 설정에 따라 예, 편집자 액세스가 부여된 경우 소유자가 필요한 액세스를 활성화한 경우 앱 및 배치를 구성할 수 있습니다.
직원 액세스 권한이 있는 개발자 앱을 준비하고 지원할 수 있습니다 허용된 경우 지원되는 편집기를 구성할 수 있습니다 판매자에 대한 권한 부여를 승인할 수 있다고 가정하면 안 됩니다.

짧은 사전 점검으로 대부분의 낭비되는 시도를 방지할 수 있습니다. 대상 스토어를 확인하고, 두 가지 인증을 확인하고, 직원 권한을 확인하고, 개발자에게 앱이 사용하도록 설계된 Shopify 표면을 문의하세요.

맞춤 앱 생성 및 승인

권한 부여는 Shopify Dev Dashboard에서 시작되며, 테마 편집기에서는 시작되지 않습니다. 개발자는 대상 스토어를 선택하고, 맞춤 앱을 열고, 해당 구성을 검토합니다. API 액세스 설정에서 앱에 필요한 범위만 선택한 후 설치 링크를 생성하기 전에 구성을 저장합니다.

Shopify의 맞춤 앱 설치 안내에서는 링크가 스토어별이라고 명시하고 있습니다. 이는 개발 스토어, 스테이징 스토어 및 프로덕션 스토어가 있는 대행사에서 중요합니다. 잘못된 파트너 조직에서 복사한 링크나 다른 스토어용으로 생성된 링크는 앱 자체가 올바르게 구성된 경우에도 유효하지 않은 스토어 결과를 생성할 수 있습니다.

권한 부여 시퀀스

  1. 의도한 스토어를 선택합니다. 무엇을 생성하기 전에 Dev Dashboard에서 스토어 이름과 도메인을 확인하세요.
  2. API 범위를 검토합니다. 개발자에게 각 범위가 무엇을 활성화하는지 문의하세요. 앱이 주문을 편집하거나, 고객 정보를 읽거나, 이행 관련 데이터를 관리하는 경우 요청된 액세스가 해당 목적과 일치해야 합니다.
  3. 구성을 저장합니다. 범위 변경은 앱 구성이 저장될 때까지 유용하지 않습니다.
  4. 설치 링크를 생성합니다. 이를 재사용 가능한 앱 URL이 아니라 비공개, 스토어별 배포 링크로 취급하세요.
  5. 판매자의 로그인한 관리자 세션에서 엽니다. 다른 스토어에 연결된 브라우저 세션에서 테스트하지 마세요.
  • 액세스 화면을 검토하세요. Shopify는 설치 전에 데이터 액세스 및 개인정보보호 정보를 표시합니다.
  • 앱 설치를 선택하세요. 판매자는 요청된 액세스를 적극적으로 승인해야 합니다.
  • Screenshot from https://shopify.dev/assets/api/custom-apps/install-confirmation.png

    승인 전에 확인할 사항

    앱이 신뢰할 수 있는 개발자로부터 왔다고 해서 인증 화면을 무시하고 진행하지 마세요. 나열된 범위를 요청한 기능과 비교하고, 개인정보보호 정책이 예상한 것인지 확인한 후, 관리자에 표시된 스토어가 올바른 대상인지 검증하세요.

    앱이 해당 기능에 맞지 않는 액세스를 요청하는 경우, 중단하고 개발자에게 구성을 수정하도록 요청하세요. 범위가 거부된 경우, 원인은 불완전한 보호된 고객 데이터 선언이거나 앱이 더 이상 사용하지 않는 범위일 수 있습니다. 개발자는 구성을 조정하고, 저장한 후, 새로운 스토어별 링크를 생성하고, 검토를 반복해야 합니다.

    설치 후, 앱이 스토어의 설치된 앱 영역에 표시되는지 확인하세요. 이것은 1단계를 확인하지만, 고객용 기능이 라이브 상태인지는 증명하지 않습니다. 여전히 확장 프로그램을 배치하고 테스트해야 합니다.

    주문 상태 페이지에 앱 블록 배치

    대부분의 구매 후 설치 실패는 인증 후 발생합니다. 판매자는 앱을 설치하고, 관리자로 돌아온 후, 기능이 자동으로 나타날 것으로 예상합니다. Shopify의 현재 모델은 체크아웃 또는 고객 계정 편집기에서 별도의 구성 단계가 필요합니다.

    설정을 연 후 체크아웃으로 이동하여 감사 페이지 및 주문 상태 경험의 맞춤설정 영역을 찾으세요. 앱 및 계정 설정에 따라, 대신 설정을 거쳐 고객 계정으로 이동하여 고객 계정 편집기를 열 수 있습니다. Shopify는 주문 상태 페이지를 고객이 특정 주문을 보고, 추적하고, 관리할 수 있는 장소로 정의하며, 이는 주문 편집기, 지원 작업, 구매 후 오퍼를 위한 자연스러운 서피스입니다.

    블록 추가

    편집기에서 페이지 선택기를 사용하여 주문 상태 또는 관련 고객 계정 대상을 엽니다. 앱 블록 추가 또는 앱 옵션을 선택한 후, 설치된 앱 목록에서 사용자 정의 앱을 검색하세요. Shopify의 체크아웃 앱 배치에 대한 문서는 설치 후 지원되는 감사 및 주문 상태 페이지에 앱을 추가할 수 있음을 확인합니다.

    앱이 첫 번째 목록에 나타나지 않으면, 설치된 이름으로 검색하세요. 모든 블록이 모든 페이지를 지원한다고 가정하지 마세요. Shopify는 특히 판매자에게 설치 후 지원되는 대상을 확인하도록 지시하며, 편집기는 앱이 고객 계정을 지원할 때만 주문, 주문 상태, 프로필 또는 계정 같은 호환되는 대상을 표시합니다.

    블록을 주문 요약 영역과 같은 의도된 섹션으로 드래그한 다음 페이지를 미리 봅니다. 편집기의 데스크톱, 모바일 및 전체 화면 보기를 사용하여 구성 요소가 사용 가능한 공간에 맞는지 확인합니다. 콘텐츠, 위치 및 표시 규칙을 확인한 후에만 구성을 저장합니다.

    https://help.shopify.com/en/manual/online-sales-channels/checkout/order-status-page/customize-order-status-page의 스크린샷

    이 워크플로우 부분에 유용한 참고 자료는 Shopify 주문 상태 페이지 사용자 지정 가이드입니다.

    미리보기를 구성 확인으로 취급

    편집기는 Shopify가 블록과 해당 위치를 수락했음을 확인합니다. 고객 경로 테스트를 대체하지 않습니다. 실제 테스트 주문을 하고, 결과 주문 상태 페이지를 열고, 테스트 중인 고객 계정 및 주문 상태에 대해 앱이 로드되는지 확인합니다.

    이 구분은 조건부 앱에 중요합니다. 주문 편집기는 이행 후 숨길 수 있으며, 업셀은 적격 제품이 없는 주문을 제외할 수 있습니다. 따라서 블록이 올바르게 배치되었지만 특정 테스트 주문에 대해 의도적으로 보이지 않을 수 있습니다.

    가장 일반적인 설치 실패 문제 해결

    실패한 사용자 정의 앱 설치는 보통 인식할 수 있는 증상을 가집니다. 먼저 증상을 진단한 다음 한 번에 하나의 변수만 변경합니다. 반복해서 다시 설치하는 것은 확장 지점 누락이나 편집기 호환성 문제를 거의 해결하지 못합니다.

    표시된 실패부터 시작

    블록이 편집기에 나타나지 않으면 개발자가 올바른 구매 후 또는 고객 계정 확장 지점을 구성했는지 확인합니다. 또한 앱이 의도한 스토어에 연결되어 있고 앱이 더 이상 개발 조직으로 제한되거나 선택 해제된 테스트 스토어로 제한되지 않는지 확인합니다.

    404 또는 invalid-store 메시지를 반환하는 설치 링크는 보통 스토어 불일치를 나타냅니다. 링크의 도메인, 현재 관리자에서 열린 스토어 및 링크를 생성하는 데 사용된 직원 계정이 여전히 액세스 권한이 있는지 확인합니다. 링크는 승인된 스토어에 대해 생성되어야 합니다.

    범위 거부는 개발자 입력이 필요합니다. 요청된 API 액세스가 오래되었거나 불완전하거나 선언되지 않은 고객 데이터 요구 사항이 적용될 수 있습니다. 검토 화면을 우회하지 마십시오. 범위 목록을 요청하고 기능의 실제 요구 사항과 비교합니다.

    증상 가능한 원인 첫 번째 해결 방법
    앱이 설치되지만 블록이 나타나지 않음 누락되었거나 호환되지 않는 확장 지점 개발자에게 앱이 지원하는 페이지와 블록 유형을 확인하세요.
    설치 링크에 유효하지 않은 스토어가 표시됨 다른 스토어를 위해 생성된 링크 스토어 도메인을 다시 확인하고 해당 스토어를 위한 새 링크를 생성하세요.
    권한 부여가 요청된 범위를 거부함 범위 구성 또는 보호된 데이터 문제 개발자에게 개발자 대시보드에서 범위 및 선언을 검토하도록 요청하세요.
    앱이 잘못된 스토어에 나타남 파트너 대시보드가 다른 대상으로 기본 설정됨 링크를 생성하기 전에 판매자의 프로덕션 스토어를 명시적으로 선택하세요.
    블록이 한 편집기에는 나타나지만 다른 편집기에는 나타나지 않음 확장이 해당 목적지를 지원하지 않음 Shopify에서 표시한 지원되는 페이지를 사용하거나 호환되는 확장을 요청하세요.

    지원팀에 문의하기 전에 스토어 도메인, 앱 이름, 정확한 오류 텍스트, 현재 사용자 역할 및 블록이 누락된 페이지를 기록하세요. Mayra Apps FAQ도 확대하기 전에 제품별 설치 질문을 확인할 수 있는 유용한 리소스입니다.

    배포 습관: 권한 부여 오류를 렌더링 오류와 분리하세요. 첫 번째는 접근 권한에 관한 것이고, 두 번째는 확장 호환성, 배치 또는 런타임 동작에 관한 것입니다.

    클릭에서 고객까지의 실제 진행 과정

    Shopify Plus 판매자가 구매 후 업셀 앱을 위해 스토어별 설치 링크를 타사 파트너로부터 받습니다. 판매자는 프로덕션 스토어에 로그인한 상태에서 링크를 열고 스토어 ID를 확인한 후 요청된 데이터 액세스를 검토하고 개인정보 처리방침을 확인한 다음 앱 설치를 클릭합니다.

    이제 앱이 판매자의 Shopify 관리자에 존재하지만 고객 경험은 변하지 않았습니다. 판매자는 체크아웃 편집기를 열고 주문 상태 페이지를 선택한 후 설치된 앱 목록을 검색하고 주문 요약 영역에 업셀 블록을 추가합니다. 편집기 미리 보기에서 데스크톱 및 모바일에서의 배치를 표시하므로 판매자는 구성을 저장합니다.

    실제 고객 경로 테스트

    판매자는 자신의 고객 계정을 사용하여 실제로 할인된 테스트 주문을 합니다. 업셀 블록이 주문 상태 페이지에서 로드되는지, 오퍼가 주문의 자격 규칙과 일치하는지, 주문을 제외해야 할 때 기능이 나타나지 않는지 확인합니다.

    구매 후 오퍼의 경우 이 테스트는 시각적 배치 이상을 포함해야 합니다. 고객이 블록과 상호작용할 수 있는지, 결과 작업이 원본 주문을 올바르게 업데이트하는지, 그리고 앱이 해당 대시보드에서 이벤트를 기록하는지 확인하세요. 테스트 주문은 편집기 미리 보기가 놓칠 수 있는 계정 상태 문제도 드러냅니다.

    그런 다음 판매자는 앱의 이벤트 활동 및 Shopify 관리자 기록을 확인합니다. 고객 관련 동작, 주문 처리 및 보고가 모두 일치하는 신호를 보낸 후에야 팀이 일반 고객을 위한 워크플로우를 게시해야 합니다.

    이것이 2단계 모델의 실질적인 의미입니다. 설치 화면은 인증을 증명합니다. 테스트 주문은 Shopify가 고객이 사용하는 곳에서 승인된 확장을 렌더링하고 실행할 수 있음을 증명합니다.

    검증 체크리스트 및 최종 질문

    모든 Shopify 사용자 정의 앱 설치 배포 후 이 체크리스트를 사용하세요. 인증 증명과 배치 증명을 분리하므로 자동 실패가 명확한 시작점을 가집니다.

    1. 스토어 인증: 앱이 올바른 Shopify 관리자에 나타나고 승인된 API 범위가 개발자의 요구사항과 일치하는지 확인합니다.
    2. 앱 블록 존재: 체크아웃 또는 고객 계정을 열고 블록이 지원되는 주문 상태, 감사 인사 또는 계정 대상에 추가되었는지 확인합니다.
    3. 주문 테스트: 실제 테스트 주문을 배치하고 데스크톱 및 모바일에서 고객 대면 페이지를 검사합니다.
    4. 웹훅 전달: 개발자에게 웹훅 이벤트가 로깅되는 위치를 물어본 후 테스트 주문의 성공적인 전달을 확인합니다.
    5. 권한 검토: 직원 액세스를 다시 확인하고 구성을 담당하는 사람들이 앱과 에디터를 관리할 수 있는지 확인합니다.

    Shopify 사용자 정의 앱 설치, 설정, 테스트 및 권한 구성을 확인하기 위한 5단계 검증 체크리스트입니다.

    판매자가 자주 묻는 최종 질문

    모든 요금제에서 사용자 정의 앱을 설치할 수 있나요? 아니오입니다. 앱의 확장 유형과 스토어의 Shopify 요금제에 따라 사용 가능한 커스터마이제이션 표면이 결정됩니다. 배포 전에 개발자와 함께 지원되는 요금제와 대상을 확인하세요.

    앱을 제거하면 어떻게 되나요? 제거하면 스토어에서 앱의 인증이 제거되지만 데이터 보존 및 정리는 앱의 구현과 정책에 따라 달라집니다. 제거하기 전에 개발자에게 저장된 구성, 고객 데이터 및 과거 기록에 어떤 일이 발생하는지 물어보세요.

    설치는 성공했지만 렌더링되는 것이 없으면 어떻게 되나요? 에디터로 돌아가 설치된 앱 목록을 검색하고 블록의 지원되는 대상을 확인합니다. 그런 다음 실제 테스트 주문을 배치합니다. 블록이 계속 없으면 개발자에게 스토어 도메인, 앱 이름, 사용자 역할, 정확한 페이지 및 Shopify에 표시된 요청 ID를 보내세요.

    범위 또는 확장 오류를 누가 수정해야 하나요? 앱 개발자가 Dev Dashboard 구성, 범위, 선언 또는 지원되지 않는 확장 포인트를 수정해야 합니다. 판매자는 인증 및 배치를 제어합니다.

    가장 깔끔한 배포 기록에는 두 가지 확인 사항이 있습니다: Shopify가 앱을 승인했고, 고객 테스트가 의도한 페이지에서 블록이 작동함을 증명했습니다.


    Mayra Apps는 Shopify 판매자가 고객 계정 및 주문 상태 페이지를 통해 셀프 서비스 주문 편집, 취소 편향 및 원클릭 상향판매와 같은 구매 후 경험을 구성하도록 돕습니다. 이러한 워크플로우를 위해 사용자 정의 앱을 설치하는 경우 Mayra Apps를 방문하여 사용 가능한 설정 및 배치 옵션을 검토하세요.