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 Tracking. accountId y accessToken provienen de ahí. Pasa las props y los callbacks a través de las opciones de creación o de las props de React.

Datos de ejemplo. Abre el Playground.

Props

string
Limita a las personas captadas por una fuente de tráfico, como una ruta de fuente: whop:adcamp_…:* para una de las campañas de la cuenta, ext:* para anuncios publicados en otro lugar, referrer:*, direct. Es el mismo valor con el que enlazan los recuentos de clics de la tabla de anuncios, así que una página puede hidratarlo directamente desde su propia URL. Por defecto es "".
string
Limita a las personas que realizaron un evento, por su nombre: payment.completed, pixel.lead, pixel.page. Por defecto es "".
string
Limita a las personas que realizaron un evento personalizado del píxel, por su nombre personalizado. Se combina con un eventName vacío. Por defecto es "".
string
Limita por el utm_source que llevaba su tráfico. Separa varios valores con comas para que coincida cualquiera de ellos. Por defecto es "".
string
Limita por código de país ISO 3166-1 alfa-2, como US o GB. Por defecto es "".
string
Limita por clase de dispositivo: desktop, mobile, tablet, bot. Por defecto es "".
string
Limita por nombre de navegador. Por defecto es "".
string
Limita por nombre de sistema operativo. Por defecto es "".
string
true solo para clientes, false para personas que nunca compraron, vacío para todos. Por defecto es "".
string
El filtro aplicado en el cuadro de búsqueda: un nombre, un email o un identificador. Por defecto es "".
string
Limita a una audiencia guardada (adaud_…) creada a partir de filtros de personas. El menú de filtro de audiencia modifica este valor. Por defecto es "".
string
Fija la ventana de eventos de los filtros source/eventName en un instante ISO 8601 exacto en lugar del period del handle. Establece tanto eventFrom como eventTo, o ninguno. Por defecto es "".
string
El final de la ventana de eventos fijada, como un instante ISO 8601. Por defecto es "".
string
La columna ordenada: name, email, ltv, purchase_count, event_count, first_seen_at, last_seen_at. Por defecto es "last_seen_at".
"asc" | "desc"
La dirección de ordenación. Por defecto es "desc".

Eventos

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

onPeriodChanged

El usuario movió la ventana desde el selector de periodo. Todas las superficies bajo el mismo handle ya la han seguido; guárdala y devuélvela como period/customRange en el handle, o la ventana se restablecerá en el siguiente montaje.
object

onAttributionModelChanged

El usuario cambió qué punto de contacto recibe el crédito, desde el menú Attribution de la fila de filtros. Todas las superficies bajo el mismo handle ya han reasignado el crédito; guárdalo y devuélvelo como attributionModel en el handle, o se revertirá en el siguiente montaje.
object

onFiltersChanged

El usuario movió un filtro, el cuadro de búsqueda o el selector de audiencia. Incluye el estado completo de los filtros, sea cual sea el que se movió: refléjalo en tu propia URL y devuélvelo como props para que la vista sea reproducible.
PeopleFilterBag

onSortChanged

El usuario ordenó una columna. Guárdalo y devuélvelo como sort/dir, o la ordenación se restablecerá en el siguiente montaje.
object

onPersonOpened

El usuario hizo clic en una fila de persona y el handle no tiene un links.person que seguir. Presenta el elemento person con él, por ejemplo createOverlay("person", { identifier: payload.personId }) (personId es la clave estable por persona; identifier es el más significativo para una persona de los que tiene la superficie), o pasa links.person en el handle para convertir las filas en enlaces reales.
object

onLoaderStart

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de onReady.

onReady

Se ejecuta después del primer pintado completo del elemento.

onError

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa code para el manejo programático. sourceKey identifica una fuente de estado del host que falló.
object

Métodos

Llámalos en el handle que devuelve create, o a través de una ref de React.

mount

Monta el elemento en target y comienza a cargarlo. Los componentes de React se montan solos. Parámetros
string | HTMLElement
requerido

destroy

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

update

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar. Parámetros
Partial<PeopleElementProps>
requerido

Estilos

Este elemento no expone nombres de clase para aplicar estilos. Usa appearance (tema, color de acento, variables) para cambiar su estilo.