Conversions API OpenAI Ads : guide de configuration WordPress

Configurez la Conversions API OpenAI Ads sur WordPress : événements côté serveur, comparaison avec le pixel, ID d’événement, déduplication, WooCommerce, formulaires et débogage.

Dernière mise à jour: 8 septembre 2026. Rédigé par PixelBridge team.

La Conversions API OpenAI Ads fournit une méthode côté serveur pour envoyer les événements de conversion pris en charge vers les systèmes de mesure publicitaire d’OpenAI.

Sur WordPress, cela signifie généralement envoyer un événement après qu’un formulaire, une réservation ou une commande est confirmé, au lieu de s’appuyer uniquement sur un script dans le navigateur. PixelBridge est conçu pour envoyer ces événements et les coordonner avec le pixel navigateur. La connexion Conversions API fait partie des fonctionnalités Pro prévues et n’est pas encore disponible publiquement.

Qu’est-ce que la Conversions API

La Conversions API est un chemin serveur à serveur. WordPress, ou un autre backend, envoie un événement de conversion pris en charge une fois qu’il sait déjà que l’action a réussi. Le navigateur n’a pas à être le seul messager.

Ce n’est pas un second compte publicitaire, et ce n’est pas un remplacement de la configuration des campagnes. C’est une méthode de livraison des événements de mesure. Les champs de requête officiels, l’authentification et les types d’événements pris en charge se trouvent dans la documentation développeur d’OpenAI. Confirmez ces détails avant de construire un client personnalisé.

PixelBridge est indépendant d’OpenAI. Utiliser la Conversions API via le plugin ne crée pas de partenariat officiel.

Pourquoi la mesure côté serveur compte

Les pixels navigateur échouent dans des conditions ordinaires :

Le visiteur refuse les cookies de mesure
Un navigateur ou une extension bloque le script
La Content Security Policy bloque le domaine du SDK
Le client ferme la page de remerciement avant que le pixel s’exécute
Un constructeur de pages ou un plugin de cache réordonne les scripts

Un événement serveur peut encore enregistrer la conversion après que WordPress a stocké le formulaire, la réservation ou la commande. Cette robustesse est la raison d’ajouter la Conversions API. Ce n’est pas une raison d’ignorer le pixel. Les pages vues et le contexte de page d’atterrissage viennent encore du navigateur.

La livraison côté serveur ne contourne pas le consentement. Si une permission de mesure est requise, gardez l’événement serveur derrière la même permission. Voir consentement.

Pixel vs Conversions API

	Pixel navigateur	Conversions API
S’exécute où	Navigateur du visiteur	WordPress / serveur
Événements typiques	Pages vues, conversions côté client	Leads, réservations, achats confirmés
Point fort	Vitesse et contexte de page	Confirmation après que WordPress a validé l’action
Faiblesse	Facile à bloquer	Nécessite des identifiants, des ID et une gestion d’erreurs
Consentement	Doit attendre lorsque c’est requis	Doit attendre lorsque c’est requis

Vous pouvez commencer par le pixel uniquement. Ajoutez la Conversions API lorsque la livraison navigateur ne suffit pas, ou lorsque les achats et réservations ont besoin d’un signal backend confirmé. Utiliser les deux est un choix de robustesse, pas une tactique de classement.

Le guide d’installation du pixel est Pixel OpenAI Ads pour WordPress. Documentation produit : Conversions API.

Déduplication

Lorsque la même conversion est envoyée depuis le navigateur et le serveur, la mesure a besoin d’un moyen de les traiter comme une seule action. Ce mécanisme est la déduplication.

Sans elle, un checkout réussi peut devenir deux achats. Avec elle, les deux payloads portent le même ID d’événement et le système de mesure publicitaire peut fusionner la paire.

La déduplication n’est pertinente que lorsque les deux couches envoient la même conversion. Un lead serveur uniquement n’a rien à fusionner. Une page vue navigateur uniquement ne doit pas inventer un jumeau serveur.

ID d’événement

Un ID d’événement est la clé partagée d’une seule action client.

Le modèle WordPress prévu :

Au hook de succès, créez ou réutilisez un ID d’événement.
Envoyez l’événement navigateur avec cet ID, si le pixel a le droit de s’exécuter.
Envoyez l’événement serveur avec le même ID, si la Conversions API est activée et que le consentement l’autorise.
Conservez assez de l’ID dans les journaux ou le diagnostic pour déboguer un écart plus tard.

Si l’événement navigateur utilise un ID et l’événement serveur un autre, vous obtenez des doublons. Si vous réessayez un appel serveur échoué avec un nouvel ID alors que l’événement navigateur d’origine a déjà réussi, vous pouvez aussi obtenir des doublons. Gardez l’ID stable pour cette conversion.

PixelBridge est conçu pour générer ou réutiliser cet ID afin que la paire puisse être dédupliquée.

Implémentation WordPress

Une configuration Conversions API WordPress est un travail backend :

Stockez les identifiants d’API dans les réglages du plugin ou la configuration d’environnement, pas dans un fichier JavaScript public.
Écoutez des hooks WordPress confirmés, pas des clics de boutons.
Construisez un payload qui correspond à la spécification d’événement officielle actuelle.
Incluez l’ID d’événement utilisé par l’événement navigateur.
Respectez le consentement avant que la requête quitte le serveur.
Enregistrez le succès et l’échec plutôt que de réessayer à l’aveugle.

Sources typiques :

Un hook d’envoi de formulaire confirmé
Un hook de confirmation de réservation
Un statut de commande WooCommerce qui signifie que l’achat est réel

N’envoyez pas d’événements serveur depuis wp_footer sur chaque page. Cela recrée le pire d’un pixel sans aucune des valeurs de page vue.

La documentation WordPress couvre les hooks et l’architecture des plugins. Elle ne définit pas les champs d’événements OpenAI.

WooCommerce

WooCommerce est une source naturelle pour la Conversions API parce que la commande existe sur le serveur même si le client ne voit jamais le pixel de remerciement.

Lorsque le suivi des achats sera publié, l’événement devra :

Se déclencher sur le statut de commande que vous traitez comme conversion
Inclure un identifiant de commande
Inclure une valeur de conversion lorsque c’est autorisé
Partager un ID d’événement avec tout événement purchase navigateur

L’intégration WooCommerce est bientôt disponible. Elle n’est pas publiée. N’attendez pas que les commandes envoient des événements OpenAI Ads tant que ce connecteur n’existe pas ou que vous ne construisez pas un hook personnalisé vous-même.

Envois de formulaires

Les formulaires sont l’autre source côté serveur courante. Un hook de succès PHP peut envoyer lead_created après que le message est stocké, ce qui est plus fiable qu’un écouteur JavaScript sur le bouton d’envoi.

Les connecteurs de formulaires prévus (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) sont bientôt disponibles. D’ici là, une implémentation personnalisée doit se déclencher une fois par envoi réussi et ignorer les échecs de validation.

Si le formulaire déclenche aussi un événement navigateur, utilisez le même ID d’événement sur les deux.

Débogage

Déboguez le navigateur et le serveur comme une paire.

Confirmez que le chemin pixel fonctionne encore. Un pixel cassé plus une API cassée ressemble à « la CAPI est en panne » alors que le vrai problème est le consentement ou un Pixel ID qui ne correspond pas.
Déclenchez une conversion.
Vérifiez si un événement navigateur a été envoyé.
Vérifiez si un événement serveur a été envoyé.
Comparez les ID d’événement.
Inspectez la réponse serveur. Gardez les échecs visibles.

Le diagnostic d’PixelBridge est conçu pour afficher le statut de connexion de la Conversions API et le statut d’envoi des événements récents. Une alerte prévue est « l’événement navigateur a été envoyé mais l’événement serveur a échoué ». Ce contrôle est prévu, pas présenté comme déjà livré. Voir diagnostic et dépannage.

Erreurs courantes

Erreur	Ce que cela signifie généralement
Aucun événement serveur du tout	CAPI non configurée, ou le hook WordPress n’a jamais tourné
401 / échec d’authentification	Identifiants manquants, renouvelés ou stockés au mauvais endroit
Événement rejeté	Les champs du payload ne correspondent pas à la spécification officielle actuelle
Conversions en double	ID d’événement manquants ou qui ne correspondent pas
Événement serveur après refus de consentement	Consentement non appliqué au chemin backend
Événements de staging dans une propriété de production	Mauvais Pixel ID ou mauvaise destination d’API

Les noms d’événements et les champs obligatoires peuvent changer. Lorsqu’un payload est rejeté, consultez la documentation officielle d’OpenAI avant de changer les hooks WordPress.

Configuration PixelBridge

PixelBridge est conçu pour envoyer des événements Conversions API depuis WordPress et les coordonner avec les événements navigateur. Cette configuration est prévue, pas lancée.

Configuration prévue, une fois Pro disponible :

Saisissez le Pixel ID et terminez d’abord la mesure navigateur.
Ajoutez les identifiants Conversions API dans les réglages du plugin.
Activez uniquement les conversions que vous faites déjà confiance dans le navigateur, ou qui n’existent que sur le serveur.
Confirmez que le diagnostic indique une connexion et un seul envoi par action de test.

Jusqu’au lancement, rejoignez l’accès anticipé depuis la page d’accueil. Lisez fonctionnalités et tarifs pour la répartition prévue Free, Pro et Agency. Pro est le foyer prévu de la Conversions API, de la déduplication, de WooCommerce et des intégrations de réservation.

Pour le modèle de mesure plus large, poursuivez avec Suivi des conversions OpenAI Ads.