# Piwik PRO

Piwik PRO peut remplacer Google Analytics 4 comme source de vos données d'analytics : trafic organique, trafic venant des assistants IA, objectifs et commandes e-commerce. Semactic lit ces données et ne modifie jamais rien dans Piwik PRO. La connexion se fait par marché : sélectionnez le bon projet et le bon marché dans la barre du haut avant de commencer.

## Créer une clé API dans Piwik PRO

### Ouvrir votre profil
Dans Piwik PRO, ouvrez le menu, puis votre profil (cliquez sur votre adresse e-mail).

### Créer la clé
Allez dans **API keys** et cliquez sur **Create a key**. Donnez-lui un nom, par exemple « Semactic ».

### Copier le client ID et le client secret
Copiez-les tout de suite : Piwik PRO n'affiche le secret qu'une seule fois.

> [!NOTE]
> La clé lit ce que voit son utilisateur : créez-la avec un utilisateur qui a au moins un accès en lecture au site.

## Connecter Semactic

### Renseigner la clé
Dans **Integration**, cliquez sur **Connecter** sur la carte **Piwik PRO**. Saisissez l'**Adresse Piwik PRO** (par exemple `votre-compte.piwik.pro` ; vous pouvez coller l'adresse depuis votre navigateur, tout ce qui suit le domaine est ignoré), le **Client ID** et le **Client secret**, puis cliquez sur **Connecter Piwik PRO**.

### Choisir le site
Dans **Site Piwik PRO**, sélectionnez le site suivi par ce marché.

### Définir le type de suivi
Choisissez **Conversion** (puis jusqu'à 30 objectifs dans **Sélectionner des objectifs**), **Revenu** ou **Transaction**.

### Enregistrer
Cliquez sur **Enregistrer le site**. Les données apparaissent après le prochain import.

> [!WARNING]
> Un marché n'utilise qu'une seule source d'analytics. Si Google Analytics 4 alimente déjà ses dashboards, la carte vous le signale : enregistrer le site Piwik PRO fait passer le marché sur Piwik PRO.

Le secret est stocké chiffré et n'est plus jamais affiché. Lors d'une reconnexion à la même adresse avec le même client ID, laissez-le vide pour garder celui déjà enregistré. **Délier** retire le site choisi ; **Déconnecter** supprime la clé API et arrête l'import, les données déjà importées restant dans vos dashboards.

## Dépannage

| Message | Cause probable |
|---------|----------------|
| Aucun compte Piwik PRO ne répond à cette adresse | Vérifiez l'adresse, de la forme `votre-compte.piwik.pro`. |
| Piwik PRO a refusé ce client ID et ce secret | L'un des deux est incomplet, ou la clé API a été supprimée. |
| Cette clé API ne peut pas lire le site | Donnez à son utilisateur au moins un accès en lecture au site dans Piwik PRO. |
| Pas de licence valide pour l'API | Le compte Piwik PRO n'a pas accès à l'API : voyez avec Piwik PRO. |
| Piwik PRO limite nos requêtes | Attendez une minute et réessayez. |
