Hoe u uw websiteanalyses zelf kunt hosten met plausibel

0
115

Plausible is een open-source alternatief voor Google Analytics. Het is beschikbaar als een commercieel gehost product en als gratis zelfgehoste software. In deze gids laten we u zien hoe u Plausible instelt en inzicht krijgt in het verkeer van uw website.

Overzicht

Plausible richt zich op privacy, eenvoud en bruikbare statistieken. Het voldoet aan de GDPR-, CCPA- en PECR-wetgeving. Aannemelijk plaatst geen cookies op uw bezoekers & # 8217; apparaten, dus je hebt geen opdringerige privacybanners op je startpagina nodig.

Het plausibele webdashboard heeft een minimaal ontwerp waarmee je bezoekersaantallen, totale paginaweergaven, bouncepercentages en bezoekduur kunt zien. Er zijn ook overzichtsgegevens over landen van herkomst, verwijzende bronnen en apparaattypen van bezoekers.

Om Plausible zelf te hosten, heb je Docker en Docker Compose nodig. Plausibel is beschikbaar op Docker Hub als plausibel/analyse, maar er zijn extra containers nodig om de databaseservers te laten draaien. Het wordt aanbevolen om het officiële Docker Compose-bestand in de plausible/hosting GitHub-repository te gebruiken om aan de slag te gaan.

Plausible installeren

Zorg ervoor dat & # 8217; Git, Docker en Docker Compose zijn geïnstalleerd. Begin met het klonen van de plausibele/hosting-repository:

git clone https://github.com/plausible/hosting cd hosting

De repository bevat vooraf voorbereide configuratiebestanden waarmee je snel een nieuwe Plausibele installatie kunt opstarten. Het docker-compose.yml-bestand zou klaar moeten zijn voor gebruik. Het koppelt de afhankelijkheidscontainers aan de hoofdplausibele app-container.

Aannemelijk zal worden getoond op poort 8000 op uw host. Als u de voorkeur geeft aan een andere poort, zoals 8800, zoek dan de regel ports: in de plausibele sectie van docker-compose.yml. Verander de volgende regel van – 8000: 8000 naar – 8800: 8000 om hostpoort 8800 te binden aan de containerpoort 8000.

Open vervolgens plausible-conf.env in je editor. Dit is het configuratiebestand voor de Plausible applicatieserver. Het bevat vijf standaardinstellingen. Ze definiëren het domein van de server en stellen een eerste beheerder in.

Vervang de ADMIN_USER_EMAIL, ADMIN_USER_NAME en ADMIN_USER_PWD waarden door respectievelijk uw e-mailadres, naam en wachtwoord. Uw wachtwoord moet minimaal zes tekens lang zijn. Stel BASE_URL in op het domein waarop uw plausibele server zal worden gehost. U kunt http: //localhost: 8000 gebruiken voor lokale tests.

De laatste aanpassing aan de configuratie is om een ​​geheime sleutel te bieden om het authenticatiesysteem van Plausible te beschermen. Genereer een willekeurige tekenreeks en voeg deze toe als de waarde SECRET_KEY_BASE. De tekenreeks moet 64 tekens lang zijn. Je kunt openssl rand gebruiken om een ​​veilige waarde te creëren:

openssl rand -base64 64

Nu ben je klaar om Plausible te starten!

docker-compose up -d

Het kan enkele seconden voor Docker om de containerinstallatiekopieën op te halen en alle services te starten. Zodra het pull-proces is voltooid, voert u docker logs hosting_plausible_1 –follow uit om te controleren of de bootstrap is voltooid.

Bezoek http: //localhost: 8000 in uw browser wanneer u & # 8220; succesvolle migraties & # 8221; verschijnen in de logboeken. U zou het plausibele inlogscherm moeten zien. Log in met het e-mailadres en wachtwoord dat u heeft geconfigureerd.

U wordt gevraagd om uw account te activeren. Het activeringsproces stuurt u een verificatiecode via e-mail. De standaardconfiguratie omvat geen functionerende uitgaande e-mail, dus het is het beste om deze fase handmatig over te slaan.

Voer de volgende opdracht uit in uw terminal:

docker exec hosting_plausible_db_1 psql – U postgres -d plausible_db -c “UPDATE gebruikers SET email_verified = true;”

Dit voert een gewone SQL-query uit op de Plausible-database. De vraag zal de in behandeling zijnde verificatiemarkering van elke gebruiker wissen.

Keer terug naar http: //localhost: 8000 in uw browser. U zou nu het plausibele dashboard moeten zien. Het zal leeg zijn aangezien u geen sites heeft toegevoegd.

Uw website verbinden met plausibel

Een enkele plausibele server kan gegevens verzamelen van meerdere onafhankelijke websites. U moet het Plausible-dashboard gebruiken om elke site die u bewaakt te registreren. Vervolgens voegt u het plausibele JavaScript-trackingscript toe aan de HTML van uw site. Dit rapporteert elke paginaweergave aan uw plausibele server. Het verkleinde trackingscript weegt minder dan 1 KB.

Klik op & # 8220; Website toevoegen & # 8221; in het plausibele dashboard. U moet wat basisinformatie over uw site opgeven. Voer de domeinnaam root in als example.com, zonder een subdomeinvoorvoegsel. Hierdoor kunnen statistieken van zowel example.com als www.example.com worden verzameld door dezelfde site-eigenschap. Kies een geschikte tijdzone om te gebruiken bij het berekenen van rapporten.

Klik op het & # 8220; Fragment toevoegen & # 8221; om uw instellingen te bevestigen. Aannemelijk zal het & # 8217; s & lt; script & gt; tag-fragment. Voeg de code toe aan de & lt; head & gt; gedeelte van de HTML van uw website. Elke pagina die wordt geladen, downloadt het script en rapporteert de statistieken terug naar Plausible.

& lt;! DOCTYPE html & gt; & nbsp; & lt; html & gt; & lt; hoofd & gt; & lt; meta charset = & quot; utf-8 & quot;/& gt; & lt; title & gt; Mijn website & lt;/title & gt; & lt; script async defer data-domain = & quot; example.com & quot; src = & quot; http: //localhost: 8000/js/plausible.js & quot; & gt; & lt;/script & gt; & lt;/head & gt; & nbsp; & lt; lichaam & gt; & lt; h1 & gt; Voorbeeldwebsite & lt;/h1 & gt; & lt;/body & gt; & lt;/html & gt;

Aannemelijk werkt niet met localhost-domeinen. Als u wilt testen tegen een site die op uw computer draait, overweeg dan om/etc/hosts te gebruiken om er een tijdelijk domein aan toe te wijzen:

127.0.0.1 foobar.net

Registreer foobar.net als uw sitedomein in Plausible , ga dan naar foobar.net in uw browser. Uw website zou moeten worden weergegeven en de treffers zullen in Plausible verschijnen.

Zodra u klaar bent met het opzetten van uw siteverbinding, klikt u op Plausible & # 8217; s & # 8220; Beginnen met het verzamelen van gegevens & # 8221; knop om het dashboard van uw site te bezoeken.

Plausible verkennen

Plausible & # 8217; s simplistische gebruikersinterface geeft u in één oogopslag een snel overzicht van de prestaties van uw site. Belangrijke statistieken zoals het totale aantal paginaweergaven en unieke bezoekers worden bovenaan het scherm weergegeven. Verderop in uw dashboard ziet u lijsten met uw best presterende pagina's, externe verwijzers en apparaattypen van bezoekers. Gegevens tonen standaard de laatste 30 dagen; u kunt dit wijzigen met de vervolgkeuzelijst in de rechterbovenhoek.

Om toegang te krijgen tot uw site-instellingen, klikt u op de sitenaam in de linkerbovenhoek. Druk op & # 8220; Site-instellingen & # 8221; in het dropdown-menu. Hier kunt u de configuratie van uw site beheren.

De & # 8220; zichtbaarheid & # 8221; sectie kunt u uw dashboard openbaar zichtbaar maken, zonder in te loggen op Plausible. U kunt ook unieke deelbare links genereren die u naar specifieke mensen kunt verspreiden.

< p> De & # 8220; doelen & # 8221; sectie biedt een basismechanisme voor het volgen van doelen/gebeurtenissen. U kunt doel-URI's definiëren, zoals/checkout-complete, die Plausible zal volgen.

Creëer doelen door naar de & # 8220; doelen & # 8221; en klik op & # 8220; Doel toevoegen & # 8221; en het invullen van het formulier om een ​​pagina-URI te leveren om bij te houden. Wanneer een gebruiker de URI bezoekt, wordt deze weergegeven onder & # 8220; Doelconversies & # 8221; onderaan uw dashboard.

E-mail instellen

De & # 8220; e-mailrapporten & # 8221; Met het item met site-instellingen kunt u zich aanmelden voor wekelijkse siteprestatierapporten en meldingen van ongebruikelijke verkeerspieken. Deze werken niet tenzij u Plausible de juiste instellingen voor uitgaande e-mail verstrekt.

Aannemelijk kan worden verzonden via een SMTP-server of de transactionele e-mailservice Postmark. Om SMTP te gebruiken, werkt u uw plausible-conf.env bij met de volgende aanvullende instellingen:

  • MAILER_EMAIL & # 8211; E-mailadres dat Plausible zal verzenden als
  • SMTP_HOST_ADDR & # 8211; SMTP-server om verbinding mee te maken (bijv. Localhost)
  • SMTP_HOST_PORT & # 8211; SMTP-serverpoort
  • SMTP_USER_NAME & # 8211; Gebruikersnaam om verbinding te maken als
  • SMTP_USER_PWD & # 8211; Wachtwoord voor levering aan de SMTP-server (indien nodig)
  • SMTP_HOST_SSL_ENABLED & # 8211; Ofwel waar of niet waar om aan te geven of SSL moet worden gebruikt voor SMTP-verbindingen.

Als je Postmark wilt gebruiken, zorg er dan eerst voor dat je een Postmark-account en API-sleutel hebt. Werk vervolgens plausible-conf.env bij met de volgende instellingen:

MAILER_ADAPTER = Bamboo.PostmarkAdapter POSTMARK_API_KEY = & lt; uw api-sleutel & gt;

Zodra u klaar bent met het aanpassen van uw plausibele configuratie, voert u docker-compose up -d uit om de wijzigingen toe te passen en uw containers opnieuw te starten. U zou nu de e-mailfuncties van Plausible & # 8217; s moeten kunnen gebruiken.

Landgegevens inschakelen

Plausible & # 8217; s dashboard bevat een kaart widget die de landen laat zien waar uw bezoekers vandaan komen. Deze gegevens zijn niet standaard ingeschakeld. Het is afhankelijk van de
database, die niet wordt gedistribueerd met Plausible zelf.

U hebt een GeoLite2-account nodig om de geolocatiefuncties van Plausible te activeren. Als u een account aanmaakt, worden een account-ID en licentiesleutel geproduceerd. Vervang deze waarden door de variabelen GEOIPUPDATE_ACCOUNT_ID en GEOIPUPDATE_LICENSE_KEY in uw geoip/geoip.conf-bestand.

Gebruik vervolgens de volgende opdracht om een ​​GeoLite2-databasecontainer toe te voegen aan uw Plausible stack:

docker-compose – f docker-compose.yml -f geoip/docker-compose.geoip.yml up

Docker zal de GeoLite database ophalen en beschikbaar maken voor de Plausible container. Toekomstige paginaweergavegebeurtenissen moeten dan geolocatiegegevens bevatten die zichtbaar zijn op het Plausible-dashboard.

Samenvatting

Plausible is een eenvoudig website-analysesysteem dat u zelf kunt gastheer. Hiermee kunt u het bereik van uw site inspecteren zonder afhankelijk te zijn van een externe service. Gebruikers worden niet op het web gevolgd of gefrustreerd door cookiebanners.

Je kunt updaten naar toekomstige plausibele versies door git pull en docker-compose up -d –pull uit te voeren. Hiermee wordt uw actieve serverinstantie bijgewerkt zodat deze overeenkomt met de nieuwste plausibele afbeelding die is gepubliceerd naar Docker Hub.