Qué puedes crear
- Ejecutar campañas con un objetivo, un presupuesto y una programación.
- Segmentar una audiencia por ubicación, datos demográficos, intereses, dispositivos e idiomas, o subir una lista de clientes como una audiencia.
- Generar creatividades como imágenes o videos con IA a partir de un prompt, aportar tus propios recursos o promocionar una publicación que ya existe en una cuenta externa conectada.
- Consultar el rendimiento atribuido: gasto, resultados, costo por resultado y retorno de la inversión publicitaria, todo en el propio objeto de campaña.
Países a los que no puedes dirigirte
Whop no permite que las campañas se dirijan a estos países:
Las solicitudes para crear un grupo de anuncios o actualizar sus países objetivo se rechazan si incluyen alguno de estos códigos. Elimínalos de tus ubicaciones objetivo antes de enviar la solicitud.
Antes de gastar
Dos requisitos condicionan un anuncio activo, y ambos son configuraciones únicas:- Un método de pago conectado en el panel, ya sea tu saldo de Whop o una tarjeta. Los borradores funcionan sin uno.
- El píxel de Whop en tu destino, a menos que envíes tráfico a una página de tienda de whop.com. Cualquier página de destino externa necesita primero el píxel.
Objetos principales
Campaña publicitaria, grupo de anuncios, anuncio, audiencia. Cada uno se define en Conceptos principales. La publicidad tiene una sola jerarquía, y cada objeto pertenece al nivel superior.Contiene el objetivo y la estrategia de presupuesto. Consulta Campañas publicitarias.
Contiene la segmentación, el objetivo de optimización, la programación y, de forma predeterminada, su propio presupuesto. Consulta Grupos de anuncios.
Contiene las creatividades, las variantes de texto, la llamada a la acción y la URL de destino. Consulta Anuncios.
POST /ads acepta un ad_group en línea, que a su vez acepta un ad_campaign en línea, por lo que una sola solicitud crea todo el árbol en una única transacción. Pasa ad_group_id en su lugar para asociar el anuncio a un grupo de anuncios que ya existe.
Para lanzar más tarde en lugar de ahora, establece status en draft en el ad_campaign en línea y luego actívalo con PATCH /ad_campaigns/{id}.
El presupuesto vive exactamente en un nivel, nunca en ambos: en el grupo de anuncios de forma predeterminada, o en la campaña cuando estableces budget_optimization en ad_campaign.
Cómo se cuentan los resultados
Cada métrica de rendimiento que reporta Whop se atribuye mediante el píxel de Whop, no mediante la red publicitaria.result_event indica el evento de conversión con el que se evalúa una campaña, y results es el recuento de ese evento atribuido por el píxel. cost_per_result divide el gasto entre ese recuento. Cuando los grupos de anuncios de una campaña optimizan hacia objetivos diferentes, no hay un único result_event, por lo que es null y results pasa a ser la suma de los resultados atribuidos de cada grupo de anuncios. Cuando no se optimiza nada atribuible por Whop, ambos son null en lugar de cero.
Costo deseado por resultado
Eldesired_cost_per_result de una campaña es el costo por resultado, en USD, que quieres que alcance. Es solo un objetivo: no es un límite de costo ni un límite de puja, y no cambia la forma en que pujan los anuncios de la campaña. Los afiliados que ejecutan la campaña lo ven como el costo por resultado al que deben apuntar. El desired_cost_per_result propio de un grupo de anuncios es un ajuste diferente: ese sí es su límite de costo o límite de puja. Establece el desired_cost_per_result de la campaña en null para eliminar el objetivo.
Pago de los anuncios
El gasto se acumula a medida que se entregan los anuncios y se cobra después. La facturación pertenece a la cuenta, abarcando todas sus campañas. Cada cobro combina el gasto no pagado elegible de las campañas en un solo pago usando los métodos de pago de anuncios configurados en la cuenta. No configuras un método de pago independiente ni solicitas un reintento independiente para cada campaña. El campospend de una campaña es el importe que se te cobra, en spend_currency.
El momento del cobro depende del gasto acumulado y de los umbrales de facturación. La consolidación no significa un pago por día. La generación de creatividades con IA usa su propio pago con saldo. Un saldo insuficiente devuelve un 402 que incluye una deposit_url.
Cuando falla un pago
Un fallo de pago de la cuenta bloquea la entrega en todas sus campañas facturables. Cada campaña afectada reportadelivery_status: "payment_failed", mientras que su status configurado sigue siendo active o paused. Lee delivery_status para determinar si una campaña puede entregarse, e issues para conocer el motivo del fallo.
La cuenta no puede activar campañas mientras tenga fallos de pago sin resolver. Aún puedes pausar una campaña para que siga desactivada después de recuperar el pago. Whop también programa reintentos automáticos. Puedes solicitar un reintento después de corregir el método de pago.
Reintentar un pago
- En el panel de anuncios de tu cuenta, selecciona Update payment method en el banner de pago fallido, o abre la configuración de anuncios y selecciona Billing. Actualiza la tarjeta de la cuenta o recarga el saldo que utiliza.
- Selecciona Retry payment una vez para la cuenta. Las integraciones con la API deben llamar a Reintentar pagos de anuncios fallidos con el ID
biz_de la cuenta y el permisoad_campaign:update. - Espera el intento en segundo plano. Una respuesta
202conqueued: trueconfirma que el trabajo fue aceptado, no que el pago se haya realizado correctamente. Consulta las campañas publicitarias de la cuenta para ver el resultado. - Tras una liquidación exitosa, el bloqueo de pago se elimina. La entrega puede mostrar
processingmientras se recalcula y sincroniza. Las campañas configuradas como activas pueden reanudarse si se cumplen sus demás requisitos de entrega. Las campañas configuradas como pausadas permanecen pausadas.
2026-09-22. A partir de 2026-09-22, devuelve 410 Gone. Usa el endpoint de cuenta indicado arriba.
Las campañas más antiguas cuyo status configurado ya era payment_failed vuelven a paused después de un reintento exitoso, porque no se conservó su ajuste anterior de activa/pausada.
Por qué una campaña no se está entregando
delivery_status responde esto directamente. Es el primer campo que debes leer cuando una campaña existe pero no ocurre nada. Varios estados pueden ser verdaderos a la vez, por lo que el valor es el más alto en esta escala:
Los anuncios y los grupos de anuncios tienen su propio
delivery_status con valores diferentes. Un anuncio nuevo pasa por in_review antes de entregarse.
Próximos pasos
Crear y lanzar un anuncio
El flujo completo, de la creatividad al anuncio activo, en dos llamadas.
Instalar el píxel
Necesario antes de poder atribuir resultados.
Crear una audiencia
Sube una lista de clientes para segmentarla o excluirla.
Referencia de anuncios
Todos los endpoints de publicidad, con un playground.

