クラウドデプロイ

概要

tracio.aiは完全マネージド型のクラウドプラットフォームです。アプリケーションはブラウザからシグナルを送信し、クラウドは識別結果を返します。プラットフォームはスケーリング、冗長性、インフラ管理を担います。

利用開始は数分で完了します。アカウントを作成し、公開鍵を取得し、SDKをインストールして、訪問者の識別を始めるだけです。

マネージドクラウドのみ。 TRACIOはセルフホスト型やオンプレミス型のデプロイを提供していません。インストール可能なサーバーコンポーネントは存在しません。制御できるのは、トラフィックが処理されるデータリージョン（下記参照）と、エージェントを自社ドメインから配信したい場合に、endpoint / scriptUrl オプションでマネージドエンドポイントの前段に置くファーストパーティプロキシです。

仕組み

アプリケーションは、クライアントサイドのJavaScript SDKを通じてクラウドと通信します。SDKはブラウザ内でエージェントを読み込み、シグナルを収集し、識別結果を返します:

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. ブラウザSDKがエージェントを読み込み、シグナルを収集します。
2. シグナルがtracio.aiクラウドに送信されます。
3. クラウドが結果を返します: visitorId と bot 情報。

自身のサーバー上で結果に基づいて処理するには、各識別を署名付きのwebhookとして受信するか、Server APIからオンデマンドで読み取ってください。

利用開始

1. サインアップしてダッシュボードを開きます。
2. データリージョンを選択します（下記参照）。
3. 公開鍵をコピーします — クライアントサイドのコードに含めても安全です。
4. SDKをインストールして初期化します:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

データリージョン

SDKの region オプションは、SDKがどのデータリージョンと通信するかを選択します。"us" または "eu" を受け付けます。未設定の場合、SDKは汎用の https://edge.tracio.ai エンドポイントを使用します。リージョンを固定するには明示的に設定してください。

APIキー管理

ワークスペースでは2種類のキーを使い分けます。両者に互換性はありません:

• どちらもダッシュボードの API Keys で作成・管理します。シークレットキーはProプラン以上で利用できます。
• シークレットキーは作成時に一度だけ表示されます — 当社側にはハッシュのみが保存されます。紛失した場合は復元ではなくローテーションで対応してください。
• シークレットキーをローテーションしても直前のキーは7日間有効なままなので、ダウンタイムなしでデプロイできます。公開鍵はローテーションできません。秘密情報ではなく、設計上ページのソースに表示されるものです。

結果をサーバーサイドで受け取る方法は2つあり、併用もできます:

• webhookを設定する — 各識別が X-Tracio-Signature で署名され、エンドポイントに配信されます。
• シークレットキーでServer APIを呼び出す — 訪問者の履歴、個別のセッション、velocityカウンターをオンデマンドで読み取れます。

Webhook

クラウドからの識別イベントを自社サーバーで受け取るために、webhookを設定できます。webhookはProプラン以上で利用できます。セットアップ、ペイロード、署名検証の詳細についてはWebhooksを参照してください。