Uso del SDK de Facebook con Singular SDK
Guía completa para implementar Facebook SDK y Singular SDK en la misma aplicación, que incluye los requisitos de configuración, consideraciones sobre la precisión de los datos y las mejores prácticas de integración.
Integración
Singular como socio de medición móvil
Si Singular SDK está integrado en la aplicación, Facebook SDK no es necesario para el seguimiento de la atribución de Facebook o eventos de visualización en la plataforma de Facebook. Como socio certificado de medición móvil (MMP) de Facebook, Singular SDK se encarga de todos los requisitos de atribución y seguimiento de eventos.
Capacidades de Singular MMP:
- Seguimiento de atribución: Rastrea automáticamente las instalaciones y conversiones de las campañas de Facebook.
- Reenvío de eventos: Envía los eventos de la aplicación a Facebook para optimizar la campaña.
- 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 utilizar el SDK de Facebook
Casos de uso válidos
Aunque Singular SDK gestiona la atribución y los análisis, algunas organizaciones deciden integrar Facebook SDK para obtener funciones adicionales específicas de Facebook más allá de la medición.
Funciones sociales
Inicio de sesión en Facebook
Permite a los usuarios autenticarse utilizando las credenciales de Facebook, lo que simplifica la incorporación y reduce la fricción del registro.
Compartir en Facebook
Permite a los usuarios compartir el contenido de la aplicación directamente en Facebook, lo que aumenta el alcance orgánico y el potencial de crecimiento viral.
Funciones avanzadas de publicidad
Anuncios de instalación de aplicaciones móviles de Facebook
Accede a las funciones avanzadas de los anuncios de instalación de aplicaciones móvilesde Facebook:
- Anuncios dinámicos de productos: Vuelve a dirigirte a los usuarios con recomendaciones de productos personalizadas.
- Red de audiencias: Amplía las campañas más allá de la plataforma de Facebook a aplicaciones asociadas
- Públicos personalizados: Cree audiencias basadas en los datos de los usuarios de Facebook
- Segmentación avanzada: Aprovecha las detalladas opciones de segmentación de Facebook
Integración con la plataforma de Facebook
Acceso a Graph API
Integración con Facebook Graph API para leer y escribir datos en el gráfico social de Facebook.
Integración con Messenger
Permite la comunicación a través de Facebook Messenger para la atención al cliente o campañas de compromiso.
Decisión de integración: Sólo integra el SDK de Facebook si tu aplicación requiere funciones específicas de la plataforma de Facebook más allá de la atribución y el análisis. Sólo para fines de medición, Singular SDK ofrece una funcionalidad completa.
Consideraciones sobre la precisión de los datos
Cuando se utilizan Facebook SDK y Singular SDK en la misma aplicación, es esencial una configuración adecuada para mantener la precisión de los datos y evitar discrepancias.
Problemas comunes con los datos
Duplicación de eventos
Sin la configuración adecuada, los eventos pueden enviarse dos veces a Facebook (una desde el SDK de Facebook y otra desde Singular SDK), lo que provoca un recuento inflado de eventos e informes inexactos.
Problema crítico: El seguimiento duplicado de eventos provoca:
- Recuentos de eventos inflados: Los informes de Facebook duplican los eventos reales, lo que distorsiona las métricas de rendimiento de la campaña.
- 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 presupuestos: Los datos inexactos afectan a la distribución del presupuesto entre las campañas
Requisitos de la solución
Estrategia de configuración
Para mantener la precisión de los datos al utilizar ambos SDK, desactiva el registro automático de eventos en el SDK de Facebook y permite que Singular SDK gestione todas las mediciones y el reenvío de eventos a Facebook.
Arquitectura de integración:
| Componente | Responsabilidad | Configuración |
|---|---|---|
| SDK singular |
|
Configuración estándar No requiere cambios especiales |
| SDK de Facebook |
|
Desactiva el registro automático Evita el envío de eventos duplicados |
Pasos de implementación
Sigue estos pasos para utilizar Facebook SDK junto con Singular SDK manteniendo la precisión de los datos y evitando la duplicación de eventos.
Paso 1: Desactivar el registro de eventos de Facebook SDK
Configuración específica de la plataforma
De forma predeterminada, Facebook SDK envía automáticamente los 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 "Desactivar el registro automático de eventos" en Introducción a App Events para iOS.
Configuración de Info.plist
Añade la siguiente clave a tu archivo Info.plist para desactivar el registro automático de eventos:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
Pasos de verificación
-
Compruebe Info.plist: Compruebe que la clave se ha añadido correctamente con el valor establecido en
false - Prueba de compilación: Cree y ejecute la aplicación para asegurarse de que se ha aplicado la configuración
- Supervisar eventos: Comprueba que el SDK de Facebook no envía eventos mediante 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. Singular SDK se encargará de reenviar todos los eventos a la plataforma de Facebook.
Método de configuración
Sigue las instrucciones oficiales de Facebook en "Desactivar el registro automático de eventos" en Introducción a App Events para Android.
Configuración de AndroidManifest.xml
Añade los siguientes metadatos a tu archivo AndroidManifest.xmldentro de la etiqueta <application>:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternativa: Configuración programática
Alternativamente, deshabilite el registro automático mediante programación en su clase de aplicación:
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
-
Compruebe AndroidManifest: Verificar que los metadatos se han añadido correctamente con el valor establecido en
false - Cree la aplicación: Limpie y reconstruya la aplicación para asegurarse de que se ha aplicado la configuración.
- Supervisar eventos: Comprueba que el SDK de Facebook no envía eventos mediante el panel de Facebook Analytics.
Importante: Elige la configuración AndroidManifest O la configuración programática, no ambas. Se recomienda la configuración del manifiesto por coherencia.
Paso 2: Configurar Facebook Attribution
Configuración de socio singular
Tras desactivar el registro de eventos del SDK de Facebook, configura la atribución de Facebook en la plataforma Singular siguiendo los procedimientos de configuración estándar.
Instrucciones de configuración: Siga los pasos del 1 al 4 de la guía Facebook Ads Attribution Integrationpara completar la configuración de atribución de Facebook.
Lista de comprobaciónde la configuración:
- Añade el ID de la aplicación de Facebook: En la plataforma Singular, navegue hasta Atribución → Configuración de socios y añada Facebook App ID.
- Configure los ajustes de atribución: Establezca las ventanas de atribución y las preferencias de medición
- Mapear Eventos: Configura el mapeo de eventos entre Singular y Facebook
- Habilitar Postbacks: Configurar los postbacks de eventos de Singular a Facebook para la optimización de la campaña
Paso 3: Validar la configuración
Procedimientos de prueba
Una vez completada la configuración, valida la correcta implementación utilizando las herramientas de prueba de Singular y Facebook.
Validación de Singular SDK
- Consola de pruebas: Utiliza la consola de pruebas de Singularpara verificar que los eventos se rastrean correctamente.
- Registros de eventos: Compruebe los registros de exportación de Singular para confirmar los eventos registrados
- Verificación de atribución: Verifica que las instalaciones de Facebook se atribuyen correctamente en los informes de Singular.
Validación de la plataforma de Facebook
- Gestor de eventos: Abre Facebook Events Manager y verifica los eventos que aparecen en Singular.
- Comparación del recuento de eventos: Compara el recuento de eventos entre Singular y Facebook para asegurarte de que no hay duplicados.
- Seguimiento de sesiones: Verifica que los recuentos de sesiones coinciden con los valores esperados sin inflación
Comprobación de la exactitud de los datos
| Comprobar | Resultado esperado |
|---|---|
| Recuento de eventos | Los eventos sólo aparecen una vez en Facebook (desde Singular), no están duplicados |
| Recuento de sesiones | Facebook muestra recuentos de sesiones normales sin inflación artificial |
| Datos de atribución | Los informes de Singular muestran las instalaciones de Facebook con los datos de campaña correctos. |
| Funciones de Facebook | Facebook Login, Share y otras funciones funcionan correctamente en la aplicación |
Plazo de validación: Transcurridas entre 24 y 48 horas desde la configuración inicial, los datos fluirán correctamente a través de ambas plataformas. Es posible que algunos datos aparezcan con retraso al principio.
Solución de problemas
Problemas comunes y soluciones al utilizar conjuntamente Facebook SDK y Singular SDK.
Problemas comunes
Síntomas
- El recuento de eventos en Facebook duplica los valores esperados
- El mismo evento aparece varias veces con marcas de tiempo idénticas
- Optimización de la campaña de Facebook afectada por métricas infladas
Causa
El registro automático de eventos de Facebook SDK no está desactivado, lo que provoca que tanto Facebook SDK como Singular SDK envíen los mismos eventos a la plataforma de Facebook.
Solución
-
Compruebe que
FacebookAutoLogAppEventsEnabledestá configurado comofalseen iOS Info.plist. -
Compruebe que
com.facebook.sdk.AutoLogAppEventsEnabledestá configurado comofalseen Android AndroidManifest.xml. - Limpia y reconstruye la aplicación para asegurarte de que se aplica la configuración.
- Supervisa Facebook Events Manager durante 24 horas para confirmar que el problema se ha resuelto.
Síntomas
- Las instalaciones de Facebook no aparecen en los informes de Singular
- Las instalaciones se atribuyen a campañas orgánicas en lugar de a campañas de Facebook
- Faltan datos de campaña en los análisis de Singular
Causa
Facebook no está configurado como socio de atribución en la plataforma Singular o el ID de la aplicación de Facebook es incorrecto.
Solución
- Navega a Singular → Atribución → Configuración de socios y busca Facebook.
- Verifique que el ID de la aplicación de Facebook se haya introducido correctamente
- Confirma que la integración de Facebook está activada y activa
- Comprueba que la configuración de la ventana de atribución coincide con los requisitos de la campaña
- Revisa la guía de integración de atribución de Facebook Adspara una configuración completa
Síntomas
- El inicio de sesión en Facebook falla o devuelve errores
- El botón Compartir de Facebook no funciona
- Las funciones del SDK de Facebook no están disponibles en la aplicación
Causa
El SDK de Facebook no se ha inicializado o configurado correctamente a pesar de que el registro automático de eventos está desactivado.
Solución
- Comprueba que el SDK de Facebook se ha inicializado correctamente en la aplicación (la desactivación del registro automático no afecta a la inicialización del SDK).
- Comprueba el ID de la aplicación de Facebook y la configuración en los ajustes de la aplicación.
- Revisa la documentación del SDK de Facebook para conocer los requisitos específicos de las funciones.
- Prueba las funciones de Facebook de forma independiente para aislar los problemas de integración.
Nota: la desactivación del registro automático de eventos sólo afecta al seguimiento de eventos, no a las funciones de la plataforma de Facebook como Iniciar sesión y Compartir. Estas funciones deberían seguir funcionando con normalidad.
Recursos adicionales
Documentación completa para la integración de Facebook y Singular SDK.
Enlaces de documentación
Recursos de Singular
- Primeros pasos con Singular SDK/S2S- Guía completa de integración SDK
- Facebook Ads Attribution Integration- Configuración de socios de Facebook
- Conector de datos de Facebook- Agregación de datos de costes y campañas
- Probar la integración de Singular SDK- Procedimientos de validación y solución de problemas
Recursos para desarrolladores de Facebook
- Facebook App Events paraiOS - Configuración del SDK de iOS y registro de eventos
- Facebook App Events paraAndroid - 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
Obtener ayuda
Si necesitas más ayuda con la integración de Facebook y Singular SDK, ponte en contacto con el servicio de asistencia de Singular o consulta a tu Customer Success Manager.