# Piwik PRO

Piwik PRO kan Google Analytics 4 vervangen als bron van uw analyticsgegevens: organisch verkeer, verkeer van AI-assistenten, doelen en e-commercebestellingen. Semactic leest deze gegevens en wijzigt nooit iets in Piwik PRO. De koppeling verloopt per markt: selecteer het juiste project en de juiste markt in de bovenste balk voordat u begint.

## Een API-sleutel aanmaken in Piwik PRO

### Uw profiel openen
Open in Piwik PRO het menu en daarna uw profiel (klik op uw e-mailadres).

### De sleutel aanmaken
Ga naar **API keys** en klik op **Create a key**. Geef de sleutel een naam, bijvoorbeeld "Semactic".

### De client-ID en het clientgeheim kopiëren
Kopieer ze meteen: Piwik PRO toont het geheim maar één keer.

> [!NOTE]
> De sleutel leest wat zijn gebruiker ziet: maak hem aan met een gebruiker die minstens leestoegang tot de site heeft.

## Semactic koppelen

### De sleutel invullen
Klik in **Integration** op **Connect** op de kaart **Piwik PRO**. Vul het **Piwik PRO address** in (bijvoorbeeld `uw-account.piwik.pro`; u kunt het adres uit uw browser plakken, alles na het domein wordt genegeerd), de **Client ID** en het **Client secret**, en klik daarna op **Connect Piwik PRO**.

### De site kiezen
Selecteer bij **Piwik PRO site** de site die door deze markt wordt gevolgd.

### Het trackingtype instellen
Kies **Conversion** (en daarna maximaal 30 doelen bij **Select goals**), **Revenue** of **Transaction**.

### Opslaan
Klik op **Save site**. De gegevens verschijnen na de volgende import.

> [!WARNING]
> Een markt gebruikt maar één analyticsbron. Voedt Google Analytics 4 de dashboards al, dan meldt de kaart dat: door de Piwik PRO-site op te slaan schakelt de markt over op Piwik PRO.

Het geheim wordt versleuteld bewaard en wordt nooit meer getoond. Laat het veld leeg wanneer u opnieuw verbindt met hetzelfde adres en dezelfde client-ID, om het opgeslagen geheim te behouden. **Unlink** verwijdert de gekozen site; **Disconnect** verwijdert de API-sleutel en stopt de import. Reeds geïmporteerde gegevens blijven in uw dashboards.

## Probleemoplossing

| Melding | Waarschijnlijke oorzaak |
|---------|-------------------------|
| No Piwik PRO account answered at that address | Controleer het adres, in de vorm `uw-account.piwik.pro`. |
| Piwik PRO refused this client ID and secret | Een van beide is onvolledig, of de API-sleutel is verwijderd. |
| This API key cannot read the site | Geef de gebruiker van de sleutel minstens leestoegang tot de site in Piwik PRO. |
| Piwik PRO says this account has no valid licence for the API | Het Piwik PRO-account heeft geen toegang tot de API: neem contact op met Piwik PRO. |
| Piwik PRO is rate-limiting us | Wacht een minuut en probeer het opnieuw. |
