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

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

1. 1

   サイトの Integrations ページで WooCommerce を開きます。Connect in one click でストアのアドレスを入力し、Approve in WooCommerce を押します。

2. 2

   Tally が、与えられるアクセスを示します。注文と返金を読み取り、Webhook を 2 つ追加するだけで、注文を変更することはありません。Continue to WooCommerce を押します。

3. 3

   ストア上で WooCommerce の画面が開き、Tally would like to connect to your store と表示されます。求められたら（管理者またはショップマネージャーとして）ログインし、Approve を押します。

4. 4

   Integrations に戻ると WooCommerce is connected と表示され、過去 365 日分の取り込みが進みます。

ストアに WordPress プラグインを入れている場合は、その Connect WooCommerce to Tally ボタンから同じ承認を始められます。

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

1. 1

   WooCommerce で REST API キーを作成する

   Tally が行うのは注文と返金の読み取りだけで、書き込むのは専用の Webhook 2 つだけです。WordPress の管理画面で WooCommerce › Settings › Advanced › REST API を開き、「Add key」を選びます。ユーザーを選び、Permissions を「Read/Write」にして生成します（WooCommerce のガイド）。Tally がこのキーで行うのは次のことだけです。

   権限	アクセス	用途
   Orders	読み取り	支払い済みのすべての注文：金額と税額、顧客のメールアドレス（すぐにハッシュ化し、保存はしません）。氏名と住所は保存しません。
   Refunds	読み取り	各返金がいつ行われ、どれだけの税額が戻されたか。
   Webhooks	書き込み	Tally が専用の Webhook を 2 つ（注文作成・注文更新）追加するので、売上は数秒で届きます。それ以外は何も書き込みません。

   Read/Write は Webhook の追加のためだけに使い、Tally が注文を変更することはありません。キーは同じ場所でいつでも取り消せます。

2. 2

   REST API キーを貼り付ける

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

   • Store address：ブラウザに表示されるとおりに入力します。WooCommerce は HTTPS 経由でしかキーを受け付けません。
   • Consumer key：キーの作成時に、シークレットとともに 1 回だけ表示されます。Tally は両方を暗号化して保管し、二度と表示しません。
   • Consumer secret：cs_ で始まります。

   続いて Connect WooCommerce を押します。

3. 3

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

   キーをストアで確認し、新しい注文を発生と同時に受け取れるよう専用の Webhook を 2 つ追加して、返金を含む過去 365 日分を取り込みます。また 30 分ごとに変更された注文を読み取るため、WooCommerce が配信できなかった注文も失われません。ストアに Tally のスニペットがあれば、注文受付ページが各注文を購入者の訪問に紐づけます。

03Tally が読み取り、保持するもの

• 2 つの Webhook、order.created と order.updated（返金のときにも発火します）が、新しい注文を数秒以内に届けます。また Tally は 30 分ごとに変更された注文を読み取り、無効になった Webhook を再び有効にします。WooCommerce は配信を再試行せず、5 回連続で失敗すると Webhook を無効にするためです。
• 注文は支払われた時点で売上になります。processing、completed、refunded、または支払日のある注文です。pending、on-hold、failed の注文は売上ではありません。金額は注文の通貨での合計から税を引いたもので、各返金はそれぞれの日時の分として数えます。
• 注文について保持するのは、金額、日付、ステータス、返金の ID、訪問者 ID と、注文キーと請求先メールアドレスのハッシュです。氏名、住所、電話番号、IP アドレス、注文明細は一切保存しません。
• WooCommerce Subscriptions の更新注文は、ほかの注文と同じ扱いです。それぞれが 1 件の売上で、それぞれの根拠で紐づけます。

04各注文を訪問に紐づける

注文受付ページを含むストアのすべてのページにスニペットを入れます（テーマのヘッダー、または各ページの head にコードを追加するプラグインで）。購入者がそのページに来ると、注文がその訪問に紐づきます。WooCommerce に追加するものはほかにありません。Cookie なしを含むどのモードでも動作します。

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

そのページまで来ない購入者（購入者を戻さない決済ゲートウェイの場合）のために、チェックアウト時に訪問者 ID を注文に保存します。次の数行は、クラシックとブロックのどちらのチェックアウトでも動作します。

// Your theme's functions.php, or a code snippets plugin: saves the visitor's id on the
// order at checkout, for buyers who never reach the order-received page.
function tally_save_visitor_id( $order ) {
    $id = isset( $_COOKIE['_tally_vid'] ) ? $_COOKIE['_tally_vid'] : '';
    if ( preg_match( '/^[A-Za-z0-9_-]{8,64}$/', $id ) ) {
        $order->update_meta_data( 'tally_visitor_id', $id );
    }
}
add_action( 'woocommerce_checkout_create_order', 'tally_save_visitor_id' );
add_action( 'woocommerce_store_api_checkout_update_order_meta', 'tally_save_visitor_id' );

05切断する

Integrations ページで切断します。Tally はストアから専用の Webhook を削除し、取り込み済みの注文はレシートとともに残ります。REST API キー自体は削除できないため、WooCommerce › Settings › Advanced › REST API で取り消してください。

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

07読み取らないもの