앱 확장 및 기능

일부 앱은 확장 및 기능을 사용하여 스토어에 기능을 추가합니다. 확장 및 기능은 앱 개발자가 설정하며 앱을 설치하고 활성화하면 사용할 수 있습니다.

확장을 통해 앱은 온라인 스토어, 체크아웃, 고객 계정 또는 POS(Point of Sale)와 같은 영역에 기능을 추가할 수 있습니다. 예를 들어 앱에서 체크아웃 페이지에 사용자 지정 필드를 추가하거나, 온라인 스토어에서 채팅 봇을 열거나, 고객 계정에 로열티 포인트를 표시할 수 있습니다.

Functions를 사용하면 앱이 스토어의 백엔드 로직을 맞춤 설정할 수 있습니다. 예를 들어 앱이 Functions를 사용하여 사용자 지정 할인 유형을 생성하거나, 체크아웃 시 배송 옵션을 조정하거나, 특정 결제 규칙을 적용할 수 있습니다. 앱을 설정하고 나면 스토어 작업의 일부로 Functions가 자동으로 실행됩니다.

Shopify 관리자의 설정 > 앱에서 설치된 앱의 확장과 함수를 확인하고 관리할 수 있습니다. 앱 정보 페이지의 확장 및 Functions 카드에는 현재 활성화된 확장과 함수의 수, 그리고 스토어에서 이를 사용할 수 있는 영역이 표시됩니다. 영역 텍스트 위에 마우스 포인터를 올리면 활성화된 위치를 확인할 수 있습니다. 확장은 체크아웃, 고객 계정, 온라인 스토어 또는 POS(Point of Sale) 등에, 함수는 체크아웃, 할인, 결제 또는 배송 및 배달 등에 활성화되어 있을 수 있습니다.

확장 또는 Functions를 클릭하여 해당 앱의 전체 목록을 확인하십시오. 확장 또는 Functions 페이지에서 활성 탭과 비활성 탭을 전환하여 현재 실행 중인 확장이나 함수를 확인할 수 있습니다. 확장이나 함수를 클릭하여 여십시오. 확장에 따라 해당 확장을 활성화하거나 관리할 수 있는 스토어 영역 또는 확장의 상태 세부 정보로 이동합니다.

앱 개발자인 경우 기술 문서에 대한 확장 관련 Shopify dev docs 및 Functions 관련 Shopify dev docs를 참조하십시오.

확장 및 Functions 활성화

Shopify 관리자 내 사용되는 영역에서 확장 및 Functions를 활성화 및 비활성화합니다. 앱 설정의 확장 또는 Functions 페이지에서 확장 또는 Functions 이름을 클릭하여 관리할 수 있는 영역으로 이동합니다. 확장 또는 Functions를 활성화하면 앱의 정보 페이지에 활성 상태로 표시됩니다.

확장의 상태 세부 정보를 확인할 수 있는 경우, 체크아웃 또는 고객 계정 확장을 클릭하면 편집기 대신 상태 세부 정보가 열립니다. 이러한 확장의 편집기를 열려면 확장 행 위에 마우스 포인터를 올린 다음 편집기에서 열기 아이콘을 클릭하십시오.

확장

확장은 다음 Shopify 관리자 영역에서 활성화할 수 있습니다.

Functions

Functions는 다음 Shopify 관리자 영역에서 활성화할 수 있습니다.

확장 프로그램의 앱 이벤트

앱은 체크아웃 및 고객 계정 확장 프로그램을 사용하여 Shopify로 앱 이벤트를 전송할 수 있습니다. 앱 이벤트는 고객이 제안을 조회하는 것과 같이 확장 프로그램 내의 작업을 기록합니다. Shopify는 앱 이벤트를 사용하여 스토어 분석에서 고객이 앱을 사용하는 방식을 표시합니다. 앱 개발자도 자체적인 분석 목적을 포함하여 앱을 모니터링하고 지원하기 위해 이벤트를 조회할 수 있습니다.

체크아웃 및 고객 계정의 앱 이벤트는 고객이 고객 개인정보 보호 설정에서 분석을 허용한 후에만 전송됩니다. Shopify는 판매자 분석을 위해 개발자 앱 이벤트에 첨부된 방문자 ID 및 세션 ID와 관련된 집계 정보를 판매자에게 반환할 수 있습니다. 앱에서 스토어프론트의 앱 이벤트를 전송하는 것을 원하지 않는 경우 앱을 제거하십시오.

확장 상태 이해

확장 상태는 앱의 체크아웃 또는 고객 계정 확장이 고객에게 얼마나 안정적으로 로드되는지를 나타냅니다. 앱 확장을 로드하지 못하면 고객은 사용자 지정 필드나 로열티 포인트 등 해당 확장이 체크아웃 또는 고객 계정에 추가하는 기능을 이용할 수 없습니다.

확장 상태 관련 고려 사항

앱의 확장 상태를 확인하기 전에 다음 고려 사항을 검토하십시오.

  • 상태는 체크아웃 및 고객 계정에서 활성화된 확장에 대해서만 측정합니다.
  • 온라인 스토어 또는 POS(Point of Sale) 등 다른 영역의 확장이나 함수는 상태를 측정하지 않습니다.
  • 실패율은 보수적으로 추정하므로 로드 횟수가 적은 확장은 소수의 실패만으로 문제가 있는 것으로 표시될 가능성이 낮습니다.

확장 상태 표시 방식

각 체크아웃 및 고객 계정 확장에는 다음 중 하나의 상태가 표시됩니다.

  • 양호: 확장에서 지속적인 로드 실패가 감지되지 않았습니다.
  • 경고: 최근 7일간 확장 로드 실패율이 5%를 초과했으며, 실패율이 5%를 초과한 상태가 72시간 동안 지속되었습니다.
  • 심각: 최근 7일간 확장 로드 실패율이 50%를 초과했으며, 실패율이 50%를 초과한 상태가 48시간 동안 지속되었습니다.
  • 데이터 부족: 확장 상태를 측정할 데이터가 충분하지 않습니다. 이 상태는 최근 7일간 확장 로드 횟수가 10회 미만이거나 현재 버전의 기록이 아직 충분하지 않을 때 표시됩니다. 상태는 확장 버전별로 측정하므로 최근 업데이트된 확장은 로드 빈도가 높더라도 새 버전의 활동 기록이 최소 7일간 쌓일 때까지 이 상태가 표시될 수 있습니다.

확장에는 상태와 최근 7일간의 다음 지표를 표시하는 세부 정보 페이지도 있습니다.

  • 실패율: 전체 확장 로드 중 실패한 비율입니다.
  • 로드 실패: 앱 문제로 확장 프로그램을 로드하지 못한 횟수입니다.
  • 확장 로드 횟수: 확장이 로드된 횟수입니다.

확장 상태 확인

  1. Shopify 관리자에서 설정 > 앱으로 이동하십시오.

  2. 확인하려는 앱을 클릭하십시오.

  3. 확장을 클릭하십시오.

  4. 활성 탭에서 각 체크아웃 및 고객 계정 확장의 상태 열을 확인하십시오.

  5. 선택 사항: 자세한 내용을 확인하려면 확장 이름을 클릭하십시오.

확장 로드 실패 처리

확장 상태가 경고 또는 심각이면 확장 세부 정보 페이지에 배너가 표시되어, 로드 실패가 앱 문제로 발생했으며 앱 개발자에게 알림을 보냈음을 안내합니다. 편집기에서 확장을 열려면 체크아웃에서 열기 또는 고객 계정에서 열기를 클릭하십시오. 확장과 관련된 도움이 필요하면 앱 개발자에게 문의하십시오.

확장 상태가 심각으로 바뀌면 확장 상태를 확인할 수 있는 직원/담당자에게 스토어의 알림 피드로 알림이 전송됩니다. 알림을 클릭하여 확장 세부 정보 페이지를 여십시오.

Functions 오류 문제 해결

Functions에 오류가 발생하면 앱의 정보 페이지에 있는 Functions 카드와 Functions 페이지에 경고가 표시됩니다. 카드에는 일반적인 사용 가능한 영역 수 대신 [number]개 영역의 오류가 표시되며, 경고는 최근 오류가 감지된 시점을 나타냅니다.

기능 페이지에서 오류가 있는 기능은 Warning 아이콘으로 강조 표시됩니다. 기능에 오류가 있는 경우 앱 개발자에게 문의하여 도움을 받으십시오. 경우에 따라 오류가 이미 해결되었을 수 있습니다. 개발자가 문제를 해결하는 데 도움이 되도록 기능 로그를 공유할 수도 있습니다.