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.