Conceptos
Eventos e ingresos
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
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.
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.