Skip to main content

Access Logs

Access logs let you track who views your tags, when they access them, and from where. Essential for security monitoring and compliance.

Enabling Access Logging​

Per-Tag Logging​

  1. Open the tag
  2. Go to Settings → Security
  3. Toggle Access Logging on
  4. Choose logging level:
    • Basic - Timestamp, device type
    • Detailed - IP, location, referrer

Account-Wide Logging​

Enable for all tags:

  1. Go to Account → Security
  2. Toggle Default Access Logging
  3. Applies to new tags automatically

Viewing Access Logs​

For a Single Tag​

  1. Open the tag
  2. Click Analytics → Access Log
  3. View chronological list of accesses

For All Tags​

  1. Go to Dashboard → Activity
  2. View access across all your tags
  3. Filter by date, tag, or access type

Log Entry Information​

Each entry shows:

  • Timestamp - Exact time of access
  • Device - Mobile, desktop, tablet
  • Browser - Chrome, Safari, Firefox, etc.
  • Location - City, region, country (approximate)
  • IP Address - Network address (detailed logging)
  • Referrer - How they found the tag
  • Duration - Time spent viewing

Log Filters​

Filter Options​

  • Date range - Last 24h, 7 days, 30 days, custom
  • Device type - Mobile only, desktop only
  • Location - By country or region
  • Access type - QR scan, direct link, shared link
  • User - Specific viewer (if authenticated)

Saved Filters​

Save frequently used filters:

  1. Set your filter criteria
  2. Click Save Filter
  3. Name it (e.g., "This week's mobile scans")
  4. Access quickly from filter dropdown

Understanding Access Data​

Access Types​

TypeDescription
QR ScanScanned QR code with camera
DirectTyped or pasted URL
Shared LinkClicked shared link
EmbedViewed in embedded iframe
APIAccessed via API

Location Data​

Location is determined by IP address:

  • Accuracy: City level (approximate)
  • VPN users show VPN location
  • Mobile networks may show carrier location
  • Some locations are "Unknown"

Device Information​

  • Operating System - iOS, Android, Windows, Mac, Linux
  • Browser - Chrome, Safari, Firefox, Edge, etc.
  • Device Type - Phone, tablet, laptop, desktop
  • Screen Size - Viewport dimensions

Alerts and Notifications​

Set Up Access Alerts​

Get notified of specific access patterns:

  1. Go to Account → Notifications
  2. Click Access Alerts
  3. Create alert rules:
    • New location
    • Multiple failed attempts
    • After-hours access
    • Specific tags accessed

Alert Types​

  • New Location - Access from new country/region
  • High Volume - Unusual spike in accesses
  • Failed Password - Multiple wrong password attempts
  • Time-Based - Access outside defined hours

Exporting Logs​

Download Log Data​

  1. Open access logs
  2. Set date range and filters
  3. Click Export
  4. Choose format:
    • CSV - Spreadsheet compatible
    • JSON - For programmatic use
    • PDF - Report format

Scheduled Reports​

Automate log exports:

  1. Go to Account → Reports
  2. Click Schedule Report
  3. Choose frequency (daily, weekly, monthly)
  4. Set format and recipients
  5. Reports are emailed automatically

Privacy Compliance​

GDPR Considerations​

Access logs may contain personal data:

  • IP addresses
  • Location data
  • Device identifiers

Ensure:

  • Privacy policy mentions logging
  • Data retention policies set
  • User consent if required
  • Ability to delete logs

Data Retention​

Configure how long logs are kept:

  1. Go to Account → Security
  2. Set Log Retention Period
  3. Options: 30, 90, 180, 365 days
  4. Older logs are automatically deleted

Anonymization​

For less sensitive tracking:

  1. Enable Anonymized Logging
  2. IP addresses are truncated
  3. Location is generalized
  4. Still get aggregate data

Use Cases​

Security Monitoring​

Watch for:

  • Unusual access locations
  • Access attempts after hours
  • Failed password attempts
  • Spikes in activity

Compliance Auditing​

Demonstrate:

  • Who accessed what, when
  • Chain of custody for documents
  • Access control effectiveness
  • Investigation trails

Usage Analytics​

Understand:

  • How often tags are scanned
  • Where users access from
  • Peak usage times
  • Device preferences

API Access​

Access logs programmatically:

# Get access logs for a tag
curl https://api.tagd-ai.com/v1/tags/{id}/logs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G \
  -d "start_date=2024-01-01" \
  -d "end_date=2024-01-31"

Response includes all log entries within the date range.

Troubleshooting​

No Log Entries​

  • Verify logging is enabled
  • Check date range filter
  • Ensure tag has been accessed
  • Wait for log processing (up to 1 hour)

Missing Location Data​

  • VPNs may hide real location
  • Some IPs can't be geolocated
  • Mobile networks may show carrier HQ
  • Private/corporate networks may block

Inaccurate Device Info​

  • Some browsers hide info
  • User-agent spoofing
  • Older browsers may not be recognized
  • Updates improve detection

Next Steps​