Vai al contenuto principale

​
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

Attribuzione Automatica delle Commissioni

Niente fogli di calcolo o tracciamento manuale. I riferimenti vengono automaticamente attribuiti e registrati quando viene effettuato un acquisto.

Reportistica in Tempo Reale

Sia tu che i tuoi affiliati potete monitorare le performance e i lead da dashboard dedicate.

Opzioni di Tracciamento Flessibili

Utilizza script di tracciamento, campi di metadati e eventi webhook per catturare i dati di riferimento attraverso registrazioni e transazioni.

Completamente Crittografato e Sicuro

Tutte le credenziali sensibili e i dati webhook vengono scambiati e memorizzati in modo sicuro utilizzando la crittografia di livello superiore.

Configurazione Rapida

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.

Integrazione senza soluzione di continuità

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.

​
Opzioni di integrazione

Dodo Payments si integra con due piattaforme di gestione affiliati leader:
  • Affonso: Una piattaforma completa di gestione affiliati con tracciamento automatico delle commissioni, reportistica in tempo reale e dashboard dedicate agli affiliati.
  • Dub Partners: 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.
1

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
  • Vai a Dettagli del Programma > Collega
  • Clicca sulla scheda integrazione Dodo Payments
  • Incolla la tua chiave API di Dodo Payments
  • Clicca su Collega
La tua chiave API sarà crittografata in modo sicuro da Affonso.
2

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
Questo consente ad Affonso di verificare in modo sicuro gli eventi in arrivo da Dodo Payments.
3

Aggiungi lo Script di Tracciamento

Posiziona il pixel di Affonso sul tuo sito per iniziare a tracciare le visite e le conversioni degli affiliati.
<!-- 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
Posiziona questo su tutti i domini dove gli utenti visitano o convertono (es. sito di marketing, app).
4

Traccia le Registrazioni degli Utenti

Per ottenere visibilità nel funnel e ottimizzare le prestazioni degli affiliati, traccia le registrazioni degli utenti come lead.
// 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
Migliore pratica: attiva questo dopo una registrazione riuscita o un doppio opt-in (DOI).
5

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

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

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();

// 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}`;
Per ulteriori dettagli, consulta la documentazione API di Dodo Payments
6

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

​
Integrazione con Dub Partners

Puoi anche utilizzare Dub Partners 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.
Per istruzioni dettagliate sull’impostazione, consulta la nostra guida all’integrazione di Dub che copre come tracciare gli eventi di conversione delle vendite e attribuire le entrate ai tuoi link affiliati.

​
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

Scopri di più

Visualizza la guida completa all’integrazione di Dub con esempi di codice e modelli di trasformazione.

​
Hai bisogno di aiuto?

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

Supporto Affonso

Supporto Dub

Supporto Dodo Payments

Per domande specifiche sull’API di Dodo Payments, consulta docs.dodopayments.com o contatta il nostro team di supporto.

Guide all'Integrazione