最速パス
開発者向け SPREEAI
試着室を建てる
あらゆる画面へ。
カタログを接続します。カスタマージャーニーを形作ります。チームに合った統合パスを備えた Always On をストアフロントに導入します。
自分の道を選択してください
どこから始めましょうか
コマーススタックは生きている。
管理された設定にはShopifyを使用するか、当社のSDKおよびAPIと統合してください。ビジネスに必要な機能を選択し、ブランドのショッピング体験を維持しましょう。
カスタムウェブ
Web SDK
配置、スタイル、イベント、サイズ変更、カートに追加の動作を制御します。JavaScript + TypeScript ドキュメントネイティブモバイル
iOS SDK
SPREEAI エクスペリエンスを既存の iOS ショッピング ジャーニーに取り入れます。iOSガイドを開く ドキュメントネイティブモバイル
Android SDK
ネイティブ コントロールを使用して、試着を Android 製品エクスペリエンスに統合します。Android ガイドを開く パートナーアクセスカスタムシステム
パブリックAPI
サーバーサイドおよびカタログワークフローには、承認済みのAPIリファレンスを使用してください。オープンAPIリファレンスマーケットプレイス
Amazonパートナーネットワーク
SPREEAI をコマーススタックに統合するためのより多くの方法が、Amazon パートナー ネットワークやその他のプラットフォームに間もなく提供される予定です。最新情報はまずこちらに掲載されますWeb SDK クイックスタート
最初の統合です。
一度認証すると、ページ上の任意の場所で試着やサイズ調整が表示されます。オンボーディング中に発行されたテスト認証情報を使用し、ブラウザー コードにクライアント シークレットを含めないでください。
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @spreeai/web-sdk@3.0.0
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}
// Pass events inside renderTryOnButton's options.
await sdk?.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
events: {
onTryOnButtonClick: (event) => {
console.info(event.name);
},
onAddToCartClicked: (event) => {
// Connect event.garments to your storefront's cart.
},
},
});
統合モデル
4つのシステム。
ある顧客の瞬間。
製品 ID、バリエーション、画像、商品化コンテキスト。
衣類は、処理、レビュー、準備状態を経ていきます。
お客様のストアフロントは、対象商品に関するエクスペリエンスをリクエストしています。
試着して、サイズを選び、コーディネートを完成させたら、レジに戻ってください。
立ち上げまでの集中的なパス
準備します。接続する。
自信を持って生きていきましょう。
3つの重要な節目と、それぞれに対応する実用的なチェックリスト。
- 01・準備する
明確な出発点。
旅、アクセス、カタログを調整します。
準備チェックリスト
- チャネル、カタログ グループ、成功指標を 1 つ選択します。
- パートナーのアクセス、認証情報、ステージング権限を確認します。
- SKU に合わせたクリーンな衣類画像を提供します。
- 02・つながる
ネイティブな感じを出しましょう。
ステージングを構築します。旅全体をテストしてください。
統合チェックリスト
- 対象となる商品をレンダリングし、バリアントとカートの動作を結び付けます。
- エクスペリエンスをブランドに合わせます。
- モバイル、デスクトップ、アクセシビリティ、パフォーマンス、障害状態を確認します。
- 03・打ち上げ
実際の使用から学びましょう。
既製品を有効にして測定します。
起動チェックリスト
- 製品の準備が整っていることを確認し、段階的なエクスペリエンスを公開します。
- 導入、完了、変換を監視します。
- 結果を参考に、次のカテゴリーや旅程を進めてください。
資産ベースライン
適切な入力はより良い結果をもたらします。
- JPEGまたはPNG
- 最小 2,000 × 2,000 ピクセル
- 正面図が必要です
- 後ろ姿推奨
- ニュートラルで均一な照明
- ファイル名の SKU またはスタイル ID
開発者向けリファレンス
次を探す
役に立つ回答です。
はじめに
アクセス権限、サポートされているプラットフォーム、そしてチームが最初に行うべき決定事項を理解しましょう。
公式リファレンス マネージド統合Shopify オンボーディング
アプリをインストールし、契約に同意し、衣服を同期し、ボタンをカスタマイズしてライブを開始します。
公式リファレンス Web SDKAPI サーフェス
初期化、レンダリング オプション、サイズ変更、カスタマイズ、および型指定されたインターフェイスを確認します。
公式リファレンス パートナーAPIパブリック API リファレンス
認証されたパートナーが利用できる、承認されたサーバー側インターフェイスを調べてください。
Swaggerリファレンス 品質衣服資産
取り込みとレビューを通じてきれいに移動する製品画像とメタデータを準備します。
SPREEAI ガイド 生産QAと発売
共有ブラウザ、パフォーマンス、アクセシビリティ、および本番稼働チェックリストを使用してください。
SPREEAI ガイド サポートトラブルシューティング
最も一般的な認証、資格、レンダリング、パフォーマンスの問題を解決します。
SPREEAI ガイド ドキュメント実装ガイド
公開クイックスタート、資産標準、起動チェックリスト、トラブルシューティング ガイダンスを参照します。
オープンドキュメント一致する開発者リソースがありません。 「Shopify」、「SDK」、「assets」、または「QA」を試してください。
実稼働用にビルドする
保護する詳細
顧客体験。
安全
シークレットをサーバー側に保持し、発行された環境のみを使用し、パートナーのワークフローを通じて資格情報をローテーションします。
プライバシー
明確な同意を得て顧客の画像をリクエストし、承認された統合計画に合わせてデータ処理を調整します。
パフォーマンス
必要に応じてエクスペリエンスをロードし、実際のデバイスをテストし、製品ページの回帰を監視します。
アクセシビリティ
エクスペリエンスが利用できない場合でも、キーボード アクセス、フォーカス順序、アクセス可能な名前、および使用可能なパスを保持します。
開発者向けよくある質問
前の質問
最初のコミット。
どの統合を選択すべきでしょうか?
最速の管理パスには Shopify アプリを、カスタムまたはヘッドレス Web 配置には Web SDK を、アプリ エクスペリエンスにはネイティブ SDK を、オンボーディング中に合意されたサーバーサイド ワークフローには承認済みの API リファレンスを使用してください。
資格情報はどこから入手するのですか?
SPREEAI は、オンボーディング中にパートナー ID と承認済み認証情報を発行します。ブラウザ SDK はクライアント ID とパートナー ID を使用します。クライアント シークレットをフロントエンド コードに埋め込まないでください。
Does the Shopify App require API keys?
現在のShopifyアプリのオンボーディングフローでは、必要な契約とサブスクリプションの手順の後、ストアに接続されます。管理対象アプリでは、セットアップ画面にキーをコピーする必要はありません。
試着ボタンが表示されないのはなぜですか?
衣類の処理が完了し、試着が有効になっていること、アクティブな製品またはバリアントにマッピングされていること、アプリ ブロックまたは SDK コンテナが製品テンプレートに存在することを確認します。
利用可能なクライアント向けイベントはどれですか?
ドキュメントに記載されているSDKコールバックは、試着ボタンのクリックとカートへの追加操作に対応しています。顧客の画像や不要な個人データを含めることなく、これらのコールバックを分析レイヤーに接続できます。
サーバー Webhook は利用できますか?
サーバープッシュ型Webhookは、現在公開されているSDKドキュメントには含まれていません。サーバー側のイベント要件については、使用する前にパートナーエンジニアリングチームにご相談ください。
開発者はどこで支援を受けられるのでしょうか?
オンボーディング時に提供されたテクニカルサポートパスを使用するか、メールを使用してください。 support@spreeai.com。環境、製品 ID、ブラウザまたはデバイス、タイムスタンプ、および簡潔な再現パスを含めてください。シークレットは決して送信しないでください。
Amazonパートナーネットワークのサポートはいつ利用可能になりますか?
Amazonパートナーネットワークとの連携機能は現在開発中です。外部開発者向けのオンボーディングおよび本番環境インターフェースが準備できるまでは、「近日公開」と表示されています。
構築する準備はできていますか?