Identificacion
Registra y actualiza usuarios con identify().
identify() registra o actualiza al usuario y envia el device token automaticamente. El idioma del dispositivo se detecta y envia automaticamente.
Llamalo en cada inicio de app una vez que conozcas la identidad del usuario.
Uso
final res = await SouthGamesSDK.identify(
externalId: 'user_123',
email: 'user@example.com',
firstName: 'Juan',
lastName: 'Perez',
phone: '+56912345678',
customParams: {'tier': 'gold'},
);
print(res.clientId); // ID unico en SouthGames
print(res.created); // true si es nuevo
print(res.deviceTokenSent); // true si el token fue enviado
Parametros
| Parametro | Tipo | Descripcion |
|---|---|---|
| externalId* | String | ID del usuario en tu plataforma |
| String? | Email del usuario | |
| firstName | String? | Nombre |
| lastName | String? | Apellido |
| phone | String? | Telefono |
| latitude | double? | Latitud |
| longitude | double? | Longitud |
| customParams | Map<String, dynamic>? | Parametros custom (se mergean con existentes) |
| attribution | Attribution? | Datos de atribucion (utmSource, utmMedium, utmCampaign, etc.) |
Respuesta: RegisterResponse
| Campo | Tipo | Descripcion |
|---|---|---|
clientId | String | ID unico del cliente en SouthGames |
created | bool | true si el cliente es nuevo |
deviceTokenSent | bool | true si el device token fue incluido |
Registro manual
Si necesitas mas control, usa registerClient() directamente:
final res = await SouthGamesSDK.registerClient(
externalId: 'user_123',
email: 'user@example.com',
deviceToken: 'fcm_or_apns_token',
);
Debug
El SDK imprime logs con el prefijo [SouthGames] en la consola de debug. Si el token no se envia, busca mensajes como:
"No tokenProvider configured"— no configurastetokenProvidereninit()"tokenProvider returned null"— el provider no retorno un token