SDK de React Native - Soporte para SKAdNetwork

Seguir
Avatar
Jared Ornstead
Updated
Documento

Introducción: SKAdNetwork y SKAN

El SDK iOS de Singular simplifica la integración de SKAdNetwork, soportando las características de SKAN 4.0 como múltiples postbacks, IDs de origen jerárquicos y valores de conversión de grano grueso. Basado en el estándar SKAN de código abierto de Singular, garantiza una fácil configuración y compatibilidad con las redes publicitarias. Para más detalles sobre la configuración, consulte la Guía SKAdNetwork de Singular.

Compatibilidad con el seguimiento SKAdNetwork

Consejo: El seguimiento de SKAdNetwork está activado por defecto cuando se utiliza Singular SDK.

Para desactivar o apagar el soporte para SKAdNetwork:

  • Establezca el método de configuración skAdNetworkEnabled en FALSE cuando construya el objeto SingularConfig.

Gestión de AppTrackingTransparency (ATT)

Para iOS 14.5+ (incluido iOS 18), utilice ATTrackingManager para solicitar el consentimiento del usuario antes de acceder al IDFA para el seguimiento. El SDK de Singular para iOS (v12.x) soporta ATT, permitiendo la inicialización antes del consentimiento y retrasando los eventos hasta que se concede el consentimiento o se produce un tiempo de espera. Esto garantiza el cumplimiento de las normas de privacidad de Apple y la compatibilidad con SKAdNetwork (SKAN) 4.0.

Implementación

  1. Añadir ATT Framework:

    • Incluya AppTrackingTransparency en su proyecto Xcode.
    • Actualice Info.plist con NSUserTrackingUsageDescription (por ejemplo, "Esta aplicación utiliza el seguimiento para personalizar los anuncios").

  2. Solicite el consentimiento de la ATT:

    • Solicite el consentimiento cuando se inicie la aplicación o después de la integración, en función de su estrategia de UX.
    • Utilice el SDK de Singular para gestionar la inicialización previa al consentimiento.

  3. Configure el SDK de Singular:

    • Establezca el método de configuración waitForTrackingAuthorizationWithTimeoutInterval al crear el objeto SingularConfig para retrasar los eventos hasta que se resuelva el consentimiento ATT o expire el tiempo de espera (por ejemplo, 30 segundos).

Mejores prácticas

  • Tiempo de aviso: Solicite el consentimiento ATT en el lanzamiento de la aplicación para maximizar la disponibilidad de IDFA, o retrase hasta después de la incorporación para mejorar el contexto del usuario. Pruebe ambas opciones para equilibrar las tasas de consentimiento y la experiencia del usuario.
  • Tiempo de espera: Establece waitForTrackingAuthorizationWithTimeoutInterval entre 30 y 300 segundos. Después del tiempo de espera, Singular procede con la atribución SKAN 4.0 (sin IDFA).
  • Integración de SKAN 4.0: Asegúrese de que las actualizaciones de los valores de conversión coinciden con el consentimiento de ATT para optimizar las devoluciones de SKAN (por ejemplo, utilice el panel de Singular para asignar eventos a los valores 0-63).
  • Tratamiento de errores: Compruebe ATTrackingManager.trackingAuthorizationStatus para restricted (por ejemplo, controles parentales) o notDetermined estados y registro para análisis.

Gestión manual de valores de conversión

Modo gestionado

Por defecto, la implementación de SKAdNetwork gestiona el valor de conversión directamente desde el lado del servidor Singular.

Esto permite la máxima flexibilidad, ya que puede establecer y cambiar los valores de conversión a través de la plataforma Singular, sin modificar el código del lado del cliente.

Este modo gestionado del lado del servidor también le ayuda a manejar los temporizadores de SKAdNetwork. SKAdNetwork le permite actualizar el valor de conversión en un plazo de 24 horas desde el momento del registro en SKAdNetwork. Cualquier llamada para actualizar el valor de conversión prolonga el temporizador 24 horas más. Por lo tanto, al elegir sus eventos de conversión, tendrá que asegurarse de que los eventos se produzcan dentro de esa ventana de actualización. En modo gestionado, puede cambiar la configuración de los eventos de conversión en cualquier momento, sin necesidad de lanzar una nueva versión de su aplicación.

Modo manual

Si quieres actualizar el valor de conversión por tu cuenta:

  • Configure el withManualSkanConversionManagement al crear el objeto SingularConfig.
  • A continuación, para actualizar el valor de conversión, utilice el método skanUpdateConversionValue siempre que sea necesario en el ciclo de vida de su aplicación.
  • O bien, para actualizar manualmente los valores de conversión de SKAdNetwork 4.0, utilice el método skanUpdateConversionValues siempre que sea necesario en el ciclo de vida de su aplicación.

Nota: El método skanUpdateConversionValue no funcionará si no ha configurado el SDK para actualizaciones manuales en la inicialización.

Recuperación del valor de conversión

Para obtener el valor de conversión actual, utilice el método skanGetConversionValue para obtener el valor de conversión actual. Este método funciona tanto en modo gestionado como manual.