Uso del SDK de Facebook y el SDK de Singular en la misma aplicación
Guía completa para implementar el SDK de Facebook y el SDK de Singular en la misma aplicación, con información sobre requisitos de configuración, consideraciones de precisión de datos y mejores prácticas de integración.
Descripción general de la integración
Singular como socio de medición móvil
Si el SDK de Singular está integrado en la aplicación, no se necesita el SDK de Facebook para rastrear la atribución de Facebook ni para ver eventos en la plataforma de Facebook. Como socio de medición móvil (MMP) certificado de Facebook, el SDK de Singular gestiona todos los requisitos de atribución y seguimiento de eventos.
Capacidades de Singular como MMP:
- Seguimiento de atribución: Rastrea automáticamente las instalaciones y conversiones de las campañas de Facebook
- Reenvío de eventos: Envía eventos dentro de la aplicación a Facebook para la optimización de campañas
- Informes de datos: Proporciona datos de atribución unificados en todos los canales, incluido Facebook
- Integración certificada: Solución de medición aprobada por Facebook con acceso completo a la API
Cuándo usar el SDK de Facebook
Casos de uso válidos
Aunque el SDK de Singular gestiona la atribución y el análisis, algunas organizaciones optan por integrar el SDK de Facebook para acceder a funciones específicas de Facebook más allá de la medición.
Funciones sociales
Inicio de sesión con Facebook
Permite a los usuarios autenticarse con sus credenciales de Facebook, lo que simplifica el proceso de incorporación y reduce la fricción en el registro.
Compartir en Facebook
Permite a los usuarios compartir contenido de la aplicación directamente en Facebook, lo que aumenta el alcance orgánico y el potencial de crecimiento viral.
Funciones publicitarias avanzadas
Anuncios de instalación de aplicaciones móviles de Facebook
Accede a las funciones avanzadas de los anuncios de instalación de aplicaciones móviles de Facebook , incluidas:
- Anuncios dinámicos de productos: Reorienta a los usuarios con recomendaciones de productos personalizadas
- Audience Network: Amplía las campañas más allá de la plataforma de Facebook hacia aplicaciones de socios
- Custom Audiences: Crea audiencias basadas en datos de usuarios de Facebook
- Segmentación avanzada: Aprovecha las opciones de segmentación detalladas de Facebook
Integración con la plataforma de Facebook
Acceso a la Graph API
Intégrate con la Graph API de Facebook para leer y escribir datos en el grafo social de Facebook.
Integración con Messenger
Habilita la comunicación a través de Facebook Messenger para soporte al cliente o campañas de engagement.
Decisión de integración: Integra el SDK de Facebook solo si tu aplicación requiere funciones específicas de la plataforma de Facebook más allá de la atribución y el análisis. Para fines de medición únicamente, el SDK de Singular proporciona la funcionalidad completa.
Consideraciones de precisión de datos
Al usar el SDK de Facebook y el SDK de Singular en la misma aplicación, es esencial realizar una configuración adecuada para mantener la precisión de los datos y evitar discrepancias.
Problemas de datos más comunes
Duplicación de eventos
Sin la configuración adecuada, los eventos pueden enviarse dos veces a Facebook (una vez desde el SDK de Facebook y una vez desde el SDK de Singular), lo que genera recuentos de eventos inflados e informes inexactos.
Problema crítico: El seguimiento duplicado de eventos provoca:
- Recuentos de eventos inflados: Facebook reporta el doble de los eventos reales, lo que distorsiona las métricas de rendimiento de las campañas
- Recuentos de sesiones incorrectos: Los datos de sesión aparecen artificialmente elevados en la plataforma de Facebook
- Problemas de optimización de campañas: El algoritmo de Facebook recibe señales incorrectas para la optimización de campañas
- Problemas de asignación de presupuesto: Los datos inexactos afectan la distribución del presupuesto entre campañas
Requisitos de la solución
Estrategia de configuración
Para mantener la precisión de los datos al usar ambos SDK, desactiva el registro automático de eventos en el SDK de Facebook y permite que el SDK de Singular gestione todas las mediciones y el reenvío de eventos a Facebook.
Arquitectura de integración:
| Componente | Responsabilidad | Configuración |
|---|---|---|
| SDK de Singular |
|
Configuración estándar No se requieren cambios especiales |
| SDK de Facebook |
|
Desactivar el registro automático Evitar el envío duplicado de eventos |
Pasos de implementación
Sigue estos pasos para usar el SDK de Facebook junto con el SDK de Singular manteniendo la precisión de los datos y evitando la duplicación de eventos.
Paso 1: Desactivar el registro de eventos del SDK de Facebook
Configuración específica por plataforma
De forma predeterminada, el SDK de Facebook envía automáticamente eventos a la plataforma de Facebook. Este registro automático debe desactivarse para evitar el seguimiento duplicado de eventos.
Método de configuración
Sigue las instrucciones oficiales de Facebook en la sección "Desactivar eventos registrados automáticamente" de Primeros pasos con App Events para iOS .
Configuración de Info.plist
Agrega la siguiente clave a tu archivo
Info.plist
para desactivar el registro automático de eventos:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
Pasos de verificación
-
Verificar Info.plist:
Confirmar que la clave se agregó correctamente con el valor
false - Compilación de prueba: Compilar y ejecutar la aplicación para asegurarse de que la configuración se aplicó correctamente
- Monitorear eventos: Verificar que el SDK de Facebook no envíe eventos usando el panel de Facebook Analytics
Importante: Después de desactivar el registro automático, el SDK de Facebook no enviará ningún evento a Facebook. El SDK de Singular gestionará todo el reenvío de eventos a la plataforma de Facebook.
Método de configuración
Sigue las instrucciones oficiales de Facebook en la sección "Desactivar eventos registrados automáticamente" de Primeros pasos con App Events para Android .
Configuración de AndroidManifest.xml
Agrega los siguientes metadatos a tu archivo
AndroidManifest.xml
dentro de la etiqueta
<application>
:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternativa: Configuración programática
Alternativamente, desactiva el registro automático de forma programática en tu clase Application:
import com.facebook.FacebookSdk;
import com.facebook.appevents.AppEventsLogger;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false);
}
}
import com.facebook.FacebookSdk
import com.facebook.appevents.AppEventsLogger
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false)
}
}
Pasos de verificación
-
Verificar AndroidManifest:
Confirmar que los metadatos se agregaron correctamente con el valor
false - Compilar la aplicación: Limpiar y recompilar la aplicación para asegurarse de que la configuración se aplicó correctamente
- Monitorear eventos: Verificar que el SDK de Facebook no envíe eventos usando el panel de Facebook Analytics
Importante: Elige la configuración de AndroidManifest O la configuración programática, pero no ambas. Se recomienda la configuración por Manifest para mayor consistencia.
Paso 2: Configurar la atribución de Facebook
Configuración del socio en Singular
Después de desactivar el registro de eventos del SDK de Facebook, configura la atribución de Facebook en la plataforma de Singular siguiendo los procedimientos de configuración estándar.
Instrucciones de configuración: Sigue los pasos 1 al 4 de la guía Integración de atribución de anuncios de Facebook para completar la configuración de la atribución de Facebook.
Lista de verificación de configuración:
- Agregar el ID de aplicación de Facebook: En la plataforma de Singular, navega a Atribución → Configuración de socios y agrega el ID de aplicación de Facebook
- Configurar los ajustes de atribución: Establece las ventanas de atribución y las preferencias de medición
- Mapear eventos: Configura el mapeo de eventos entre Singular y Facebook
- Habilitar postbacks: Configura los postbacks de eventos desde Singular a Facebook para la optimización de campañas
Paso 3: Validar la configuración
Procedimientos de prueba
Después de completar la configuración, valida la implementación correcta utilizando las herramientas de prueba de Singular y Facebook.
Validación del SDK de Singular
- Consola de pruebas: Usa la consola de pruebas de Singular para verificar que los eventos se rastrean correctamente
- Registros de eventos: Revisa los registros de exportación de Singular para confirmar que los eventos quedaron registrados
- Verificación de atribución: Verifica que las instalaciones de Facebook se atribuyen correctamente en los informes de Singular
Validación en la plataforma de Facebook
- Administrador de eventos: Abre el Administrador de eventos de Facebook y verifica que los eventos aparecen desde Singular
- Comparación de recuentos de eventos: Compara los recuentos de eventos entre Singular y Facebook para asegurarte de que no haya duplicación
- Seguimiento de sesiones: Verifica que los recuentos de sesiones coincidan con los valores esperados sin inflación
Verificaciones de precisión de datos
| Verificación | Resultado esperado |
|---|---|
| Recuentos de eventos | Los eventos aparecen solo una vez en Facebook (desde Singular), sin duplicación |
| Recuentos de sesiones | Facebook muestra recuentos de sesiones normales sin inflación artificial |
| Datos de atribución | Los informes de Singular muestran instalaciones de Facebook con datos correctos de campaña |
| Funciones de Facebook | El inicio de sesión, la función para compartir y otras funciones de Facebook funcionan correctamente en la aplicación |
Período de validación: Espera entre 24 y 48 horas después de la configuración inicial para que los datos fluyan correctamente a través de ambas plataformas. Es posible que algunos datos aparezcan con retraso inicialmente.
Resolución de problemas
Problemas comunes y soluciones al usar el SDK de Facebook y el SDK de Singular juntos.
Problemas comunes
Síntomas
- Los recuentos de eventos en Facebook duplican los valores esperados
- El mismo evento aparece varias veces con marcas de tiempo idénticas
- La optimización de campañas de Facebook se ve afectada por métricas infladas
Causa
El registro automático de eventos del SDK de Facebook no está desactivado, lo que hace que tanto el SDK de Facebook como el SDK de Singular envíen los mismos eventos a la plataforma de Facebook.
Solución
-
Verificar que
FacebookAutoLogAppEventsEnabledesté enfalseen el archivo Info.plist de iOS -
Verificar que
com.facebook.sdk.AutoLogAppEventsEnabledesté enfalseen el archivo AndroidManifest.xml de Android - Limpiar y recompilar la aplicación para asegurarse de que la configuración se aplicó correctamente
- Monitorear el Administrador de eventos de Facebook durante 24 horas para confirmar que el problema se resolvió
Síntomas
- Las instalaciones de Facebook no aparecen en los informes de Singular
- Las instalaciones se atribuyen a tráfico orgánico en lugar de a campañas de Facebook
- Los datos de campaña no aparecen en el análisis de Singular
Causa
Facebook no está configurado como socio de atribución en la plataforma de Singular, o el ID de aplicación de Facebook está ausente o es incorrecto.
Solución
- Navega a Singular → Atribución → Configuración de socios y busca Facebook
- Verifica que el ID de aplicación de Facebook esté ingresado correctamente
- Confirma que la integración de Facebook esté habilitada y activa
- Comprueba que la configuración de la ventana de atribución coincida con los requisitos de la campaña
- Consulta la guía Integración de atribución de anuncios de Facebook para una configuración completa
Síntomas
- El inicio de sesión con Facebook falla o devuelve errores
- El botón para compartir en Facebook no funciona
- Las funciones del SDK de Facebook no están disponibles en la aplicación
Causa
El SDK de Facebook no está correctamente inicializado o configurado a pesar de que el registro automático de eventos está desactivado.
Solución
- Verificar que el SDK de Facebook esté correctamente inicializado en la aplicación (desactivar el registro automático no afecta la inicialización del SDK)
- Comprobar el ID de aplicación de Facebook y la configuración en los ajustes de la aplicación
- Revisar la documentación del SDK de Facebook para conocer los requisitos específicos de cada función
- Probar las funciones de Facebook de forma independiente para aislar los problemas de integración
Nota: Desactivar el registro automático de eventos afecta únicamente el seguimiento de eventos, no las funciones de la plataforma de Facebook como el inicio de sesión y compartir. Estas funciones deberían seguir funcionando con normalidad.
Recursos adicionales
Documentación completa para la integración del SDK de Facebook y Singular.
Enlaces de documentación
Recursos de Singular
- Primeros pasos con el SDK/S2S de Singular - Guía completa de integración del SDK
- Integración de atribución de anuncios de Facebook - Configuración del socio Facebook
- Conector de datos de Facebook - Agregación de datos de costos y campañas
- Prueba de la integración del SDK de Singular - Procedimientos de validación y resolución de problemas
Recursos para desarrolladores de Facebook
- App Events de Facebook para iOS - Configuración del SDK de iOS y registro de eventos
- App Events de Facebook para Android - Configuración del SDK de Android y registro de eventos
- Anuncios de instalación de aplicaciones móviles de Facebook - Funciones y capacidades publicitarias avanzadas
Soporte
Cómo obtener ayuda
Para obtener ayuda adicional con la integración del SDK de Facebook y Singular, comunícate con el soporte de Singular o consulta con tu gerente de éxito del cliente.