Ressource PageView

Dernière mise à jour Oct 17, 2025

Les documents PageView suivent chaque fois qu’une page d’atterrissage hébergée liée à un QR code est consultée. Utilisez cette ressource pour surveiller l’engagement sur les expériences hébergées par Twilee.


Représentation de la ressource

Chaque vue de page enregistre le moment où la page d’atterrissage a été chargée, quel QR code a généré la vue et le pays déduit du visiteur. Les entrées sont renvoyées de la plus récente à la plus ancienne.

{
  "id": "68d12b6e7df5d4583403a912",
  "datetime": "2025-09-21T17:05:11+00:00",
  "qrCode": "/qr_codes/68cdbbe0ed096c7b590277c6",
  "country": "FR"
}

Référence des champs

Champ Type Description
id string Identifiant unique de l’entrée de vue de page.
datetime datetime Horodatage ISO 8601 indiquant quand la page d’atterrissage a été consultée.
qrCode string IRI du QR code dont la page a été visitée.
country `string null`

Remarque : Les champs internes tels que l’adresse IP, le fuseau horaire et l’agent utilisateur sont conservés pour l’analytique mais ne figurent pas dans la réponse API.


Lister les PageViews — GET /qr_codes/{id}/page-views

Retournez l’historique des vues de page pour un QR code appartenant à votre équipe. Les résultats sont triés par datetime décroissant.

curl -X GET "https://api.twilee.com/qr_codes/68cdbbe0ed096c7b590277c6/page-views" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Accept: application/json"

Réponse (JSON-LD)

{
  "@context": "/contexts/PageView",
  "@id": "/qr_codes/68cdbbe0ed096c7b590277c6/page-views",
  "@type": "Collection",
  "totalItems": 3,
  "member": [
    {
      "@id": "/page_views/68d12b6e7df5d4583403a912",
      "@type": "PageView",
      "datetime": "2025-09-21T17:05:11+00:00",
      "qrCode": "/qr_codes/68cdbbe0ed096c7b590277c6",
      "country": "FR"
    }
  ]
}

Paginez les enregistrements supplémentaires avec le paramètre page :

GET /qr_codes/{id}/page-views?page=2

La pagination suit la configuration par défaut d’API Platform.