Uso del SDK de Facebook y Singular SDK/S2S en la misma aplicación

Documento

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 del SDK de Facebook
#

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
  • Gestiona todo el seguimiento de atribuciones
  • Rastrea los eventos dentro de la aplicación
  • Remite los eventos a Facebook
  • Proporciona análisis unificados

Configuración estándar

No requiere cambios especiales

SDK de Facebook
  • Proporciona funciones de la plataforma de Facebook
  • Permite iniciar sesión, compartir, etc.
  • NO envía eventos
  • NO rastrea la atribución

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.

iOS: desactivar el registro automático 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

  1. Compruebe Info.plist: Compruebe que la clave se ha añadido correctamente con el valor establecido en false
  2. Prueba de compilación: Cree y ejecute la aplicación para asegurarse de que se ha aplicado la configuración
  3. 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.

Android - Desactivar el registro automático 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 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:

JAVAKOTLIN
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);
    }
}

Pasos de verificación

  1. Compruebe AndroidManifest: Verificar que los metadatos se han añadido correctamente con el valor establecido en false
  2. Cree la aplicación: Limpie y reconstruya la aplicación para asegurarse de que se ha aplicado la configuración.
  3. 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:

  1. 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.
  2. Configure los ajustes de atribución: Establezca las ventanas de atribución y las preferencias de medición
  3. Mapear Eventos: Configura el mapeo de eventos entre Singular y Facebook
  4. 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.

Lista de validación
#

Validación de Singular SDK

  1. Consola de pruebas: Utiliza la consola de pruebas de Singularpara verificar que los eventos se rastrean correctamente.
  2. Registros de eventos: Compruebe los registros de exportación de Singular para confirmar los eventos registrados
  3. 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

  1. Gestor de eventos: Abre Facebook Events Manager y verifica los eventos que aparecen en Singular.
  2. Comparación del recuento de eventos: Compara el recuento de eventos entre Singular y Facebook para asegurarte de que no hay duplicados.
  3. 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

Eventos duplicados en Facebook
#

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

  1. Compruebe que FacebookAutoLogAppEventsEnabled está configurado como false en iOS Info.plist.
  2. Compruebe que com.facebook.sdk.AutoLogAppEventsEnabledestá configurado como false en Android AndroidManifest.xml.
  3. Limpia y reconstruye la aplicación para asegurarte de que se aplica la configuración.
  4. Supervisa Facebook Events Manager durante 24 horas para confirmar que el problema se ha resuelto.
Falta la atribución de Facebook en Singular
#

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

  1. Navega a Singular → Atribución → Configuración de socios y busca Facebook.
  2. Verifique que el ID de la aplicación de Facebook se haya introducido correctamente
  3. Confirma que la integración de Facebook está activada y activa
  4. Comprueba que la configuración de la ventana de atribución coincide con los requisitos de la campaña
  5. Revisa la guía de integración de atribución de Facebook Adspara una configuración completa
Funciones de Facebook que no funcionan
#

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

  1. 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).
  2. Comprueba el ID de la aplicación de Facebook y la configuración en los ajustes de la aplicación.
  3. Revisa la documentación del SDK de Facebook para conocer los requisitos específicos de las funciones.
  4. 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


Recursos para desarrolladores de Facebook


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.