CrowlKit - Gebruikersgegevens

Het kan handig zijn om gegevens over het toestel van de gebruiker te kunnen opvragen. Het kan bijvoorbeeld handig zijn om te weten of de gebruiker een mobiel toestel gebruikt om de app te openen, wat de taal is, hoe breed of hoog het scherm is... 

Libaries toevoegen

Zorg dat de onderstaande libaries aanwezig zijn in de head van je pagina:

<script src="https://cdn.publihub.media/lib/app.js"></script>
<script src="https://cdn.publihub.media/lib/crowl.whois.js?v2"></script>

Gebruikersdata ophalen

Voeg nu de volgende regel toe aan je pagina of app:

<app-whois id="user"></app-whois>

Het app-whois ("who is") - element heeft één attribuut nl een uniek "id". In het bovenstaande voorbeeld gebruik ik hiervoor "user", maar je kan het om het even welke naam geven. 

Opgelet: het heeft geen zin om dit element meerdere keren in de pagina op te nemen. Eén app-whois-element is voldoende om alle beschikbare data van het systeem te tonen. 

Data opvragen

Je kan in de app-ready-functie alle data opvragen en bewaren in een "doosje" of "variabele". 

var gebruikersdata = id("user").data();
terminal(gebruikersdata);

Het is ook mogelijk om heel specifieke data op te vragen:

//bekijk je het op een mobiel toestel ja of neen?
var mobiel = id("user").isMobile();
terminal(mobiel);

//de taal van het toestel
var taal = id("user").language();
terminal(taal);

//de breedte in pixels
var breedte = id("user").width();
terminal(breedte);

//de hoogte in pixels
var hoogte = id("user").height();
terminal(hoogte);

//bekijk je het op een mobiel toestel ja of neen?
var besturingssysteem = id("user").getos();
terminal(besturingssysteem);

//bekijk je het op een mobiel toestel ja of neen?
var besturingssysteem = id("user").os();
terminal(besturingssysteem);

//bekijk je het op een mobiel toestel ja of neen?
var browser = id("user").browser();
terminal(browser);

//bekijk je het op een mobiel toestel ja of neen?
var besturingssysteem = id("user").os();
terminal(besturingssysteem);

//Portret of landschap, rotatie van het toestel
var rotatie = id("user").rotation();
terminal(rotatie);

//Unieke "vingerafdruk" van het toestel
var vingerafdruk = id("user").fingerprint();
terminal(vingerafdruk);
Opgelet: met de fingerprint bedoelen we niet de biometrische vingerafdruk die je op veel toestellen gebruikt om aan te melden. Een fingerprint is een unieke code die wordt gemaakt op basis van de unieke elementen van elk toestel. Zo kunnen we een "toestel/gebruiker" herkennen als hij/zij/x de pagina of app later opnieuw bezoekt. Zo weet je of iemand terugkeert of voor de eerste keer "op bezoek komt". 

Als je het app-scherm schaalt (het kleiner of groter maakt) wijzigen de breedte en de hoogte. Ook die wijzigende gegevens kan je opvragen:

id("user").after("resize").do(function(data){
    terminal(id("user").height() + " " + id("user").width());
});

Data bewaren in de "Sky"

Als je een API-key hebt, kan je de data, zoals de fingerprint, ook bewaren in de "Crowl Sky". 

Volgende pagina