Skip to main content
Un Ad Group se encuentra dentro de una campaña publicitaria y controla la entrega de los anuncios. Define la audiencia, la programación y el presupuesto de sus anuncios. Usa la API de Ad Groups para crear grupos de anuncios en campañas, listar u obtener la configuración de segmentación y entrega, actualizar presupuestos o segmentación, eliminar grupos que deban dejar de ejecutarse y pausar o reanudar la entrega.

Endpoints

Restricciones de segmentación

Los grupos de anuncios no pueden segmentar los países indicados en la guía de publicidad. Las solicitudes para crear un grupo de anuncios o actualizar sus países segmentados se rechazan si incluyen un país bloqueado en regions.include.countries.

Atributos

string
requerido
Identificador único del grupo de anuncios, con el prefijo adgrp_.
object
requerido
La campaña publicitaria a la que pertenece este grupo de anuncios.

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.
object
requerido
Audiencias guardadas a las que este grupo de anuncios entrega o que excluye.

Propiedades

string[]
requerido
IDs de las audiencias guardadas excluidas de la entrega, con el prefijo adaud_.
string[]
requerido
IDs de las audiencias guardadas a las que entrega el grupo de anuncios, con el prefijo adaud_.
string | null
requerido
Cómo se establecen las pujas de entrega en la subasta de anuncios. Las estrategias basadas en objetivos usan desired_cost_per_result.Opciones disponibles: minimum_cost, average_target, maximum_target
number | null
requerido
El presupuesto de este grupo de anuncios en USD, la moneda en la que se almacena y se factura. null cuando el presupuesto se establece en la campaña.
number | null
requerido
El mismo presupuesto expresado en budget_currency al tipo de cambio de hoy, para mostrarlo en la moneda de informes de anuncios de la cuenta. null cuando budget_amount lo es.
string
requerido
El código ISO 4217 en el que está budget_amount_local: la preferencia ads_reporting_currency de la cuenta. usd a menos que la cuenta la haya cambiado.
string | null
requerido
Si budget_amount se gasta por día (daily) o durante toda la duración del grupo de anuncios (lifetime). Un grupo de anuncios lifetime también necesita ends_at, al menos 24 horas después de su inicio.Opciones disponibles: daily, lifetime
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.
string | null
requerido
El evento del píxel para el que se optimiza. Un evento estándar, o cualquier nombre de evento personalizado del píxel.
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 grupo de anuncios, como marca de tiempo ISO 8601.
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.
object | null
requerido
Horas en las que el grupo de anuncios entrega cada semana, indexadas por día. Se omiten los días en que no entrega. null cuando entrega a todas horas. Algunas plataformas necesitan un budget_type lifetime para una programación, en el grupo de anuncios o en su campaña cuando la campaña tiene el presupuesto.

Propiedades

object[]
Franjas en las que el grupo de anuncios entrega el viernes, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el lunes, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el sábado, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el domingo, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el jueves, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el martes, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
object[]
Franjas en las que el grupo de anuncios entrega el miércoles, en orden cronológico. Se omite cuando no entrega ese día.

Propiedades

string
requerido
Cuándo se detiene la entrega, como hora en formato de 24 horas HH:00 hasta 24:00 para la medianoche. Posterior a start; una franja que pasa de la medianoche se divide en dos días.
string
requerido
Cuándo empieza la entrega, como hora en formato de 24 horas HH:00 de 00:00 a 23:00.
string
requerido
Si los anuncios de este grupo se están entregando ahora mismo y, si no, por qué. Cuando se aplican varios estados a la vez, se devuelve el de mayor precedencia.Opciones disponibles: all_ads_rejected, rejected, draft, campaign_paused, paused, in_review, processing, revise_content, issues, scheduled, completed, learning, active
object
requerido
Segmentación por edad, género y audiencia automática.

Propiedades

boolean
requerido
Si la segmentación automática de audiencia está activada. Cuando es true, la entrega puede ir más allá de las edades y géneros que estableces, tratándolos como sugerencias.
string
requerido
Género segmentado.Opciones disponibles: all, male, female
number | null
requerido
Edad máxima segmentada. null cuando no hay máximo establecido.
number | null
requerido
Edad mínima segmentada. null cuando no hay mínimo establecido.
number | null
requerido
Costo por resultado al que apuntar (average_target) o que nunca se debe superar (maximum_target). null para pujas minimum_cost.
object
requerido
Plataformas de dispositivo y sistemas operativos segmentados.

Propiedades

object[]
requerido
Sistemas operativos segmentados. Vacío segmenta todos los sistemas operativos.

Propiedades

string
Versión mínima del sistema operativo segmentada, como 18.0. Ausente cuando cualquier versión es válida.
string
requerido
Sistema operativo segmentado.Opciones disponibles: ios, android
string[]
requerido
Tipos de dispositivo segmentados. Vacío segmenta todos los dispositivos.Opciones disponibles: mobile, desktop
string | null
requerido
Cuándo deja de entregarse el grupo de anuncios, como marca de tiempo ISO 8601. null cuando se ejecuta hasta que se pausa.
number | null
requerido
Impresiones divididas entre el alcance.
number
requerido
El número de impresiones.
object[]
requerido
Problemas abiertos que afectan a este grupo de anuncios y a sus anuncios. 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.
object[]
Términos de búsqueda para los que pueden mostrarse los anuncios de este grupo, y términos para los que nunca se muestran. Solo campañas de búsqueda, donde cada grupo de anuncios necesita al menos uno antes del lanzamiento.

Propiedades

string
requerido
Qué tan exacta debe ser la coincidencia de una búsqueda: broad también alcanza búsquedas relacionadas, phrase requiere el significado de la frase y exact requiere el mismo significado que el término. El valor predeterminado es broad.Opciones disponibles: broad, phrase, exact
boolean
requerido
Si este término impide que se muestren los anuncios en lugar de hacerlos elegibles. El valor predeterminado es false.
string
requerido
El término de búsqueda, de hasta 80 caracteres y 10 palabras.
string[]
requerido
Idiomas segmentados, como códigos ISO 639 como en o es. Una configuración regional específica de una región sin código ISO aparece como una clave de configuración regional numérica. Vacío segmenta todos los idiomas.
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.
object | null
requerido
Progreso hacia las conversiones que necesita la fase de aprendizaje de este grupo de anuncios. Null salvo que esté en aprendizaje o en aprendizaje limitado y haya recuentos válidos disponibles. Alcanzar el umbral no determina el estado de entrega.

Propiedades

integer
requerido
Las conversiones que necesita la fase de aprendizaje de este grupo de anuncios. Puede cambiar durante la entrega.
integer
requerido
Conversiones contadas desde la última edición significativa durante la fase de aprendizaje de este grupo de anuncios.
number
requerido
Conversiones divididas entre el umbral, como porcentaje limitado a 0–100. El delivery_status del grupo de anuncios sigue siendo la referencia.
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.
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.
object
requerido
Ubicaciones segmentadas y excluidas.

Propiedades

object
requerido
Ubicaciones excluidas de la segmentación. Los grupos de países no se pueden excluir.

Propiedades

object[]
requerido
Ciudades, indexadas por la taxonomía de ubicaciones.

Propiedades

string
requerido
La clave de la ciudad en la taxonomía de ubicaciones.
string
Nombre de la ciudad, como Austin. Ausente cuando la taxonomía de ubicaciones no tiene ninguno.
string[]
requerido
Países, como códigos ISO 3166-1 alfa-2 como US.
string[]
requerido
Grupos de varios países, como worldwide o europe.
object[]
requerido
Áreas circulares, cada una formada por una coordenada y un radio.

Propiedades

string
País ISO 3166-1 alfa-2 en el que se encuentra el punto. Envíalo en una categoría especial de anuncios, donde la campaña debe declarar los países a los que llegan sus conjuntos de anuncios.
string
requerido
Unidad de radius.Opciones disponibles: mile, kilometer
number
requerido
Latitud del punto central.
number
requerido
Longitud del punto central.
string
Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
number
requerido
Radio alrededor del punto central, en distance_unit.
string[]
requerido
Estados de EE. UU. y DC, como códigos ISO 3166-2 como US-CA. Los territorios de EE. UU. (PR, GU, VI, AS, MP) y cualquier lugar fuera de EE. UU. se segmentan mediante countries.
string[]
requerido
Códigos ZIP y postales, indexados como COUNTRY:CODE, como US:78756.
object
requerido
Ubicaciones que segmenta el grupo de anuncios.

Propiedades

object[]
requerido
Ciudades, indexadas por la taxonomía de ubicaciones.

Propiedades

string
requerido
La clave de la ciudad en la taxonomía de ubicaciones.
string
Nombre de la ciudad, como Austin. Ausente cuando la taxonomía de ubicaciones no tiene ninguno.
string[]
requerido
Países, como códigos ISO 3166-1 alfa-2 como US.
string[]
requerido
Grupos de varios países, como worldwide o europe.
object[]
requerido
Áreas circulares, cada una formada por una coordenada y un radio.

Propiedades

string
País ISO 3166-1 alfa-2 en el que se encuentra el punto. Envíalo en una categoría especial de anuncios, donde la campaña debe declarar los países a los que llegan sus conjuntos de anuncios.
string
requerido
Unidad de radius.Opciones disponibles: mile, kilometer
number
requerido
Latitud del punto central.
number
requerido
Longitud del punto central.
string
Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
number
requerido
Radio alrededor del punto central, en distance_unit.
string[]
requerido
Estados de EE. UU. y DC, como códigos ISO 3166-2 como US-CA. Los territorios de EE. UU. (PR, GU, VI, AS, MP) y cualquier lugar fuera de EE. UU. se segmentan mediante countries.
string[]
requerido
Códigos ZIP y postales, indexados como COUNTRY:CODE, como US:78756.
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 | null
requerido
Cuándo empieza a entregarse el grupo de anuncios, como marca de tiempo ISO 8601. null cuando empieza en cuanto está activo.
string
requerido
Si el grupo de anuncios está habilitado. active y paused los estableces tú; rejected significa que no superó la revisión de anuncios; duplicating es una copia que todavía se está completando.Opciones disponibles: active, paused, rejected, duplicating
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
Nombre visible del grupo de anuncios.
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 grupo de anuncios por última vez, como marca de tiempo ISO 8601.
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.
AdGroup