Skip to main content
Whop Ads diffuse des publicités payantes sur des réseaux publicitaires externes directement depuis votre compte Whop. Les dépenses publicitaires sont facturées sur la carte ou le solde configuré du compte, pour l’ensemble de ses campagnes. Whop gère le compte publicitaire, la vérification, le lancement et la facturation. Deux appels API suffisent pour passer de rien à une annonce en ligne : générer une création, puis créer la campagne, le groupe d’annonces et l’annonce en une seule requête.

Ressources

Facturation et recouvrement des paiements

Les dépenses sont prélevées au niveau du compte, pour l’ensemble des campagnes. Un paiement échoué bloque la diffusion avec delivery_status: "payment_failed" tout en conservant le status actif/en pause configuré de chaque campagne. Corrigez le moyen de paiement du compte, puis appelez Retry Failed Ads Payments une seule fois pour le compte. La réponse met en file d’attente une tentative en arrière-plan ; elle ne confirme pas le paiement. Après le règlement, les campagnes actives peuvent reprendre et les campagnes en pause restent en pause, sous réserve des autres conditions de diffusion. Consultez Payer les publicités pour le parcours dans le tableau de bord, un exemple de requête, le comportement en cas de requête en double et la gestion des anciennes campagnes.

Configuration initiale

  • Scopes : media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • Moyen de paiement publicitaire : connecté dans le tableau de bord (solde ou carte). Seul le lancement en a besoin ; les brouillons fonctionnent sans.
1

Générer une création

Facturé sur votre solde (amount_charged ; solde insuffisant → 402 avec une deposit_url). Interrogez GET /media/{id} jusqu’à ce que status soit ready, puis utilisez file.id :
failed rembourse le montant prélevé : ajustez le prompt et réessayez. Vidéo : "type": "video" plus, en option, duration_seconds (5/10/15), resolution (480p–4k) et jusqu’à 4 ID de fichiers reference_media (le premier sert de base à l’image d’ouverture).
2

Créer et lancer l'annonce — une seule requête

POST /ads avec un ad_group et un ad_campaign intégrés crée toute l’arborescence en une seule transaction et la lance :
Pas encore prêt à dépenser ? Ajoutez "status": "draft" à ad_campaign, puis lancez plus tard avec PATCH /ad_campaigns/{id} {"status": "active"}.Pour réutiliser des conteneurs existants, passez ad_group_id au lieu de ad_group, ou ad_campaign_id au lieu de ad_campaign.
3

Surveiller

Interrogez GET /ads/{id} : delivery_status correspond à l’état en direct (un bref in_review pour la modération du contenu est normal), et issues[] contient un message lisible pour tout ce que le réseau publicitaire a rejeté de manière asynchrone.Contrôlez la diffusion avec pause / unpause sur les annonces, les groupes d’annonces ou les campagnes. Modifiez le texte ou les créations avec PATCH /ads/{id} : envoyer creatives remplace l’ensemble complet, incluez donc l’entrée de base.

Erreurs

Chaque contrôle renvoie une erreur 400 dont le message indique ce qu’il faut corriger :