Guía
Tutorial sobre Install Referrer
Usando @capgo/capacitor-install-referrer
@capgo/capacitor-install-referrer lee señales de atribución de instalación en aplicaciones Capacitor.
Utilízalo cuando necesites datos de Install Referrer de Google Play en Android y tokens de atribución de Apple AdServices en iOS a través de un solo API.
Instalar
bun add @capgo/capacitor-install-referrer
bunx cap sync
¿Qué Esta Plugin Exposa
getReferrerdevuelve detalles de atribución de instalación para Android o iOS.GetReferreres un alias de compatibilidad obsoleto para la migración desdecap-play-install-referrer.- Android devuelve la cadena de referrer de Play, el timestamp de clic, el timestamp de instalación y la bandera de aplicación instantánea.
- iOS devuelve un token de atribución de AdServices y puede obtener opcionalmente el payload de atribución de Apple.
Ejemplo de uso
import { InstallReferrer } from '@capgo/capacitor-install-referrer';
const result = await InstallReferrer.getReferrer();
if (result.platform === 'android') {
console.log(result.referrer);
}
if (result.platform === 'ios') {
console.log(result.attributionToken);
}
Payload de atribución de Apple
const result = await InstallReferrer.getReferrer({
fetchAppleAttribution: true,
appleAttributionRetryCount: 3,
appleAttributionRetryDelayMs: 5000,
});
console.log(result.appleAttribution);
Notas de plataforma
Android utiliza el servicio de instalador de referrer de Google Play y requiere una instalación de tienda Play para datos de referrer reales. iOS utiliza Apple AdServices porque Apple no proporciona un equivalente de referrer de instalación de tienda App Store genérica.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-install-referrer/
- Documentación: /docs/plugins/install-referrer/