# Eventos e ingresos

URL: https://traqio.app/es/docs/concepts/events-and-revenue
Last updated: 2026-10-14

Qué nombres de evento optimizan Meta y TikTok, cómo llegan los ingresos de compra a Traqio — desde el SDK, RevenueCat y AdMob — y cómo se calcula el ROAS.

Un **evento** es algo que un usuario hizo en tu app después de instalarla — registrarse, empezar una prueba, comprar algo. Los eventos llevan un **valor** y una **moneda** opcionales; los que tienen valor son ingresos. Traqio une cada evento con la instalación que lo generó, y esa unión es lo que convierte una campaña en un retorno de la inversión publicitaria.

## Nombres de evento

Meta y TikTok optimizan las campañas sobre sus propios eventos estándar. Cuando Traqio reenvía un evento, traduce los nombres de abajo al nombre estándar de cada red; la comparación no distingue mayúsculas de minúsculas e ignora los espacios de los extremos.

| Envías | Meta recibe | TikTok recibe |
| --- | --- | --- |
| purchase | fb_mobile_purchase | CompletePayment |
| signup | fb_mobile_complete_registration | CompleteRegistration |
| registration | fb_mobile_complete_registration | CompleteRegistration |
| subscribe | Subscribe | Subscribe |
| trial | StartTrial | StartTrial |
| add_to_cart | fb_mobile_add_to_cart | AddToCart |
| checkout | fb_mobile_initiated_checkout | InitiateCheckout |
| add_payment_info | fb_mobile_add_payment_info | tal cual se envía |
| search | fb_mobile_search | tal cual se envía |
| content_view | fb_mobile_content_view | tal cual se envía |
| level_achieved | fb_mobile_level_achieved | tal cual se envía |
| tutorial_complete | fb_mobile_tutorial_completion | tal cual se envía |

> **No envíes tu catálogo de analítica** Un nombre fuera de esta lista se guarda y aparece en tus informes, y llega a las redes como un evento personalizado por el que ninguna campaña puede pujar. Asigna tus nombres internos (offer_purchased, pack_opened) a este vocabulario en el punto de llamada, y envía a Traqio los eventos sobre los que una campaña debe optimizar.

## De dónde vienen los ingresos

| Fuente | Qué es | ¿Verificado? |
| --- | --- | --- |
| El SDK — track("purchase", { value, currency }) | el importe que declara tu app | no: el SDK no lee ningún recibo |
| Webhook de RevenueCat | suscripciones y compras in-app, renovaciones y reembolsos, de servidor a servidor | sí: desde la tienda, a través de RevenueCat |
| AdMob | ingresos publicitarios por impresión, desde el callback de evento pagado de AdMob | estimado por AdMob |

Las apps que venden a través de RevenueCat deberían seguir midiendo la compra desde el SDK cuando puedan: en iOS es lo que mueve el valor de conversión de SKAdNetwork, que debe definirse en el dispositivo antes de que se cierre la ventana de Apple — un webhook de servidor llega demasiado tarde para eso.

## Contar una compra una sola vez

Una compra que reporta tu app *y* que reporta RevenueCat es el mismo dinero. Para contarla una sola vez, pasa el identificador de la compra en la tienda — el `transactionId` de StoreKit, el `orderId` de Google Play — como `transactionId`. Traqio archiva entonces el evento bajo la misma clave que deriva el envío de RevenueCat para esa transacción, y prevalece el importe verificado.

```ts
Traqio.track("purchase", {
  value: 9.99,
  currency: "EUR",
  transactionId: purchase.transactionId, // StoreKit transactionId / Play orderId
});
```

Sin él, no se pueden asociar los dos y la compra se cuenta dos veces; la consola lo señala. El campo `transactionId` está disponible en los SDK de React Native, Expo y Capacitor; en los demás, reporta las compras solo a través de RevenueCat.

## Reembolsos, sandbox y tráfico de prueba

- Los **reembolsos** recibidos de RevenueCat se registran como ingresos negativos en la misma instalación, así que todos los totales los descuentan. Un reembolso no es una conversión y nunca se reenvía a las redes.
- Las **compras en sandbox** y las **impresiones de prueba de AdMob** se muestran en la consola, para que veas que la conexión funciona, y nunca se cuentan ni se reenvían.

## Cómo se calcula el ROAS

El **ROAS** (retorno de la inversión publicitaria) son los ingresos atribuidos divididos entre la inversión publicitaria, para la misma campaña, conjunto de anuncios o anuncio, en los mismos días. La inversión se obtiene a diario de las cuentas publicitarias de Meta y TikTok conectadas; los ingresos son lo que han generado las instalaciones que trajo cada campaña. El ROAS se calcula desde la primera instalación — no hay volumen mínimo.

### Días y moneda

- Cada producto tiene una **zona horaria** y una **moneda de reporte** — UTC y dólares estadounidenses salvo que se hayan definido otras. Cada día de cada informe se corta en esa zona horaria; cambiarla vuelve a cortar el histórico en el momento de la lectura, no se reescribe nada.
- Los importes se convierten a la moneda de reporte con el tipo de cambio de su propio día. Un importe cuyo día no tiene tipo de cambio se muestra en su propia moneda y nunca se suma con otro — un hueco se puede recuperar, una cifra errónea pero verosímil no.
- Los ingresos de SKAdNetwork se modelan a partir de un valor de conversión de seis bits y se reportan aparte; nunca entran en los ingresos medidos ni en el ROAS.

Los informes de cohortes cuentan desde el día 0, el propio día de la instalación. Algunos proveedores empiezan en el día 1; Traqio dice qué convención usa en lugar de dejarte comparar dos cifras construidas de forma distinta.

## Preguntas frecuentes

**¿Puedo enviar cualquier nombre de evento a Traqio?**
Sí — cada nombre se guarda y se reporta. Pero solo los nombres del vocabulario de Traqio (purchase, signup, subscribe, trial, add_to_cart, checkout y algunos más) se traducen a los eventos estándar de Meta y de TikTok. Cualquier otro nombre llega a las redes como evento personalizado, sobre el que ninguna campaña puede optimizar.

**¿Cómo calcula Traqio el ROAS?**
El ROAS son los ingresos atribuidos divididos entre la inversión publicitaria, para la misma campaña, conjunto de anuncios o anuncio y los mismos días. Los ingresos son lo que han generado las instalaciones que trajo una campaña — compras desde el SDK y desde RevenueCat, ingresos publicitarios de AdMob —, en bruto, en la moneda de reporte de la app. La inversión se obtiene a diario de las APIs de marketing de Meta y TikTok.

**¿Los ingresos son brutos o netos de comisiones de la tienda?**
Brutos: lo que pagó el comprador, antes de la comisión del App Store o de Google Play y antes de impuestos. Los porcentajes de comisión e impuestos recibidos de RevenueCat se guardan pero nunca se aplican, porque los tramos de comisión de las tiendas varían según el programa, la región y la antigüedad de la suscripción, y una cifra neta estimada sería errónea de formas que nadie podría ver.