Atribución

Captura datos de atribución desde tracking links, deep links y UTM parameters.

El SDK permite capturar datos de atribución para medir de dónde vienen tus usuarios. Los datos se envían automáticamente al registrar o identificar un cliente.

Modelo Attribution

final attr = Attribution(
  utmSource: 'meta',
  utmMedium: 'cpc',
  utmCampaign: 'black-friday-2026',
  utmContent: 'banner-azul',
  utmTerm: 'juegos-gratis',
  linkId: 'abc123',  // ID del tracking link de SouthGames
);

Enviar con identify()

Pasa la atribución directamente al identificar al usuario:

final attr = Attribution(
  utmSource: 'meta',
  utmMedium: 'cpc',
  utmCampaign: 'black-friday',
);

await SouthGamesSDK.instance.identify(
  externalId: 'user_123',
  attribution: attr,
);

Parsear desde deep link

Cuando tu app recibe un deep link, parsea la atribución automáticamente:

// Deep link: southgames://open?utm_source=meta&utm_campaign=bf2026&linkId=abc
final attr = Attribution.fromUri(deepLinkUri);
await SouthGamesSDK.instance.identify(
  externalId: 'user_123',
  attribution: attr,
);

Parsear desde Android Install Referrer

En Android, el Install Referrer API entrega los UTM params del link de Play Store:

// Los params vienen como Map<String, String>
final attr = Attribution.fromMap(installReferrerParams);
SouthGamesSDK.instance.setAttribution(attr);
// Se envía automáticamente en el próximo identify() o registerClient()

setAttribution() (previo al identify)

Si capturas la atribución antes de conocer la identidad del usuario, guárdala con setAttribution(). Se enviará automáticamente en el próximo identify() o registerClient():

// Al recibir un deep link (antes del login)
SouthGamesSDK.instance.setAttribution(
  Attribution(utmSource: 'google', utmMedium: 'cpc'),
);

// Más tarde, al hacer login:
await SouthGamesSDK.instance.identify(externalId: 'user_123');
// La atribución se envió automáticamente y se limpia

Clientes anónimos

Si el SDK registra un dispositivo anónimo (register-device) y hay atribución guardada vía setAttribution(), también se envía en ese registro.

Tracking Links

Los tracking links de SouthGames (/go/{shortCode}) redirigen al usuario y setean una cookie sg_attr con los datos de atribución. Si tu app web lee esa cookie al registrar, los datos se envían automáticamente.

Para apps móviles, el tracking link redirige al store con referrer params (Android) o a la URL de destino configurada.