Saltar al contenido principal
Volver a plugins
@capgo/capacitor-install-referrer
Tutoría
por github.com/Cap-go

Instalar referente

Leer datos de instalación de Google Play y atribución de Apple AdServices desde Capacitor

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

  • getReferrer devuelve detalles de atribución de instalación para Android o iOS.
  • GetReferrer es un alias de compatibilidad obsoleto para la migración desde cap-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