Unreal Engine SDK: Adicionando suporte SkadNetwork

 

Introdução: SKAdNetwork e SKAN

SKAdNetwork é a nova estrutura da Apple para atribuir instalações móveis sem comprometer a privacidade do usuário final. A nova versão do SDK para iOS da Singular ajuda você a implementar a SKAdNetwork sem problemas e com o mínimo de esforço de engenharia. Essa implementação da SKAdNetwork é baseada no SKAN - um padrão desenvolvido pela Singular para uma implementação tranquila da SKAdNetwork.

Para obter um guia completo sobre a implementação de SKAdNetwork da Singular, consulte o guia de implementação de SKAdNetwork do SDK do iOS.

Implementação da SKAdNetwork no SDK do Unreal Engine

Configurações do método USingularSDKBPLibrary::Initialize

Você pode configurar as seguintes opções no método USingularSDKBPLibrary::Initialize. Para obter mais informações sobre cada uma dessas opções, consulte o guia de implementação do iOS SDK SKAdNetwork.

Opção Padrão
Descrição
skAdNetworkEnabled True Defina como true para ativar o suporte a SKAdNetwork.
manualSKANConversionManagement False Defina como true se quiser gerenciar o valor de conversão manualmente.

Observação:a partir da versão 2.0.11 do Unreal Engine SDK, a SKAdNetwork é ativada por padrão.

Se estiver usando uma versão mais antiga do SDK, será necessário ativar a SKAdNetwork definindo skAdNetworkEnabled como True.

Métodos de SKAdNetwork

Método SingularSDK SkanRegisterAppForAdNetworkAttribution
Descrição

Registro para rastreamento de SKAdNetwork.

Observações:

  • Isso é o mesmo que definir skAdNetworkEnabled como True no método USingularSDKBPLibrary::Initialize .
  • A chamada desse método substitui o valor configurado em USingularSDKBPLibrary::Initialize.
  • A partir da versão 2.0.11 do Unreal Engine SDK, o SKAdNetwork é ativado por padrão.
Assinatura public void SkanRegisterAppForAdNetworkAttribution()
Exemplo de uso
USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();
Método SingularSDK SkanUpdateConversionValue
Descrição

Atualiza o valor de conversão de SKAdNetwork.

Observação: use esse método se você tiver selecionado a atualização manual do valor de conversão SKAdNetwork. Esse método funcionará somente se manualSKANConversionManagement estiver definido como True.

Assinatura public void SkanUpdateConversionValue(int conversionValue)
Exemplo de uso
  // Um evento de inscrição aconteceu
  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // Atualize o valor de conversão para 7
  USingularSDKBPLibrary::SkanUpdateConversionValue(7);
Método SingularSDK SkanGetConversionValue
Descrição Obtém o valor de conversão atual rastreado pelo Singular SDK.
Assinatura public int SkanGetConversionValue()
Exemplo de uso
int value = USingularSDKBPLibrary::SkanGetConversionValue();

Registro no valor de conversão SKAN atualizado

  1. Adicione #include "SingularDelegates.h" ao topo do arquivo de cabeçalho da classe em que deseja registrar o delegado.
  2. Adicione o seguinte à sua classe:

      // Um delegado para registrar que invoca o Valor de Conversão atualizado
      UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
      FOnConversionValueUpdated OnConversionValueUpdated;
      
      // O método que usaremos para registrar o delegado
      UFUNCTION()
      void NewConversionValue(int32 conversionValue);
  3. No arquivo cpp da classe, registre-se no evento:

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