Skip to main content
La publicité vous permet d’acheter des annonces sur des réseaux publicitaires externes depuis votre compte Whop. Whop détient le compte publicitaire, le processus de vérification et de lancement, ainsi que la relation de facturation. Vous créez une campagne via l’API au lieu de connecter un compte publicitaire que vous gérez vous-même.

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.
La vue d’ensemble de l’API Ads couvre chacun de ces points avec les appels exacts, les scopes requis et les messages d’erreur que vous obtenez lorsque l’un d’eux manque.

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.
adcamp_
Contient l’objectif et la stratégie de budget. Voir Campagnes publicitaires.
adgrp_
Contient le ciblage, l’objectif d’optimisation, le calendrier et, par défaut, son propre budget. Voir Groupes d’annonces.
ad_
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é

Le desired_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 champ spend 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 indique delivery_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

  1. 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.
  2. 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 permission ad_campaign:update.
  3. Attendez la tentative en arrière-plan. Une réponse 202 avec queued: true confirme 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.
  4. Après un règlement réussi, le blocage de paiement est levé. La diffusion peut afficher processing pendant 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.
Les requêtes répétées alors qu’une nouvelle tentative du compte est en file d’attente ou en cours renvoient une erreur vous demandant de patienter. Si le paiement échoue à nouveau, la diffusion reste bloquée : vérifiez la raison de l’échec et corrigez le moyen de paiement avant de réessayer. Ne parcourez pas les campagnes pour relancer chacune d’elles. L’ancien endpoint de nouvelle tentative par campagne met toujours en file d’attente une nouvelle tentative du compte sur les versions de l’API antérieures à 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.