SDK do Unity - Referência dos métodos de configuração

Documento de referência

SDK do Unity - Referência de configuração

Este documento fornece uma referência abrangente para todas as opções de configuração disponíveis no Singular SDK para aplicativos Unity. A configuração é realizada através do componente SingularSDK MonoBehaviour, que pode ser anexado a um GameObject na sua cena Unity ou configurado através do Unity Inspetor. Cada propriedade de configuração é apresentada com uma descrição, uma assinatura e exemplos práticos de utilização.

Exemplo de configuração completa

Configuração abrangente do SDK

O exemplo a seguir demonstra como configurar o SDK Singular com várias opções. A configuração pode ser feita através do Unity Inspetor no SingularSDKObject GameObject.

Painel do Inspetor do SingularSDKObject

unity_singularsdkobject.png

Domínios de marca

Define os domínios de marca para atribuição web-to-app. Isso permite que o Singular SDK reconheça o domínio de rastreamento personalizado e permita a abertura do aplicativo.

Exemplo de uso

yourcompany.com
go.yourcompany.com
promo.yourcompany.com

Atribuição da área de transferência

Use esta caixa de seleção para ativar a atribuição da área de transferência para iOS. Quando ativada, o SDK lê a área de transferência na inicialização do aplicativo para detetar links de atribuição. Somente iOS.


Recolher OAID

Marque esta caixa para ativar a recolha de OAID (Open Anonymous Device Identifier) em dispositivos Android. O OAID é usado como um identificador alternativo em regiões onde o Google Advertising ID não está disponível. Apenas Android.


Tempo limite de ddl em segundos

Define o tempo limite em segundos para a resolução diferida de links profundos. Isso determina quanto tempo o SDK aguardará por um deep link adiado antes de continuar com a inicialização. O valor padrão é 60 segundos.


Ativar registro em log

Marque esta caixa para ativar o registro do SDK. Quando ativado, o SDK emitirá informações de depuração para ajudar na integração e na solução de problemas. Deve ser desativado em compilações de produção.


Ativar ODM com intervalo de tempo limite

Ativa o ODM (On-Device Matching) com um intervalo de tempo limite especificado em segundos. O ODM permite uma atribuição mais precisa ao fazer a correspondência das impressões digitais do dispositivo. Defina como -1 para desativar. Apenas iOS.


ID do aplicativo do Facebook

Define a ID do aplicativo do Facebook para a integração de atribuição do Facebook. Isso permite que o SDK rastreie a atribuição de campanha do Facebook. Apenas Android.


Inicializar ao acordar

Determina se o SDK deve ser inicializado automaticamente quando o GameObject é ativado. Quando definido como false, é necessário chamar manualmente InitializeSingularSDK() para inicializar o SDK.


Limitar identificadores de publicidade

Ativa o modo de identificadores de publicidade limitados em aplicações de público misto. Esta opção afecta a forma como o SDK recolhe e utiliza identificadores de dispositivos para rastreio. Se estiver activada, os Identificadores de publicidade não serão recolhidos.


Nível de registo

Define o nível de registo para o registo do SDK. Os valores válidos são: 0 (Nenhum), 1 (Erro), 2 (Aviso), 3 (Info/Debug), 4 (Verbose). Os valores mais elevados fornecem uma saída de registo mais detalhada.


Gestão manual de conversões SKAN

Ativa a gestão manual do valor de conversão SKAdNetwork. Quando ativado, é necessário atualizar manualmente os valores de conversão utilizando SkanUpdateConversionValue(). Apenas iOS.


Caminhos de ligação das notificações push

Especifica os caminhos JSON onde os URLs de links profundos podem ser encontrados em cargas de notificação push. Isso permite que o SDK extraia e processe links profundos de notificações por push. Somente iOS.

notification/deep_link
data/url
custom_link


Tempo limite da sessão em segundos

Define o tempo limite da sessão em segundos. Isso determina quanto tempo uma sessão de usuário dura depois que o aplicativo vai para o segundo plano. O valor padrão é 60 segundos.


Tempo limite de resolução de links curtos

Define o tempo limite em segundos para a resolução de links curtos. Isso determina quanto tempo o SDK aguardará para que um link curto seja resolvido. O valor padrão é 10 segundos.


Chave de API singular

Define a chave de API singular para seu aplicativo. Esse é um valor de configuração obrigatório que identifica seu aplicativo para a plataforma Singular. Você pode encontrar sua chave de API no painel do Singular.


Segredo da API Singular

Define o segredo da API Singular para seu aplicativo. Este é um valor de configuração obrigatório usado juntamente com a chave da API para comunicação segura. Pode encontrar o seu segredo da API no painel do Singular.


SKAN ativado

Habilita ou desabilita a funcionalidade SKAdNetwork. Quando ativado, o SDK se registrará automaticamente para a atribuição de SKAdNetwork e gerenciará os valores de conversão. Somente iOS.


Aguardar autorização de rastreamento com intervalo de tempo limite

Define o tempo limite em segundos para aguardar a autorização ATT (App Tracking Transparency) antes de inicializar o SDK. Defina como 0 para não esperar. Apenas iOS.