Documento

Guia de integração do SDK do Unreal Engine

Guia para	Desenvolvedores Registro de alterações
Pré-requisitos	Acesso à conta Singular Download: Singular Unreal Engine SDK versão 2.5.0
Compatibilidade	Unreal Engine 4.23+
Guias de integração	Integração básica Acompanhamento de eventos e receita Implementação de links profundos Adicionando suporte a SKAdNetwork Opções avançadas

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 do iOS da Singular ajuda-o a implementar a SKAdNetwork sem problemas e com um esforço mínimo 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 da SKAdNetwork da Singular, consulte o guia de implementação da SKAdNetwork do SDK do iOS.

Implementação de SKAdNetwork no SDK do Unreal Engine

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

É possível 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	Predefinição	Descrição
skAdNetworkEnabled	Verdadeiro	Defina como true para ativar o suporte de SKAdNetwork.
manualSKANConversionManagement	Falso	Defina como true se pretender gerir o valor de conversão manualmente.

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

Se estiver a utilizar uma versão mais antiga do SDK, terá de ativar a SKAdNetwork definindo skAdNetworkEnabled para True.

Métodos SKAdNetwork

Método SingularSDK SkanRegisterAppForAdNetworkAttribution
Descrição	Registo para rastreio da SKAdNetwork. Notas: Isto é o mesmo que definir skAdNetworkEnabled para True no método USingularSDKBPLibrary::Initialize . A chamada deste 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 utilização	`USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();`
Método SingularSDK SkanUpdateConversionValue
Descrição	Actualiza o valor de conversão SKAdNetwork. Nota: Utilize este método se tiver selecionado a atualização manual do valor de conversão SKAdNetwork. Este método só funcionará se manualSKANConversionManagement estiver definido como True.
Assinatura	public void SkanUpdateConversionValue(int conversionValue)
Exemplo de utilização	`// A sign-up event happened USingularSDKBPLibrary::SendEvent("SignUp"); // Update the conversion value to 7 USingularSDKBPLibrary::SkanUpdateConversionValue(7);`
Método SingularSDK SkanGetConversionValue
Descrição	Obtém o valor de conversão atual monitorizado pelo Singular SDK.
Assinatura	public int SkanGetConversionValue()
Exemplo de utilização	`int value = USingularSDKBPLibrary::SkanGetConversionValue();`

Registo no valor de conversão SKAN atualizado

Adicione #include "SingularDelegates.h" ao topo do ficheiro de cabeçalho da classe que pretende registar o delegado.

Adicione o seguinte à sua classe:

// 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);

No ficheiro cpp da classe, registe-se no evento:

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

Guia de integração do Unreal Engine SDK

Guias de integração	Integração básica Acompanhamento de eventos e receitas Implementação de links profundos Adicionando suporte a SKAdNetwork Opções avançadas