Squarespace を接続し、注文を訪問に紐づける

01ワンクリックで接続する

1. 1

   サイトの Integrations ページで Squarespace を開き、Connect with Squarespace を押します。

2. 2

   Tally が、与えられるアクセスを示します。注文とその取引の読み取り専用のアクセスと、Webhook サブスクリプション 1 つです。注文を変更することはありません。Continue to Squarespace を押します。

3. 3

   Squarespace から、サイトのオーナーまたは管理者としてログインし、サイトを選ぶよう求められます。確認ページでは、Tally が注文と取引をオフラインで読み取る許可を求められます。これにより、あなたが画面を離れている間も読み取りを続けられます。Allow を押します。

4. 4

   Integrations に戻ると Squarespace is connected と表示され、返金を含む 1 年分の注文の取り込みが進みます。

以降、新しい注文は Webhook サブスクリプションを通じて数秒以内に届きます。また Tally は 30 分ごとに変更された注文を読み取るため、通知が届かなかった注文も取り込まれます。

02または API キーで接続する

1. 1

   Squarespace で API キーを作成する

   API キーは Core、Plus、Advanced、Commerce Advanced プランで使えます。Squarespace で Settings › Developer Tools › Developer API Keys を開き、「Generate Key」を選んで、次の権限だけを付けます（Squarespace のガイド）。

   権限	アクセス	用途
   Orders	読み取り	支払い済みのすべての注文：合計額と税額、顧客のメールアドレス（すぐにハッシュ化し、保存はしません）。氏名と住所は保存しません。
   Transactions	読み取り	各返金がいつ行われ、いくら戻されたか。

   どちらも Read Only にします。Squarespace は Webhook をワンクリックで接続したアプリにしか提供しないため、キーで接続した場合、Tally は 10 分ごとに新しい注文を読み取ります。キーは同じ場所でいつでも削除できます。

2. 2

   API キーを貼り付ける

   サイトの Integrations ページ（またはサイト追加時の Payments の手順）で Squarespace を開き、次を入力します。

   • API key：キーの作成時に 1 回だけ表示されます。Tally は暗号化して保管し、二度と表示しません。

   続いて Connect Squarespace を押します。

3. 3

   Tally が確認し、過去 1 年分を取り込む

   キーをサイトで確認し、返金を含む過去 365 日分を取り込んだ後、10 分ごとに新しい注文と変更された注文を読み取ります。各注文を購入者の訪問に紐づけるには、Pages › Custom Code › Code Injection に Tally のスニペットを追加します。タグは Header に、Coverage and fixes にある注文状況ページ用の数行は Order Status Page と Order Confirmation Page の欄に入れます。

03Code Injection にコードを追加する

Squarespace はストア上でアプリのコードを実行しないため、コードは手動で入れます。Squarespace で Pages › Custom Code › Code Injection を開きます（以前は Developer Tools の下にありました）。Code Injection は Core、Plus、Advanced プランと一部の旧プランで使え、Basic と Personal では使えません。

Header

スニペット。ストアのすべてのページで訪問を数えます。

<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

Order Status Page と Order Confirmation Page

次の数行を、両方の欄に入れます。Squarespace はチェックアウト後、物理商品・ダウンロード商品・サービス商品では注文状況ページを、ギフトカード・サブスクリプション・メンバーシップでは注文確認ページを表示します。{orderId} には注文番号が入り、この数行がそれを送信します。

{.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}

購入者がそのページを訪れることで、注文がその購入者に紐づきます：確度：高。{.if firstPageView} によって、後でメールのリンクからそのページを再訪しても、再び数えられることはありません。この数行がない場合は、サイトが購入者のアドレスで identify を呼び出していれば、注文はメールアドレスで紐づきます（確度：中。ゴールと identify）。

04売上として数えるもの

• 注文は支払われた時点で、注文日時の売上として数えます。金額は注文の通貨での合計から税を引いたもので、送料を含み、割引は差し引き済みです。
• 各返金は注文の取引から読み取り、返金した日時の分として、注文の税額を按分して数えます。

05保持するもの

Tally が各注文について保持するのは、金額、日付、支払い状態と、2 つのハッシュ（顧客のメールアドレスと注文番号）です。注文状況ページから届く番号は受信時にハッシュ化されるため、保存されるのはハッシュだけです。氏名、住所、電話番号、注文明細、フォームの回答、メモは一切保存しません。

06切断する

• Squarespace 側：Extensions パネルの Connected extensions で Tally を切断します。
• Tally 側：Integrations ページで切断します。Tally は Webhook サブスクリプションを削除してアクセス権を破棄しますが、Squarespace 側でも切断するまで、Connected extensions には表示され続けます。自分で作成したキーは、Squarespace で削除してください。
• どちらの場合も、取り込み済みの注文はレシートとともに残ります。

07うまくいったか確認する

08自分の訪問が表示されないとき

Squarespace にログインしているサイトのオーナーはエディターに移動してしまい、訪問者としてストアを見ることがないため、その訪問は数えられません。ログアウトした状態のプライベートウィンドウで、サイトにパスワードがある場合はそれを通過してから確認してください。