APIドキュメンテーション

分析

Analytics API

詳細なスキャンデータ、地理情報、デバイスの内訳、トレンド分析を使用してQRコードのパフォーマンスを追跡および分析します。

スキャントレンド

日次、週次、または月次の内訳でスキャンを追跡します

地理データ

国と都市ごとにQRコードがスキャンされている場所を確認します

デバイス情報

デバイスタイプ、オペレーティングシステム、ブラウザを理解します

リファラーデータ

キャンペーンの帰属のためにスキャンの発信元を追跡します

エンドポイント

メソッド	エンドポイント	説明
GET	/organizations/:orgId/qr-codes/analytics	組織全体の分析
GET	/organizations/:orgId/qr-codes/:id/analytics	単一QRコード分析
GET	/organizations/:orgId/qr-codes/:id/analytics/export	CSVとして分析をエクスポート
GET	/organizations/:orgId/qr-codes/:id/scans	個別のスキャン記録を取得

QRコード分析を取得

特定のQRコードの包括的な分析を取得します。

GET

/organizations/:orgId/qr-codes/:id/analytics

クエリパラメータ

パラメーター	タイプ	説明
startDate	string	開始日（ISO 8601形式）
endDate	string	終了日（ISO 8601形式）
interval	string	グルーピング間隔：日、週、月

リクエストの例

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics?startDate=2024-01-01&endDate=2024-01-31&interval=day" \
  -H "X-API-Key: YOUR_API_KEY"

レスポンス

{
  "qrCodeId": "qr_xyz789",
  "period": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-31T23:59:59Z"
  },
  "summary": {
    "totalScans": 1542,
    "uniqueScans": 1203,
    "avgDailyScans": 49.7
  },
  "timeline": [
    { "date": "2024-01-01", "scans": 45, "uniqueScans": 38 },
    { "date": "2024-01-02", "scans": 52, "uniqueScans": 41 },
    ...
  ],
  "geography": {
    "countries": [
      { "country": "US", "scans": 823, "percentage": 53.4 },
      { "country": "GB", "scans": 234, "percentage": 15.2 },
      { "country": "DE", "scans": 156, "percentage": 10.1 }
    ],
    "cities": [
      { "city": "New York", "country": "US", "scans": 234 },
      { "city": "London", "country": "GB", "scans": 189 },
      { "city": "Los Angeles", "country": "US", "scans": 145 }
    ]
  },
  "devices": {
    "types": [
      { "type": "mobile", "scans": 1234, "percentage": 80.0 },
      { "type": "desktop", "scans": 231, "percentage": 15.0 },
      { "type": "tablet", "scans": 77, "percentage": 5.0 }
    ],
    "os": [
      { "os": "iOS", "scans": 687, "percentage": 44.6 },
      { "os": "Android", "scans": 547, "percentage": 35.5 },
      { "os": "Windows", "scans": 189, "percentage": 12.3 }
    ],
    "browsers": [
      { "browser": "Safari", "scans": 654, "percentage": 42.4 },
      { "browser": "Chrome", "scans": 521, "percentage": 33.8 },
      { "browser": "Firefox", "scans": 156, "percentage": 10.1 }
    ]
  }
}

地理的分析

分析のレスポンスには、国と都市別のスキャンの詳細な地理的内訳が含まれています。このデータは、スキャンリクエストのIPジオロケーションから派生しています。

利用可能な地理データ

• 国： ISO国コードとスキャン数
• 都市： 国の文脈を持つ都市名
• パーセンテージ： スキャンの相対的分布
• 座標： おおよその緯度/経度（利用可能な場合）

プライバシーノート： 正確なユーザーの位置情報は保存していません。地理データはIPアドレスから派生し、おおよその都市レベルの精度を提供します。

分析をエクスポート

分析データをCSVとしてエクスポートし、スプレッドシートやBIツールでさらに分析します。

GET

/organizations/:orgId/qr-codes/:id/analytics/export

CSVにエクスポート

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics/export?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o analytics.csv

CSV列

列	説明
timestamp	スキャンタイムスタンプ（ISO 8601）
country	国コード
city	都市名
device_type	モバイル、デスクトップ、タブレット
os	オペレーティングシステム
browser	ブラウザ名
is_unique	初回スキャン（true/false）

組織全体の分析

組織内のすべてのQRコードにわたる集約分析を取得します。

GET

/organizations/:orgId/qr-codes/analytics

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/analytics?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY"

次のステップ