> ## 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.

# Affiliati

> Lancia e gestisci il tuo programma di affiliazione mentre elabori le transazioni tramite Dodo Payments.

## Introduzione

Questa guida ti guida su come tracciare i referral affiliati, gestire eventi di commissione e aumentare le tue entrate con partnership affiliate affidabili tramite Dodo Payments. Offriamo integrazioni con le principali piattaforme affiliate, tra cui **Affonso** e **Dub Partners**, per aiutarti a gestire e tracciare i tuoi programmi di affiliazione senza problemi.

## Caratteristiche Principali

<CardGroup cols={2}>
  <Card title="Attribuzione Automatica delle Commissioni" icon="robot">
    Niente fogli di calcolo o tracciamento manuale. I riferimenti vengono automaticamente attribuiti e registrati quando viene effettuato un acquisto.
  </Card>

  <Card title="Reportistica in Tempo Reale" icon="chart-line">
    Sia tu che i tuoi affiliati potete monitorare le performance e i lead da dashboard dedicate.
  </Card>

  <Card title="Opzioni di Tracciamento Flessibili" icon="code">
    Utilizza script di tracciamento, campi di metadati e eventi webhook per catturare i dati di riferimento attraverso registrazioni e transazioni.
  </Card>

  <Card title="Completamente Crittografato e Sicuro" icon="shield">
    Tutte le credenziali sensibili e i dati webhook vengono scambiati e memorizzati in modo sicuro utilizzando la crittografia di livello superiore.
  </Card>

  <Card title="Configurazione Rapida" icon="bolt">
    Lancia il tuo programma di affiliazione in pochi minuti: nessuna modifica al codice richiesta oltre al copia-incolla di frammenti di script e token API.
  </Card>

  <Card title="Integrazione senza soluzione di continuità" icon="plug">
    Collega il tracciamento degli affiliati direttamente nei tuoi flussi di checkout utilizzando le nostre integrazioni con Affonso e Dub Partners, le principali piattaforme di marketing affiliato.
  </Card>
</CardGroup>

## Opzioni di integrazione

Dodo Payments si integra con due piattaforme di gestione affiliati leader:

* **[Affonso](https://affonso.io)**: Una piattaforma completa di gestione affiliati con tracciamento automatico delle commissioni, reportistica in tempo reale e dashboard dedicate agli affiliati.
* **[Dub Partners](https://dub.co)**: Utilizza la gestione dei link e il tracciamento delle conversioni di Dub per potenziare il tuo programma di affiliazione con analisi dettagliate di attribuzione.

Scegli la piattaforma che meglio si adatta alle tue esigenze, oppure utilizza entrambe per casi d'uso diversi.

## Integrazione con Affonso

Abbiamo collaborato con Affonso, una piattaforma leader nella gestione degli affiliati, per potenziare le tue vendite. Segui i passaggi qui sotto per collegare il tuo account Dodo Payments con Affonso e iniziare a tracciare le vendite generate dagli affiliati.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/8tw8o9yOjsA" title="Integrazione Affiliati | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<Steps>
  <Step title="Collegati a Dodo Payments">
    Per iniziare, collega il tuo account Dodo Payments aggiungendo la tua chiave API.

    ### Come ottenere la tua chiave API di Dodo Payments

    * Accedi al tuo **Dashboard di Dodo Payments**
    * Vai alla sezione **Sviluppatore** nel menu a sinistra
    * Clicca su **Chiavi API**
    * Seleziona **Aggiungi Chiave API**
    * Dagli un nome (es. "Integrazione Affonso")
    * Clicca su **Crea** e **copia** la tua chiave API

    ### Aggiungi la tua chiave API a Affonso

    * Apri il tuo **Dashboard di Affonso tramite** [affonso.io](https://affonso.io/)
    * Vai a **Dettagli del Programma > Collega**
    * Clicca sulla scheda **integrazione Dodo Payments**
    * Incolla la tua chiave API di Dodo Payments
    * Clicca su **Collega**

    <Callout type="info">
      La tua chiave API sarà crittografata in modo sicuro da Affonso.
    </Callout>
  </Step>

  <Step title="Aggiungi Webhook a Dodo Payments">
    Una volta collegato, riceverai un URL webhook unico da Affonso. Questo consente il tracciamento dei pagamenti e l'attivazione delle commissioni affiliate.

    ### Aggiungi l'URL Webhook in Dodo Payments

    * Nel tuo Dashboard di Dodo Payments, vai su **Sviluppatore → Webhooks**
    * Clicca su **Aggiungi Webhook**
    * Incolla il tuo **URL webhook di Affonso** (dalle impostazioni del tuo programma)
    * Salva il webhook

    ### Aggiungi il Segreto Webhook in Affonso

    * Dopo aver salvato il webhook in Dodo Payments, **copia la chiave di firma** fornita
    * Incollala di nuovo in Affonso sotto le **impostazioni webhook di Dodo Payments**

    <Callout type="info">
      Questo consente ad Affonso di verificare in modo sicuro gli eventi in arrivo da Dodo Payments.
    </Callout>
  </Step>

  <Step title="Aggiungi lo Script di Tracciamento">
    Posiziona il pixel di Affonso sul tuo sito per iniziare a tracciare le visite e le conversioni degli affiliati.

    ```html theme={null}
    <!-- Place in <head> tag -->
    <script async defer
    src="https://affonso.io/js/pixel.min.js"
    data-affonso="YOUR_PUBLIC_PROGRAM_ID"
    data-cookie_duration="YOUR_COOKIE_DURATION">
    </script>
    ```

    Questo script:

    * Traccia le visite degli affiliati
    * Imposta un cookie con l'ID di referral (`affonso_referral`)
    * Abilita il tracciamento delle registrazioni e dei pagamenti

    <Callout type="info">
      Posiziona questo su tutti i domini dove gli utenti visitano o convertono (es. sito di marketing, app).
    </Callout>
  </Step>

  <Step title="Traccia le Registrazioni degli Utenti">
    Per ottenere visibilità nel funnel e ottimizzare le prestazioni degli affiliati, traccia le registrazioni degli utenti come lead.

    ```js theme={null}
    // After successful registration
    window.Affonso.signup(userEmail);
    ```

    Questo:

    * Registra un nuovo referral come **LEAD** se l'utente è arrivato tramite un link affiliato
    * Lo visualizza nel tuo dashboard e nelle statistiche dell'affiliato

    <Callout type="info">
      Migliore pratica: attiva questo dopo una registrazione riuscita o un doppio opt-in (DOI).
    </Callout>
  </Step>

  <Step title="Passa i Dati di Referral a Dodo Payments">
    Per attribuire correttamente le commissioni, passa l'ID di referral da Affonso a Dodo Payments durante il checkout.

    ### Integrazione Pagamenti

    ```js theme={null}
    import DodoPayments from 'dodopayments';

    const referralId = window.affonso_referral;

    const client = new DodoPayments({
      bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
    });

    async function main() {
      const payment = await client.payments.create({
        payment_link: true,
        billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
        customer: { email: 'email@email.com', name: 'name' },
        product_cart: [{ product_id: 'product_id', quantity: 0 }],
        metadata: {
          affonso_referral: referralId,
        },
      });

      console.log(payment.payment_id);
    }

    main();
    ```

    ### Integrazione Abbonamenti

    ```js theme={null}
    import DodoPayments from 'dodopayments';

    const referralId = window.affonso_referral;

    const client = new DodoPayments({
      bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
    });

    async function main() {
      const subscription = await client.subscriptions.create({
        billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
        customer: { customer_id: 'customer_id' },
        product_id: 'product_id',
        payment_link: true,
        return_url: 'https://example.com/success',
        quantity: 1,
        metadata: {
          affonso_referral: referralId,
        },
      });

      console.log(subscription.subscription_id);
    }

    main();
    ```

    ### Link di Pagamento

    ```js theme={null}
    // Original Dodo Payments Link
    const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

    // Append referral ID as reference_id
    const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
    ```

    <Callout type="info">
      Per ulteriori dettagli, consulta la [documentazione API di Dodo Payments](https://docs.dodopayments.com/api-reference/introduction)
    </Callout>
  </Step>

  <Step title="Testa la tua Integrazione">
    Prima di lanciare pubblicamente, testa la tua configurazione con link affiliati attivi e transazioni di prova.

    **Checklist di Test:**

    * ✅ Crea un affiliato e genera un link di tracciamento
    * ✅ Visita il tuo sito tramite il link affiliato
    * ✅ Assicurati che lo script di Affonso si carichi e che il cookie `affonso_referral` sia impostato
    * ✅ Completa una registrazione (opzionale)
    * ✅ Completa un pagamento tramite Dodo Payments
    * ✅ Conferma il tracciamento e l'attribuzione nel tuo dashboard di Affonso
  </Step>
</Steps>

## Integrazione con Dub Partners

Puoi anche utilizzare [Dub Partners](https://dub.co) per tracciare i referral e le conversioni degli affiliati. La funzione di tracciamento delle conversioni di Dub ti consente di attribuire le vendite ai tuoi link affiliati, fornendo analisi dettagliate su quali partner generano il maggior fatturato.

<Info>
  Per istruzioni dettagliate sull'impostazione, consulta la nostra [guida all'integrazione di Dub](/integrations/dub) che copre come tracciare gli eventi di conversione delle vendite e attribuire le entrate ai tuoi link affiliati.
</Info>

### Configurazione Rapida con Dub Partners

1. **Abilita il tracciamento delle conversioni** nel tuo dashboard di Dub per i link affiliati
2. **Cattura l'ID clic di Dub** (`dub_id` cookie) durante la creazione delle sessioni di checkout
3. **Memorizza l'ID clic** nei metadati di pagamento insieme alle informazioni del cliente
4. **Configura l'integrazione webhook** per inviare i dati di vendita a Dub quando i pagamenti hanno successo

L'integrazione traccia automaticamente:

* Pagamenti una tantum
* Attivazioni di abbonamenti
* Pagamenti ricorrenti di abbonamenti

<Card title="Scopri di più" icon="book" href="/integrations/dub">
  Visualizza la guida completa all'integrazione di Dub con esempi di codice e modelli di trasformazione.
</Card>

## Hai bisogno di aiuto?

Se riscontri problemi o hai bisogno di supporto durante l'integrazione:

<CardGroup cols={2}>
  <Card title="Supporto Affonso" icon="headset">
    * Chattaci tramite **chat dal vivo** su [affonso.io](https://affonso.io/)
    * Inviaci un'email a **[support@affonso.io](mailto:support@affonso.io)**
  </Card>

  <Card title="Supporto Dub" icon="headset">
    * Visita la [documentazione di Dub](https://dub.co/docs) per guide sul tracciamento delle conversioni
    * Contatta il supporto di Dub tramite il loro [dashboard](https://app.dub.co)
  </Card>

  <Card title="Supporto Dodo Payments" icon="headset">
    Per domande specifiche sull'API di Dodo Payments, consulta docs.dodopayments.com o contatta il nostro team di supporto.
  </Card>

  <Card title="Guide all'Integrazione" icon="book">
    * [Integrazione Affonso](#affonso-integration) (sopra)
    * [Integrazione Dub Partners](/integrations/dub)
  </Card>
</CardGroup>