Añadir soporte SKAdNetwork

Documento

Guía de integración del SDK de Unreal Engine

Guía para Desarrolladores Registro de cambios
Requisitos previos
Compatibilidad Unreal Engine 4.23+
Guías de integración
  1. Integración básica
  2. Seguimiento de eventos e ingresos
  3. Implementación de enlaces profundos
  4. Añadir soporte SKAdNetwork
  5. Opciones Avanzadas

Introducción a SKAdNetwork SKAdNetwork y SKAN

SKAdNetwork es el nuevo marco de Apple para atribuir instalaciones móviles sin comprometer la privacidad del usuario final. La nueva versión de Singular del SDK de iOS le ayuda a implementar SKAdNetwork sin problemas y con un mínimo esfuerzo de ingeniería. Esta implementación de SKAdNetwork se basa en SKAN - un estándar desarrollado por Singular para una implementación fluida de SKAdNetwork.

Para una guía completa de la implementación de SKAdNetwork de Singular, consulte la guía de implementación de SKAdNetwork del SDK de iOS.

Implementación de SKAdNetwork en el SDK de Unreal Engine

Configuración del método USingularSDKBPLibrary::Initialize

Puede configurar las siguientes opciones en el método USingularSDKBPLibrary::Initialize. Para obtener más información sobre cada una de estas opciones, consulte la guía de implementación de SKAdNetwork del SDK de iOS.

Opción Valor predeterminado
Descripción
skAdNetworkEnabled Verdadero Establecer como true para habilitar el soporte SKAdNetwork.
manualSKANConversionManagement Falso Establézcalo en true si desea gestionar el valor de conversión manualmente.

Nota: a partir de la versión 2.0.11 del SDK de Unreal Engine, SKAdNetwork está activado por defecto.

Si utiliza una versión anterior del SDK, deberá activar SKAdNetwork estableciendo skAdNetworkEnabled en True.

Métodos SKAdNetwork

Método SkanRegisterAppForAdNetworkAttribution de SingularSDK
Descripción

Registro para el seguimiento de SKAdNetwork.

Notas:

  • Esto es lo mismo que configurar skAdNetworkEnabled como True en el método USingularSDKBPLibrary::Initialize .
  • La llamada a este método anula el valor configurado en USingularSDKBPLibrary::Initialize.
  • A partir de la versión 2.0.11 del SDK de Unreal Engine, SKAdNetwork está activado por defecto.
Firma public void SkanRegisterAppForAdNetworkAttribution()
Ejemplo de uso
USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();
SingularSDK Método SkanUpdateConversionValue
Descripción

Actualiza el valor de conversión de SKAdNetwork.

Nota: utilice este método si ha seleccionado actualizar manualmente el valor de conversión de SKAdNetwork. Este método sólo funcionará si manualSKANConversionManagement está configurado como True.

Firma public void SkanUpdateConversionValue(int conversionValue)
Ejemplo de uso
// A sign-up event happened

  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // Update the conversion value to 7

  USingularSDKBPLibrary::SkanUpdateConversionValue(7);
SingularSDK Método SkanGetConversionValue
Descripción Obtiene el valor de conversión actual rastreado por Singular SDK.
Firma public int SkanGetConversionValue()
Ejemplo de uso
int value = USingularSDKBPLibrary::SkanGetConversionValue();

Registro en SKAN Valor de conversión actualizado

  1. Añada #include "SingularDelegates.h" al principio del archivo de cabecera de la clase en la que desea registrar el delegado.
  2. Añada lo siguiente a su clase:

    // A delegate to register that invokes the Conversion Value updated
    
      UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
      FOnConversionValueUpdated OnConversionValueUpdated;
      
      // The method we will use to register the delegate
    
      UFUNCTION()
      void NewConversionValue(int32 conversionValue);
  3. En el archivo cpp de la clase registrar al evento:

    OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);