D01 · DOCUMENTATIONSCANFENCE / DOCUMENTATIONQUICKSTART · API · RECIPES
仕組みを知る。
セットアップガイド、APIリファレンス、統合レシピ。まずはクイックスタートから始め、準備ができたら技術リファレンスへと進んでください。
目次
1. はじめに
1.1 アカウントの作成
- /signup にある GeoTrack のサインアップページにアクセスします
- サブスクリプションプラン（Basic、Starter、Professional）を選択します
- メールアドレスを入力し、安全なパスワードを作成します
- 「アカウントを作成」をクリックします
- 自動的にログインし、ダッシュボードへリダイレクトされます
注意: すべてのプランに7日間の無料トライアルが含まれます。トライアル終了までカードに請求は発生しません。
1.2 初回ログイン
初めてログインすると、次の項目が表示されます:
- クイック統計を備えたダッシュボード（現在はゼロ）
- 利用可能な機能を含む左側のナビゲーションメニュー
- 最初のQRコードの作成を促すウェルカムメッセージ
1.3 プラン上限の理解
Basic プラン（$4.99/月）
- 20個のQRコード
- 月間5,000スキャン
- チームメンバー1名
- データ保持7日間
- メールサポート（48時間以内の返信）
Starter プラン（$14.99/月）
- 100個のQRコード
- 月間25,000スキャン
- チームメンバー2名
- データ保持30日間
- 優先メールサポート（24時間）
Professional プラン（$44.99/月）
- 500個のQRコード
- 月間250,000スキャン
- チームメンバー10名
- データ保持90日間
- 優先サポート + APIアクセス
2. ダッシュボード概要
2.1 ダッシュボードの構成要素
ダッシュボードには次の内容が表示されます:
主要指標:
• 総QRコード数: 作成したQRコードの数
• 総スキャン数: すべてのQRコードにわたる累計スキャン数
• アクティブなジオフェンス: 現在有効なジオフェンスの数
• 今月のスキャン数: 当月に記録されたスキャン数
3. QRコードの作成
3.1 標準QRコード
目的: 単一のURLへリダイレクトするシンプルなQRコード。
手順:
- ナビゲーションメニューの「QR Codes」に移動します
- 「Create New QR Code」をクリックします
- 種類として「Standard」を選択します
- QRコードの名前を入力します（例:「Product Brochure」）
- リンク先URLを入力します
- 「Create QR Code」をクリックします
ユースケース:
- 製品情報ページ
- イベント登録
- 連絡先情報
- SNSプロフィール
3.2 ジオフェンス付きQRコード
目的: ユーザーの物理的な位置に応じて、異なるURLへリダイレクトします。
手順:
- 「QR Codes」→「Create New QR Code」に移動します
- 種類として「Geofence」を選択します
- QRコードの名前を入力します
- デフォルトURLを入力します（ユーザーがすべてのジオフェンス外にいる場合に使用）
- 「Create QR Code」をクリックします
- 「Geofences」メニューに移動し、「Create Geofence」をクリックします
- QRコードを選択し、位置と半径を設定します
- この位置のリダイレクト先URLを入力します
ユースケース:
- 複数拠点を持つ小売店舗
- 地域別のコンテンツ配信
- ロケーション限定のオファー
- イベント会場のナビゲーション
3.3 マルチロケーションQRコード
目的: 事前に定義したリストの中から、最も近い拠点へ自動的にユーザーをリダイレクトします。
仕組み:
- ユーザーがQRコードをスキャンします
- システムがユーザーのGPS座標を検出します
- すべての拠点までの距離を計算します
- 最も近い拠点へリダイレクトします
ユースケース:
- フランチャイズ事業
- チェーンレストラン
- 複数拠点を持つサービス事業者
- 店舗検索
3.4 時間ベースのルールの追加
任意のQRコードに時間ベースのルーティングを追加し、スキャンした時間帯に応じてユーザーをリダイレクトできます。
設定項目:
- 曜日: このルールを適用する曜日を選択します
- 時間帯: 開始時刻と終了時刻を設定します（24時間表記）
- 期間: 任意で特定の日付範囲を指定します
- 優先度: 数値が大きいほど優先されます
- リンク先URL: この時間帯にリダイレクトする先
例:
- レストランのメニュー（朝食、昼食、夕食）
- 営業時間と営業時間外の案内
- 季節限定コンテンツ
- イベント専用のリダイレクト
3.5 スキャン上限の設定
スキャン上限で希少性と緊急性を演出します。
ユースケース:
- 期間限定オファー（「先着100名様が20%オフ」）
- 限定アクセスコード
- イベントの定員管理
- プロモーションキャンペーン
4. ジオフェンスの管理
4.1 ジオフェンスの作成
- ナビゲーションの「Geofences」に移動します
- 「Create Geofence」をクリックします
- ジオフェンスを設定したいQRコードを選択します
- 位置情報（住所または座標）を入力します
- 半径をメートル単位で設定します（デフォルト: 100m）
- このジオフェンスのリダイレクト先URLを入力します
- 「Create Geofence」をクリックします
4.2 ジオフェンスのベストプラクティス
半径の選び方:
- 都市部: 50〜100メートル（GPS精度が高い）
- 郊外: 100〜300メートル（中程度の精度）
- 地方: 300〜1000メートル（GPS精度が低い）
ジオフェンスの重複:
- ジオフェンスが重複する場合、システムは最も近い中心点を使用します
- 優先度設定で動作を制御します
- ジオフェンスが重複する領域では入念にテストします
5. 分析とレポート
5.1 分析ダッシュボード
概要指標:
- 総スキャン数（累計）
- ユニークスキャン数
- 今月のスキャン数
- スキャンの増加率
チャートとグラフ:
- スキャンの推移（日次/週次/月次）
- 地理的分布
- デバイス別内訳（モバイルとデスクトップ）
- ブラウザ統計
5.2 スキャンマップ
インタラクティブマップには次の内容が表示されます:
- 各スキャン位置のピンマーカー
- 複数のスキャンが近接している場合のクラスターマーカー
- ピンをクリックしてスキャンの詳細を表示
- ズームとパンで地域を探索
5.3 データのエクスポート
手順:
- Analytics ページに移動します
- 希望するフィルターを設定します
- 「Export Data」をクリックします
- 形式（CSV）を選択します
- ファイルをダウンロードします
エクスポートされるデータに含まれる項目:
- タイムスタンプ、QRコード名、位置
- デバイスの種類、ブラウザ、OS
- ユーザーエージェント文字列
6. チーム管理
6.1 チームの役割
Admin（管理者）
• すべての機能にフルアクセス
• チームメンバーの招待/削除
• 請求の管理
• すべての分析の閲覧
• 設定へのアクセス
Manager（マネージャー）
• QRコードの作成/管理
• ジオフェンスの作成/管理
• すべての分析の閲覧
• チームの管理は不可
• 請求へのアクセスは不可
Field User（現場ユーザー）
• QRコードの作成
• 自分のQRコードのみ閲覧
• 分析へのアクセスは制限あり
• ジオフェンスの管理は不可
• 請求へのアクセスは不可
6.2 チームメンバーの招待
- ナビゲーションの「Team」に移動します（Admin権限が必要）
- 「Invite Team Member」をクリックします
- 相手のメールアドレスを入力します
- 役割（Admin、Manager、Field User）を選択します
- 「Send Invitation」をクリックします
- 招待された相手が承諾リンク付きのメールを受け取ります
注意: 招待できるメンバー数はプランの上限までです（Basic: 1名、Starter: 2名、Professional: 10名）
7. サブスクリプションと請求
7.1 サブスクリプション状況の確認
ステータス表示:
- Active: サブスクリプションは有効で継続中です
- Trial: 7日間のトライアル期間中です
- Past Due: 支払いに失敗し、再試行中です
- Canceled: 解約済みですが、期間終了まで有効です
- Expired: サブスクリプションが終了しました
7.2 プランのアップグレード
- 「Pricing」ページまたはダッシュボードに移動します
- 希望するプランの「Upgrade」をクリックします
- 新しいプランの機能と上限を確認します
- アップグレードを確定します
- 日割り料金が即時に適用されます
- 新しい上限が即時に有効になります
8. 高度な機能
8.1 ジオフェンスと時間ルールの組み合わせ
ユースケース例: レストランチェーン
- マルチロケーションQRコードを作成します
- 各レストラン拠点にジオフェンスを追加します
- メニュー用の時間ベースのルール（朝食、昼食、夕食）を追加します
優先度システム:
- ジオフェンス + 時間ルールの一致 = 最優先
- ジオフェンスのみ一致 = 中優先度
- 時間ルールのみ一致 = 低優先度
- 一致なし = デフォルトURL
8.2 動的URLパラメータ
スキャンに関する情報をリンク先URLへ渡します:
利用可能なパラメータ:
{scan_id}– 一意のスキャン識別子{qr_code_id}– QRコード識別子{timestamp}– Unix タイムスタンプ{lat}– 緯度{lng}– 経度
https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}9. トラブルシューティング
9.1 QRコードがスキャンできない
考えられる原因:
- QRコード画像の品質が低すぎる
- 照明条件が悪い
- カメラのピントの問題
- QRコードが小さすぎる、または大きすぎる
解決策:
- より高解像度のQRコードをダウンロードする（300×300 または 500×500）
- 十分なコントラストを確保する（明るい背景に暗い色）
- 印刷時は最小サイズ 2cm x 2cm を維持する
9.2 誤った位置が検出される
原因:
- デバイスでGPSが無効になっている
- 屋内（GPS信号が弱い）
- デバイスのGPS精度が低い
- ユーザーが位置情報の許可を拒否した
解決策:
- ユーザーに位置情報サービスを有効にするよう依頼する
- 屋内利用向けにジオフェンスの半径を広げる
- 位置情報取得に失敗した場合のフォールバックURLを用意する
9.3 ジオフェンスが機能しない
チェックリスト:
- ジオフェンスは有効か？（ダッシュボードでステータスを確認）
- QRコードの種類が「Geofence」に設定されているか？
- 半径はその地域に適しているか？
- 位置情報を有効にしたデバイスでテストしたか？
- 座標は正しいか？（地図で確認）
10. ベストプラクティス
10.1 QRコードのデザイン
✓ 推奨:
- 高いコントラストを使用する（白地に黒が理想）
- コードの周囲に余白を残す（クワイエットゾーン）
- 大量印刷の前にテストする
- 明確な行動喚起テキストを添える
✗ 非推奨:
- コントラストを下げる色を使う
- QRコードを小さくしすぎる（最小 2cm x 2cm）
- 曲面に配置する
- 低解像度の画像を使う
10.2 ジオフェンス戦略
計画:
- まずすべての拠点を洗い出す
- 各拠点に適した半径を決める
- 各エリアのGPS精度を考慮する
- 重複するシナリオをテストする
最適化:
- 大きめの半径から始め、テスト後に絞り込む
- 分析を使ってジオフェンスの精度を検証する
- 実際のスキャンデータに基づいて調整する
10.3 セキュリティとプライバシー
アカウントの保護:
- 強力で固有のパスワードを使用する
- 二要素認証を有効にする（近日提供予定）
- ログイン情報を共有しない
- チームメンバーのアクセス権を定期的に見直す
ユーザーのプライバシー:
- 必要な位置情報のみを収集する
- GDPR/プライバシー規制を遵守する
- リンク先URLをHTTPSで保護する