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 enregions.include.countries.
Atributos
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.
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_targetEl 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.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.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.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, lifetimeValor 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.
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.
El evento del píxel para el que se optimiza. Un evento estándar, o cualquier nombre de evento personalizado del píxel.
Gasto dividido entre los eventos de añadir al carrito atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
Gasto dividido entre los eventos de registro completado atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
Gasto dividido entre los eventos de contacto atribuidos; null cuando los contactos no son el objetivo y no hay ninguno atribuido.
Gasto dividido entre los leads atribuidos; null cuando los leads no son un objetivo y no hay ninguno atribuido.
Gasto dividido entre las compras atribuidas; null cuando las compras no son un objetivo y no hay ninguna atribuida.
Gasto dividido entre los resultados atribuidos por el píxel de Whop; null cuando no se está optimizando para nada atribuible por Whop.
Gasto dividido entre los eventos de agendamiento atribuidos; null cuando los agendamientos no son el objetivo y no hay ninguno atribuido.
Gasto dividido entre los eventos de envío de solicitud atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
Gasto dividido entre los eventos de visualización de contenido atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.
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.
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.
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.
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
Propiedades
Franjas en las que el grupo de anuncios entrega el viernes, en orden cronológico. Se omite cuando no entrega ese día.
Propiedades
Propiedades
Franjas en las que el grupo de anuncios entrega el lunes, en orden cronológico. Se omite cuando no entrega ese día.
Propiedades
Propiedades
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
Propiedades
Franjas en las que el grupo de anuncios entrega el domingo, en orden cronológico. Se omite cuando no entrega ese día.
Propiedades
Propiedades
Franjas en las que el grupo de anuncios entrega el jueves, en orden cronológico. Se omite cuando no entrega ese día.
Propiedades
Propiedades
Franjas en las que el grupo de anuncios entrega el martes, en orden cronológico. Se omite cuando no entrega ese día.
Propiedades
Propiedades
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
Propiedades
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, activeSegmentación por edad, género y audiencia automática.
Propiedades
Propiedades
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.Costo por resultado al que apuntar (
average_target) o que nunca se debe superar (maximum_target). null para pujas minimum_cost.Plataformas de dispositivo y sistemas operativos segmentados.
Propiedades
Propiedades
Cuándo deja de entregarse el grupo de anuncios, como marca de tiempo ISO 8601.
null cuando se ejecuta hasta que se pausa.Problemas abiertos que afectan a este grupo de anuncios y a sus anuncios. Vacío cuando no hay ninguno.
Propiedades
Propiedades
El tipo de problema: información sobre la entrega, una advertencia o un error que requiere atención.Opciones disponibles:
information, warning, errorEl ID de la campaña, el grupo de anuncios o el anuncio al que está asociado el problema.
El tipo de recurso al que está asociado el problema.Opciones disponibles:
ad_campaign, ad_group, adTé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
Propiedades
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, exactSi este término impide que se muestren los anuncios en lugar de hacerlos elegibles. El valor predeterminado es
false.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.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.
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
Propiedades
Las conversiones que necesita la fase de aprendizaje de este grupo de anuncios. Puede cambiar durante la entrega.
Conversiones contadas desde la última edición significativa durante la fase de aprendizaje de este grupo de anuncios.
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.
Ubicaciones segmentadas y excluidas.
Propiedades
Propiedades
Ubicaciones excluidas de la segmentación. Los grupos de países no se pueden excluir.
Propiedades
Propiedades
Áreas circulares, cada una formada por una coordenada y un radio.
Propiedades
Propiedades
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.
Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
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.Ubicaciones que segmenta el grupo de anuncios.
Propiedades
Propiedades
Áreas circulares, cada una formada por una coordenada y un radio.
Propiedades
Propiedades
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.
Etiqueta de la ubicación, como una ciudad o una dirección. Ausente cuando la ubicación no tiene etiqueta.
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.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_conversationEl nombre del evento definido por el comerciante cuando result_event es custom; null para los eventos estándar.
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.
Valor de compra dividido entre el gasto, ambos en USD (una proporción independiente de la moneda); 0 cuando no hay gasto.
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.
Cuándo empieza a entregarse el grupo de anuncios, como marca de tiempo ISO 8601.
null cuando empieza en cuanto está activo.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, duplicatingValor 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.
Personas que hicieron clic, informadas por el píxel de Whop, contadas una vez por persona.
Cuándo se actualizó el grupo de anuncios por última vez, como marca de tiempo ISO 8601.
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.
AdGroup

