QR Code Analytics

curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-02-01&to=2025-02-25&type=count,device,os" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_by": "qrid",
    "q": ["Qf94b25d768294148"]
  }'

curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-02-01&to=2025-02-25&type=count,geography" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_by": "tags",
    "q": ["marketing", "campaign"]
  }'

curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-01-01&to=2025-01-31&type=count,device,os,browser,date" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_by": "qrid",
    "q": ["Qf94b25d768294148", "Qf94b25d768294149", "Qf94b25d768294150"]
  }'

curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-02-01&to=2025-02-25&type=count,qr,device,os,browser,date,handset,geography,geo_location" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_by": "qrid",
    "q": ["Qf94b25d768294148"]
  }'

curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-02-01&to=2025-02-25&type=count,device&exclude_bot_scan=true" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_by": "qrid",
    "q": ["Qf94b25d768294148"]
  }'

{
  "qr": [
    ["QR Code", 1]
  ],
  "count": {
    "total": 1,
    "elevation": {
      "percent": 100,
      "previous": 2,
      "type": "-",
      "period": {
        "start": "2025-10-11T18:07:00Z",
        "end": "2025-10-18T18:07:00Z"
      }
    },
    "unique": 1,
    "unique_elevation": {
      "percent": 100,
      "previous": 2,
      "type": "-",
      "period": {
        "start": "2025-10-11T18:07:00Z",
        "end": "2025-10-18T18:07:00Z"
      }
    },
    "scan_qr": 0,
    "scan_url": 1
  },
  "device": [
    ["PC", 1]
  ],
  "os": [
    ["Mac OS X", 1]
  ],
  "date": {
    "all": [
      ["2025-10-18", 0],
      ["2025-10-19", 0],
      ["2025-10-20", 0],
      ["2025-10-21", 0],
      ["2025-10-22", 0],
      ["2025-10-23", 0],
      ["2025-10-24", 0],
      ["2025-10-25", 1],
      ["2025-10-26", 0]
    ],
    "qr": [
      ["2025-10-18", 0],
      ["2025-10-19", 0],
      ["2025-10-20", 0],
      ["2025-10-21", 0],
      ["2025-10-22", 0],
      ["2025-10-23", 0],
      ["2025-10-24", 0],
      ["2025-10-25", 0],
      ["2025-10-26", 0]
    ],
    "url": [
      ["2025-10-18", 0],
      ["2025-10-19", 0],
      ["2025-10-20", 0],
      ["2025-10-21", 0],
      ["2025-10-22", 0],
      ["2025-10-23", 0],
      ["2025-10-24", 0],
      ["2025-10-25", 1],
      ["2025-10-26", 0]
    ]
  },
  "handset": [
    ["Mac", 1]
  ],
  "browser": [
    ["Chrome", 1]
  ],
  "geography": [
    {
      "country_code": "Unknown",
      "country_name": "Unknown",
      "region": "Unknown",
      "city": "Unknown",
      "count": 1
    }
  ],
  "geo_location": [],
  "age": [],
  "day_time": [
    ["Sun", "00", 0],
    ["Sun", "01", 1],
    ["Sun", "02", 0],
    ["Mon", "09", 2],
    ["Mon", "14", 3],
    ["Tue", "18", 1],
    ["Wed", "12", 2],
    ["Thu", "16", 1],
    ["Fri", "11", 2],
    ["Sat", "20", 1]
  ]
}

{
  "count": {
    "total": 1,
    "elevation": {
      "percent": 100,
      "previous": 2,
      "type": "-",
      "period": {
        "start": "2025-10-11T18:07:00Z",
        "end": "2025-10-18T18:07:00Z"
      }
    },
    "unique": 1,
    "unique_elevation": {
      "percent": 100,
      "previous": 2,
      "type": "-",
      "period": {
        "start": "2025-10-11T18:07:00Z",
        "end": "2025-10-18T18:07:00Z"
      }
    },
    "scan_qr": 0,
    "scan_url": 1
  }
}

{
  "device": [
    ["PC", 1]
  ],
  "os": [
    ["Mac OS X", 1]
  ],
  "browser": [
    ["Chrome", 1]
  ]
}

{
  "count": {
    "total": 85,
    "unique": 72
  },
  "device": [
    ["Mobile", 60],
    ["PC", 25]
  ],
  "bot_scans": {
    "total": 12,
    "unique": 5,
    "by_type": [
      ["Googlebot", 7],
      ["AhrefsBot", 5]
    ],
    "by_qr": [
      ["My Campaign QR", 10],
      ["Landing Page QR", 2]
    ]
  }
}

async function getQRAnalytics(filterBy, q, fromDate, toDate, types = 'count,device,os') {
  try {
    const response = await fetch(
      `https://management.scanova.io/analytics/qr/?from=${fromDate}&to=${toDate}&type=${types}`,
      {
        method: 'POST',
        headers: {
          'Authorization': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          filter_by: filterBy,
          q: q
        })
      }
    );
    
    if (response.ok) {
      const analytics = await response.json();
      return analytics;
    } else {
      throw new Error('Failed to fetch analytics');
    }
  } catch (error) {
    console.error('Error fetching analytics:', error);
    return null;
  }
}

// Usage - Get analytics by QR ID
const analytics = await getQRAnalytics('qrid', ['Qf94b25d768294148'], '2025-02-01', '2025-02-25');
console.log('Analytics data:', analytics);

// Usage - Get analytics by tags
const tagAnalytics = await getQRAnalytics('tags', ['marketing', 'campaign'], '2025-02-01', '2025-02-25', 'count,geography');

// Usage - Get multiple QR codes analytics
const multiAnalytics = await getQRAnalytics('qrid', ['Qf94b25d768294148', 'Qf94b25d768294149'], '2025-02-01', '2025-02-25', 'count,device,os,browser');

import requests
from datetime import datetime, timedelta

def get_qr_analytics(filter_by, q, from_date, to_date, types='count,device,os'):
    url = "https://management.scanova.io/analytics/qr/"
    headers = {
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    
    params = {
        'from': from_date,
        'to': to_date,
        'type': types
    }
    
    data = {
        'filter_by': filter_by,
        'q': q
    }
    
    try:
        response = requests.post(url, headers=headers, params=params, json=data)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error fetching analytics: {e}")
        return None

def analyze_qr_performance(qr_ids, days=30, types='count,device,os,geography'):
    """Get analytics for the last N days"""
    to_date = datetime.now().strftime('%Y-%m-%d')
    from_date = (datetime.now() - timedelta(days=days)).strftime('%Y-%m-%d')
    
    analytics = get_qr_analytics('qrid', qr_ids, from_date, to_date, types)
    if analytics:
        print(f"Analytics for QR Codes: {qr_ids}")
        print(f"Date Range: {from_date} to {to_date}")
        
        # Display analytics based on requested types
        if 'count' in types:
            print(f"\nScan Counts: {analytics.get('count', 'N/A')}")
        
        if 'device' in types:
            print(f"\nDevice Analytics: {analytics.get('device', 'N/A')}")
        
        if 'geography' in types:
            print(f"\nGeographic Analytics: {analytics.get('geography', 'N/A')}")
    
    return analytics

def get_analytics_by_tags(tags, from_date, to_date, types='count,geography'):
    """Get analytics for QR codes with specific tags"""
    return get_qr_analytics('tags', tags, from_date, to_date, types)

# Usage - Get analytics by QR ID
analytics = get_qr_analytics('qrid', ['Qf94b25d768294148'], '2025-02-01', '2025-02-25')
print("Analytics:", analytics)

# Usage - Get analytics by tags
tag_analytics = get_analytics_by_tags(['marketing', 'campaign'], '2025-02-01', '2025-02-25')

# Usage - Analyze performance for multiple QR codes
analyze_qr_performance(['Qf94b25d768294148', 'Qf94b25d768294149'], 30, 'count,device,os,browser,geography')

<?php
function getQRAnalytics($filterBy, $q, $fromDate, $toDate, $types = 'count,device,os') {
    $url = "https://management.scanova.io/analytics/qr/";
    $headers = [
        "Authorization: YOUR_API_KEY",
        "Content-Type: application/json"
    ];
    
    $params = http_build_query([
        'from' => $fromDate,
        'to' => $toDate,
        'type' => $types
    ]);
    
    $data = json_encode([
        'filter_by' => $filterBy,
        'q' => $q
    ]);
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url . '?' . $params);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode === 200) {
        return json_decode($response, true);
    } else {
        echo "Error fetching analytics: " . $response;
        return null;
    }
}

function analyzeQRPerformance($qrIds, $days = 30, $types = 'count,device,os,geography') {
    $toDate = date('Y-m-d');
    $fromDate = date('Y-m-d', strtotime("-{$days} days"));
    
    $analytics = getQRAnalytics('qrid', $qrIds, $fromDate, $toDate, $types);
    if ($analytics) {
        echo "Analytics for QR Codes: " . implode(', ', $qrIds) . "\n";
        echo "Date Range: {$fromDate} to {$toDate}\n";
        
        // Display analytics based on requested types
        if (strpos($types, 'count') !== false) {
            echo "\nScan Counts: " . json_encode($analytics['count'] ?? 'N/A') . "\n";
        }
        
        if (strpos($types, 'device') !== false) {
            echo "\nDevice Analytics: " . json_encode($analytics['device'] ?? 'N/A') . "\n";
        }
        
        if (strpos($types, 'geography') !== false) {
            echo "\nGeographic Analytics: " . json_encode($analytics['geography'] ?? 'N/A') . "\n";
        }
    }
    
    return $analytics;
}

function getAnalyticsByTags($tags, $fromDate, $toDate, $types = 'count,geography') {
    return getQRAnalytics('tags', $tags, $fromDate, $toDate, $types);
}

// Usage - Get analytics by QR ID
$analytics = getQRAnalytics('qrid', ['Qf94b25d768294148'], '2025-02-01', '2025-02-25');
echo "Analytics: " . json_encode($analytics) . "\n";

// Usage - Get analytics by tags
$tagAnalytics = getAnalyticsByTags(['marketing', 'campaign'], '2025-02-01', '2025-02-25');

// Usage - Analyze performance for multiple QR codes
analyzeQRPerformance(['Qf94b25d768294148', 'Qf94b25d768294149'], 30, 'count,device,os,browser,geography');
?>