Unreal Engine SDK: Agregar soporte de skadnetwork

 

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 True Establezca el valor true para activar la compatibilidad con SKAdNetwork.
manualSKANConversionManagement False Establezca 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
  // Se produjo un evento de registro.
  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // Actualice el valor de conversión a 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 deuso
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:

      // Un delegado para registrarse que invoca el Valor de Conversión actualizado
      UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
      FOnConversionValueUpdated OnConversionValueUpdated;
      
      // El método que usaremos para registrar al delegado.
      UFUNCTION()
      void NewConversionValue(int32 conversionValue);
  3. En el archivo cpp de la clase registrar al evento:

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