API 문서

분석

분석 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 주소에서 파생되며 대략적인 도시 수준의 정확성을 제공합니다.

분석 내보내기

스프레드시트나 BI 도구에서 추가 분석을 위해 CSV로 분석 데이터를 내보냅니다.

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"

다음 단계

관련 기능에 대해 알아보세요:

분석