Skip to main content
Un Ad es la unidad creativa individual que entrega un grupo de anuncios. Contiene los textos, los recursos creativos y la URL de destino de un anuncio. Usa la API de Ads para listar los anuncios de una cuenta, crear anuncios dentro de grupos de anuncios, obtener o actualizar los detalles creativos, eliminar anuncios que deban dejar de ejecutarse y pausar o reanudar la entrega.

Endpoints

Atributos

string
requerido
Identificador único del anuncio, con el prefijo ad_.
object
requerido
La campaña publicitaria a la que pertenece este anuncio.

Propiedades

string
requerido
El id de la entidad referenciada.
object
requerido
El grupo de anuncios al que pertenece este anuncio.

Propiedades

string
requerido
El id de la entidad referenciada.
number
requerido
Valor en USD atribuido a los eventos de añadir al carrito. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de añadir al carrito atribuidos por el píxel de Whop, último clic.
string | null
requerido
El botón de llamada a la acción que se muestra en el anuncio.Opciones disponibles: learn_more, shop_now, sign_up, subscribe, get_started, book_now, apply_now, contact_us, download, order_now, buy_now, get_quote, message_page, whatsapp_message, instagram_message, call_now, get_directions, send_updates, get_offer, watch_more, listen_now, play_game, open_link, no_button, get_offer_view, get_event_tickets, see_menu, request_time, event_rsvp, see_details, view_instagram_profile, donate_now, see_more, visit_site
number
requerido
Clics divididos entre impresiones, entre 0 y 1.
number
requerido
El número de clics.
number
requerido
Valor en USD atribuido a los eventos de registro completado. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de registro completado atribuidos por el píxel de Whop, último clic.
number
requerido
Valor en USD atribuido a los eventos de contacto. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de contacto atribuidos por el píxel de Whop, último clic.
object
requerido
La revisión de contenido de Whop para este anuncio: si ha terminado, para qué redes publicitarias se recomienda y qué reglas de contenido incumple.

Propiedades

object[]
requerido
Si cada red puede ejecutar el anuncio. Vacío hasta que termina la revisión.

Propiedades

Si el anuncio cumple la política de contenido de Whop y la de esta red.
string
requerido
La red. whop es la propia política de contenido de Whop, que todas las demás redes también exigen.Opciones disponibles: whop, meta, tiktok, google
string
requerido
reviewed una vez que termina la revisión de contenido de Whop, in_review mientras se ejecuta, not_reviewed cuando nunca se ejecutó.Opciones disponibles: reviewed, in_review, not_reviewed
object[]
requerido
Todas las reglas que la revisión determinó que el anuncio incumple, en cualquier red. Vacío cuando no incumple ninguna o la revisión no ha terminado.

Propiedades

string
requerido
La evidencia que registró la revisión para esta regla.
string
requerido
La regla que la revisión de contenido de Whop determinó que el anuncio incumple.
number | null
requerido
Gasto dividido entre los eventos de añadir al carrito atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
number
requerido
Gasto dividido entre clics; 0 cuando no hay clics.
number | null
requerido
Gasto dividido entre los eventos de registro completado atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
number | null
requerido
Gasto dividido entre los eventos de contacto atribuidos; null cuando los contactos no son el objetivo y no hay ninguno atribuido.
number | null
requerido
Gasto dividido entre los leads atribuidos; null cuando los leads no son un objetivo y no hay ninguno atribuido.
number
requerido
Gasto por cada 1.000 impresiones; 0 cuando no hay impresiones.
number | null
requerido
Gasto dividido entre las compras atribuidas; null cuando las compras no son un objetivo y no hay ninguna atribuida.
number | null
requerido
Gasto dividido entre los resultados atribuidos por el píxel de Whop; null cuando no se está optimizando para nada atribuible por Whop.
number | null
requerido
Gasto dividido entre los eventos de agendamiento atribuidos; null cuando los agendamientos no son el objetivo y no hay ninguno atribuido.
number | null
requerido
Gasto dividido entre los eventos de envío de solicitud atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
number | null
requerido
Gasto dividido entre clics únicos; null cuando no hay clics únicos.
number | null
requerido
Gasto dividido entre los eventos de visualización de contenido atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
string
requerido
Cuándo se creó el anuncio, como marca de tiempo ISO 8601.
object[]
requerido
Los recursos creativos que usa este anuncio. El recurso original tiene un format null; las entradas square, vertical y horizontal son variantes específicas de cada ubicación. Un anuncio de carrusel devuelve una entrada con format null por cada adjunto, en orden.

Propiedades

string
requerido
El id de archivo del adjunto creativo.
object | null
requerido
El área de recorte guardada para esta creatividad, en píxeles de la imagen original. Null para el recurso original o para un formato que no se ha recortado.

Propiedades

number
requerido
Alto del área de recorte en píxeles de origen.
number
requerido
Ancho del área de recorte en píxeles de origen.
number
requerido
Borde izquierdo del área de recorte en píxeles de origen.
number
requerido
Borde superior del área de recorte en píxeles de origen.
string | null
requerido
La variante de ubicación que cubre este recurso, o null para el recurso original.Opciones disponibles: square, vertical, horizontal
string | null
requerido
Siempre null. Las traducciones ya no están disponibles.
string | null
requerido
El tipo de recurso, imagen o video.
string | null
requerido
URL del recurso en la CDN.
number
requerido
Eventos de conversión personalizados (definidos por el comerciante) atribuidos por el píxel de Whop, último clic, en todos los nombres de eventos personalizados.
object
requerido
Conversiones personalizadas atribuidas por el píxel de Whop, indexadas por el nombre de tu evento, con su recuento de último clic como valor. Vacío cuando no hay eventos personalizados con nombre atribuidos. Los eventos personalizados disparados sin nombre se cuentan en custom_conversions pero se omiten aquí, por lo que estos valores suman como máximo custom_conversions.
object
requerido
Valor de conversión atribuido a cada evento personalizado, indexado por nombre de evento como custom_event_counts. Suma el valor pasado a whop.track, normalizado a USD; los eventos disparados sin valor aportan 0.
string
requerido
Si el anuncio se está entregando ahora mismo y, si no, por qué. Cuando se aplican varios estados a la vez, se devuelve el de mayor precedencia.Opciones disponibles: rejected, in_review, draft, campaign_paused, paused, processing, revise_content, issues, scheduled, learning, active
object[]
requerido
La descripción que se muestra en el anuncio.

Propiedades

string | null
requerido
Siempre null. Las traducciones ya no están disponibles.
string
requerido
El texto que se muestra a los espectadores.
number | null
requerido
Impresiones divididas entre el alcance.
object[]
requerido
El titular que se muestra en el anuncio.

Propiedades

string | null
requerido
Siempre null. Las traducciones ya no están disponibles.
string
requerido
El texto que se muestra a los espectadores.
number
requerido
El número de impresiones.
object[]
requerido
Problemas abiertos que afectan a este anuncio. Vacío cuando no hay ninguno.

Propiedades

string
requerido
Identificador único del problema.
string
requerido
El tipo de problema: información sobre la entrega, una advertencia o un error que requiere atención.Opciones disponibles: information, warning, error
string
requerido
Una descripción de en qué consiste el problema y cómo puede resolverse.
string | null
requerido
El ID de la campaña, el grupo de anuncios o el anuncio al que está asociado el problema.
string
requerido
El tipo de recurso al que está asociado el problema.Opciones disponibles: ad_campaign, ad_group, ad
string
requerido
Un título breve del problema, orientado al creador: la regla que indica un rechazo de la revisión de contenido, o una etiqueta genérica.
number
requerido
Valor en USD atribuido a los eventos de lead. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Leads atribuidos por el píxel de Whop, último clic.
Vistas de página en tu destino de personas que hicieron clic en el anuncio, registradas por el píxel de Whop. Se cuentan de la misma forma en todas las plataformas de anuncios.
object[]
requerido
El texto principal que se muestra en el cuerpo del anuncio. Varias entradas crean variaciones de texto.

Propiedades

string | null
requerido
Siempre null. Las traducciones ya no están disponibles.
string
requerido
El texto que se muestra a los espectadores.
number
requerido
Valor en USD de las compras atribuidas por el píxel.
number
requerido
Compras atribuidas por el píxel de Whop, último clic.
number
requerido
El número de personas únicas que vieron esto.
string | null
requerido
El evento de conversión del píxel de Whop cuyo recuento atribuido representa los resultados: el objetivo de optimización, o el evento atribuido de mayor volumen en las campañas con presupuesto por grupo de anuncios. Null cuando el objetivo no es un evento atribuido por Whop.Opciones disponibles: purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom, messaging_conversation
string | null
requerido
El nombre del evento definido por el comerciante cuando result_event es custom; null para los eventos estándar.
number | null
requerido
El recuento atribuido por el píxel de Whop detrás de result_event. Cuando los grupos de anuncios de una campaña optimizan objetivos distintos no hay un único result_event (es null), y esto es en cambio la suma de los resultados atribuidos de cada grupo de anuncios. Null cuando no se está optimizando para nada atribuible por Whop.
number
requerido
Valor de compra dividido entre el gasto, ambos en USD (una proporción independiente de la moneda); 0 cuando no hay gasto.
number
requerido
Valor en USD atribuido a los eventos de agendamiento. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de agendamiento atribuidos por el píxel de Whop, último clic.
number
requerido
El importe cobrado, en spend_currency.
string | null
requerido
El código de moneda ISO 4217 de todas las métricas monetarias.
string
requerido
Si el anuncio está habilitado. active y paused los estableces tú; in_review y rejected provienen de la revisión de anuncios.Opciones disponibles: active, paused, in_review, rejected
number
requerido
Valor en USD atribuido a los eventos de envío de solicitud. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de envío de solicitud atribuidos por el píxel de Whop, último clic.
string | null
requerido
Título visible del anuncio.
number | null
requerido
Clics únicos divididos entre impresiones, entre 0 y 1.
number
requerido
Personas que hicieron clic, informadas por el píxel de Whop, contadas una vez por persona.
string
requerido
Cuándo se actualizó el anuncio por última vez, como marca de tiempo ISO 8601.
string | null
requerido
La URL a la que enlaza el anuncio, sin su cadena de consulta. Los parámetros van en url_parameters; cualquiera que envíes en url se mueve allí.
object
requerido
Parámetros de consulta añadidos a url, indexados por nombre. Los parámetros de atribución de clics de Whop están reservados.
number
requerido
Valor en USD atribuido a los eventos de visualización de contenido. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.
number
requerido
Eventos de visualización de contenido atribuidos por el píxel de Whop, último clic.
Ad