Skip to main content

​
概要

Upcart の API の使用に関する、特によくある質問への回答をご紹介します。

​
Upcart API スクリプトはどこに追加すればよいですか?

スクリプトは、Upcart の Custom HTML 設定内、または Shopify のテーマコードに直接追加できます。どちらが最適かは、カスタマイズのニーズによって異なります。

​
Upcart の Custom HTML はどう使いますか?

  1. Upcart → Settings → Custom HTML に移動します
  2. API スクリプトを使用して、開くタイミングやアップセルの表示など、カートの動作を変更します
  3. 商品ページのボタンを非表示にするなど、Upcart 外の要素を調整します

​
💡 例:カートが空のときにスティッキーカートボタンを非表示にする

レガシーに関する注記: window.upcartOnCartLoaded コールバックは引き続き動作しますが、非推奨であり、コンソールに警告が記録されます。新しいスクリプトではすべて upcartSubscribeCartLoaded を使用してください。event.cart には item_count プロパティがないことに注意してください。合計商品数を計算するには event.cart.items.reduce((total, item) => total + item.quantity, 0) を使用します。

​
Upcart の API を使うには開発者である必要がありますか?

いいえ!Upcart の API は、コーディングスキルがなくても簡単に使えます。多くの機能は組み込み済みで、当社のカスタマイズドキュメントには、Upcart の Custom HTML 設定にコピーするだけで使える、あらかじめ書かれたスクリプトが用意されています。コーディングは不要です! カスタムスクリプトを書きたい場合は、基本的な JavaScript の知識が役立ちます。JavaScript が初めてでもご心配なく!初心者向けのリソースである W3Schools と MDN Web Docs が学習の助けになります。

​
Upcart の API は他のサードパーティアプリと統合できますか?

はい!Upcart の API は、翻訳、分析、アップセルなどのアプリと連携できます。自動的に統合されるものもあれば、小さなスクリプトが必要なものもあります。 たとえば、トラッキングに TripleWhale を使用している場合、カートのアクティビティを正しく記録させるには、次のスクリプトを追加する必要があります:
レガシーに関する注記: window.upcartOnAddToCart コールバックは引き続き動作しますが、非推奨であり、コンソールに警告が記録されます。新しいスクリプトではすべて upcartSubscribeAddedToCart を使用してください。イベントプロパティは(variantId と quantityAdded を持つ)event.item にあり、個別のパラメータとしては渡されないことに注意してください。
アプリはそれぞれ異なるため、追加のコードが必要かどうかは、アプリのサポートチームにご確認ください。Upcart はサードパーティアプリ向けのスクリプトサポートは提供していませんが、アプリの提供元に統合ガイドがある場合があります。

​
API の変更が機能しているかどうかをテストするには?

Upcart の Custom HTML 設定にスクリプトを追加した後、次の手順で動作を確認してください:
  1. ストアを再読み込みして、商品をカートに追加します。
  2. キャッシュを消去して再度試し、最新の変更を確認します。
  3. テストメッセージを追加:</script> の前に console.log("The script works!"); を挿入して、スクリプトが実行されるかを確認します。
  4. ブラウザのコンソールを確認します:
    • 開発者ツールを開きます(Windows では F12 または Ctrl + Shift + J、Mac では Cmd + Option + J)。
    • Console タブに移動して 「The script works!」 を探します。
    • メッセージが表示されていれば、スクリプトは動作しています!表示されない場合、スクリプトが正しく実行されていない可能性があります。
  5. さまざまな操作をテストして(例:商品の削除)、期待どおりの動作を確認します。
タイプミスやコンソールエラーを確認し、必要に応じてコードを調整して問題をトラブルシューティングしてください。

​
API スクリプトが機能しない場合はどうすればよいですか?

API スクリプトが機能しない場合は、次のトラブルシューティング手順をお試しください:
  • タイプミスを確認する – 小さなミスでもスクリプトは動作しなくなります。文字の欠落や構文の誤りがないか確認してください。
  • スクリプトの配置場所を確認する – スクリプトが Upcart → Settings → Custom HTML の正しいセクションにあることを確認します。Upcart には 10 個のスクリプトセクション(9 つの HTML 挿入ポイントと 1 つの Scripts-before-load セクション)があります — 各セクションの詳細はこちら。
  • ブラウザのコンソールを確認する – 上記の手順に従ってエラーを探します。
  • 別のスクリプトをテストする – あらかじめ用意された別の Upcart API スクリプトを試して、問題があなたのコードにあるのかどうかを確認します。
  • それでも解決しない場合 – Shopify テーマの変更やサードパーティアプリの統合を行っている場合は、Shopify パートナーディレクトリの Shopify エキスパートがお手伝いできます。
これらの手順で、ほとんどのスクリプトの問題を特定して解決できるはずです!

​
問題を引き起こすスクリプトを追加してしまった場合、変更を元に戻すには?

期待どおりに動作しないスクリプトを追加してしまった場合、簡単に削除または無効化できます:
  • スクリプトを追加した Upcart の Custom HTML 設定に移動します。
  • スクリプトを削除するか、各行の先頭に // を追加して一時的に無効化します(コメントに変わり、実行されなくなります)。
  • 変更を保存してストアを再読み込みし、問題が解決したか確認します。
問題が解決しない場合は、キャッシュの消去や、最近のテーマ変更を元に戻すことをお試しください。これで隠れた競合が解消されることがよくあります。
🚧 高度なカスタマイズをお探しですか? ストア全体のカスタマイズやサードパーティアプリとの統合が必要ですか?Upcart の API を Shopify テーマに追加するには、開発者が必要になる場合があります。 **Shopify パートナーディレクトリ**を通じて Shopify エキスパートの採用を検討し、当社の API ドキュメントを共有してサポートを受けてください