# Convrail pour WooCommerce

> L’extension Convrail connecte votre boutique WooCommerce en trois étapes : connecter la boutique, coller vos identifiants OpenAI, laisser les produits se synchroniser. Le pixel est ajouté au pied de page, les commandes payées sont transmises une seule fois avec l’attribution capturée au paiement, et le catalogue est synchronisé par lots. Validation, regroupement, reprises et flux s’exécutent sur la plateforme Convrail, pas sur votre serveur.

Canonical: https://convrail.com/fr/plateformes/woocommerce/

## Installation

1. **Installez et activez l’extension** Nécessite WordPress 6.0 ou plus récent et PHP 7.4 ou plus récent. Compatible avec le stockage haute performance des commandes de WooCommerce.
2. **Connectez la boutique** Dans WooCommerce, ouvrez Convrail et cliquez sur Connecter. L’extension enregistre votre boutique auprès du pont et conserve un jeton à portée limitée.
3. **Collez vos identifiants OpenAI** Votre identifiant de pixel et votre jeton Conversions API, depuis l’Ads Manager d’OpenAI. Ils sont validés en direct et stockés chiffrés sur la plateforme, pas dans votre base WordPress.
4. **Laissez le catalogue se synchroniser** Les produits sont envoyés par lots de 50 à chaque passage du cron jusqu’à synchronisation complète, puis tenus à jour.

## Ce que l’extension fait sur votre site


| Composant | Comportement |
| --- | --- |
| Pixel | Script de pied de page : capture `oppref` dans l’URL d’atterrissage vers un cookie first-party, envoie les événements navigateur à OpenAI et les relaie à Convrail avec le même identifiant |
| Capture atterrissage et referrer | Conserve l’URL d’atterrissage et le referrer dans des cookies pour attribuer la commande au paiement, même quand le referrer a disparu |
| Commandes | Au paiement, la commande est transmise une fois avec l’attribution capturée (un marqueur `_ocl_pushed` empêche les doublons) ; l’événement de paiement utilise `order_<id>` |
| Catalogue | Produits et variations sont convertis vers le modèle de flux et envoyés par lots ; une synchronisation complète peut être lancée depuis les réglages |
| Désinstallation | Retire les options et les événements planifiés ; rien ne reste derrière |

L’extension est volontairement légère : elle ne valide, ne regroupe ni ne rejoue rien sur votre serveur, elle ne peut donc ni ralentir votre paiement ni remplir votre base de données.

## Compatibilité

- WordPress 6.0 ou plus récent, testé jusqu’à 6.8.
- PHP 7.4 ou plus récent.
- WooCommerce avec ou sans stockage haute performance des commandes.
- Fonctionne avec votre extension de gestion du consentement : le pixel lit l’état de consentement de la boutique avant de se déclencher.

## Questions fréquentes

### L’extension ralentit-elle ma boutique ?

Non. Elle ajoute un petit script au pied de page et transmet commandes et lots de produits de façon asynchrone. Validation, regroupement et reprises s’exécutent sur la plateforme Convrail.

### Où sont stockés mes identifiants OpenAI ?

Sur la plateforme Convrail, chiffrés au repos. L’extension ne conserve que le jeton de pont nécessaire pour dialoguer avec la plateforme.

### Est-ce compatible avec le checkout classique et le checkout par blocs ?

Oui. Le suivi des commandes utilise des hooks WooCommerce côté serveur déclenchés au paiement, indépendants du type de checkout.

### Est-elle sur WordPress.org ?

La publication est en cours. Pendant l’accès anticipé, l’extension est distribuée directement ; demandez-la via la page de contact.