Affiliate

In breve

Due voci di menu: Panoramica (risultati) e Impostazioni (regole del programma).

Cosa fa

Dove si trova nell’applicazione: Commerciale → Affiliate

• Segue i partner, i loro link, le provvigioni e i pagamenti.
• Le Impostazioni sono una schermata separata, non una scheda della panoramica.

Come si configura

La procedura dettagliata è in fase di stesura. Per ora questa pagina indica dove si trova la funzione nell’applicazione e cosa copre.

Portale del partner e aspetto

I partner accedono e si registrano sul portale pubblico, all’indirizzo di riserva …/partner/<codice e-shop> oppure sul vostro dominio (scheda Dominio). In alto c’è una fascia nel colore principale del programma con la scheda di accesso (o di registrazione) e accanto la scheda della persona di contatto: il responsabile dell’Affiliate con foto, telefono ed e-mail. La descrizione facoltativa del programma è più in basso; sul telefono tutto si dispone in colonna.

Si configura in Impostazioni → Programma e aspetto: Programma (nome, modalità di registrazione, approvazione automatica delle registrazioni dei partner; l’approvazione delle conversioni è un’impostazione della campagna, vedere più avanti), Persona di contatto (nome, e-mail, telefono, URL della foto del profilo; senza nome ed e-mail la scheda non viene mostrata), Aspetto del portale (logo, colori, link all’informativa sulla privacy) e Registrazione e dati del partner (quali campi sono obbligatori e quando). Il logo ha un’unica fonte: il portale usa il logo impostato per il vostro account (Impostazioni → Email → Logo); il colore del testo sul colore scelto viene calcolato in modo da restare leggibile.

Alla registrazione il partner spunta una sola casella: “Accetto le Condizioni del programma e prendo atto dell’Informativa sul trattamento dei dati personali”; entrambi i nomi sono link che aprono il testo in una nuova scheda. L’informativa sulla privacy non è un consenso al trattamento (il trattamento si basa sul contratto e sulla legge), quindi non viene chiesta separatamente; l’audit registra l’accettazione delle condizioni e la presa d’atto dell’informativa, ognuna con un’impronta del testo. Il partner conferma inoltre i documenti che avete contrassegnato come obbligatori alla registrazione (scheda Documenti). Il nome del documento apre il PDF in una nuova scheda, accanto c’è Scarica; un documento senza testo caricato non viene mostrato ai partner.

Sia le condizioni sia l’informativa sulla privacy sono documenti integrati nella scheda Documenti: un nuovo programma li riceve precompilati in tutte le lingue con i vostri dati da Impostazioni → Account. Sono modelli modificabili: MitoOps non ne garantisce la correttezza giuridica; la conformità alla legge del vostro paese è responsabilità del gestore del programma. Non si possono eliminare né disattivare, cambia solo il loro testo.

Un partner, e-shop uno per uno

Un partner è un solo account per tutto il vostro account cliente (un accesso, un codice pubblico), ma il programma funziona per e-shop. Quali e-shop vede il partner lo decide l’appartenenza: la registrazione tramite il portale di un e-shop (…/partner/sk) dà accesso solo a quell’e-shop: alle sue campagne, il codice del partner viene creato lì e valgono solo i documenti di quell’e-shop (la verifica di completezza non chiede mai contratti di altri e-shop). Gli altri e-shop li attivate o revocate nel dettaglio del partner, sezione E-shop del partner; il partner può richiedere un e-shop dal portale (Campagne → I tuoi e-shop): voi ricevete un’e-mail e decidete, nulla si attiva da solo. La registrazione della stessa e-mail tramite il portale di un altro e-shop non crea un secondo account; viene registrata come richiesta di accesso a quell’e-shop: il partner riceve un’e-mail al riguardo e voi la gestite come una richiesta dal portale (nulla viene concesso automaticamente e i dati dell’account non cambiano). La revoca di un e-shop conserva lo storico (conversioni, coupon); le campagne di quell’e-shop scompaiono per il partner e il suo codice lì viene terminato secondo le impostazioni del programma, la riattivazione lo ripristina. Ai partner registrati prima che esistesse l’appartenenza, questa è stata ricavata dall’e-shop di registrazione, dagli e-shop di coupon e conversioni e dalle campagne assegnate esplicitamente; un partner senza tali dati ha ricevuto tutti gli e-shop collegati.

Richiesta di accesso a un e-shop insieme al codice. Il pulsante Richiedi accesso nel portale apre solo un pannello accanto all’e-shop: il partner scrive una nota (fino a 500 caratteri), sceglie se trasferire il codice esistente, proporne uno nuovo o procedere senza codice, e solo dopo fa clic su Invia richiesta. Nel dettaglio del partner (sezione E-shop e codici del partner) decidete in un solo passaggio: Approva accesso e codice, Solo accesso, senza codice oppure Rifiuta con un motivo. Il codice viene creato nell’e-shop con lo sconto della campagna di quell’e-shop; se la campagna non ha uno sconto, l’accesso viene concesso e la riga indica “bloccato” con un link alla campagna: dopo aver impostato lo sconto basta Riprova. Il partner riceve un’e-mail con l’esito.

Il codice del partner ha una storia. Un unico codice canonico viene trasferito agli altri e-shop (anche in blocco, selezionando gli e-shop); un coupon esistente dell’e-shop (ad esempio un codice che il partner usava molto prima del programma) si può adottare senza crearne un secondo: lo digitate, MitoOps lo trova tra i coupon caricati, mostra sconto, validità e utilizzo e confronta lo sconto con quello della campagna (se differiscono, confermate che lo adottate con lo sconto originale; lo sconto nell’e-shop non viene modificato). Un codice che ha già portato ordini non viene mai eliminato: lo ritirate (valido fino a ieri) o lo sostituite con uno nuovo, e quello vecchio viene ritirato solo dopo che il nuovo è andato a buon fine. Gli ordini con il vecchio codice restano del partner; il partner vede i codici ritirati e quale codice li ha sostituiti.

Siti registrati e documento per il pagamento

Nel dettaglio del partner ci sono due cose su cui decidete: i siti registrati (il partner indica dove vi promuove; arrivano come In attesa di approvazione e voi li Approvate o Rifiutate con un motivo che il partner vede; l’approvazione gli invia un’e-mail) e i documenti per il pagamento (la base per pagare una provvigione: una fattura di un partner con partita IVA, per un periodo specifico, oppure un contratto di intermediazione di un partner senza partita IVA, valido fino a revoca). Il file lo carica il partner nel portale oppure voi con Aggiungi documento. Se un partner senza partita IVA ha un contratto del programma firmato, questo è la base per il pagamento e non serve un altro documento: la scheda lo indica e il pagamento procede. Un documento non viene mai eliminato, solo annullato. Il flusso di pagamento è sempre lo stesso: il partner chiede un pagamento, voi approvate il lotto e lo pagate.

Codice del partner: la provvigione non è lo sconto

Una campagna ha due valori indipendenti: la provvigione del partner e lo sconto per il cliente sul codice del partner; nessuno dei due deriva dall’altro e il partner li vede entrambi, con il loro nome, nella scheda Campagne accanto alla finestra di attribuzione e alla modalità di approvazione. Un codice approvato viene creato negli e-shop del partner la cui campagna ha uno sconto per il cliente; senza sconto la creazione è Bloccata: la scheda Codici sconto mostra l’e-shop e la campagna con un link diretto a essa, e dopo aver impostato lo sconto Ripeti creazione la completa. Nulla viene creato due volte e nel frattempo il partner vede “in preparazione”, mai un falso “attivo”.

Il link del partner applica automaticamente il suo codice aggiunge il codice con il parametro mitoops_coupon: lo stesso meccanismo dei coupon in Emailing, applicato dal codice web di MitoOps; il nome del parametro non è configurabile. Se un e-shop non ha un codice web in grado di applicare un coupon dall’URL, l’impostazione vi avvisa: il link porta il codice, ma lo sconto non si applica da solo nel carrello (l’attribuzione funziona comunque, si basa sull’identificatore del clic). Validità del clic (finestra di attribuzione, ad esempio 30 giorni) e Conservazione dei dati sui click (ad esempio 180 giorni) sono due impostazioni: la prima dice per quanto tempo dopo un clic un ordine viene ancora attribuito, la seconda per quanto tempo il clic resta nelle statistiche.

Testi del portale e variabili

I testi che un partner legge si trovano in quattro posti: Pagine del portale (Accesso, Registrazione, Dopo l’accesso: tre pagine di sistema con anteprima e un editor che dice dove viene mostrato il testo), Descrizione del programma (scheda Testi), Descrizione della campagna (per ogni campagna; senza un vostro testo il partner riceve un testo predefinito con i valori della campagna) e Articoli (scheda Articoli; i partner li leggono nella sezione Guida). Tutti hanno un testo predefinito in undici lingue che potete riscrivere o ripristinare.

I testi possono usare variabili compilate dalle impostazioni, così un numero non si discosta mai dalla campagna: ad esempio {{provizia}}, {{atribucia_dni}} e {{schvalenie}} (in una campagna), {{minimum_vyplaty}}, {{zaklad_provizie}}, {{program}}, {{prevadzkovatel}}, {{meno}} e {{kod}} (dopo l’accesso) e i link alle sezioni ({{odkaz_vyplaty}}). L’editor propone solo le variabili che in quel punto hanno un valore: per ognuna vedete il token, il suo nome, un fumetto “i” con la spiegazione e un esempio (funziona con mouse, tastiera e touch) e un pulsante Copia. Il token (ad esempio {{prevadzkovatel_email}}) è lo stesso in tutte le lingue dell’applicazione; si traducono solo il nome e la spiegazione. Le variabili della campagna ({{provizia}}, {{schvalenie}}…) non vengono proposte per l’inserimento nella descrizione del programma: lì vengono compilate solo quando l’e-shop ha esattamente una campagna pubblica, altrimenti appartengono alla descrizione della campagna, dove la tariffa è univoca; il fumetto lo spiega. Una variabile senza valore non viene mostrata al partner; un blocco {{#minimum_vyplaty}}…{{/minimum_vyplaty}} compare solo quando esiste un minimo. Una campagna con approvazione manuale non ha {{schvalenie_dni}}: il testo non mente mai.

Le stesse variabili funzionano nelle e-mail, con gli alias dei modelli precedenti ({{partnerName}} equivale a {{meno}}, {{amount}} equivale a {{suma}}); il registro completo con tipo, superfici e alias lo fornisce affiliate_variables_list. Bozze di testo: un nuovo testo delle condizioni, dell’informativa sulla privacy o di un vostro contratto può arrivare come bozza, dall’applicazione o da un assistente collegato (MCP). I partner non la vedono e nulla cambia finché non la pubblicate nella scheda Documenti, dove vedete le differenze rispetto al testo attuale; la pubblicazione crea una nuova versione con traccia di audit (chi, quando, hash). Le accettazioni dei partner restano legate al testo che hanno visto; con l’opzione “nuova conferma per una nuova versione” attiva, i partner confermano di nuovo.

L’anteprima del portale (Mostra anteprima) apre il portale reale con un partner e numeri fittizi; ogni sezione si può esplorare e non viene inviato nulla. Dopo l’accesso il partner vede a destra un pannello Avete una domanda? con la persona di contatto, la stessa della pagina pubblica.

Link dei partner sul vostro dominio

Finché un e-shop non ha un dominio proprio, i partner ricevono link nella forma https://<indirizzo dell'applicazione>/api/r/<codice partner>?k=<campagna>. Non appena il dominio proprio dell’e-shop è collegato e attivo, i link vengono composti automaticamente su di esso: nel portale, nelle e-mail, nel generatore di link alle sottopagine e tramite l’API. La forma è https://affiliate.vostrodominio.it/api/r/<codice partner>?k=<campagna> e, dove il gestore della piattaforma ha configurato per il dominio anche il percorso breve, https://affiliate.vostrodominio.it/r/<codice partner>?k=<campagna>. Entrambi funzionano e misurano allo stesso modo; quello breve è solo più corto. La scheda Dominio mostra per ogni e-shop la forma esatta che ricevono i partner. I link che i partner hanno già condiviso tramite l’indirizzo dell’applicazione continuano a funzionare; dopo la disattivazione del dominio i nuovi link tornano all’indirizzo dell’applicazione. Un link è legato all’e-shop del dominio: un link con la campagna di un altro e-shop non viene accettato su di esso. <codice partner> è il codice pubblico del partner (il suo account); k è il numero della campagna, che stabilisce la destinazione e le condizioni della provvigione.

Dominio principale e alias. Un e-shop può avere contemporaneamente più domini verificati, tipicamente durante il passaggio da un indirizzo provvisorio a quello definitivo. I nuovi link e gli indirizzi nelle e-mail vengono generati dal dominio principale; gli altri domini attivi sono alias: i link che i partner hanno già condiviso continuano a funzionare tramite essi, ma da essi non se ne generano di nuovi. Per il passaggio: aggiungete il nuovo dominio con Aggiungi un altro dominio, inserite i record DNS, fate clic su Verifica e collega e poi su Imposta come principale; il vecchio dominio resta un alias finché non lo eliminate o disattivate consapevolmente. L’indirizzo del portale nelle e-mail usa un dominio alle stesse condizioni dei link: collegato (DNS e certificato) e attivato.

Visite dai link dei partner in Google Analytics. Oltre all’identificatore del clic, il reindirizzamento aggiunge all’indirizzo di destinazione i tag per l’analytics dell’e-shop: utm_source=affiliate, utm_medium=affiliate, utm_campaign=mitoops-<codice e-shop>-k<numero campagna> (ad esempio mitoops-de-k5) e utm_content=<codice partner>. Google Analytics 4 classifica quindi la visita nel canale Affiliates invece che nel traffico diretto (direct) / (none), anche quando il link è stato aperto da un’app o da un’e-mail che non invia la pagina di provenienza. I tag già presenti nell’indirizzo di destinazione della campagna o nella sottopagina del partner non vengono sovrascritti. L’eccezione è il mezzo, che per un link del partner è sempre affiliate. L’attribuzione dell’ordine al partner non dipende da questi tag; si basa sull’identificatore del clic.

Consenso del visitatore alla memorizzazione del clic

Un clic viene sempre conteggiato: è registrato sul server durante il reindirizzamento e nel browser non viene salvato nulla. Perché in seguito un ordine dal link si possa attribuire, il codice del sito salva l’identificatore del clic nel browser, e solo con il consenso del visitatore. Verifica il consenso in quest’ordine, e decide la prima fonte che dà una risposta:

1. La vostra integrazione dell’e-shop: se la pagina definisce window.mitoopsSuhlas, il codice lo interroga (window.mitoopsSuhlas('meranie') restituisce true o false). Così potete collegare qualsiasi strumento di consenso che MitoOps non conosce.
2. Il consenso della piattaforma dell’e-shop: su Shoptet la sua barra dei consensi, su WooCommerce la WordPress Consent API.
3. TCF (lo standard di gestione dei consensi): finalità 1.
4. Google Consent Mode: analytics_storage.
5. Se il consenso non si riesce a determinare affatto, l’identificatore viene salvato.

Finché il consenso manca il clic non viene salvato, ma non va nemmeno perso: se il visitatore acconsente più tardi sulla stessa pagina, viene aggiunto. Un consenso revocato elimina l’identificatore salvato. L’attribuzione tramite un codice sconto non dipende dal consenso: il codice fa parte dell’ordine.

La misurazione propria dell’e-shop (i suoi tag, Google Tag Manager lato server, analytics) non viene toccata: il codice del sito si limita a leggere Consent Mode e il dataLayer, non vi scrive mai e non chiama nulla.

Firma elettronica dei contratti

Per ogni documento del programma scegliete una modalità di conferma: presa d’atto (il partner spunta di averlo letto), firma elettronica nel portale oppure copia firmata caricata (il partner stampa, firma e carica; voi la verificate). Con la firma elettronica il partner legge il testo esatto con i valori compilati (la vostra azienda e il firmatario, i suoi dati, l’e-shop e le condizioni della campagna), digita il proprio nome, conferma che sta firmando e fa clic su Firma elettronicamente; una firma disegnata con il mouse o con il dito è facoltativa. Viene salvato un record immutabile: il testo firmato, il suo hash, l’ora, il nome, il metodo e la verifica dell’identità. Il PDF firmato possono scaricarlo in qualsiasi momento sia il partner sia voi; viene generato dal record, non dal documento attuale, quindi le modifiche successive al modello, alla campagna o ai dati aziendali non lo alterano mai.

La firma alla registrazione passa per l’e-mail: il partner riceve un link (valido 24 ore, monouso) che conferma il suo indirizzo e apre la firma, prima che l’account venga approvato. Il modulo di registrazione non spunta un documento del genere, si limita ad annunciarlo. Un partner che ha effettuato l’accesso firma in Documenti; quando pubblicate una nuova versione con “nuova conferma per una nuova versione”, vede Nuova versione da firmare e la firma separatamente: la firma originale viene conservata. Un account preso in carico da un amministratore (“Accedi come”) non può firmare.

La scheda Contratti firmati elenca tutte le firme (filtri per partner, documento, e-shop, stato e periodo), un dettaglio con il testo esatto e le prove, il PDF, l’esportazione CSV e i partner con una firma mancante: potete inviare loro una richiesta di firma via e-mail. Una firma non si può modificare; un amministratore può revocarla con un motivo obbligatorio (il record resta come revocato). Un partner con un contratto firmato non si può eliminare, solo rifiutare o fargli cancellare i dati personali.

Un modello integrato di contratto di collaborazione è pronto in ogni lingua del programma per ogni account, disattivato finché non lo attivate in Documenti. Il testo è neutro: il gestore, il partner (azienda o persona fisica), l’e-shop e le condizioni della campagna sono variabili compilate al momento della firma. L’attivazione richiede un firmatario del gestore in Impostazioni → Programma (chi conclude i contratti per vostro conto). Il modello si modifica tramite una bozza di testo; “Nuovo contratto dal modello” crea un altro testo, ad esempio per un solo e-shop. Il modello non è una consulenza legale: adattatelo alla legge che si applica al vostro programma prima di attivarlo. La firma elettronica in MitoOps è una manifestazione elettronica di volontà con traccia di audit, non una firma elettronica qualificata ai sensi di eIDAS.

Le parti nel PDF. Sotto le righe delle firme il gestore compare come persona giuridica dal profilo di fatturazione dell’account (Impostazioni → Account) con partita IVA, firmatario e ruolo (Impostazioni → Programma); il nome del programma è nell’intestazione del documento come nome del programma, non come parte. Il partner compare come azienda con partita IVA, firmatario e ruolo, oppure come persona fisica con il proprio nome. I valori provengono dall’istantanea presa al momento della firma, quindi una modifica successiva del profilo non altera i vecchi contratti.

Un coupon adottato riceve un contrassegno nell’e-shop. Quando assegnate a un partner un coupon esistente dell’e-shop (o sostituite con esso uno vecchio), l’applicazione aggiunge alla nota del coupon nell’amministrazione dell’e-shop il contrassegno “MitoOps Affiliate · partner … · campagna …”. La nota originale del commerciante resta, il contrassegno non viene mai duplicato e lo sconto del coupon non viene modificato. Se l’e-shop rifiuta la scrittura, l’assegnazione del codice resta valida e l’applicazione si limita a informarvi.

Timbro e firma del gestore. L’immagine del timbro è una sola per tutta l’applicazione: caricatela in Reclami → Modelli e-mail | Documenti oppure in Affiliate → Impostazioni → Documenti (entrambi i blocchi mostrano lo stesso file). Il contratto firmato la riceve nel blocco “Firme delle parti” sopra la riga della firma del gestore, insieme al rappresentante e al ruolo; accanto c’è la firma del partner con l’ora. Il timbro è sempre delimitato e non rompe mai il documento.

Panoramica e statistiche: cosa significano i numeri

Panoramica e Statistiche (amministratore e partner) si calcolano da un’unica fonte, quindi per lo stesso periodo il partner vede lo stesso numero che vedete voi. Filtri: periodo, e-shop, campagna, partner. I clic sono reindirizzamenti validi tramite il link del partner, senza bot e senza ripetizioni dallo stesso indirizzo entro un breve intervallo; unici significa indirizzi distinti. I clic non dipendono dal consenso del visitatore alla memorizzazione: il consenso decide solo se un ordine viene attribuito dal link. Le conversioni sono ordini attribuiti, esclusi quelli rifiutati e annullati; il tasso è conversioni / clic. Il denaro è sempre per valuta. Imbuto: clic → conversioni → approvate → pagate; fonti: link tracciato, codice sconto, manuale. I giorni si contano in UTC.

Due impostazioni che si confondono: Validità del clic (finestra di attribuzione) indica per quanto tempo dopo un clic un ordine viene ancora attribuito al partner; Conservazione dei dati sui click indica per quanto tempo un clic resta nelle statistiche (180 giorni per impostazione predefinita; un clic su cui si basa una provvigione non viene mai eliminato).

Il filtro ha anche codice sconto, fonte dell’attribuzione e stato della conversione e una tabella per codici sconto (un codice ritirato vi resta). Con un filtro per codice i clic sono 0: un clic non porta alcun codice. Nella Panoramica il partner vede anche Base della provvigione del periodo e Provvigione del periodo e nelle Statistiche filtra solo per i propri codici. Un ordine attribuito a un partner tramite link compare anche nell’Analisi (canali, elenco ordini) come “Affiliate · partner”, non come “Non attribuiti”; una conversione annullata non viene attribuita.

Notifiche al team: una nuova registrazione, una richiesta di e-shop, codice o sito, una richiesta di pagamento e un contratto firmato arrivano nella campanella e, a seconda dell’argomento, del ruolo e dell’autorizzazione Affiliate, come notifica push sul telefono, con un link diretto al punto dell’applicazione. La registrazione ha un campo facoltativo Su di me (500 caratteri) che vedete nella registrazione in attesa, nel dettaglio e nell’e-mail.

Conversioni e provvigione: due importi, due nomi

La base della provvigione è l’importo da cui si calcola la provvigione secondo le impostazioni del programma (merce senza o con IVA; spedizione e commissione di pagamento sono escluse per impostazione predefinita). Il totale dell’ordine IVA inclusa è ciò che il cliente ha effettivamente pagato. Un esempio da un ordine reale: merce 89,55 + 5,31 IVA inclusa (IVA al 23 %), spedizione gratuita, provvigione del 10 %: base 77,12 (IVA esclusa), totale dell’ordine IVA inclusa 94,86, provvigione 7,71. Entrambi gli importi compaiono nelle Conversioni, nel CSV, nell’e-mail al partner ({{revenue}} è la base, {{orderTotal}} il totale IVA inclusa) e nel portale del partner; gli importi vengono salvati dall’ordine, non si stima nulla.

La scheda Affiliate → Conversioni è la schermata di lavoro per le approvazioni: filtri per partner, e-shop, periodo, stato della provvigione, fonte, numero d’ordine e classificazione dell’ordine; ogni conversione mostra lo stato dell’ordine dall’e-shop (lo stesso di Ordini → Panoramica) classificato come aperto / completato / annullato. La classificazione è un contesto, non una decisione: annullamenti e note di credito modificano la provvigione secondo le regole del programma. Il rifiuto e l’annullamento chiedono un motivo che il partner riceve via e-mail; l’approvazione in blocco ha una conferma con il conteggio. L’esportazione CSV riporta lo stesso filtro, lo stato dell’ordine e colonne univoche; il CSV del partner non ha lo stato dell’ordine né dati dei clienti.

Approvazione automatica delle conversioni

Le conversioni possono approvarsi da sole, e lo si configura sulla campagna, non nelle impostazioni del programma: Affiliate → Campagne → campagna → Approvazione conversioni con le opzioni Manuale (predefinita) e Automatico (al soddisfacimento delle condizioni). Con l’approvazione automatica compaiono le condizioni della campagna:

• Approvare non prima di (giorni dall’ordine): il periodo per i resi, predefinito 14. I giorni si contano dalla creazione dell’ordine (non dalla consegna: l’e-shop non ci invia lo storico degli stati, quindi “giorni dalla consegna” sarebbe un’ipotesi).
• Approvare solo negli stati dell’ordine: scegliete tra gli stati reali dell’e-shop della campagna (il campo Campagna e-shop; ad esempio Consegnato, Completato), gli stessi di Ordini → Panoramica e delle Automazioni. Una campagna appartiene a un solo e-shop e questo non cambia mai; in Nuova campagna scegliete uno o più e-shop collegati e per ciascuno viene creata una campagna separata con impostazioni identiche: una campagna per un altro e-shop ha i propri stati. Vuoto = qualsiasi stato. Un ordine il cui stato l’applicazione non conosce (ad esempio una conversione aggiunta manualmente senza un ordine nel mirror) non viene mai approvato finché l’elenco è compilato.
• Richiedere ordine pagato: predefinito No, perché il contrassegno si paga al ritiro. Con Sì viene approvato solo un ordine il cui stato di pagamento è pagato (indicatore di pagamento di Shoptet, stato del pagamento di WooCommerce); un ordine con stato di pagamento sconosciuto no.

Una conversione viene approvata solo quando tutte le condizioni selezionate sono soddisfatte. Una volta all’ora l’applicazione passa in rassegna le nuove conversioni delle campagne con approvazione automatica; il partner riceve la stessa e-mail di un’approvazione manuale e l’audit registra “sistema” come autore della decisione. Una conversione che non soddisfa ancora le condizioni continua ad attendere: accanto al suo stato nella scheda Conversioni si vede cosa sta aspettando l’automazione (ad esempio “in attesa del periodo di trattenuta (3 g)” oppure “l’ordine non è pagato”). I partner vedono il periodo nella descrizione della campagna tramite la variabile {{schvalenie}}.

Cosa vale sempre, indipendentemente dalle impostazioni:

• L’annullamento di un ordine rifiuta la conversione (una approvata viene annullata) e una nota di credito la riduce oppure, quando l’intero ordine viene reso, la annulla, sia con l’approvazione manuale sia con quella automatica. L’automazione non approva mai un ordine annullato o reso interamente, anche se tutte le altre condizioni corrispondono; un ordine reso in parte viene approvato con una provvigione ridotta.
• Una provvigione già pagata non viene mai toccata dal sistema: si regola con il partner.
• L’impostazione vale per campagna: ogni campagna appartiene a un solo e-shop e ha la propria modalità, il proprio periodo e i propri stati.
• Le campagne esistenti non sono cambiate quando sono state aggiunte le condizioni: una campagna che aveva “automaticamente dopo il periodo” continua ad approvare in base al solo periodo finché non aggiungete condizioni.

Se vi serve una condizione che la campagna non ha (un valore minimo, un partner specifico), mantenete Manuale e decidete nella scheda Conversioni, dove ogni conversione mostra lo stato dell’ordine e lo stato del pagamento.

Domande frequenti: Come rifiuto una conversione? Nella scheda Conversioni fate clic su Rifiuta accanto a una nuova conversione e inserite un motivo: il partner lo riceve via e-mail; una conversione approvata si può Annullare, una già pagata no. Posso approvare solo gli ordini completati o consegnati? Sì: scegliete gli stati in Approvare solo negli stati dell’ordine sulla campagna. MitoOps verifica se l’ordine è pagato? Sì, prende lo stato del pagamento dall’e-shop e lo mostra accanto alla conversione; influisce sull’approvazione automatica solo quando Richiedere ordine pagato è attivo. Cosa succede in caso di annullamento o rimborso? L’annullamento rifiuta o annulla la conversione, una nota di credito la riduce o la annulla quando viene reso l’intero ordine: automaticamente, con entrambe le modalità di approvazione.

API e MCP

Con l’ambito affiliate:read il vostro programma o un assistente AI legge la panoramica, i partner, le campagne, i codici, le conversioni, i pagamenti, le impostazioni, i documenti, lo stato del portale, i modelli di e-mail, gli articoli di aiuto e le richieste di codice. Legge anche i testi dei documenti legali per lingua con gli hash (affiliate_documents_get; le firme elettroniche dei partner in sola lettura tramite affiliate_signatures_list e affiliate_signatures_get) e il registro delle variabili (affiliate_variables_list). Con l’ambito sensibile affiliate:write (solo MCP) può approvare, rifiutare o sospendere l’account di un partner, attivare o revocare un e-shop di un partner (affiliate_partners_set_market), gestire una richiesta di codice, aggiornare le impostazioni non finanziarie, i testi del portale, gli articoli di aiuto (creare, modificare, ripristinare il testo predefinito, attivare o disattivare; mai eliminare), i modelli, le campagne e la politica dei documenti. Un nuovo testo legale (inclusa l’informativa sulla privacy) viene salvato solo come bozza (affiliate_documents_draft_create): il testo attivo lo pubblicate nell’applicazione. Le conversioni (affiliate_conversions_list, dettaglio affiliate_conversions_get) riportano la base della provvigione e il totale dell’ordine IVA inclusa, il motivo dello stato e lo stato dell’ordine dall’e-shop con un filtro orderState. L’approvazione automatica si legge e si imposta sulla campagna tramite l’interfaccia: affiliate_campaigns_get restituisce approval (manual / automatic), approveAfterDays, requiredOrderStatusIds e paidRequired; affiliate_campaigns_update li modifica con l’ambito affiliate:write (gli identificatori di stato devono essere stati dell’e-shop della campagna). Ogni conversione nell’elenco e nel dettaglio riporta approvalPolicy (la politica della sua campagna) e approvalEligibility: se l’automazione la approverebbe in questo momento e perché no (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual, …); è lo stesso calcolo che viene eseguito ogni ora, non una seconda copia. L’elenco ha i filtri orderPaid, minCommission, orderState, state, un periodo e la paginazione (offset, hasMore), così un assistente può “passare in rassegna le nuove conversioni degli ultimi due mesi, mostrare quelle non pagate o superiori a 20 €” e poi chiamare affiliate_conversions_decide separatamente per ogni conversione indicata. L’assistente nell’applicazione spiega e legge le stesse cose, ma non modifica nulla. Le decisioni sulle provvigioni hanno un proprio ambito sensibile affiliate:approve (solo MCP): l’assistente può approvare, rifiutare o annullare una singola conversione specifica che indicate voi (rifiuto e annullamento con un motivo, una provvigione pagata non viene mai stornata), seguendo lo stesso percorso dell’applicazione. Non esiste un’approvazione in blocco in una sola chiamata. I pagamenti sono in sola lettura tramite l’interfaccia (affiliate_payouts_list): creare un lotto, il suo documento, l’invio al partner o un ordine bancario non si possono avviare tramite l’API o MCP; restano nell’applicazione. Dettagli nell’interfaccia MCP.

Pagine correlate

• Codici sconto
• Interfaccia MCP