Esta página documenta
@whop/elements@1.10.0 y @whop/elements-react@1.10.0.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
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 "".Limita a las personas que realizaron un evento, por su nombre:
payment.completed, pixel.lead, pixel.page. Por defecto es "".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 "".Limita por el
utm_source que llevaba su tráfico. Separa varios valores con comas para que coincida cualquiera de ellos. Por defecto es "".true solo para clientes, false para personas que nunca compraron, vacío para todos. Por defecto es "".El filtro aplicado en el cuadro de búsqueda: un nombre, un email o un identificador. Por defecto es
"".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 "".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 "".La columna ordenada:
name, email, ltv, purchase_count, event_count, first_seen_at, last_seen_at. Por defecto es "last_seen_at".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.
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.
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.
onSortChanged
El usuario ordenó una columna. Guárdalo y devuélvelo como sort/dir, o la ordenación se restablecerá en el siguiente montaje.
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.
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ó.
Métodos
Llámalos en el handle que devuelvecreate, 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
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
Estilos
Este elemento no expone nombres de clase para aplicar estilos. Usaappearance (tema, color de acento, variables) para cambiar su estilo.
