Documentation menu
埋め込みガイド
図面またはコレクションの埋め込みを準備・公開・配置し、テーマ、アクセス制御、言語、通貨、対応ディープリンクを設定します。
概要
PartGridの埋め込みでは、公開済みの図面またはコレクションをストアフロントやポータル内に表示できます。ダッシュボードで顧客向け表示を準備・プレビューしてから、生成されたiframeを対象ページへ配置します。
埋め込みの種類
顧客体験を選ぶ
コンテンツを準備する
図面またはコレクションの設定で、公開範囲、割り当て済みコンテンツ、言語、通貨を確認します。iframeをコピーする前にプレビューし、参照番号、リンク済み部品、価格、顧客向け名称が正しいことを確認してください。
準備チェックリスト
- Integrations → Embed → Behavior で Public embed connectivity を接続します。
- 単体図面は、生成されたiframeをコピーする前に Public にします。
- コレクションでは、公開範囲、カテゴリ範囲、割り当て済みの公開図面を確認します。
- 対象市場で使用する言語と通貨を選択します。
- 外部Webサイトへ配置する前に、図面またはコレクションをプレビューします。
埋め込みワークスペースを設定する
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が対応契約として明示的に文書化しているものだけを使用してください。管理対象の埋め込み内部で確認できるメッセージ名やネットワークペイロードを連携仕様として利用しないでください。