Ce que vous pouvez créer
- Lancez des campagnes avec un objectif, un budget et un calendrier.
- Ciblez une audience par localisation, données démographiques, centres d’intérêt, appareils et langues, ou importez une liste de clients en tant qu’audience.
- Générez des créations sous forme d’images ou de vidéos IA à partir d’un prompt, fournissez vos propres ressources, ou mettez en avant une publication qui existe déjà sur un compte externe connecté.
- Consultez les performances attribuées : dépenses, résultats, coût par résultat et retour sur dépenses publicitaires, le tout directement sur l’objet campagne.
Pays que vous ne pouvez pas cibler
Whop n’autorise pas les campagnes à cibler les pays suivants :
Les requêtes de création d’un groupe d’annonces ou de mise à jour de ses pays ciblés sont rejetées si elles incluent l’un de ces codes. Retirez-les de vos localisations ciblées avant d’envoyer la requête.
Avant de dépenser
Deux éléments conditionnent la diffusion d’une annonce, et tous deux ne se configurent qu’une seule fois :- Un moyen de paiement connecté dans le tableau de bord, soit votre solde Whop, soit une carte. Les brouillons fonctionnent sans.
- Le pixel Whop sur votre destination, sauf si vous envoyez le trafic vers une page de boutique whop.com. Toute page de destination externe nécessite d’abord le pixel.
Objets principaux
Campagne publicitaire, groupe d’annonces, annonce, audience. Chacun est défini dans Concepts clés. La publicité suit une seule hiérarchie, et chaque objet appartient au niveau supérieur.Contient l’objectif et la stratégie de budget. Voir Campagnes publicitaires.
Contient le ciblage, l’objectif d’optimisation, le calendrier et, par défaut, son propre budget. Voir Groupes d’annonces.
Contient les créations, les variantes de texte, l’appel à l’action et l’URL de destination. Voir Annonces.
POST /ads accepte un ad_group en ligne, qui accepte lui-même un ad_campaign en ligne, de sorte qu’une seule requête crée toute l’arborescence en une seule transaction. Passez plutôt ad_group_id pour rattacher l’annonce à un groupe d’annonces existant.
Pour lancer plus tard plutôt que maintenant, définissez status sur draft dans l’ad_campaign en ligne, puis activez-la avec PATCH /ad_campaigns/{id}.
Le budget se situe à un seul niveau, jamais aux deux : sur le groupe d’annonces par défaut, ou sur la campagne lorsque vous définissez budget_optimization sur ad_campaign.
Comment les résultats sont comptabilisés
Chaque indicateur de performance rapporté par Whop est attribué par le pixel Whop, et non par le réseau publicitaire.result_event désigne l’événement de conversion sur lequel une campagne est évaluée, et results en est le nombre attribué par le pixel. cost_per_result divise les dépenses par ce nombre. Lorsque les groupes d’annonces d’une campagne optimisent vers des objectifs différents, il n’existe pas de result_event unique : il vaut donc null et results devient la somme des résultats attribués de chaque groupe d’annonces. Lorsque rien d’attribuable par Whop n’est optimisé, les deux valent null plutôt que zéro.
Coût par résultat souhaité
Ledesired_cost_per_result d’une campagne est le coût par résultat, en USD, que vous souhaitez atteindre. Il s’agit uniquement d’un objectif : ce n’est ni un plafond de coût ni un plafond d’enchère, et il ne modifie pas la façon dont les annonces de la campagne enchérissent. Les affiliés qui gèrent la campagne le voient comme le coût par résultat à viser. Le desired_cost_per_result propre à un groupe d’annonces est un paramètre différent : celui-ci correspond à son plafond de coût ou d’enchère. Définissez le desired_cost_per_result de la campagne sur null pour supprimer l’objectif.
Payer les publicités
Les dépenses s’accumulent au fil de la diffusion des annonces et sont facturées ensuite. La facturation appartient au compte, pour l’ensemble de ses campagnes. Chaque encaissement regroupe les dépenses de campagne impayées éligibles en un seul paiement, à l’aide des moyens de paiement publicitaires configurés pour le compte. Vous ne configurez pas de moyen de paiement distinct et ne demandez pas de nouvelle tentative séparée pour chaque campagne. Le champspend d’une campagne correspond au montant qui vous est facturé, en spend_currency.
Le moment de l’encaissement dépend des dépenses accumulées et des seuils de facturation. Le regroupement ne signifie pas un paiement par jour. La génération de créations par IA utilise son propre paiement sur le solde. Un solde insuffisant renvoie une erreur 402 contenant une deposit_url.
Lorsqu’un paiement échoue
Un échec de paiement du compte bloque la diffusion de toutes ses campagnes facturables. Chaque campagne concernée indiquedelivery_status: "payment_failed", tandis que son status configuré reste active ou paused. Lisez delivery_status pour déterminer si une campagne peut être diffusée, et issues pour connaître la raison de l’échec.
Le compte ne peut pas activer de campagnes tant qu’il a des échecs de paiement non résolus. Vous pouvez toujours mettre une campagne en pause pour qu’elle reste désactivée après le rétablissement du paiement. Whop planifie également des nouvelles tentatives automatiques. Vous pouvez demander une nouvelle tentative après avoir corrigé le moyen de paiement.
Relancer un paiement
- Dans le tableau de bord Ads de votre compte, sélectionnez Update payment method dans la bannière de paiement échoué, ou ouvrez les paramètres Ads et sélectionnez Billing. Mettez à jour la carte du compte ou approvisionnez le solde qu’il utilise.
- Sélectionnez Retry payment une seule fois pour le compte. Les intégrations API doivent appeler Retry Failed Ads Payments avec l’ID
biz_du compte et la permissionad_campaign:update. - Attendez la tentative en arrière-plan. Une réponse
202avecqueued: trueconfirme que la tâche a été acceptée, et non que le paiement a réussi. Consultez les campagnes publicitaires du compte pour connaître le résultat. - Après un règlement réussi, le blocage de paiement est levé. La diffusion peut afficher
processingpendant son recalcul et sa synchronisation. Les campagnes configurées comme actives peuvent reprendre si leurs autres conditions de diffusion sont remplies. Les campagnes configurées en pause restent en pause.
2026-09-22. À partir de 2026-09-22, il renvoie 410 Gone. Utilisez l’endpoint de compte ci-dessus.
Les anciennes campagnes dont le status configuré était déjà payment_failed repassent à paused après une nouvelle tentative réussie, car leur précédent réglage actif/en pause n’a pas été conservé.
Pourquoi une campagne n’est pas diffusée
delivery_status répond directement à cette question. C’est le premier champ à consulter lorsqu’une campagne existe mais que rien ne se passe. Plusieurs états peuvent être vrais simultanément ; la valeur est donc la plus haute sur cette échelle :
Les annonces et les groupes d’annonces ont leur propre
delivery_status avec des valeurs différentes. Une nouvelle annonce passe par in_review avant d’être diffusée.
Pour aller plus loin
Créer et lancer une annonce
Le parcours complet, de la création à l’annonce en ligne, en deux appels.
Installer le pixel
Requis avant que les résultats puissent être attribués.
Créer une audience
Importez une liste de clients à cibler ou à exclure.
Référence Ads
Tous les endpoints publicitaires, avec un playground.

