Definindo Propriedades Globais

O Singular SDK permite definir propriedades personalizadas a serem enviadas para os servidores Singular juntamente com cada sessão e evento enviado pela aplicação. Essas propriedades podem representar qualquer informação que você queira sobre o usuário, o modo/status da aplicação ou qualquer outra coisa.

É possível 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.

Casos de utilização

Alguns casos de uso para propriedades globais são:

• Passar um identificador de um SDK de terceiros e, em seguida, usá-lo em um postback do Singular para o referido terceiro para fins de correspondência.
• Em uma aplicação de jogos, você pode definir uma propriedade chamada "Level" e configurá-la inicialmente como "0". Qualquer sessão e evento enviado do aplicativo será enviado com "Level": "0". Quando o utilizador subir de nível, a propriedade é reposta a "1" e assim sucessivamente.

Definição de propriedades globais através do objeto Config

Para definir propriedades globais antes de inicializar o SDK, use o método setGlobalProperty no objeto Config.

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. Use o parâmetro overrideExisting para dizer ao SDK se deve substituir uma propriedade existente com o novo valor ou não.

func getConfig() -> SingularConfig? {         
  // (Optional) Get 3rd-party identifiers to set in Global Properties:     


  // If 3rd-party SDKs are providing any identifiers to Singular, the


  // respective SDK must be initialized before Singular.     


  let thirdPartyKey = "anonymousID"     
  let thirdPartyID = "2ed20738-059d-42b5-ab80-5aa0c530e3e1"     
  
  // Singular Config Options     


  guard let config = SingularConfig(apiKey: Constants.APIKEY, 
    andSecret: Constants.SECRET) else {
      return nil
      }
  //...     
  // Using Singular Global Properties feature to capture third party identifiers


  config.setGlobalProperty(thirdPartyKey, withValue: thirdPartyID, overrideExisting: true)     
  //...
  return config 
}

- (SingularConfig *)getConfig {     
  // (Optional) Get 3rd-party identifiers to set in Global Properties:     


  // If 3rd-party SDKs are providing any identifiers to Singular, the


  // respective SDK must be initialized before Singular.     


  NSString* thirdPartyKey = @"anonymousID";
  NSString* thirdPartyID = @"2ed20738-059d-42b5-ab80-5aa0c530e3e1";     
  
  // Singular Config Options     


  SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY 
    andSecret:SECRET];
  //...
  
  // Using Singular Global Properties feature to capture 3rd-party identifiers     


  [config setGlobalProperty:thirdPartyKey withValue:thirdPartyID overrideExisting:YES];
  //...
  return config;
}

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.

var result = Singular.setGlobalProperty("propertyName",
  andValue: "propertyValue", overrideExisting: true)

BOOL result = [Singular setGlobalProperty:@"propertyName"
  andValue:@"propertyValue" overrideExisting:YES];

var globalProperties = Singular.getGlobalProperties()

NSDictionary* globalProperties = [Singular getGlobalProperties];

Singular.unsetGlobalProperty("propertyName")

[Singular unsetGlobalProperty:@"propertyName"];

Singular.clearGlobalProperties()

[Singular clearGlobalProperties];