Traqio.

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íasMeta recibeTikTok recibe
purchasefb_mobile_purchaseCompletePayment
signupfb_mobile_complete_registrationCompleteRegistration
registrationfb_mobile_complete_registrationCompleteRegistration
subscribeSubscribeSubscribe
trialStartTrialStartTrial
add_to_cartfb_mobile_add_to_cartAddToCart
checkoutfb_mobile_initiated_checkoutInitiateCheckout
add_payment_infofb_mobile_add_payment_infotal cual se envía
searchfb_mobile_searchtal cual se envía
content_viewfb_mobile_content_viewtal cual se envía
level_achievedfb_mobile_level_achievedtal cual se envía
tutorial_completefb_mobile_tutorial_completiontal 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#

FuenteQué es¿Verificado?
El SDK — track("purchase", { value, currency })el importe que declara tu appno: el SDK no lee ningún recibo
Webhook de RevenueCatsuscripciones y compras in-app, renovaciones y reembolsos, de servidor a servidorsí: desde la tienda, a través de RevenueCat
AdMobingresos publicitarios por impresión, desde el callback de evento pagado de AdMobestimado 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.

Actualizado el 14 de octubre de 2026