Integrare Mindbody, Glofox o AimHarder con le tue campagne pubblicitarie: cosa espone ogni software e come collegarlo
Il tuo gestionale già conserva tutto ciò che ti serve per capire se le tue inserzioni sono redditizie: chi si è iscritto, quando, quanto paga ogni mese e quando ha disdetto. Quello che manca è tirarlo fuori e incrociarlo con le tue campagne. Quanto costa farlo dipende quasi interamente dal software che usi: con Mindbody o Glofox il percorso è documentato; con altri dovrai accontentarti di export CSV. Questo articolo passa in rassegna cosa espone ogni software diffuso in Spagna e in Europa, il tipico percorso di integrazione e i problemi di matching che nessuno ti racconta finché non ti ci scontri.
Avviso preliminare: questa è idraulica, non magia. Collegare il software alle inserzioni non migliora nessuna campagna da solo. Il valore sta in le decisioni che i dati di fatturazione permettono di prendere e nella tesi generale di misurare per incassi e non per lead. Se queste due idee non ti hanno ancora convinto, leggile prima, l'integrazione non fa che accelerare qualcosa che devi già voler fare.
Cosa espone ogni software
La domanda non è "ha un'API?" ma "cosa permette di leggere l'API?". Per il marketing hai bisogno di quattro dati: iscrizioni (con data e contatti), pagamenti (ogni addebito, con importo), disdette (quando va via ogni socio) e, come bonus utile, presenze (un socio che smette di venire è una disdetta differita). Ecco il quadro con i software più comuni in questo mercato, in base alla loro documentazione pubblica alla data di questo articolo:
| Software | Iscrizioni via API | Pagamenti via API | Disdette | Presenze | Webhook | Note |
|---|---|---|---|---|---|---|
| Mindbody | Sì | Sì (sales/transactions) | Sì | Sì | Sì | L'API più completa, e la più cara: l'accesso partner ha un costo e un processo di approvazione |
| Glofox | Sì | Sì | Sì | Sì | Sì (eventi socio e pagamento) | API REST ragionevole; l'accesso si richiede al supporto e dipende dal piano sottoscritto |
| AimHarder | Parziale | Limitato | Parziale | Sì | Non pubblico | Molto diffuso nelle box in Spagna; l'accesso programmatico è limitato, in pratica si lavora con gli export |
| WodBuster | Parziale | Limitato | Parziale | Sì | Non pubblico | Simile: solido nella gestione dei corsi, carente nell'API pubblica documentata |
| Resamania | Sì | Sì | Sì | Sì | Sì | API moderna orientata agli integratori; comune in catene e grandi club in Francia e Spagna |
Due letture della tabella. La prima: la colonna che separa un'integrazione completa da una a metà è quella dei pagamenti. Con le iscrizioni ma senza i pagamenti puoi attribuire soci alle campagne, ma non i ricavi, e i ricavi sono il dato che decide. La seconda: se il tuo software è debole sull'API non sei tagliato fuori; cambi semplicemente corsia verso l'export CSV programmato, che vediamo alla fine. Prima di cambiare software solo per questo, guarda cos'altro dovresti esigere da un gestionale: l'API è un criterio tra tanti, anche se è quello che nessuno controlla prima di firmare.
Un avvertimento sulla scadenza: le API cambiano. Quello che Glofox espone oggi può ampliarsi, o restringersi, il prossimo anno. La tabella ti orienta; la risposta definitiva te la dà il supporto del tuo software quando chiedi per iscritto cosa puoi leggere con il tuo piano.
Il tipico percorso di integrazione
Qualunque sia il software, il percorso ha sempre gli stessi quattro passi.
Passo 1: la chiave API
Chiedi l'accesso API al supporto del tuo software. Con Mindbody è un processo formale di developer account; con Glofox e Resamania, un ticket al supporto; con AimHarder o WodBuster, la risposta probabile è che non esiste un'API pubblica completa e passi al piano CSV. Chiedi per iscritto tre cose precise: leggere soci e iscrizioni, leggere i pagamenti e ricevere webhook per ogni nuova iscrizione. Le risposte a queste tre domande definiscono l'intera integrazione.
Passo 2: il webhook di iscrizione
Ogni volta che viene creato un socio, il software notifica un URL tuo (o della tua piattaforma intermedia) con i dati dell'iscrizione. Se non ci sono webhook, si sostituisce con una query periodica: ogni notte, "dammi le iscrizioni di oggi". Meno elegante, ugualmente utile. La differenza pratica è di ore, per decisioni che si prendono mensilmente, irrilevante.
Passo 3: il matching lead-socio
Qui sta il cuore di tutto, e la sezione successiva gli è interamente dedicata. Ogni nuova iscrizione viene cercata tra i lead delle tue campagne, di solito per telefono e come backup per email. Se c'è corrispondenza, il socio viene attribuito alla campagna di origine. I livelli 1 e 2 di questa connessione si possono costruire senza nessuna API; il passo 3 è la versione automatizzata dello stesso incrocio che faresti in Excel.
Passo 4: l'attribuzione dei pagamenti
Con il socio già collegato alla sua campagna, ogni suo pagamento (letto via API o importato dall'export dei pagamenti) si aggiunge al fatturato di quella campagna. Da qui hai la tabella che conta: euro incassati per euro investito, per campagna. E se vuoi il passo avanzato, queste iscrizioni con un valore possono tornare su Meta come conversioni offline perché l'algoritmo impari chi è un buon socio.
Con un software ad API completa, uno sviluppatore freelance monta tutto questo in pochi giorni; €500–€2.000 di lavoro una tantum è un range ragionevole a seconda dell'API e dello stato dei tuoi dati. L'alternativa è una piattaforma che porta il connettore già pronto per il tuo software; lì paghi un canone mensile invece dei costi di sviluppo. Nessuna delle due opzioni è migliore in astratto: con volumi bassi e un software poco comune, il freelance è la scelta giusta; con un software supportato, il connettore già fatto ti risparmia la manutenzione, che è il costo che il budget iniziale non include mai.
I veri problemi del matching
Sulla carta, incrociare lead e iscrizioni per telefono sembra banale. In pratica, tre problemi si mangiano tra il 20% e il 40% dei match se non li tratti.
Numeri di telefono che non coincidono pur essendo identici
Il lead ha scritto 612345678 nel modulo Meta. La receptionist ha digitato +34 612 34 56 78 in Mindbody. Stesso numero, zero corrispondenze se confronti testo contro testo. La soluzione è normalizzare prima di confrontare: rimuovere spazi, trattini e parentesi, e unificare il prefisso (o confrontare tutto nel formato internazionale E.164, che per la Spagna significa anteporre +34 alle nove cifre). È una regola di trasformazione banale che aumenta il tasso di match più di qualsiasi altro miglioramento in questa lista. Se il tuo incrocio è manuale in Excel, una colonna ausiliaria con =DESTRA(SOSTITUISCI(...)) fa lo stesso lavoro.
Email diverse tra modulo e iscrizione
La stessa persona usa [email protected] nell'inserzione Instagram alle undici di sera e l'email di lavoro quando compila il modulo alla reception. O viceversa. Per questo l'email è il backup del matching e non la chiave principale: il numero di telefono cambia molto meno spesso dell'indirizzo email che qualcuno decide di dare in quel momento. La pratica difensiva: fare matching prima per telefono normalizzato, poi per email in minuscolo, e trattare il match solo-via-email come "probabile" invece che certo.
Iscrizioni senza lead precedente
Una parte delle tue iscrizioni non verrà da nessun modulo: chi passava davanti, l'amico di un socio, chi ha visto l'inserzione ed è entrato direttamente senza cliccare. Se forzi ogni iscrizione ad avere una campagna, contaminerai l'attribuzione con falsi positivi. La soluzione ha due parti. Una categoria esplicita "walk-in / senza lead precedente", alimentata dal campo "come ci hai conosciuto?" dell'iscrizione, che smette di essere una cortesia e diventa un dato. E una finestra di attribuzione: un'iscrizione si collega a un lead solo se il lead ha meno di 90 giorni. Il lead di un anno fa che si iscrive adesso non lo si deve (solo) alla tua campagna di allora, e attribuirglielo gonfia la campagna sbagliata. I 90 giorni sono una convenzione ragionevole per le palestre, non una legge; l'importante è fissare una finestra e non cambiarla ogni mese. Come decidere e difendere la tua finestra di attribuzione merita un articolo a sé.
Metti in conto che, anche facendo tutto bene, tra il 10% e il 25% delle tue iscrizioni resteranno non attribuite o classificate come "walk-in". Non è un difetto del sistema: è la realtà di come le persone arrivano a una palestra. L'attribuzione utile non è quella perfetta; è quella sufficiente a distinguere la campagna che rende 2€ per euro da quella che ne rende 8€.
Se il tuo software non ha un'API
Non sei bloccato, sei in modalità manuale assistita. Il sostituto dell'integrazione è l'export CSV programmato: quasi tutti i software, compresi quelli più chiusi, permettono di esportare iscrizioni e pagamenti, e molti permettono di programmare quell'export via email ogni settimana o ogni mese.
Il circuito minimo: export iscrizioni e pagamenti ogni lunedì, uno script o uno Zap che lo riversa in un foglio di calcolo, e lo stesso matching di prima (telefono normalizzato, finestra di 90 giorni, categoria walk-in) applicato sul foglio. Perdi il tempo reale, che per decisioni mensili non ti serviva comunque, e guadagni indipendenza dal supporto del tuo software. Molte palestre funzionano in questa modalità per anni con risultati identici all'integrazione completa, perché le decisioni che alimentano sono le stesse.
Il criterio per sapere se vale la pena combattere per l'API: volume e dolore. Sotto i 40–50 lead al mese, il CSV settimanale costa poco e l'API è un lusso. Oltre questa soglia, o quando l'incrocio è saltato due mesi di fila per mancanza di tempo, l'automazione smette di essere un capriccio. Ci sono piattaforme che gestiscono questo circuito completo per te, connettore incluso (Pilotium è tra queste); il criterio di scelta è sempre lo stesso, che il fatturato per campagna si aggiorni senza che nessuno debba ricordarselo.
Quello che non cambia in nessuno scenario: il software che scegli, l'API che hai e il matching che costruisci sono mezzi. Il fine è una tabella mensile dove ogni campagna mostra il suo fatturato incassato, e un titolare di palestra che sposta il budget secondo quella tabella. Tutto il resto, Mindbody compreso, è idraulica.