Definición de propiedades globales

Singular SDK permite definir propiedades personalizadas que se enviarán a los servidores de Singular junto con cada sesión y evento enviado desde la aplicación. Estas propiedades pueden representar cualquier información que desee sobre el usuario, el modo/estado de la aplicación o cualquier otra cosa.

Puedes definir hasta 5 propiedades globales. Persisten entre ejecuciones de la aplicación (con el último valor que les haya dado) hasta que las desactive o el usuario desinstale la aplicación.

Casos de uso

Algunos casos de uso para las propiedades globales son:

• Pasar un identificador desde un SDK de terceros y luego usarlo en un postback desde Singular a dicho tercero para propósitos de emparejamiento.
• En una app de juegos, puedes definir una propiedad llamada "Nivel" y establecerla inicialmente a "0". Cualquier sesión y evento enviado desde la app será enviado con "Level": "0". Una vez que el usuario suba de nivel, restableces la propiedad a "1" y así sucesivamente.

Configuración de propiedades globales a través del objeto Config

Para establecer propiedades globales antes de inicializar el SDK, utilice el método setGlobalProperty en el objeto Config.

Tenga en cuenta que como las propiedades globales y sus valores persisten entre ejecuciones de la aplicación, la propiedad que está estableciendo puede estar ya establecida en un valor diferente. Utilice el parámetro overrideExisting para indicar al SDK si debe anular una propiedad existente con el nuevo valor o no.

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;
}

Establecer propiedades globales después de la inicialización

Utilice los siguientes métodos para establecer, desestablecer y recuperar propiedades globales en cualquier momento de la ejecución de la aplicación.

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];