連携 · 決済サービス
Squarespace の注文と返金を、購入者の訪問に 1 件ずつ紐づけます。
Squarespace 自身の確認ページで Tally を許可するか、サイトで作成した API キーを貼り付けます。返金を含む 1 年分の注文を取り込み、以降は新しい注文を数秒以内に受け取ります。Code Injection に入れる 2 つのコードが、すべての注文を購入につながった訪問に紐づけます。
Tally は Squarespace の推奨を受けておらず、Squarespace との提携関係もありません。
14 日間無料、カード登録は不要です。
01Tally が読み取るもの
- 支払い済みのすべての注文を、注文した日付で、総額から税を引いた金額として数えます。送料は含み、割引は差し引き済みで、金額はストアの通貨でセント単位まで正確に読み取ります。
- 各返金を、注文の取引から発生した日付で読み取ります。Squarespace は返金に税額を記録しないため、注文の税を按分して付けます。
- 接続するとすぐに過去 365 日分を取り込みます。ワンクリックで接続したストアでは、以降の新しい注文を 1 つの Webhook サブスクリプションで数秒以内に受け取ります。
- 前回以降に変更されたすべての注文を定期的に読み直します。ワンクリック接続では 30 分ごと、通知を受け取れない API キーでは 10 分ごとです。
- 保存するのは数値に必要なものだけです。金額、日付、支払い状態、顧客のメールアドレスと注文番号のハッシュ。氏名、住所、電話番号、注文明細、フォームの回答、メモは一切保存しません。
02売上が訪問に紐づくしくみ
- 注文状況ページCode Injection の Order Status Page と Order Confirmation Page の欄に入れた Tally のコードが、チェックアウト後に購入者がそのページに来た時点で注文番号を送ります。注文番号は受信時にハッシュ化され、注文と照合されます。確度：高。
- メールアドレスこのコードがない場合は、注文の顧客メールアドレスを読み取った時点でハッシュ化し、サイトがそのアドレスで tally('identify') を呼び出していれば売上を紐づけます。確度：中。
- 返金返金は、お金を返した Squarespace の注文の紐づけを引き継ぎます。
03読み取れないもの
- サイトのチェックアウトがテストモードのときの注文は数えません。
- 分割払いの注文は、全額が支払われるまで数えません。
- Stripe のダッシュボードなど、Squarespace の外で行った返金は Squarespace の API に含まれないため、これも数えません。
- Squarespace はストア上でアプリのコードを実行しないため、スニペットは Code Injection から手動で入れます。Code Injection は Core、Plus、Advanced プランと一部の旧プランで使え、Basic と Personal では使えません。
- Squarespace は Webhook をアプリにしか提供しないため、API キーでは Webhook が使えません。新しい注文は数秒以内ではなく、10 分ごとに届きます。
04接続のしかた
- サイトの Integrations ページで Squarespace を開き、「Connect with Squarespace」、続いて「Continue to Squarespace」を選びます。サイトのオーナーまたは管理者としてログインし、サイトを選んで、Squarespace の確認ページで「Allow」を押します。
- 確認ページでは、注文と取引をオフラインで読み取る許可を求められます。これにより、管理画面を開いていない間も Tally が読み取りを続けられます。過去 365 日分を取り込み、その後の注文は Webhook サブスクリプションで届きます。
- または API キーを作成します。Squarespace の Settings → Developer Tools → Developer API Keys で、Orders と Transactions を読み取り専用にしたキーを作り、同じパネルに貼り付けます。
- Squarespace で Pages → Custom Code → Code Injection を開きます。スニペットを Header に、下記の注文状況用のコードを Order Status Page と Order Confirmation Page の両方の欄に貼り付けます。
- ログアウトした状態のプライベートウィンドウで確認します。ログイン中のオーナーはエディターに移動してしまい、訪問者としてストアを見ることができません。
API キーに必要な権限
Tally が求めるのは、次のことだけができる API キーです。貼り付けた時点で権限ごとに実際の呼び出しで確認するので、足りない権限があれば名前で示されます。
| 権限 | アクセス | 用途 |
|---|---|---|
| Orders | 読み取り | 支払い済みのすべての注文：合計額と税額、顧客のメールアドレス（すぐにハッシュ化し、保存はしません）。氏名と住所は保存しません。 |
| Transactions | 読み取り | 各返金がいつ行われ、いくら戻されたか。 |
作成方法：Squarespace のガイド.
注文状況ページ用のコード（Order Status Page と Order Confirmation Page の欄）
{.if firstPageView}
<script>
window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
tally('squarespace_order', { order: order });
});
</script>
{.end}
05よくある質問
Tally がストアの内容を変更することはありますか？
いいえ。注文とその取引を読み取り、新しい注文を受け取るための Webhook サブスクリプションを 1 つ作るだけで、注文を変更することはありません。Code Injection のコードは、訪問を数え、注文状況ページから注文番号を送るだけです。
同じコードを 2 つの注文ページの欄に貼り付けるのはなぜですか？
Squarespace は、物理商品・ダウンロード商品・サービス商品の購入者を注文状況ページに、ギフトカード・サブスクリプション・メンバーシップの購入者を注文確認ページに送ります。両方にコードを入れておけば、どの種類の注文も訪問に紐づけられます。
ワンクリックと API キー、どちらで接続すべきですか？
できればワンクリックで接続してください。Squarespace は Webhook をアプリにしか提供しないため、ワンクリック接続では新しい注文が数秒以内に届き、API キーでは 10 分ごとになります。どちらも過去 365 日分を取り込み、注文の紐づけ方も同じです。
テスト注文は数えますか？
いいえ。サイトのチェックアウトがテストモードのときの注文は売上ではないため、収益に含めません。Sales ページに最初に表示される紐づいた注文は、実際の注文です。
ストアから Tally を切断するにはどうすればよいですか？
Squarespace の Extensions パネルの Connected extensions から、または Tally の Integrations ページから切断できます。取り込み済みの注文はレシートとともに残ります。Tally 側で切断しても Squarespace の一覧からは消えないため、Squarespace 側でも切断してください。