Ga naar hoofdinhoud

Aan de slag

Welkom bij Divine Data (d8a)! Deze gids helpt je om aan de slag te gaan met d8a, een open-source clickstream-analyticsplatform dat volledig compatibel is met de GA4-trackingprotocollen.

Cloud-optie beschikbaar

Je kunt beginnen met onze gratis cloud-optie. Bezoek de aanmeldpagina om een account aan te maken. Nadat je je account hebt ingesteld, kun je direct doorgaan naar stap 4.

Vereisten:

  • Basiskennis van Unix (bestanden, mappen aanmaken, enzovoort)
  • Unix-shell (Linux, macOS, WSL, enzovoort)
  • Docker geïnstalleerd met het commando docker compose

Stap 1: Maak een configuratiebestand aan​

Maak eerst een configuratiebestand aan (meer over de configuratieopties lees je in de configuratiereferentie):

cat > config.yaml <<EOF
sessions:
  timeout: 10s # Pas dit na de testfase aan naar een productiewaarde

warehouse:
  driver: clickhouse
  clickhouse:
    host: clickhouse
    port: "9000"
    database: d8a
    username: default
    password: "verySecuredD8aDatabase"

protocol: ga4 # Stel in op 'd8a' bij gebruik van de d8a-webtracker en het /d/c-endpoint
EOF
notitie

Als je een andere opslag wilt gebruiken, raadpleeg dan het artikel warehouses.

Stap 2: Bereid de runtime voor​

cat > docker-compose.yml <<EOF
services:
  clickhouse:
    image: clickhouse/clickhouse-server:latest
    container_name: clickhouse
    restart: unless-stopped
    ports:
      - "8123:8123"  # HTTP-interface
      - "9000:9000"  # Native protocol
    volumes:
      - clickhouse-data:/var/lib/clickhouse
    environment:
      - CLICKHOUSE_DB=d8a
      - CLICKHOUSE_USER=default
      - CLICKHOUSE_PASSWORD=verySecuredD8aDatabase
    networks:
      - d8a-network

  d8a:
    image: ghcr.io/d8a-tech/d8a:latest
    container_name: d8a
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/config.yaml:ro
      - d8a-data:/storage
    command: server --config /config.yaml
    networks:
      - d8a-network
    depends_on:
      - clickhouse

networks:
  d8a-network:
    driver: bridge

volumes:
  d8a-data:
  clickhouse-data:
EOF

Stap 3: Start de applicatie​

Start ten slotte d8a:

docker compose up -d
docker compose logs -f

Je d8a-instantie zou nu beschikbaar moeten zijn op http://localhost:8080. Je kunt nu een test-trackingverzoek naar je d8a-instantie sturen:

curl "http://localhost:8080/g/collect?v=2&tid=14&dl=https%3A%2F%2Ffoo.bar&en=page_view&cid=ag9" -X POST

Wacht ongeveer 10 seconden en controleer vervolgens je ClickHouse op de opgeslagen sessie.

Je d8a-serveropstelling is nu compleet. Als je een domein wilt koppelen en SSL wilt gebruiken, heb je een reverse proxy zoals Nginx nodig. Bronnen voor het opzetten van reverse proxy's vind je in de Nginx-documentatie of de Apache HTTP Server-documentatie.

Stap 4: Tracking instellen​

Nadat d8a draait, is de volgende stap om trackingverkeer naar je d8a-endpoint te sturen. Zo leg je analyticsgegevens vast op je eigen infrastructuur, terwijl je compatibel blijft met de GA4-trackingprotocollen.

We raden aan te beginnen met GA4-events onderscheppen. Als die aanpak niet bij jouw opstelling past, kun je een andere integratieoptie kiezen uit de sectie Bronnen in de zijbalk.

Volgende stappen​

Nadat je alle stappen hebt voltooid:

  • Controleer of events worden ontvangen door je d8a-instantie in het warehouse van jouw keuze
  • Voor BigQuery kun je het officiële Data Studio-dashboard kopiëren
  • Voor de lokale CSV-optie bekijk je de gegenereerde bestanden in ./csv-out
  • Voor de files-warehousedriver raadpleeg je de gids voor de files-warehousedriver voor de uploadbestemmingsopties (S3/MinIO, GCS of lokaal bestandssysteem)
  • Bekijk het databaseschema om de datastructuur te begrijpen