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

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

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
  • Gestiona todo el seguimiento de atribución
  • Rastrea eventos dentro de la aplicación
  • Reenvía eventos a Facebook
  • Proporciona análisis unificado

Configuración estándar

No se requieren cambios especiales

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

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.

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

  1. Verificar Info.plist: Confirmar que la clave se agregó correctamente con el valor false
  2. Compilación de prueba: Compilar y ejecutar la aplicación para asegurarse de que la configuración se aplicó correctamente
  3. 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.

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

JAVA KOTLIN
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. Verificar AndroidManifest: Confirmar que los metadatos se agregaron correctamente con el valor false
  2. Compilar la aplicación: Limpiar y recompilar la aplicación para asegurarse de que la configuración se aplicó correctamente
  3. 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:

  1. 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
  2. Configurar los ajustes de atribución: Establece 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: 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.

Lista de verificación de validación

Validación del SDK de Singular

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

  1. Administrador de eventos: Abre el Administrador de eventos de Facebook y verifica que los eventos aparecen desde Singular
  2. Comparación de recuentos de eventos: Compara los recuentos de eventos entre Singular y Facebook para asegurarte de que no haya duplicación
  3. 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

Eventos duplicados en Facebook

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

  1. Verificar que FacebookAutoLogAppEventsEnabled esté en false en el archivo Info.plist de iOS
  2. Verificar que com.facebook.sdk.AutoLogAppEventsEnabled esté en false en el archivo AndroidManifest.xml de Android
  3. Limpiar y recompilar la aplicación para asegurarse de que la configuración se aplicó correctamente
  4. Monitorear el Administrador de eventos de Facebook durante 24 horas para confirmar que el problema se resolvió
Atribución de Facebook faltante en Singular

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

  1. Navega a Singular → Atribución → Configuración de socios y busca Facebook
  2. Verifica que el ID de aplicación de Facebook esté ingresado correctamente
  3. Confirma que la integración de Facebook esté habilitada y activa
  4. Comprueba que la configuración de la ventana de atribución coincida con los requisitos de la campaña
  5. Consulta la guía Integración de atribución de anuncios de Facebook para una configuración completa
Las funciones de Facebook no funcionan

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

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


Recursos para desarrolladores de Facebook


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.