Iniziare

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-android-inline-install`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/it/docs/plugins/android-inline-install/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installazione

npm install @capgo/capacitor-android-inline-install
npx cap sync

yarn add @capgo/capacitor-android-inline-install
npx cap sync

pnpm add @capgo/capacitor-android-inline-install
npx cap sync

bun add @capgo/capacitor-android-inline-install
npx cap sync

Esempio di Utilizzo

import { AndroidInlineInstall } from '@capgo/capacitor-android-inline-install';

// Basic inline install
await AndroidInlineInstall.startInlineInstall({
  id: 'com.example.targetapp'
});

// Advanced install with tracking
await AndroidInlineInstall.startInlineInstall({
  id: 'com.example.targetapp',
  referrer: 'campaign=my-campaign&source=app',
  overlay: true,
  fallback: true
});

// Handle the installation flow
try {
  await AndroidInlineInstall.startInlineInstall({
    id: 'com.spotify.music',
    referrer: 'utm_source=myapp&utm_campaign=music_promotion'
  });
  console.log('Install overlay triggered successfully');
} catch (error) {
  console.error('Install failed:', error);
}

Metodi API Principali

Gestione dell’Installazione

startInlineInstall(options) - Attiva l’overlay di installazione inline di Google Play per l’app specificata

Opzioni di Configurazione

interface InlineInstallOptions {
  id: string;           // Nome del pacchetto dell'app di destinazione (obbligatorio)
  referrer?: string;    // Stringa della campagna di tracciamento (opzionale)
  callerId?: string;    // Nome del pacchetto dell'app chiamante (predefinito: app corrente)
  overlay?: boolean;    // Abilita/disabilita overlay di Play (predefinito: true)
  fallback?: boolean;   // Usa la pagina completa dello store se l'overlay fallisce (predefinito: true)
}

Requisiti di Google Play

Idoneità per Premium Growth Tools

La tua app deve qualificarsi per i Premium Growth Tools di Google Play per utilizzare l’installazione inline:

App con un coinvolgimento utente significativo
Buone valutazioni e recensioni su Play Store
Conformità alle politiche di Google Play

Requisiti dell’App di Destinazione

L’app di destinazione deve essere disponibile su Google Play Store
L’app di destinazione deve supportare l’installazione inline
L’utente deve aver effettuato l’accesso a Google Play Store

Comportamento e Fallback

Modalità Overlay (predefinita)

Tenta di aprire l’overlay di Google Play all’interno della tua app
Se l’overlay non è disponibile, torna alla pagina completa di Play Store
Se Play Store non è disponibile, mostra un errore

Modalità Store Completo

Apre direttamente la pagina completa di Google Play Store
Bypassa completamente il tentativo dell’overlay

Supporto Piattaforme

Android: Supporto completo con Google Play Services
iOS: Non supportato (funzionalità specifica per Android)
Web: Non supportato (funzionalità nativa Android)

Dettagli di Implementazione

Il plugin utilizza intent Android per comunicare con Google Play Store:

Action intent per overlay di installazione inline
Fallback all’intent standard di Play Store
Gestione automatica della disponibilità di Play Services

Casi d’Uso

Scoperta di app: Promuovi app correlate all’interno del tuo ecosistema
Promozione incrociata: Aumenta le installazioni per applicazioni partner
Sblocco di funzionalità: Installa moduli o estensioni aggiuntive
App complementari: Installa applicazioni di supporto senza interruzioni

Migliori Pratiche

Fornisci sempre opzioni di fallback per utenti senza Play Services
Testa con diverse configurazioni di dispositivo e versioni di Play Store
Utilizza il tracciamento referrer per misurare i tassi di conversione
Gestisci gli errori di installazione in modo elegante
Rispetta la scelta dell’utente se rifiuta l’installazione

Limitazioni

Funzionalità solo per Android
Richiede Google Play Services
Funziona solo con app qualificate per Premium Growth Tools
Soggetto alle politiche e alla disponibilità di Google Play Store