Sistema Import/Export

Disponibile in:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Panoramica

Il Sistema Import/Export in Post Affiliate Pro fornisce potenti strumenti per operazioni massive sui dati. Che tu stia migrando da un’altra piattaforma, gestendo dataset grandi o sincronizzando dati tra sistemi, la funzionalita import/export risparmia tempo e riduce gli errori manuali.

Il sistema supporta import ed export di:

• Affiliati - Account utente con tutti i dati profilo e opzioni di pagamento
• Campagne - Impostazioni campagna, tipi di commissione, gruppi e tassi
• Banner - Definizioni banner e materiali promozionali
• Transazioni - Vendite, commissioni e record transazioni
• Temi - Temi personalizzati del pannello e template

Import/Export Affiliati

Esportazione Affiliati

La funzione di esportazione affiliati crea un file CSV completo contenente tutti i dati degli affiliati dalla tua installazione. L’esportazione include:

Campi Core Affiliato:

• User ID (identificatore unico)
• Reference ID (refid)
• Username (email)
• Nome e Cognome
• Stato Account (in sospeso, approvato, rifiutato)
• Data Inserimento e Data Approvazione
• User ID Genitore (per strutture multi-livello)
• Soglia Pagamento Minimo
• Note e Foto

Campi Dati Personalizzati:

• Data1 fino a Data25 (campi affiliato personalizzati)

Opzioni di Pagamento: L’esportazione include anche una sezione separata per le opzioni di pagamento, contenente:

• User ID
• Nome campo pagamento
• Valore campo pagamento

Importazione Affiliati

Quando importi affiliati, il sistema elabora il file CSV e crea nuovi account affiliato o aggiorna quelli esistenti in base allo User ID.

Campi Richiesti:

• !USERID - L’identificatore unico per l’affiliato

Comportamenti Chiave:

• Se un affiliato con lo User ID specificato esiste, il record viene aggiornato
• Se lo User ID non esiste, viene creato un nuovo account affiliato
• I campi stato vuoti defaultano ad “Approvato”
• Il sistema gestisce automaticamente le relazioni parent-user per strutture multi-livello
• Le password possono essere importate con o senza crittografia salt

Mappatura Campi: La riga header del CSV definisce i nomi dei campi usando il formato !NOMECAMPO. Per esempio:

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

Esempio Formato CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,john@example.com,John,Smith,A,50.00
def67890,REF002,jane@example.com,Jane,Doe,A,100.00

Valori stato:

• A - Approvato
• P - In Sospeso
• D - Rifiutato

Import/Export Campagne

Cosa Viene Esportato

L’esportazione campagne crea un backup completo della tua struttura campagne includendo:

Campagne:

• ID Campagna, Nome e Descrizione
• Tipo e Stato
• Data Inserimento
• Ordine Visualizzazione
• Durata Cookie e impostazioni Sovrascrittura
• Impostazioni Geo-targeting (paesi, regole visualizzazione)
• Impostazioni intervallo date valide
• URL Logo e ID Prodotto

Tipi di Commissione:

• ID Tipo Commissione
• Tipo (vendita, lead, clic, ecc.)
• Nome e Codice
• Stato e impostazioni Approvazione
• Impostazioni preset Ricorrenza
• Opzioni gestione commissioni zero
• Restrizioni paese e citta

Gruppi Commissioni:

• ID Gruppo e Nome
• Associazione Campagna
• Flag gruppo predefinito

Commissioni:

• ID Commissione
• Livello tier
• Tipo commissione (percentuale, fisso)
• Valore
• Associazione a tipi e gruppi commissioni

Importazione Campagne

L’import campagne supporta la creazione o aggiornamento di campagne con tutte le loro strutture commissioni associate.

Campi Richiesti per Sezione:

• Campagne: !CAMPAIGNID
• Tipi Commissione: !COMMTYPEID
• Gruppi Commissioni: !COMMISSIONGROUPID
• Commissioni: !COMMISSIONID

L’import elabora ogni sezione sequenzialmente, assicurando relazioni corrette tra campagne, tipi di commissione, gruppi e tassi di commissione.

Import/Export Banner

Struttura Dati Banner

L’import/export banner gestisce i metadati e la configurazione dei tuoi materiali promozionali:

Campi Esportati:

• ID Banner
• ID Account e ID Campagna
• Tipo Banner (immagine, HTML, link testuale, ecc.)
• Stato (attivo/inattivo)
• Nome e Descrizione
• URL Destinazione
• Dimensioni
• Campi dati (Data1-Data4) per contenuto specifico per tipo
• Ordine Visualizzazione
• Stringa SEO
• ID Wrapper
• Data Inserimento

Nota Importante: L’import/export banner gestisce solo le definizioni, non i file immagine fisici o gli asset. Assicurati che le immagini referenziate siano disponibili agli URL specificati dopo l’import.

Campo Richiesto:

• !BANNERID - Identificatore banner unico

Esempio Formato CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Banner Saldi Estivi,https://example.com/sale,A
ban67890,camp001,T,Promo Link Testuale,https://example.com/promo,A

Tipi banner:

• I - Banner immagine
• T - Link testuale
• H - Banner HTML
• E altri tipi supportati

Import Transazioni

Panoramica

L’import transazioni e una funzionalita potente per caricare in massa vendite, commissioni e altri record transazioni. Questo e particolarmente utile per:

• Migrare dati storici da altre piattaforme
• Importare vendite offline
• Elaborazione batch di aggiornamenti transazioni
• Sincronizzazione con sistemi esterni

Campi Disponibili

L’import transazioni supporta un set completo di campi:

Campi Core Transazione:

• ID Transazione
• ID Account
• User ID (affiliato) - supporta ID, refid o username
• ID Banner e ID Banner Genitore
• ID Campagna
• ID Ordine e ID Prodotto
• Stato (in sospeso, approvato, rifiutato)
• Tipo (vendita, lead, clic, rimborso, chargeback)
• Data Inserimento e Data Approvazione
• Importo commissione
• Costo Totale e Costo Fisso
• Livello tier

Informazioni Tracciamento:

• Codice Paese
• Indirizzo IP
• Browser
• URL Referrer
• Metodo Tracciamento
• Conteggio Clic
• Canale
• ID Visitatore

Dati Aggiuntivi:

• Campi Dati Extra (Data1-Data5)
• Nota Merchant e Nota Sistema
• ID Coupon o Codice
• Informazioni valuta (ID, valore, tasso)
• ID Tipo Commissione e ID Gruppo
• Fee Network
• ID Vendita e informazioni Split

Opzioni Import

Abbinamento Transazioni: L’import puo abbinare transazioni esistenti per:

• Order ID - Aggiorna transazioni con order ID corrispondente
• Transaction ID - Aggiorna transazione specifica per ID
• Order ID (Tutti i Tier) - Aggiorna tutte le transazioni tier per un ordine

Calcolo Commissioni Automatico: Abilita il computing automatico delle commissioni per far calcolare al sistema gli importi delle commissioni basandosi su:

• Impostazioni commissioni campagna
• Gruppo commissioni dell’affiliato
• Valore costo totale
• Regole tipo commissione

Generazione Commissioni Multi-Tier: Quando abilitato, l’import crea automaticamente commissioni tier basate sulla struttura upline dell’affiliato e le impostazioni campagna.

Gestione Stato:

• Imposta uno stato specifico per tutte le transazioni importate
• Usa lo stato dal file (valore campo)
• Preserva lo stato originale quando aggiorni transazioni esistenti

Preset Formato Import

Puoi salvare e riutilizzare configurazioni di formato import:

• Definisci mappature colonne
• Imposta opzioni import
• Salva come preset nominati per import ricorrenti

Esempio Formato CSV

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,ORD-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,ORD-002,P,2025-01-10 11:45:00

Gestione Rimborsi e Chargeback

Quando importi rimborsi o chargeback:

• Imposta il tipo transazione a rimborso (R) o chargeback (H)
• Fornisci l’ID transazione genitore o order ID per riferimento
• Gli importi commissione vengono automaticamente calcolati come valori negativi quando si usa il calcolo automatico

Import/Export Temi

Esportazione Temi

Esporta i tuoi temi personalizzati come pacchetti completi per backup o migrazione:

Cosa Viene Esportato:

• Configurazione tema (impostazioni theme.php)
• Tutti i file template (.tpl e .stpl)
• File CSS personalizzati (custom.css, custom_colors.css)
• Asset immagini (JPEG, PNG, GIF, BMP)

L’esportazione crea un archivio ZIP contenente la struttura completa del tema.

La Configurazione Tema Include:

• Nome e descrizione tema
• Autore e URL
• Modulo (pannello merchant/affiliato)
• Modalita visualizzazione (singola/finestra)
• Impostazioni sfondo predefinito
• Immagine miniatura
• Impostazioni override CSS
• Riferimento tema originale

Importazione Temi

Importa temi da pacchetti ZIP per distribuire rapidamente design personalizzati:

Requisiti:

• Archivio ZIP valido con configurazione theme.php
• Sintassi template corretta (validata durante l’import)
• Riferimento tema originale valido
• Immagine miniatura specificata

Validazione: Il processo di import valida:

• Completezza configurazione tema
• Sintassi template Smarty
• Esistenza tema originale
• Restrizioni tipo file (solo estensioni permesse)

Tipi File Supportati:

• Template: .tpl, .stpl
• Stili: .css (solo custom.css, custom_colors.css)
• Immagini: .jpg, .jpeg, .png, .gif, .bmp

Requisiti Formato Dati

Struttura File CSV

Requisiti Generali:

• Usa codifica UTF-8 per una corretta gestione dei caratteri
• La prima riga dovrebbe contenere gli header delle colonne
• Delimitatore consistente in tutto il file (virgola, punto e virgola o tab)
• Caratteri speciali correttamente escaped

Formato Nomi Campi:

• I campi richiesti sono prefissati con ! (es. !USERID)
• I nomi dei campi sono case-insensitive
• La mappatura personalizzata permette ordinamento flessibile delle colonne

Formato Date: Le date dovrebbero essere in un formato riconoscibile:

• YYYY-MM-DD HH:MM:SS (raccomandato)
• I formati data standard vengono automaticamente parsati

Valori Numerici:

• Usa il punto (.) come separatore decimale
• Nessun separatore delle migliaia
• Valori negativi supportati (es. per rimborsi)

File Multi-Sezione

Alcune esportazioni (affiliati, campagne) includono sezioni dati multiple:

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Ogni sezione e identificata da un marcatore header e ha la propria struttura colonne.

Best Practice per Operazioni Massive

Prima di Importare

1. Crea un Backup Esporta sempre i tuoi dati correnti prima di eseguire import massivi, specialmente quando usi l’opzione cancella.

2. Valida i Tuoi Dati

   • Controlla ID duplicati
   • Verifica che i campi richiesti siano presenti
   • Assicurati che i formati data siano consistenti
   • Valida codici stato e tipo

3. Testa con Dataset Piccolo Importa prima pochi record per verificare mappatura e comportamento prima di elaborare file grandi.

4. Controlla le Dipendenze

   • Assicurati che le campagne referenziate esistano prima di importare banner
   • Verifica che gli account affiliati esistano prima di importare transazioni
   • Conferma che i tipi di commissione siano impostati prima di importare commissioni

Durante l’Import

5. Monitora il Progresso L’import viene eseguito come task in background con tracciamento progresso. Controlla le notifiche task per aggiornamenti stato e messaggi di errore.

6. Gestisci gli Errori con Grazia Il sistema logga errori per record individuali continuando a elaborare voci valide. Rivedi il log import per gestire i record falliti.

Dopo l’Import

7. Verifica i Risultati

   • Controlla a campione i record importati
   • Verifica che totali e conteggi corrispondano alle aspettative
   • Testa i login affiliati se sono state importate password

8. Aggiorna Record Correlati Alcuni import potrebbero richiedere azioni di follow-up:

   • Assegna affiliati alle campagne
   • Carica immagini banner
   • Configura tassi di commissione

Considerazioni sulle Prestazioni

9. Gestione File Grandi Il sistema di import elabora i dati in batch per prevenire timeout. File molto grandi potrebbero richiedere diversi minuti per completare.

10. Pianifica Durante Bassa Attivita Per migliori prestazioni, pianifica import grandi durante ore non di punta quando il carico del sistema e minore.

Note sulla Sicurezza

11. Dati Sensibili

    • I campi password sono gestiti in modo sicuro con crittografia salt
    • Evita di importare informazioni di pagamento sensibili attraverso canali non sicuri
    • Rivedi i file import per esposizione non intenzionale di dati

12. Controllo Accessi Le funzioni import/export richiedono permessi appropriati di amministratore merchant.

Casi d’Uso Comuni

Migrazione da Un’Altra Piattaforma

1. Esporta dati dalla tua piattaforma esistente in formato CSV
2. Mappa le colonne ai nomi campi Post Affiliate Pro
3. Importa prima gli affiliati per stabilire gli account utente
4. Importa campagne e strutture commissioni
5. Importa transazioni storiche
6. Carica banner e materiali promozionali

Sincronizzazione Transazioni Mensile

1. Crea un preset formato import per il tuo sistema esterno
2. Esporta transazioni dalla tua piattaforma e-commerce
3. Importa usando abbinamento Order ID per aggiornare transazioni esistenti
4. Rivedi il log import per eventuali discrepanze

Backup e Distribuzione Temi

1. Personalizza il tuo tema in un ambiente di sviluppo
2. Esporta il tema come pacchetto ZIP
3. Importa nell’installazione di produzione
4. Verifica aspetto e funzionalita del tema

Aggiornamenti Affiliati in Massa

1. Esporta i dati affiliati correnti
2. Modifica il file CSV con informazioni aggiornate
3. Importa con abbinamento per User ID
4. Verifica che gli aggiornamenti siano stati applicati correttamente