開発者向けSPREEAI

試着室を作って
すべての画面に。.

Shopify、Web SDK、または承認されたAPI連携から始めましょう。このハブは、チームを最初の決定からテスト済みのローンチへと導きます。.

04
統合パス
v2.1
現在のWeb SDK
01
ローンチチェックリスト
開発者の視点ムリナル・シュクラ開発責任者

自分の道を選べ

あなたが
コマーススタックは生きている。.

ストアフロントに最適な、最も迅速な方法を選択してください。体験が成長するにつれて、マネージドアプリからカスタムSDKまたはAPIインテグレーションへ移行することができます。.

Web SDK クイックスタート

インストールから
動作するボタン.

一度認証すれば、ページのどこでも試着やサイズ測定を表示できます。オンボーディング時に発行されたテスト認証情報を使用し、クライアントシークレットをブラウザコードに記述しないでください。.

npm install @spreeai/web-sdk

# または
yarn add @spreeai/web-sdk

統合モデル

4つのシステム。.
1つの顧客体験.

01カタログ

製品ID、バリエーション、画像、およびマーチャンダイジングのコンテキスト.

02SPREEAI インジェクション

衣類は、処理、レビュー、および準備の状態を経て移動します。.

03SDK または API

お客様のストアフロントは、対象商品のエクスペリエンスをリクエストします。.

04顧客のアクション

試着して、サイズを探し、コーディネートを完成させて、レジに戻りましょう。.

本番パス

統合する
ゴールラインを越えて.

クリーンなローンチとは、単にボタンが機能する以上のものです。アクセスの整合、アセット、挙動、品質、測定を揃えるために、この手順を活用してください。.

  1. 01

    最初のジャーニーのスコープを設定する

    1つのチャネル、カタロググループ、カスタマーモーメント、および成功指標を選択してください。.

    オーナー · プロダクト + コマース
  2. 02

    アクセスを準備する

    パートナーID、承認済みクライアント資格情報、ストアフロントの権限、およびステージング環境を確認してください。.

    オーナー · エンジニアリング
  3. 03

    不要なアセットを削除する

    画像1枚につき衣類1点、正面からのビューが必須、高解像度、クリーンなライティング、SKUに合わせたファイル名。.

    オーナー · カタログチーム
  4. 04

    ステージング環境に統合する

    対象商品のみに表示し、バリエーションとカートの挙動を連動させ、エントリーポイントをブランドに一致させます。.

    オーナー · フロントエンド
  5. 05

    ローンチQAを実行

    モバイルとデスクトップのテスト、ブラウザの網羅性、アクセシビリティ、パフォーマンス、視覚的忠実度、および障害状態のテスト。.

    オーナー · QA + ブランド
  6. 06

    有効化と計測

    Ready製品を有効にし、ステージングされたエクスペリエンスを公開して、採用、完了、コンバージョンを監視します。.

    オーナー · コマース + アナリティクス

アセットベースライン

良い入力が、より良い結果を生み出す。.

  • JPEGまたはPNG
  • 最小 2,000 × 2,000 px
  • 正面からのビューが必要です
  • 背面推奨
  • ニュートラルで均一な照明
  • ファイル名のSKUまたはスタイルID
アセットチェックリストを開く ↗

開発者向けリファレンス

次を検索
役に立つ答え。.

ここから開始

はじめに

アクセス、サポートされているプラットフォーム、およびチームが最初に下すべき決定事項を理解する。.

公式リファレンス ↗
マネージドインテグレーション

Shopifyオンボーディング

アプリをインストールし、規約に同意し、ガーメントを同期し、ボタンをカスタマイズして、ライブ配信を開始します。.

公式リファレンス ↗
Web SDK

APIサーフェス

初期化、レンダリングオプション、サイズ調整、カスタマイズ、および型付きインターフェースを確認します。.

公式リファレンス ↗
パートナーAPI

パブリックAPIリファレンス

認証済みパートナーが利用できる承認済みのサーバーサイドインターフェイスを探索する。.

Swagger リファレンス ↗
品質

衣服アセット

インジェクションとレビューをスムーズに通過する製品画像とメタデータを準備する。.

SPREEAI ガイド ↗
本番

品質保証とローンチ

共有されているブラウザ、パフォーマンス、アクセシビリティ、および本番リリースチェックリストを使用してください。.

SPREEAI ガイド ↗
サポート

トラブルシューティング

最も一般的な認証、資格確認、レンダリング、およびパフォーマンスの問題を解決します。.

SPREEAI ガイド ↗
ドキュメント

実装ガイド

公開されているクイックスタート、アセット標準、ローンチチェックリスト、トラブルシューティングガイドをご覧ください。.

ドキュメントを開く ↗

プロダクション用にビルドする

守るべき細部
顧客体験.

01

セキュリティ

機密情報はサーバー側で保持し、発行された環境のみを使用し、パートナーのワークフローを通じて認証情報をローテーションしてください。.

02

プライバシー

明確な同意を得て顧客の画像を取得し、承認された統合プランに合わせてデータ処理を調整してください。.

03

パフォーマンス

必要とされる場所にエクスペリエンスを読み込み、実機でテストし、プロダクトページの回帰をモニタリングします。.

04

アクセシビリティ

機能が利用できない場合でも、キーボードアクセス、フォーカス順序、アクセシブルな名前、および操作可能なパスを維持してください。.

開発者向け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)」と表示されています。.

ビルドの準備はできましたか?

道を選べ。.
私たちが発送のお手伝いをします。.

技術ディスカバリーを予約するすべてのドキュメントを見る ↗パートナーワークスペースを開く ↗