> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upcart API に関するよくある質問

> セットアップ、トラブルシューティング、サードパーティ統合など、Upcart の API の使用に関するよくある質問への回答をご紹介します。

<div id="overview">
  # 概要
</div>

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

* **[Upcart API スクリプトはどこに追加すればよいですか?](#where-to-add-upcart-api-scripts)**
* **[Upcart の API を使うには開発者である必要がありますか?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[Upcart の API は他のサードパーティアプリと統合できますか?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[API の変更が機能しているかどうかをテストするには?](#how-do-i-test-if-my-api-changes-are-working)**
* **[API スクリプトが機能しない場合はどうすればよいですか?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[問題を引き起こすスクリプトを追加してしまった場合、変更を元に戻すには?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Upcart API スクリプトはどこに追加すればよいですか?**
</div>

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

<div id="how-do-i-use-upcarts-custom-html">
  ## Upcart の Custom HTML はどう使いますか?
</div>

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

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *例:カートが空のときにスティッキーカートボタンを非表示にする*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

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

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Upcart の API を使うには開発者である必要がありますか?**
</div>

いいえ!Upcart の API は、コーディングスキルがなくても簡単に使えます。多くの機能は組み込み済みで、当社の[カスタマイズドキュメント](/ja/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)には、Upcart の Custom HTML 設定にコピーするだけで使える、あらかじめ書かれたスクリプトが用意されています。コーディングは不要です!

カスタムスクリプトを書きたい場合は、基本的な JavaScript の知識が役立ちます。JavaScript が初めてでもご心配なく!初心者向けのリソースである **W3Schools** と **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** が学習の助けになります。

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # Upcart の API は他のサードパーティアプリと統合できますか?
</div>

はい!Upcart の API は、翻訳、分析、アップセルなどのアプリと連携できます。自動的に統合されるものもあれば、小さなスクリプトが必要なものもあります。

たとえば、トラッキングに **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** を使用している場合、カートのアクティビティを正しく記録させるには、次のスクリプトを追加する必要があります:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **レガシーに関する注記:** `window.upcartOnAddToCart` コールバックは引き続き動作しますが、非推奨であり、コンソールに警告が記録されます。新しいスクリプトではすべて `upcartSubscribeAddedToCart` を使用してください。イベントプロパティは(`variantId` と `quantityAdded` を持つ)`event.item` にあり、個別のパラメータとしては渡されないことに注意してください。
</Note>

アプリはそれぞれ異なるため、追加のコードが必要かどうかは、アプリのサポートチームにご確認ください。Upcart はサードパーティアプリ向けのスクリプトサポートは提供していませんが、アプリの提供元に統合ガイドがある場合があります。

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # API の変更が機能しているかどうかをテストするには?
</div>

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. **さまざまな操作をテスト**して(例:商品の削除)、期待どおりの動作を確認します。

タイプミスやコンソールエラーを確認し、必要に応じてコードを調整して**問題をトラブルシューティング**してください。

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # API スクリプトが機能しない場合はどうすればよいですか?
</div>

API スクリプトが機能しない場合は、次のトラブルシューティング手順をお試しください:

* **タイプミスを確認する** – 小さなミスでもスクリプトは動作しなくなります。文字の欠落や構文の誤りがないか確認してください。

* **スクリプトの配置場所を確認する** – スクリプトが Upcart → Settings → Custom HTML の正しいセクションにあることを確認します。Upcart には 10 個のスクリプトセクション(9 つの HTML 挿入ポイントと 1 つの Scripts-before-load セクション)があります — [各セクションの詳細はこちら。](/ja/upcart/custom_html)

* **ブラウザのコンソールを確認する** – 上記の手順に従ってエラーを探します。

* **別のスクリプトをテストする** – あらかじめ用意された別の Upcart API スクリプトを試して、問題があなたのコードにあるのかどうかを確認します。

* **それでも解決しない場合** – Shopify テーマの変更やサードパーティアプリの統合を行っている場合は、[Shopify パートナーディレクトリ](https://www.shopify.com/partners/directory)の Shopify エキスパートがお手伝いできます。

これらの手順で、ほとんどのスクリプトの問題を特定して解決できるはずです!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # 問題を引き起こすスクリプトを追加してしまった場合、変更を元に戻すには?
</div>

期待どおりに動作しないスクリプトを追加してしまった場合、**簡単に削除または無効化**できます:

* スクリプトを追加した **Upcart の Custom HTML 設定に移動**します。

* **スクリプトを削除**するか、各行の先頭に `//` を追加して一時的に無効化します(コメントに変わり、実行されなくなります)。

* **変更を保存してストアを再読み込み**し、問題が解決したか確認します。

問題が解決しない場合は、キャッシュの消去や、最近のテーマ変更を元に戻すことをお試しください。これで隠れた競合が解消されることがよくあります。

***

🚧 **高度なカスタマイズをお探しですか?**

ストア全体のカスタマイズやサードパーティアプリとの統合が必要ですか?Upcart の API を Shopify テーマに追加するには、開発者が必要になる場合があります。

\*\*[Shopify パートナーディレクトリ](https://www.shopify.com/partners/directory)\*\*を通じて Shopify エキスパートの採用を検討し、当社の [API ドキュメント](/ja/upcart/introduction_to_upcarts_public_api)を共有してサポートを受けてください