Affiliate Manager: Importa Campagne, Affiliati e Commissioni da FirstPromoter

Benvenuto! Questa guida mostra come migrare i tuoi programmi FirstPromoter in HITLEAD Affiliate Manager usando la nuova importazione guidata. Porterai campagne, affiliati e commissioni storiche — senza CSV — così puoi gestire tutto in un unico posto con reportistica accurata.

---

INDICE

• Cos'è l'Importazione Guidata di FirstPromoter?
• Vantaggi Chiave dell'Importazione da FirstPromoter
• Come Configurare l'Importazione da FirstPromoter
• Domande Frequenti

---

Cos'è l'Importazione Guidata di FirstPromoter?

L'importazione guidata è un Workflow basato su API che connette il tuo spazio di lavoro FirstPromoter a HITLEAD. Dopo una rapida verifica delle credenziali, selezioni le campagne da importare e verifichi eventuali conflitti di contatti prima di procedere. Questo garantisce dati puliti, storico preservato e una transizione più rapida rispetto alle esportazioni manuali.

• Connetti il tuo account FirstPromoter con Account ID e API Key
• Seleziona le campagne e le preferenze di importazione
• Verifica/risolvi i conflitti email, poi importa

---

Vantaggi Chiave dell'Importazione da FirstPromoter

Capire il valore di questa funzione ti aiuta a decidere quando usare l'importatore e come migliora le operazioni affiliate e la reportistica.

• Setup rapido: Procedura guidata in tre passaggi, senza codice, per connettere, selezionare e importare.
• Continuità storica: Preserva referral e commissioni passati per una visibilità accurata su trend e pagamenti.
• Contatti puliti: Rilevamento intelligente delle email duplicate con opzioni di unione/esclusione per evitare record disordinati.
• Controllo sui pagamenti: Scegli di includere le Pending Commissions e imposta i Payout Terms così gli elementi importati rispettano la tua cadenza di pagamento.
• Analisi unificata: Campagne e affiliati appaiono nei Dashboard di Affiliate Manager insieme agli altri tuoi indicatori di performance.

---

Come Configurare l'Importazione da FirstPromoter

Segui questi passaggi chiari e ripetibili per eseguire l'importatore dall'inizio alla fine con il minor numero di errori.

Apri la Procedura Guidata di Importazione

Marketing → Affiliate Manager → Campaigns → Import.

Connetti FirstPromoter

Incolla il tuo Account ID e la tua API Key → Connect & Fetch.

Dove trovare le credenziali in FirstPromoter: Settings → API & Webhooks → copia l'Account ID e genera un'API Key con permessi di lettura per affiliati e campagne.

Seleziona le Campagne

Spunta le campagne che vuoi migrare. Verifica stato, regole di commissione, numero di affiliati e durata del cookie. Scegli esattamente quali programmi migrare e visualizza in anteprima i dettagli principali (stato, tipo di commissione, numero di affiliati, durata cookie) per evitare di importare elementi sbagliati.

• Usa la ricerca e le caselle di spunta per selezionare le campagne.
• Verifica le colonne come Status, Affiliate, Commissions e Cookie life.
• Nota: Se FirstPromoter mostra pagamenti elaborati tramite Stripe, questo riflette la tua configurazione originale di FirstPromoter.

Imposta le Preferenze

Attiva Pending Commissions se necessario e conferma i Payout Terms. Personalizza cosa viene importato e come verranno pianificati i pagamenti così il tuo flusso finanziario rimane coerente dopo la migrazione.

• Pending Commissions (toggle): Includi le commissioni non pagate da FirstPromoter se vuoi tracciarle immediatamente in HITLEAD.
• Current Payout Terms (menu a tendina, es. Net-30 (30 days after month ends)): Determina quando le commissioni importate diventano esigibili all'interno di Affiliate Manager.

Verifica gli Affiliati

In Affiliate Management, risolvi eventuali Conflicts scegliendo Merge o Skip. I nuovi affiliati vengono creati automaticamente come Contatti. Se un'email esiste già, risolverai il conflitto per mantenere un unico profilo CRM pulito.

• Le schede mostrano Total, New e Conflicts.
• Per i conflitti, confronta Affiliate Name, Status, Email e Join Date.
• Le azioni includono tipicamente Merge (mantieni il contatto esistente e collega i dati affiliato) o Skip (non importare questo affiliato ora).

Avvia l'Importazione

Clicca Start Import. Tieni la pagina aperta oppure naviga altrove — l'elaborazione continua. Dopo aver avviato l'importazione, vedrai un breve riepilogo così sai cosa è stato messo in coda e cosa fare dopo per iniziare il tracciamento.

• Le schede riepilogative mostrano Campaigns, Total Affiliates e Historical Referrals in coda per l'importazione.
• Al termine, puoi tranquillamente lasciare la pagina — HITLEAD ti invierà una notifica.

---

Domande Frequenti

D: Ho ancora bisogno delle esportazioni CSV da FirstPromoter?

No. La procedura guidata basata su API sostituisce i trasferimenti CSV manuali per i dati supportati.

D: Cosa succede agli stati delle commissioni durante l'importazione?

Ogni commissione mantiene il suo stato originale (es. Pending/Approved). I tempi di pagamento seguono i Payout Terms impostati nelle Preferenze.

D: Posso includere i guadagni non pagati?

Sì. Attiva Pending Commissions per importare gli elementi non pagati così appaiono nel flusso di pagamento di Affiliate Manager.

D: L'importatore creerà Contatti duplicati?

No. Le email duplicate vengono segnalate per la verifica. Usa Merge per mantenere un unico record di contatto con i dati affiliato allegati, oppure Skip per escludere quella voce.

D: Posso eseguire l'importazione più di una volta?

Sì. Puoi rieseguire la procedura guidata per importare campagne o affiliati aggiuntivi; gli elementi già importati non vengono duplicati.

D: Le commissioni basate su prodotto sono supportate?

Non durante l'importazione stessa. Dopo l'importazione, configura le regole di commissione basate su prodotto direttamente in Affiliate Manager.

D: Dove aggiungo gli script di tracciamento dopo l'importazione?

Apri la campagna importata, usa il menu ⋯ nell'elenco campagne per individuare gli script di tracciamento e aggiungili prima di attivare la campagna.