Vai al contenuto principale

​
Introduzione

Questa guida ti accompagna su come tracciare i riferimenti degli affiliati, gestire gli eventi di commissione e aumentare le tue entrate con partnership di affiliazione affidabili tramite Dodo Payments.

​
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 la nostra integrazione con Affonso, una piattaforma leader nel marketing di affiliazione.

​
Passaggi per l’Integrazione

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 in 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 riferimento (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 performance degli affiliati, traccia le registrazioni degli utenti come lead.
// After successful registration
window.Affonso.signup(userEmail);
Questo farà:
  • Registrare un nuovo riferimento come LEAD se l’utente è arrivato tramite un link affiliato
  • Visualizzarlo nel tuo dashboard e nelle statistiche dell’affiliato
Migliore prassi: attiva questo dopo una registrazione riuscita o un doppio opt-in (DOI).
5

Passa i Dati di Riferimento a Dodo Payments

Per attribuire correttamente le commissioni, passa l’ID di riferimento 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 protected]', 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

​
Hai Bisogno di Aiuto?

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

Supporto Affonso

Supporto Dodo Payments

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