Saltar al contenido principal
@capgo/capacitor-install-referrer Analíticas Código abierto

Instalar Referrer plugin Capacitor

Lee los datos de install referrer de Google Play y la atribución de Apple AdServices desde Capacitor

Instalar

bun add @capgo/capacitor-install-referrer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-install-referrer
  • pnpm add @capgo/capacitor-install-referrer
  • yarn add @capgo/capacitor-install-referrer

Guía

Cómo usar Install Referrer en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin Install Referrer code

Uso de @capgo/capacitor-install-referrer

@capgo/capacitor-install-referrer lee señales de atribución de instalación en apps Capacitor.

Úsalo cuando necesites datos de Google Play Install Referrer en Android y tokens de atribución de Apple AdServices en iOS mediante un único API.

Instalar

bun add @capgo/capacitor-install-referrer
bunx cap sync

Lo que expone este plugin

  • getReferrer devuelve detalles de atribución de instalación para Android o iOS.
  • GetReferrer es un alias de compatibilidad obsoleto para migrar desde cap-play-install-referrer.
  • Android devuelve el Play referrer string, el timestamp del clic, el timestamp de instalación y el flag de instant app.
  • 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 la plataforma

Android usa el servicio Google Play Install Referrer y requiere una instalación de la Play Store para datos reales. iOS usa Apple AdServices ya que Apple no ofrece un equivalente genérico de referente de instalación de la App Store.

Referencia completa

Continúa desde Usar @capgo/capacitor-install-referrer

Si estás usando Uso de @capgo/capacitor-install-referrer para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-install-referrer por el detalle de implementación en @capgo/capacitor-install-referrer, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Install Referrer

¿Cómo instalo el plugin Install Referrer en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-install-referrer" (o "npm install @capgo/capacitor-install-referrer"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-install-referrer" en el code de tu app.

¿Funciona @capgo/capacitor-install-referrer con React, Vue y Angular?

Sí. Install Referrer es un paquete de Capacitor, por lo que funciona con cualquier framework web que corra dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-install-referrer?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-install-referrer gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-install-referrer/ y el paquete es gratuito en npm. Se aceptan reportes de bugs y pull requests.

¿Puedo actualizar code que usa Install Referrer sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Install Referrer sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo