Filter je app uit in je website analytics

Net zoals je misschien graag wilt zien hoe gebruikers met je website omgaan, wil je misschien ook weten hoe ze je app gebruiken. Dat kun je doen door te kijken naar je website analytics.

App-gebruikers filteren met user agent

De eenvoudigste manier om websitegebruikers van app-gebruikers te scheiden in je analytics is door de user agents te filteren. De user agent is een korte string die de browser naar websites stuurt. De user agent bevat informatie over de browser, een Firefox-browser zou bijvoorbeeld een volgende user agent kunnen sturen:

Door de app gebruikte user agents

De app gebruikt een paar verschillende user agents:

• $regularUserAgent App-WebView ($operatingSystem) $version
  Dit is de gebruikelijke user agent die door de interne browser van de app gebruikt wordt. Verzoeken die met deze user agent worden gedaan, worden geïnitieerd door de gebruiker van de app. Dit is de user agent die je in je analytics moet zoeken.
• App-HttpClient $version
  Dit is de user agent die gebruikt wordt voor verzoeken van de app die niet direct door de gebruiker geïnitieerd worden. De app doet hiermee bijvoorbeeld enkele verzoeken om delen van de website op te slaan voor offline gebruik.

$version is de interne versie van de app (b.v. 1.4.8+52) en $operatingSystem is het platform waarop de app gebruikt wordt (bijv. ios of android).

$regularUserAgent is de user agent van een mobiele browser die van het toestel verwacht zou worden, zoals Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148

Je hoeft je over dit alles niet echt zorgen te maken, tenzij je iets bijzonders wilt doen. Volg anders gewoon de volgende stappen om in je analytics te filteren op de user agent.

Filteren op user agent in Google Analytics

Als voorbeeld zie je hier hoe je in Google Analytics kunt filteren op user agent:

• Klik op 'Beheer' aan de linkerkant
• Klik rechts op 'Segmenten'
• Klik bovenaan op 'Nieuw Segment' en voer er een naam voor in, bijvoorbeeld 'App'.
• Klik op 'Technologie'.
• Stel het ‘Browser’ veld in op ‘bevat’ & "App-WebView". Als je een segment wilt maken voor alleen iOS-app-gebruikers, stel je het in op ‘bevat’ & "App-WebView (ios)".
• Klik op de 'save' knop bovenaan.
• Nu kun je bijna overal app gebruikers analyseren in Google Analytics, klik gewoon op 'Add segment' op een pagina waar je geïnteresseerd bent in app-gebruikersgedrag.

App-gebruikers filteren met JavaScript

Een ingewikkelder maar ook krachtigere manier om te detecteren of een gebruiker je website bezoekt met een browser of de app is met behulp van JavaScript. Dit is vooral handig als je analytics-software het filteren op user agents niet ondersteunt.

De eenvoudigste optie is het gebruik van getAppPlatform uit het app-helperscript. De functie retourneert null als de app in de browser wordt geopend, of anders het besturingssysteem waarop de app wordt gebruikt. Zoals in de documentatie vermeld staat, werkt dit echter alleen als je de app user agents laat wijzigen.

Een optie die niet afhankelijk is van user agents is executeWhenAppReady. De code daarin wordt alleen uitgevoerd als je website in de app wordt bekeken.