連携 · 決済サービス

WooCommerce の注文と返金を、売上を生んだ訪問に 1 件ずつ紐づけます。

Tally の画面か Tally WordPress プラグインから進み、WooCommerce 自身の画面でワンクリックで Tally を承認するか、REST API キーで接続します。Tally は返金を含む過去 365 日分を取り込み、以降の注文のために Webhook を 2 つ追加して、各注文を購入者の訪問に紐づけます。

無料で始める

14 日間無料、カード登録は不要です。

01Tally が読み取るもの

  • 支払い済みのすべての注文。processing、completed、refunded のほか、支払日があって後からキャンセルされた注文も含みます。代金引換は processing の時点から数え、pending、on-hold、failed、draft の注文は売上に含めません。
  • 注文合計から税を引いた金額です。送料と手数料は含み、割引は差し引き済みです。注文の通貨で正確に読み取り、その日の欧州中央銀行のレートで米ドル(セント単位)に換算します。
  • 各返金を、返された税額とあわせて、返金した時点で記録します。品目ごとの返金はその品目の税額を持ち、金額指定の返金は注文の税を按分して返します。
  • 接続時に過去 365 日分を取り込み、以降は Tally が追加する 2 つの Webhook(order created と order updated)で、各注文を数秒以内に受け取ります。
  • 30 分ごとに前回以降に変更された注文を読み直し、無効になった Webhook を再び有効にします。届かなかった配信があっても、注文が失われることはありません。
  • 保存するのは数値に必要なものだけです。金額、日付、ステータス、返金、注文キーと請求先メールアドレスのハッシュ。氏名、住所、電話番号、注文明細は一切保存しません。

02売上が訪問に紐づくしくみ

  • 注文受付ページストアに Tally のスニペットがあれば、購入者が注文受付ページを訪れた時点で、その注文を訪問者に紐づけます。ページのアドレスに含まれる注文キーはハッシュとしてのみ保持し、注文と照合します。確度:高。WooCommerce 側に追加するものはありません。
  • 注文に保存する訪問者 IDTally WordPress プラグインは、クラシックでもブロックでもチェックアウト時に訪問者の ID を注文に保存するため、注文受付ページまで来ない購入者も紐づきます。プラグインがなくても、functions.php に数行足せば同じことができます。確度:高(Cookie モード、または同意後)。
  • メールアドレス請求先メールアドレスを受信時にハッシュ化し、サイトでの tally('identify') の呼び出しと照合します。確度:中。
  • 返金返金は、お金を返した注文の紐づけを引き継ぎます。

03読み取れないもの

  • WooCommerce Subscriptions の更新注文は、更新として区別しません。それぞれを独立した売上として数え、それぞれの根拠で紐づけます。また、この有料拡張機能での動作は検証していません。
  • ストアが自分の Stripe アカウントで決済している場合は、WooCommerce かその Stripe アカウントのどちらか一方だけを接続してください。両方つなぐと同じ売上を二重に数えます。
  • WooCommerce には独自のテストモードがないため、決済ゲートウェイのテストモードで作られた注文も、通常の注文として売上に数えます。
  • WooCommerce は HTTPS 経由でしかキーを受け付けないため、HTTP のみのストアは接続できません。
  • 1 つのストアがデータを送れるのは、一度に 1 サイトのみです。最初のサイトから切断するまで、別のサイトへの接続は拒否されます。

04接続のしかた

  1. サイトの Integrations ページでストアのアドレスを入力して「Approve in WooCommerce」を選ぶか、Tally WordPress プラグインの「Connect WooCommerce to Tally」ボタンを使います。ストアが管理者またはショップマネージャーに Tally の承認を求め、キーを自動で作成します。
  2. キーを手動で作る場合は、WordPress で WooCommerce → Settings → Advanced → REST API を開き、「Add key」を選んで Permissions を「Read/Write」に設定し、コンシューマーキーとシークレットをストアのアドレスとともに貼り付けます。
  3. Read/Write は Tally 専用の 2 つの Webhook のためだけに使い、注文を変更することはありません。キーをストアで確認したあと、返金を含む過去 365 日分を取り込みます。
  4. Tally WordPress プラグインをインストールして Site ID を貼り付けます。注文受付ページを含むすべてのページにスニペットを入れ、購入者ごとの訪問者 ID を注文に保存します。または、テーマのヘッダーにスニペットを貼り付けます。
  5. プラグインを使わない場合は、決済ゲートウェイが注文受付ページに戻さない購入者のために、下記の functions.php のコードを追加します。同じコードは Coverage ページにもあります。

REST API キーに必要な権限

Tally が求めるのは、次のことだけができる REST API キーです。貼り付けた時点で権限ごとに実際の呼び出しで確認するので、足りない権限があれば名前で示されます。

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

作成方法:WooCommerce のガイド.

プラグインなしの場合:訪問者 ID を注文に保存する(functions.php)

// 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よくある質問

  • WordPress プラグインはありますか?

    はい、Tally WordPress プラグインがあります。Site ID を貼り付けると、すべてのページにスニペットを追加し、ログイン中の管理者を除外し、チェックアウト時に購入者の訪問者 ID を WooCommerce の各注文に保存します。「Connect WooCommerce to Tally」ボタンからは WooCommerce の承認画面が開きます。functions.php のコードは不要になります。

  • キーをコピーせずに接続できますか?

    はい。Integrations ページでストアのアドレスを入力し、WooCommerce 自身の画面で Tally を承認します。ストアが Read/Write のキーを作って受け渡すので、何もコピーする必要はありません。キーは WooCommerce → Settings → Advanced → REST API でいつでも取り消せます。

  • Webhook の配信に失敗したらどうなりますか?

    WooCommerce は配信を再試行せず、失敗が続くと Webhook を無効にします。Tally は 30 分ごとに前回以降に変更された注文を読み取り、無効になった Webhook を再び有効にするので、その注文も取り込まれます。

  • ブロックチェックアウトでも使えますか?

    はい。注文受付ページはどちらのチェックアウトでも同じで、functions.php のコードはクラシックでもブロックでも訪問者の ID を保存します。どちらも WooCommerce 11.2 で検証済みです。

  • ホスティングが Authorization ヘッダーを削除してしまいます。ストアは接続できますか?

    はい。キーが送られていないかのような応答をストアが返した場合、Tally は WooCommerce のドキュメントどおり、代わりに HTTPS 経由でキーをクエリパラメーターとして送ります。わかりやすいパーマリンク(pretty permalinks)を使っていないサイトには、?rest_route= 経由で接続します。