Tutorial Completo de AppsFlyer para React Native
Tutorial Completo de AppsFlyer para React Native
Bienvenido al tutorial más completo en español de AppsFlyer SDK para React Native. Aprenderás a integrar, configurar y aprovechar al máximo esta poderosa herramienta de atribución y análisis móvil.
🚀 ¿Qué es AppsFlyer?
AppsFlyer es una plataforma líder de atribución móvil y análisis de marketing que te ayuda a:
- Medir el rendimiento de tus campañas de marketing
- Rastrear la atribución de instalaciones y conversiones
- Analizar el comportamiento de los usuarios en tu app
- Optimizar el ROI de tus inversiones en marketing
- Prevenir el fraude en instalaciones móviles
- Implementar deep linking avanzado
📚 Contenido del Tutorial
Módulo 1: Fundamentos e Instalación
-
- Conceptos básicos de atribución móvil
- Instalación del SDK
- Configuración inicial para iOS y Android
- Primeras pruebas
-
Inicialización y Configuración Básica
- Inicializar el SDK
- Configurar App ID y Dev Key
- Gestión de permisos
- Modo debug y testing
-
- Atribución de primera instalación
- Datos de conversión
- Organic vs Non-organic
- Testing de atribución
Módulo 2: Eventos y Analytics
-
Eventos In-App (Próximamente)
- Tipos de eventos predefinidos
- Eventos personalizados
- Parámetros de eventos
- Revenue tracking
-
Deep Linking y Deferred Deep Linking (Próximamente)
- OneLink configuration
- Universal Links (iOS)
- App Links (Android)
- Deferred deep linking
-
User Invite y Referrals (Próximamente)
- Implementar sistema de referidos
- Tracking de invitaciones
- Atribución de usuarios invitados
Módulo 3: Características Avanzadas
-
Uninstall Measurement (Próximamente)
- Configurar medición de desinstalaciones
- Silent push notifications
- Análisis de retención
-
Ad Revenue Tracking (Próximamente)
- Integración con redes publicitarias
- Tracking de ingresos publicitarios
- LTV calculation
-
Prevención de Fraude (Próximamente)
- Protect360
- Validación de instalaciones
- Detección de anomalías
Módulo 4: Optimización y Mejores Prácticas
-
Testing y Debugging (Próximamente)
- Herramientas de testing
- Debug mode
- Validación de eventos
- Troubleshooting común
-
Mejores Prácticas y Optimización (Próximamente)
- Naming conventions
- Estructura de eventos
- Performance optimization
- Compliance (GDPR, ATT)
-
Integración con Otras Herramientas (Próximamente)
- Firebase
- Segment
- MMP platforms
- Data warehouses
🎯 Objetivos de Aprendizaje
Al completar este tutorial serás capaz de:
- ✅ Integrar completamente AppsFlyer en tu app React Native
- ✅ Configurar tracking de instalaciones y eventos
- ✅ Implementar deep linking avanzado
- ✅ Analizar y optimizar campañas de marketing
- ✅ Medir el ROI y LTV de usuarios
- ✅ Prevenir fraude en instalaciones
📋 Prerrequisitos
Para seguir este tutorial necesitas:
- React Native configurado (0.60+)
- Conocimientos básicos de React Native
- Cuenta de AppsFlyer (Crear cuenta gratuita)
- Xcode (para iOS) y Android Studio (para Android)
- Dispositivo físico o emulador para testing
🛠️ Versiones y Compatibilidad
Este tutorial está basado en:
- AppsFlyer React Native SDK: v6.13.x
- Android SDK nativo: v6.13.0
- iOS SDK nativo: v6.13.1
- React Native: 0.60+
Cambios Importantes (Breaking Changes v6.x.x)
Si vienes de versiones anteriores, ten en cuenta:
trackEvent
ahora eslogEvent
trackLocation
ha sido removidostopTracking
ahora esstop
- iOS framework actualizado a xcframework
📖 Cómo Usar Este Tutorial
Estructura de Cada Capítulo
Cada capítulo incluye:
- Conceptos teóricos: Entender el “por qué”
- Implementación paso a paso: Código detallado
- Ejemplos prácticos: Casos de uso reales
- Testing: Cómo verificar que funciona
- Troubleshooting: Problemas comunes y soluciones
Metodología Recomendada
- Sigue el orden: Los capítulos están diseñados secuencialmente
- Practica cada ejemplo: No solo leas, implementa
- Usa el modo debug: Verifica cada implementación
- Consulta el dashboard: Familiarízate con la interfaz de AppsFlyer
🚦 Tu Primera Integración
Empecemos con una integración básica:
// 1. Instalar el SDK
npm install react-native-appsflyer
// 2. Importar AppsFlyer
import appsFlyer from 'react-native-appsflyer';
// 3. Configuración básica
const initOptions = {
devKey: 'TU_DEV_KEY',
appId: 'TU_APP_ID', // Solo iOS
isDebug: true,
onInstallConversionDataListener: true,
};
// 4. Inicializar
appsFlyer.initSdk(
initOptions,
(result) => {
console.log('AppsFlyer iniciado:', result);
},
(error) => {
console.error('Error iniciando AppsFlyer:', error);
}
);
💡 Tips Importantes
1. Siempre Testea en Dispositivos Reales
// El comportamiento puede variar en emuladores
const isRealDevice = !DeviceInfo.isEmulator();
if (isRealDevice) {
appsFlyer.initSdk(initOptions);
}
2. Usa Nombres de Eventos Consistentes
// ✅ Bueno: snake_case consistente
appsFlyer.logEvent('add_to_cart', { product_id: '123' });
appsFlyer.logEvent('purchase_completed', { revenue: 99.99 });
// ❌ Evitar: mezclar formatos
appsFlyer.logEvent('AddToCart', { ProductID: '123' });
appsFlyer.logEvent('purchase-completed', { Revenue: 99.99 });
3. Implementa Error Handling
try {
await appsFlyer.logEvent('user_signup', {
method: 'email',
success: true
});
} catch (error) {
console.error('Error logging event:', error);
// Enviar a tu sistema de logs
}
📊 Dashboard de AppsFlyer
Secciones Principales
- Overview: Métricas generales
- Dashboards: Visualizaciones personalizadas
- Reports: Datos detallados
- Audiences: Segmentación de usuarios
- Fraud: Protección contra fraude
KPIs Importantes
- Instalaciones: Orgánicas vs Pagas
- Retención: D1, D7, D30
- LTV: Lifetime Value por fuente
- ROI/ROAS: Return on Investment/Ad Spend
- Eventos: Conversiones y revenue
🔍 Casos de Uso Comunes
E-commerce
// Tracking de compra
appsFlyer.logEvent('af_purchase', {
af_revenue: 149.99,
af_currency: 'USD',
af_quantity: 1,
af_content_id: 'SKU123',
af_content_type: 'electronics'
});
Gaming
// Level completion
appsFlyer.logEvent('af_level_achieved', {
af_level: 10,
af_score: 5000,
time_spent: 300
});
Fintech
// Registro completado
appsFlyer.logEvent('af_complete_registration', {
af_registration_method: 'email',
kyc_completed: true
});
🎓 Progreso del Tutorial
- Introducción (Este archivo)
- Capítulo 1: Instalación y Configuración
- Capítulo 2: Inicialización Básica
- Capítulo 3: Tracking de Instalaciones
- Capítulo 4: Eventos In-App
- … más capítulos próximamente
🤝 Recursos y Soporte
Documentación Oficial
- Docs AppsFlyer: dev.appsflyer.com
- GitHub SDK: github.com/AppsFlyerSDK/react-native-appsflyer
- Support Center: support.appsflyer.com
Herramientas Útiles
- AppsFlyer SDK Integration Test: App para validar integración
- Link Management: Crear y testear deep links
- Raw Data Reports: Exportar datos para análisis
Comunidad
- Stack Overflow: Tag
appsflyer
- GitHub Issues: Reportar bugs del SDK
- AppsFlyer Community: Foro oficial
📅 Actualizaciones
Este tutorial se mantiene actualizado con:
- Nuevas versiones del SDK
- Cambios en las plataformas (iOS/Android)
- Mejores prácticas de la industria
- Feedback de la comunidad
Última actualización: Enero 2025
🎯 Siguiente Paso
¿Listo para empezar? Continúa con el primer capítulo:
→ Capítulo 1: Instalación y Configuración
Este tutorial está en desarrollo activo. Los capítulos marcados como “Próximamente” se irán publicando gradualmente.
¡Éxito con tu integración de AppsFlyer! 📱📊