Documentation menu
임베드 가이드
도면 또는 컬렉션 임베드를 준비, 게시, 배치하고 테마, 접근 제한, 언어, 통화 및 지원되는 딥 링크를 설정합니다.
개요
PartGrid 임베드를 사용하면 공개 도면 또는 컬렉션 경험을 스토어프런트와 포털 안에 표시할 수 있습니다. 대시보드에서 고객용 경험을 준비하고 미리 본 뒤 생성된 iframe을 대상 페이지에 배치합니다.
임베드 유형
고객 경험 선택
콘텐츠 준비
도면 또는 컬렉션 설정에서 공개 범위, 지정된 콘텐츠, 언어 및 통화를 확인합니다. iframe을 복사하기 전에 미리 보기로 참조 번호, 연결된 부품, 가격 및 고객용 이름이 올바른지 확인하세요.
준비 체크리스트
- Integrations → Embed → Behavior에서 Public embed connectivity를 연결합니다.
- 독립 도면은 생성된 iframe을 복사하기 전에 Public로 설정합니다.
- 컬렉션에서는 공개 범위, 카테고리 범위 및 지정된 공개 도면을 확인합니다.
- 대상 시장에서 사용할 언어와 통화를 선택합니다.
- 외부 웹사이트에 배치하기 전에 도면 또는 컬렉션을 미리 봅니다.
임베드 작업 공간 설정
Integrations → Embed를 엽니다. Overview에서 현재 임베드 상태를 확인할 수 있습니다. Theme Library에서는 테마를 생성·편집하고, Theme selection에서는 컬렉션과 대리점 컬렉션의 재정의 테마를 선택하며, Behavior에서는 공개 연결, 가격 표시, 견적 설정, 알림 이메일 및 허용 도메인을 관리합니다.
생성된 iframe 복사
고객용 경험이 준비되면 Schematic Settings 또는 Collection Settings에서 iframe을 복사합니다. 생성된 URL에는 선택한 로케일과 통화가 포함됩니다. 공개 URL을 직접 조합하지 말고 생성된 코드를 사용하세요.
<iframe
src="https://app.partgrid.ai/embed/en/collection/COLLECTION_UUID/schematic/SCHEMATIC_UUID?currency=USD"
title="PartGrid parts catalog"
style="width: 100%; min-height: 720px; border: 0;"
loading="lazy"
></iframe>딥 링크
컬렉션 임베드에서는 경로가 현재 도면을 선택합니다. 지원되는 쿼리 매개변수를 사용하면 특정 핫스팟이나 부품에 초기 포커스를 줄 수 있습니다. 가능한 경우 안정적인 UUID 매개변수를 사용하세요.
지원 경로와 매개변수
- Name
- Type
- item
- Description
- Name
- Type
- item
- Description
- Name
- Type
- item
- Description
- Name
- Type
- item
- Description
- Name
- Type
- item
- Description
| Name | Type | Description |
|---|---|---|
| item | ||
| item | ||
| item | ||
| item | ||
| item |
스토어프런트 통신
브라우저 이벤트나 페이로드는 PartGrid가 지원 계약으로 명시적으로 문서화한 경우에만 사용하세요. 관리형 임베드 내부에서 관찰되는 메시지 이름이나 네트워크 페이로드를 연동 규격으로 사용하지 마세요.