Skip to main content
Esta página documenta @whop/elements@1.10.0 y @whop/elements-react@1.10.0.
Desde v1.0.0. Se monta dentro de Ads. Créalo para obtener un handle y después monta sus elementos en ese handle. Llama a destroy() para eliminar el subcontrolador. Vuelve a crearlo para obtener un handle nuevo.

Vista previa

Una demostración en vivo e interactiva de la disposición predeterminada de este subcontrolador con datos de ejemplo:

Opciones

Pásalas a ads.create('reporting', { … }), o como props de <Reporting> en React. Las props inyectadas por el elemento padre nunca aparecen aquí.
string
El periodo sobre el que informan todas las superficies: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time o custom (combínalo con customRange). El gráfico incluye el selector y es el que lo cambia, así que un host puede controlar el periodo y leerlo de nuevo desde periodChanged. Por defecto es "last_14_days".Uno de "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" o "custom".
object | null
El periodo explícito, como instantes ISO 8601, que se usa cuando period es custom. En caso contrario, se ignora. Por defecto es null.
"account" | "local"
Zona horaria para todas las cifras de los informes. Usa account para la preferences.ads_scheduling_timezone de la cuenta o local para la zona horaria del navegador del visitante. Son las únicas opciones que ofrece el gráfico. Una zona horaria IANA libre podría hacer que el selector etiquetara los datos incorrectamente y se perdería cuando el visitante cambiara la selección. Para informar en otra zona horaria, cambia el ajuste de la cuenta. account recurre a la zona horaria del visitante cuando la cuenta no tiene ningún ajuste. Por defecto es "account".
string
Código de moneda ISO 4217 de tres letras en minúsculas para los importes convertidos, como usd o eur. Si no se establece, usa por defecto la preferences.ads_reporting_currency de la cuenta. Por defecto es "".
"last_touch" | "first_touch"
Qué punto de contacto del recorrido de un comprador recibe la atribución: last_touch, el predeterminado, o first_touch. Con ambos, un punto de contacto de Whop en cualquier parte del recorrido se lleva la atribución a Whop; el modelo solo elige los extremos. La tabla incluye el selector y es la que lo cambia, así que un host puede controlarlo y leerlo de nuevo desde attributionModelChanged. Por defecto es "last_touch".
string[]
Acota los informes a estas campañas publicitarias (adcamp_…). Si está vacío, informa sobre toda la cuenta. adGroupIds o adIds lo anulan cuando se establece cualquiera de ellos. Pasa un solo ID para obtener una cifra exacta: la API de informes acota por una única ruta de origen, así que cuando se pasa más de uno el gráfico informa solo sobre el primero. Por defecto es [].
string[]
Acota los informes a estos grupos de anuncios (adgrp_…). Tiene prioridad sobre campaignIds. Se aplica la misma advertencia sobre un solo ID. Por defecto es [].
string[]
Acota los informes a estos anuncios (ad_…). Es el filtro más restrictivo: tiene prioridad sobre los otros dos. Se aplica la misma advertencia sobre un solo ID. Por defecto es [].
"ads" | "all" | "businesses" | "campaigns" | "ad-groups"
En qué tabla se abre el elemento table: campaigns, ad-groups, ads o all para la vista de fuentes de tráfico. all siempre informa sobre toda la cuenta (la serie de fuentes solo existe a ese nivel), así que un filtro establecido junto a él acota la tabla, pero no el gráfico. Por defecto es "campaigns".
string[] | null
Sobre qué tráfico informa el gráfico, como rutas de origen: whop:* para la publicidad comprada a través de Whop, ext:* y ext:<platform>:* para anuncios publicados en otros sitios, referrer:* para el tráfico orgánico, direct, other. null, el valor predeterminado, informa solo sobre la publicidad de Whop; [] informa sobre todas las fuentes; un array no vacío informa sobre esas. Es un eje DISTINTO de campaignIds y similares, que acotan dentro de la publicidad de Whop: las ratios derivadas del gasto siguen atribuidas a Whop sea cual sea este valor, porque el gasto solo compra anuncios de Whop. La pestaña All del elemento table lo cambia. Por defecto es null.

Eventos

Pasa los callbacks en las opciones de creación o como props de React.

onEditRequested

El visitante pidió editar algo: un menú de fila, una fila en borrador o Edit ad en el overlay de detalles. campaignId siempre está presente; adGroupId y adId lo acotan a lo que pulsó. Solo se emite cuando useCampaignCreator está desactivado; si está activado, el creador se abre sobre la página y este evento no se emite.
AdsEditTarget

Métodos

Llámalos en el subhandle obtenido de ads.create('reporting', { … }).

update

Combina nuevas props y callbacks en el subcontrolador. Parámetros
Partial<ReportingSubOptions>
requerido

destroy

Destruye el subcontrolador y sus elementos y después libera su ranura exclusiva. Un create("reporting") posterior empieza de cero.

Elementos

Los elementos que monta este subcontrolador. Cada uno tiene su propia página:

ChartElement

El rendimiento de una cuenta en un periodo, con un selector de lo que se representa: gasto, impresiones, clics o cualquier conversión que registre la cuenta. Solo lectura.

TableElement

Las campañas, los grupos de anuncios y los anuncios de una cuenta publicitaria en una sola tabla, con las pestañas para moverse entre ellos: elige filas para acotar el nivel inferior, busca, ordena, desglosa las cifras, elige tus columnas y pausa, reanuda, duplica o elimina directamente desde una fila. El periodo sobre el que informa y las filas a las que está filtrada residen en el handle, así que un gráfico montado a su lado informa exactamente sobre lo mismo.