> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Airship

> Collega Airship a storekit per inviare notifiche push, SMS e messaggi in-app basati sugli eventi degli ordini. Attiva messaggi di lifecycle e campagne di re-engagement.

Airship è una piattaforma di customer engagement per notifiche push, SMS e messaggistica in-app. L'integrazione storekit invia dati clienti e ordini per alimentare le tue campagne di messaging.

## Configurazione

1. Accedi al tuo account Airship
2. Vai su **Settings** → **Project Details**
3. Copia la tua **App Key** e il tuo **App Secret**
4. In storekit vai su **Settings** → **Integrations**
5. Inserisci le tue credenziali Airship
6. Salva le modifiche

## Dati sincronizzati

Quando un cliente effettua un ordine o invia un feedback, i seguenti dati vengono inviati ad Airship:

### Profilo cliente

| Campo        | Descrizione                 |
| ------------ | --------------------------- |
| `email`      | Indirizzo email del cliente |
| `first_name` | Nome                        |
| `last_name`  | Cognome                     |
| `phone`      | Numero di telefono          |

### Attributi ordine

| Attributo          | Descrizione                     |
| ------------------ | ------------------------------- |
| `order_count`      | Totale ordini effettuati        |
| `total_spent`      | Spesa totale nel tempo          |
| `last_order_date`  | Data dell'ordine più recente    |
| `last_order_value` | Importo dell'ordine più recente |
| `store_id`         | ID punto vendita                |
| `store_name`       | Nome punto vendita              |

### Eventi

| Evento            | Trigger                                    |
| ----------------- | ------------------------------------------ |
| `order_placed`    | Il cliente completa un ordine              |
| `order_accepted`  | L'ordine viene accettato dal punto vendita |
| `order_ready`     | L'ordine è pronto per il ritiro            |
| `order_delivered` | L'ordine è stato consegnato                |

### Feedback cliente

Quando i clienti inviano recensioni, il feedback viene sincronizzato automaticamente ad Airship con:

| Campo       | Descrizione                                               |
| ----------- | --------------------------------------------------------- |
| `type_id`   | Sentiment del feedback (1=positivo, 2=negativo, 3=neutro) |
| `source_id` | Sempre impostato a 1 (sito web)                           |
| `unit_id`   | Il tuo unit ID Airship                                    |
| `comments`  | Testo della recensione e valutazioni aggiuntive           |
| `ratings`   | Valutazione cibo, valutazione servizio e punteggio NPS    |

**Categorie di valutazione:**

* **Food** — Valutazione di qualità e gusto (1-5 stelle)
* **Service** — Valutazione dello staff e del servizio (1-5 stelle)
* **NPS** — Net Promoter Score calcolato dalla valutazione complessiva (scala 0-10)
* **Atmosphere** — Inclusa nella sezione commenti
* **Value for money** — Inclusa nella sezione commenti

Il feedback è classificato come:

* **Positivo** (type\_id: 1) — valutazioni 4-5 stelle
* **Negativo** (type\_id: 2) — valutazioni 1-2 stelle
* **Neutro** (type\_id: 3) — valutazione 3 stelle

<Note>
  I dati delle recensioni sono sincronizzati in tempo reale quando i clienti inviano il feedback. Tutte le categorie di valutazione vengono mappate correttamente per garantire un'accurata analisi del sentiment in Airship.
</Note>

## Casi d'uso

### Aggiornamenti sull'ordine

Invia notifiche push in tempo reale sullo stato dell'ordine:

1. Crea un'automazione attivata da `order_accepted`
2. Invia push: "Il tuo ordine è stato confermato!"
3. Crea un'automazione per `order_ready`
4. Invia push: "Il tuo ordine è pronto per il ritiro"

### Push promozionale

Stimola gli ordini con notifiche push mirate:

1. Segmenta per `last_order_date` > 7 giorni
2. Invia push con offerta a tempo limitato
3. Deep link alla tua pagina di ordinazione

### Messaggistica basata sulla posizione

Per i clienti vicini al tuo punto vendita:

1. Imposta un geofence intorno alla tua sede
2. Attiva un messaggio quando il cliente entra nella zona
3. Promuovi le offerte pranzo o l'happy hour

### Re-engagement

Riporta i clienti inattivi:

1. Segmento: nessun ordine da oltre 30 giorni
2. Invia una push personalizzata con un'offerta
3. Fai follow-up via email se non c'è risposta

### Campagne basate sul feedback

Rispondi automaticamente al feedback dei clienti:

1. Segmenta per feedback negativi (1-2 stelle)
2. Invia scuse personalizzate con codice sconto
3. Traccia il riscatto per misurare il recupero

Oppure premia i feedback positivi:

1. Segmenta per feedback positivi (4-5 stelle)
2. Ringrazia i clienti con punti fedeltà
3. Incoraggiali a condividere sui social

## Priorità dei canali

Configura quali canali usare per i diversi tipi di messaggi:

| Tipo di messaggio    | Canale consigliato |
| -------------------- | ------------------ |
| Aggiornamenti ordine | Notifica push      |
| Promozioni           | Push + Email       |
| Sondaggi             | Email              |
| Avvisi urgenti       | SMS                |

## Correlati

<CardGroup cols={2}>
  <Card title="Dati cliente" icon="users" href="/docs/it/guides/marketing/customer-data">
    Visualizza ed esporta i dati dei clienti
  </Card>

  <Card title="Feedback cliente" icon="star" href="/docs/it/guides/marketing/customer-feedback">
    Raccogli recensioni dei clienti
  </Card>
</CardGroup>


## Related topics

- [Panoramica sulle integrazioni](/docs/it/guides/integrations/overview.md)