Esta página documenta
@whop/elements@1.10.0 y @whop/elements-react@1.10.0.v1.0.0.
Playground
Combina los elementos con datos de ejemplo. Usa los controles, añade y organiza elementos, y observa cómo se disparan los eventos en vivo:Opciones
Pásalas awhop.tracking.create({ … }), o como props de <Tracking> en React.
ID de la cuenta, con el prefijo
biz_, cuyas personas y eventos se leen. Obligatorio. Por defecto es "".Un token con alcance limitado con el que leen ambas superficies. Genera un token para todo el handle en tu servidor con
POST /api/v1/access_tokens y establece uno nuevo con update({ accessToken }) antes de que caduque. Leer las listas requiere member:basic:read o company:basic:read; los recuentos de opciones de los menús de filtro usan además stats:read, y el filtro de audiencias guardadas de la tabla People usa audience:basic:read; sin ellos, los menús simplemente muestran menos opciones. Si se omite, las llamadas llevan la sesión propia del usuario, que solo responde en el mismo origen.Adónde llevan los enlaces de persona en tu sitio.
person es una plantilla de URL absoluta con dos marcadores, cada uno sustituido por fila con codificación URL: {personId} es el ID estable prsn_…, idéntico para la misma persona en todas las superficies, así que usa ese valor como clave de tu página y monta allí el elemento person; {identifier} es el identificador más significativo para una persona que tiene la superficie (un ID de usuario o un email cuando se conoce), por lo que puede variar entre superficies. Debe ser absoluta (https://…); una URL relativa se resolvería respecto al frame del elemento, así que se trata como no establecida. Si no se establece, un clic en una persona emite personOpened en su elemento, que es la señal para presentar person sobre tu página. Las URL base people y events se aceptan por simetría con el handle de anuncios, pero nada bajo este handle las renderiza. Por defecto es {}.La ventana que cubren ambas superficies:
today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time o custom (combínalo con customRange). Los elementos incluyen el selector y modifican este valor; léelo de vuelta 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".La ventana explícita, como instantes ISO 8601, que se usa cuando
period es custom. Se ignora en otro caso. Por defecto es null.En cuál de las dos zonas horarias se resuelve la ventana:
account, la zona horaria de programación de la propia cuenta, o local, la zona horaria en la que esté el navegador del usuario. account recurre a la del propio usuario cuando la cuenta no ha establecido ninguna. Por defecto es "account".Qué punto de contacto del recorrido de una persona recibe el crédito al filtrar por fuente:
last_touch, el predeterminado, o first_touch. Los elementos incluyen el selector y modifican este valor, así que un host puede controlarlo y leerlo de vuelta desde attributionModelChanged. Por defecto es "last_touch".Personalización visual para los elementos de este grupo. Anula el
WhopElements({ appearance }) global. Cámbiala en vivo con update({ appearance }).Configuración regional para el texto de la interfaz de los elementos de este grupo. Establécela en una de las configuraciones regionales incluidas en la app para anular la configuración global. Cualquier otro valor recurre a la configuración regional predeterminada.
Eventos
Pasa los callbacks en las opciones de creación o como props de React.onLoadingChange
Se ejecuta cuando cambia el estado de carga agrupado. El valor es true mientras algún elemento montado todavía se está cargando.
Métodos
Llámalos en el handle de Tracking obtenido dewhop.tracking.create({ … }) o useTracking().
update
Combina nuevas opciones del handle en todos los elementos montados. En React, cambia las props del namespace en su lugar.
Parámetros
destroy
Destruye todos los elementos y subcontroladores que creó este handle, elimina el frame del controlador y libera sus suscripciones. Puedes llamarlo más de una vez, pero un handle destruido rechaza cualquier otra llamada: crea un nuevo handle para empezar de nuevo. React elimina el grupo automáticamente cuando el provider se desmonta.
Elementos
Los elementos que monta este grupo. Cada uno tiene su propia página:PeopleElement
Todas las personas que ha visto la cuenta: visitantes y clientes resueltos a partir de la actividad del píxel, con su fuente, su gasto y sus contadores de actividad. Busca, filtra por fuente, evento, geografía o dispositivo, ordena cualquier columna y pasa de página. Un clic en una fila sigue
links.person cuando el handle lo configura y, si no, te llega como personOpened.EventsElement
Cada evento que midió la cuenta (vistas de página, leads, compras y eventos personalizados del píxel) como un flujo sin procesar y filtrable. Las filas que hay detrás de cualquier métrica: filtra por evento, fuente, geografía o dispositivo dentro de la ventana del handle, o busca el identificador de una persona para leer todo su recorrido. Una celda de persona sigue
links.person cuando el handle lo configura y, si no, te llega como personOpened.PersonElement
Todo lo que la cuenta sabe sobre una persona: quién es, de dónde vino, cuánto ha gastado y cada evento que ha realizado, en orden. Es la vista a la que lleva un clic en una persona: móntala en la página a la que apunta
links.person, o preséntala sobre tu propia página cuando people o events emitan personOpened. identifier acepta cualquier identificador con el que se haya visto a una persona, así que un payload de personOpened se resuelve aquí sin cambios.
