マーケットプレイス
開発者向けSPREEAI
試着室を作って
すべての画面に。.
Shopify、Web SDK、または承認されたAPI連携から始めましょう。このハブは、チームを最初の決定からテスト済みのローンチへと導きます。.
- 04
- 統合パス
- v2.1
- 現在のWeb SDK
- 01
- ローンチチェックリスト
自分の道を選べ
あなたが
コマーススタックは生きている。.
ストアフロントに最適な、最も迅速な方法を選択してください。体験が成長するにつれて、マネージドアプリからカスタムSDKまたはAPIインテグレーションへ移行することができます。.
最速の経路
Shopifyアプリ
インストールし、ガーメントを同期し、カスタマイズして、カスタムバックエンドなしで起動します。.Shopifyストアに最適 ↗ v2.1.0カスタムウェブ
Web SDK
配置、スタイル、イベント、サイズ、および「カートに追加」の動作を制御します。.JavaScript + TypeScript ↗ ドキュメントネイティブモバイル
iOS SDK
SPREEAIの体験を既存のiOSショッピングジャーニーに導入します。.iOSガイドを開く ↗ ドキュメントネイティブモバイル
Android SDK
ネイティブコントロールを使用して、試着機能をAndroidの製品体験に統合する。.Androidガイドを開く ↗ パートナーアクセスカスタムシステム
パブリックAPI
サーバーサイドおよびカタログのワークフローには、承認済みのAPIリファレンスを使用してください。.API リファレンスを開く ↗Web SDK クイックスタート
インストールから
動作するボタン.
一度認証すれば、ページのどこでも試着やサイズ測定を表示できます。オンボーディング時に発行されたテスト認証情報を使用し、クライアントシークレットをブラウザコードに記述しないでください。.
npm install @spreeai/web-sdk
# または
yarn add @spreeai/web-sdk
import { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}
events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// 既存のカートのワークフローに接続します。
},
}
統合モデル
4つのシステム。.
1つの顧客体験.
製品ID、バリエーション、画像、およびマーチャンダイジングのコンテキスト.
衣類は、処理、レビュー、および準備の状態を経て移動します。.
お客様のストアフロントは、対象商品のエクスペリエンスをリクエストします。.
試着して、サイズを探し、コーディネートを完成させて、レジに戻りましょう。.
本番パス
統合する
ゴールラインを越えて.
クリーンなローンチとは、単にボタンが機能する以上のものです。アクセスの整合、アセット、挙動、品質、測定を揃えるために、この手順を活用してください。.
- 01オーナー · プロダクト + コマース
最初のジャーニーのスコープを設定する
1つのチャネル、カタロググループ、カスタマーモーメント、および成功指標を選択してください。.
- 02オーナー · エンジニアリング
アクセスを準備する
パートナーID、承認済みクライアント資格情報、ストアフロントの権限、およびステージング環境を確認してください。.
- 03オーナー · カタログチーム
不要なアセットを削除する
画像1枚につき衣類1点、正面からのビューが必須、高解像度、クリーンなライティング、SKUに合わせたファイル名。.
- 04オーナー · フロントエンド
ステージング環境に統合する
対象商品のみに表示し、バリエーションとカートの挙動を連動させ、エントリーポイントをブランドに一致させます。.
- 05オーナー · QA + ブランド
ローンチQAを実行
モバイルとデスクトップのテスト、ブラウザの網羅性、アクセシビリティ、パフォーマンス、視覚的忠実度、および障害状態のテスト。.
- 06オーナー · コマース + アナリティクス
有効化と計測
Ready製品を有効にし、ステージングされたエクスペリエンスを公開して、採用、完了、コンバージョンを監視します。.
アセットベースライン
良い入力が、より良い結果を生み出す。.
- JPEGまたはPNG
- 最小 2,000 × 2,000 px
- 正面からのビューが必要です
- 背面推奨
- ニュートラルで均一な照明
- ファイル名のSKUまたはスタイルID
開発者向けリファレンス
次を検索
役に立つ答え。.
はじめに
アクセス、サポートされているプラットフォーム、およびチームが最初に下すべき決定事項を理解する。.
公式リファレンス ↗ マネージドインテグレーションShopifyオンボーディング
アプリをインストールし、規約に同意し、ガーメントを同期し、ボタンをカスタマイズして、ライブ配信を開始します。.
公式リファレンス ↗ Web SDKAPIサーフェス
初期化、レンダリングオプション、サイズ調整、カスタマイズ、および型付きインターフェースを確認します。.
公式リファレンス ↗ パートナーAPIパブリックAPIリファレンス
認証済みパートナーが利用できる承認済みのサーバーサイドインターフェイスを探索する。.
Swagger リファレンス ↗ 品質衣服アセット
インジェクションとレビューをスムーズに通過する製品画像とメタデータを準備する。.
SPREEAI ガイド ↗ 本番品質保証とローンチ
共有されているブラウザ、パフォーマンス、アクセシビリティ、および本番リリースチェックリストを使用してください。.
SPREEAI ガイド ↗ サポートトラブルシューティング
最も一般的な認証、資格確認、レンダリング、およびパフォーマンスの問題を解決します。.
SPREEAI ガイド ↗ ドキュメント実装ガイド
公開されているクイックスタート、アセット標準、ローンチチェックリスト、トラブルシューティングガイドをご覧ください。.
ドキュメントを開く ↗一致する開発者リソースが見つかりません。「Shopify」、「SDK」、「assets」、「QA」で試してください。“
プロダクション用にビルドする
守るべき細部
顧客体験.
セキュリティ
機密情報はサーバー側で保持し、発行された環境のみを使用し、パートナーのワークフローを通じて認証情報をローテーションしてください。.
プライバシー
明確な同意を得て顧客の画像を取得し、承認された統合プランに合わせてデータ処理を調整してください。.
パフォーマンス
必要とされる場所にエクスペリエンスを読み込み、実機でテストし、プロダクトページの回帰をモニタリングします。.
アクセシビリティ
機能が利用できない場合でも、キーボードアクセス、フォーカス順序、アクセシブルな名前、および操作可能なパスを維持してください。.
開発者向けFAQ
事前の質問
最初のコミット。.
どの連携を選ぶべきですか?
最速のマネージドパスにはShopifyアプリを、カスタムまたはヘッドレスのウェブ配置にはWeb SDKを、アプリ体験にはネイティブSDKを、オンボーディング時に合意したサーバーサイドワークフローには承認済みのAPIリファレンスを使用してください。.
資格情報はどこから入手できますか?
SPREEAIは、オンボーディング時にパートナーIDと承認済みの認証情報を発行します。ブラウザSDKは、クライアントIDとパートナーIDを使用します。クライアントシークレットをフロントエンドのコードに絶対に埋め込まないでください。.
ShopifyアプリにはAPIキーが必要ですか?
現在のShopifyアプリのオンボーディングフローでは、必要な同意とサブスクリプションステップの後にストアが接続されます。マネージドアプリでは、セットアップ画面にキーをコピーする必要はありません。.
試着ボタンが表示されないのはなぜですか?
衣類の処理が完了し、試着が有効になっており、アクティブな商品またはバリエーションにマッピングされており、アプリブロックまたはSDKコンテナが商品テンプレートに存在することを確認してください。.
利用可能なクライアントイベントは何ですか?
ドキュメント化されたSDKコールバックは、試着ボタンのクリックとカート追加のインタラクションを網羅しています。顧客の画像や不要な個人データを含めることなく、これらをアナリティクスレイヤーに接続してください。.
サーバーウェブフックは利用可能ですか?
サーバープッシュ型ウェブフックは、現在公開されているSDKドキュメントには含まれていません。サーバーサイドのイベント要件については、それに依存する前に必ずパートナーエンジニアリングに確認(スコープの定義)を行ってください。.
開発者はどこで助けを得ますか?
オンボーディングやメールで案内されたテクニカルサポートのパスを利用してください support@spreeai.com. 環境、製品ID、ブラウザまたはデバイス、タイムスタンプ、および簡潔な再現手順を含めてください。機密情報は絶対に送信しないでください。.
Amazonパートナーネットワークのサポートはいつ利用可能になりますか?
Amazon Partner Networkの統合は現在開発中です。オンボーディングおよび本番用インターフェースの外部開発者向け提供の準備が整うまで、意図的に「近日公開(Coming Soon)」と表示されています。.
ビルドの準備はできましたか?