トラブルシューティング

Cabinaがストアフロントを壊すことはありません。動作できないときは、自分から身を引きます。これは意図した動作であり、ここに挙げる不具合の一部が完全に無言である理由でもあります。

商品ページのどこにもボタンがない

コンソール： www.cabina.ioを名指しした、ブラウザのCORSエラー

ストアのドメインが許可リストにないため、APIはCORSヘッダーなしで応答し、ブラウザがそのレスポンスを破棄しています。

ウィジェット で正確なオリジンを追加してください。https://shop.comとhttps://www.shop.comは別々の2つのオリジンです。両方がストアを配信しているなら、両方を追加してください。

同じ一覧は試着にも適用されます。一覧にないサイトからの試着リクエストは、クレジットが消費される前に拒否されます（403）。ドメインを変えてから試着が止まった場合も、対処は同じです。新しいドメインを追加してください。

ボタンがなく、CORSエラーもない

コンソール： [widget] error=WIDGET_CONFIG_MISSING

APIキーがないか、scriptタグから読み取れていません。

data-api-keyがまさにその<script>タグに付いていて、cab_live_で始まっているか確認してください。

ボタンがなく、コンソールにも何もない

コンソール： 何もなし — このケースは無言です

プランのセッションを使い切ったか、クレジットがなくなっています。ストアが動き続けるように、ウィジェットは意図的に自分を隠しています。

請求 を確認してください。

ボタンがページの一番下にある

コンソール： 何もなし — このケースも無言です

既知のアンカーがどれもテーマに一致しなかったため、ボタンは<body>に追加されました。

置きたい場所に<div data-cabina-target></div>を追加してください。ボタンはその要素の内側に入ります。ボタンの位置を変えるをご覧ください。

ボタンが2つあり、セッションが二重に数えられる

コンソール： [widget] warn=GIA_CARICATO

スニペットがページに2回入っています。古いコピーとプラグインの組み合わせがよくあるケースです。

2つの<script>タグのうち1つを取り除いてください。

ボタンは開くが、試着が途中で失敗する

コンソール： 何もなし

Cabinaがページ上でアイテムの画像を見つけられませんでした。

商品テンプレートにog:imageメタタグを追加してください。アイテムの画像をご覧ください。

多くのお客様が同時に試着すると、一部の試着が失敗する

コンソール： 何もなし。ブラウザのネットワークタブに429のレスポンス

Cabinaが受け付ける試着は、1ストアにつき1分あたり最大30回です。公開キーを使って、誰かが数分であなたのクレジットを使い切ることがないようにするためです。この上限を超えると試着は失敗します。少し待ってからやり直せば大丈夫です。

ボタンは動くが、サイズがおすすめされない

コンソール： 何もなし

そのアイテムに必要な寸法を、お客様が入力していません。たとえばトップスなのに身長だけ、という場合です（トップスにはバストとウエストが必要です）。ウィジェットは、サイズを当て推量するよりも、何も表示しないことを選びます。

アイテムの種類ごとに必要な寸法は、ダッシュボードに載っています。

ターミナルから検証する

# 1. タグが実際に配信されている
curl -s https://your-store.com/products/some-product | grep -o 'widget.iife.js'
 
# 2. ページがアイテムの画像を公開している
curl -s https://your-store.com/products/some-product | grep -o 'og:image[^>]*'

失敗するのはこの2つです。両方とも応答するなら、問題はほぼ必ず許可されていないドメインです。

どれにも当てはまらない？

商品ページのリンクと、可能ならコンソールに表示されている内容を添えて、info@cabina.ioまでご連絡ください。