Definindo propriedades globais

O Singular SDK permite definir propriedades personalizadas adicionais para enviar aos servidores Singular com cada sessão e evento enviado pelo aplicativo. Essas propriedades podem representar qualquer informação que você queira sobre o usuário, o modo ou status do aplicativo ou qualquer outra coisa. Depois de definir essas propriedades, elas ficam disponíveis como dimensões nos seus relatórios e você pode usá-las para dividir seus dados.

Por exemplo, se tiver uma aplicação de jogos, pode definir uma propriedade chamada "Nível" e defini-la inicialmente como "0". Qualquer sessão e evento enviado da aplicação será enviado com "Nível": "0". Quando o utilizador subir de nível, a propriedade é reposta a "1" e assim sucessivamente. Pode então obter os seus relatórios, incluindo sessões, contagens de eventos e dados de receitas, repartidos por nível de utilizador.

• Pode definir até 5 propriedades globais.
• Estas propriedades persistem entre execuções da aplicação (com o valor mais recente que lhes atribuiu) até que as desfaça ou o utilizador desinstale a aplicação.
• Cada nome e valor de propriedade pode ter até 200 caracteres. Se passar um nome ou valor de propriedade mais longo, este será truncado para 200 caracteres.
• As propriedades globais estão acessíveis e disponíveis em exportações e postbacks ao nível do utilizador. No futuro, será adicionado o suporte a relatórios agregados. Informe seu gerente de sucesso do cliente Singular se tiver alguma dúvida ou se estiver interessado em atualizações para o suporte a propriedades globais!

Implementação

Definindo Propriedades Globais através do SingularConfig

Se você já conhece a Propriedade Global quando o aplicativo é aberto, use o método withGlobalProperty para definir propriedades globais por meio de SingularConfig antes de inicializar o SDK.

Observe que, como as propriedades globais e seus valores persistem entre as execuções do aplicativo, a propriedade que você está definindo pode já estar definida com um valor diferente. Utilize o parâmetro overrideExisting para indicar ao SDK se deve substituir uma propriedade existente pelo novo valor ou não.

Definir propriedades globais após a inicialização

Utilize os seguintes métodos para definir, anular e recuperar propriedades globais em qualquer altura da execução da aplicação.

• Para definir as propriedades globais, use o método setGlobalProperty.
• Para desativar as Propriedades Globais, utilize o método unsetGlobalProperty.
• Para obter as Propriedades Globais, utilize o método getGlobalProperties.
• Para limpar as Propriedades Globais, utilize o método clearGlobalProperties.