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

# Blueprint di Ingestione

> Modelli di ingestione eventi pronti all'uso per casi d'uso comuni con codice di esempio.

I blueprint di ingestione sono modelli predefiniti per il tracciamento dell'uso in scenari comuni. Invece di dover capire le strutture degli eventi e le configurazioni dei misuratori da zero, inizia con un blueprint collaudato e personalizzalo per le tue esigenze.

## Cosa Sono i Blueprint?

Ogni blueprint include:

* **Raccomandazioni sulla struttura degli eventi**: Nomenclatura ottimale degli eventi e design dei metadati
* **Configurazione del misuratore**: Tipi di aggregazione e filtri suggeriti
* **Codice di esempio**: Esempi di implementazione funzionanti in più linguaggi
* **Migliori pratiche**: Suggerimenti per accuratezza, prestazioni e ottimizzazione dei costi

<Tip>
  I blueprint fanno risparmiare ore di configurazione e aiutano a evitare gli errori più comuni. Parti da un blueprint e poi adattalo ai tuoi requisiti specifici.
</Tip>

## Perché Usare i Blueprint?

<CardGroup cols={3}>
  <Card title="Faster Setup" icon="rocket">
    Ottieni il tracciamento dell'utilizzo in pochi minuti invece che in ore. Copia schemi già collaudati invece di progettarli da zero.
  </Card>

  <Card title="Best Practices Built In" icon="shield-check">
    Evita errori comuni con strutture di eventi testate, metadati corretti e scelte di aggregazione ottimali.
  </Card>

  <Card title="Production Ready" icon="code">
    Il codice di esempio è basato su implementazioni reali. Aggiungi solo le tue chiavi API e sei pronto.
  </Card>
</CardGroup>

## Blueprint Disponibili

Scegli il blueprint che corrisponde al tuo caso d'uso:

<CardGroup cols={1}>
  <Card title="LLM Blueprint" icon="brain-circuit" href="/developer-resources/ingestion-blueprints/llm">
    Traccia l'utilizzo dei token AI su OpenAI, Anthropic, Groq, Gemini, Vercel AI SDK e altro.

    **Perfetto per**: chatbot AI, generatori di codice, strumenti di creazione di contenuti, app potenziate da AI.

    **Cosa traccerai**: token di input, token di output, utilizzo del modello, conteggi delle richieste.
  </Card>

  <Card title="API Gateway Blueprint" icon="cloud" href="/developer-resources/ingestion-blueprints/api-gateway">
    Misura le richieste API a livello di gateway con supporto per il filtraggio degli endpoint e il rate limiting.

    **Perfetto per**: API REST, servizi GraphQL, fornitori di webhook, piattaforme API-first.

    **Cosa traccerai**: conteggi delle richieste, utilizzo degli endpoint, metodi HTTP, tempi di risposta.
  </Card>

  <Card title="Object Storage Blueprint" icon="box-archive" href="/developer-resources/ingestion-blueprints/object-storage">
    Traccia caricamenti di file, consumo di storage e larghezza di banda per servizi di archiviazione cloud.

    **Perfetto per**: hosting di file, piattaforme multimediali, servizi di backup, gestione documentale.

    **Cosa traccerai**: byte archiviati, caricamenti di file, download, snapshot di storage.
  </Card>

  <Card title="Stream Blueprint" icon="tower-broadcast" href="/developer-resources/ingestion-blueprints/stream">
    Misura la larghezza di banda dello streaming per video, audio e consegna di dati in tempo reale.

    **Perfetto per**: streaming video, piattaforme audio, trasmissioni in diretta, flussi di dati in tempo reale.

    **Cosa traccerai**: larghezza di banda consumata, durata dello streaming, livelli di qualità, stream simultanei.
  </Card>

  <Card title="Time Range Blueprint" icon="clock" href="/developer-resources/ingestion-blueprints/time-range">
    Fattura in base al tempo trascorso per risorse di calcolo, funzioni serverless e job di lunga durata.

    **Perfetto per**: piattaforme serverless, hosting di container, istanze di calcolo, elaborazione batch.

    **Cosa traccerai**: tempo di esecuzione, ore di calcolo, invocazioni delle funzioni, durata dei job.
  </Card>
</CardGroup>

## Come Usare un Blueprint

<Steps>
  <Step title="Choose your blueprint">
    Seleziona il blueprint che corrisponde meglio al tuo scenario di fatturazione. Ogni pagina di blueprint include guide di implementazione dettagliate.
  </Step>

  <Step title="Review the event structure">
    Comprendi il naming degli eventi e il design dei metadati consigliati. Copia la struttura degli eventi per il tuo caso d'uso.
  </Step>

  <Step title="Create the meter">
    Segui le istruzioni di configurazione dei meter del blueprint. Usa il tipo di aggregazione e i filtri suggeriti.
  </Step>

  <Step title="Implement event sending">
    Copia il codice di esempio per il tuo linguaggio/framework. Sostituisci i valori segnaposto con le tue chiavi API e ID cliente reali.
  </Step>

  <Step title="Test and verify">
    Invia eventi di test e verifica che compaiano nella dashboard del tuo meter con l'aggregazione corretta.
  </Step>

  <Step title="Customize as needed">
    Adatta il blueprint ai tuoi requisiti specifici: aggiungi metadati personalizzati, regola i filtri o modifica i prezzi.
  </Step>
</Steps>

## Confronto dei Blueprint

Non sei sicuro di quale blueprint si adatti alle tue esigenze? Ecco un rapido confronto:

| Caso d'uso        | Blueprint      | Aggregazione               | Metadati Comuni                        |
| ----------------- | -------------- | -------------------------- | -------------------------------------- |
| App chat AI       | LLM            | Somma (token)              | modello, input\_tokens, output\_tokens |
| API REST          | API Gateway    | Conteggio                  | endpoint, metodo, status\_code         |
| Storage file      | Object Storage | Somma (byte)               | file\_size, file\_type, operation      |
| Piattaforma video | Stream         | Somma (larghezza di banda) | durata, qualità, bitrate               |
| Serverless        | Time Range     | Somma (durata)             | function\_name, execution\_time\_ms    |

## Implementazioni Personalizzate

Non vedi un blueprint per il tuo caso d'uso esatto? Nessun problema:

1. **Inizia con il blueprint più vicino**: Scegli quello più simile alle tue esigenze
2. **Adatta la struttura dell'evento**: Modifica i campi dei metadati per soddisfare le tue esigenze
3. **Regola la configurazione del misuratore**: Cambia il tipo di aggregazione o i filtri se necessario
4. **Testa a fondo**: Verifica i calcoli di fatturazione con l'uso di esempio

<Info>
  Tutti i blueprint sono punti di partenza. Sentiti libero di mescolare concetti da blueprint diversi o creare implementazioni completamente personalizzate.
</Info>

## Hai Bisogno di Aiuto?

Se non sei sicuro di quale blueprint utilizzare o hai bisogno di aiuto per la personalizzazione:

<CardGroup cols={2}>
  <Card title="Complete Tutorial" icon="code" href="/developer-resources/usage-based-billing-build-ai-image-generator">
    Segui il nostro tutorial end-to-end costruendo un generatore di immagini AI con billing basato sull'utilizzo.
  </Card>

  <Card title="Integration Guide" icon="book" href="/developer-resources/usage-based-billing-guide">
    Guida completa che copre tutti gli aspetti dell'implementazione della fatturazione basata sull'utilizzo.
  </Card>
</CardGroup>