Creare i link brevi uno alla volta non funziona più quando il foglio di una campagna o un catalogo prodotti arriva a centinaia di righe. L'import in blocco di Posty5 accetta un unico file CSV, controlla ogni riga prima di creare qualsiasi cosa, crea i link in background e ti restituisce un file di risultati con ogni indirizzo breve accanto alla riga da cui proviene.
- Apri Bulk import — Apri URL Shortener nella dashboard di Posty5 e scegli Bulk import.
- Compila il modello — Scarica il modello CSV e compila una riga per ogni URL di destinazione; è obbligatoria solo la colonna url.
- Carica e controlla — Carica il file, scegli i valori predefiniti per le colonne vuote e controllalo. Posty5 elenca ogni riga con errori prima di creare qualsiasi cosa.
- Avvia l'import — Avvia l'import e seguine l'avanzamento, oppure lascia la pagina e attendi la notifica.
- Scarica i risultati — Scarica il file dei risultati con ogni indirizzo breve e, se qualche riga è fallita, il file degli errori.
Prima di iniziare
Ti serve un account Posty5 con accesso effettuato. Apri URL Shortener nella dashboard e scegli Bulk import. La creazione in blocco dipende dal tuo piano: se il piano non la include, la pagina la mostra come bloccata.
Parti dal modello CSV offerto dalla pagina. Ha già la riga di intestazione corretta e una riga di esempio: ti basta sostituire l'esempio con i tuoi dati.
Prepara il file CSV
È obbligatoria solo la colonna url. I nomi delle colonne non distinguono maiuscole e minuscole, e una colonna che Posty5 non riconosce viene ignorata e segnalata nella fase di controllo.
url | L'indirizzo di destinazione. Obbligatorio. Viene accettato anche il nome alternativo baseUrl. |
name | Un nome per il tuo elenco. Se lo lasci vuoto, Posty5 lo compila in background a partire dalla pagina di destinazione. |
customId | La parte finale personalizzata del link breve, se il tuo piano consente finali personalizzati. Non deve essere già in uso, nemmeno da una riga precedente dello stesso file. |
tag | Un tag per raggruppare e filtrare i link in seguito. |
refId | Un tuo riferimento, ad esempio il codice di un prodotto nel tuo sistema. |
templateId | Il modello di QR code di questa riga. Sostituisce quello predefinito scelto nella fase di caricamento. |
Salva il file come CSV UTF-8 con virgole e una riga di intestazione. I valori che contengono virgole vanno tra virgolette doppie, cosa che i programmi di fogli di calcolo fanno da soli quando esportano in CSV.
Avvia un import in bloccoCarica e controlla il file
Dopo il caricamento, scegli i valori predefiniti per le righe che lasciano vuota una colonna (modello, tag e ref ID), poi controlla il file. Posty5 legge ogni riga senza creare nulla ed elenca ogni riga con errori insieme al suo numero, contando dalla prima riga sotto l'intestazione. Una riga non è valida quando:
- l'URL manca, non è un indirizzo web valido o supera i 2.048 caratteri
- l'URL è bloccato perché non sicuro, esattamente come accadrebbe per un singolo link
- un nome, un tag o un riferimento supera i 255 caratteri
- il finale personalizzato non è consentito dal tuo piano, non è valido o è già in uso
- il modello non esiste o non è tuo
Avvia l'import
Avvia l'import quando il controllo è a posto. Viene eseguito in background: la pagina mostra quante righe sono state elaborate, create e fallite, e puoi anche chiuderla, perché una notifica ti avvisa quando l'import è terminato.
Puoi annullare un import in corso. I link creati prima dell'annullamento restano nel tuo account.
Titoli delle pagine e deep link delle app vengono recuperati dopo la creazione di ogni link, quindi per qualche istante un nuovo link può mostrare il nome host come nome.
- Un file contiene al massimo 5.000 righe e 2 MB.
- Si possono creare in blocco fino a 20.000 righe per account al giorno (UTC), sommando tutti gli import e le chiamate API.
- Si esegue un import alla volta, e fino ad altri tre possono restare in attesa dietro di esso.
- Se il tuo account esaurisce i crediti durante un import, quella riga e tutte le successive falliscono, mentre i link già creati restano.
Scarica i risultati
Al termine dell'import, scarica il file dei risultati. Contiene una riga per ogni riga del tuo file: il numero di riga, lo stato (creata, fallita, saltata, oppure non elaborata se l'import si è fermato prima di arrivarci), l'ID e l'indirizzo breve del nuovo link e il motivo quando una riga è fallita.
Un secondo file contiene solo le righe fallite con i tuoi valori originali, così puoi correggerle e caricare di nuovo quel file.
Gli import passati sono elencati con stato e conteggi, quindi puoi riaprirne uno più tardi e scaricarne di nuovo i file. I file caricati e quelli dei risultati vengono conservati per 7 giorni e il record dell'import per 30 giorni: scarica ciò che ti serve prima di allora. I link invece non vengono mai rimossi.
Esporta i tuoi link in seguito
- Dall'elenco dei link brevi, scegli Export CSV o Export JSON per scaricare i tuoi link con i relativi contatori di visite.
- L'esportazione segue i filtri applicati all'elenco: filtra prima per tag per esportare una sola campagna.
- Un'esportazione contiene al massimo 50.000 righe, dalla più recente; un elenco più lungo viene troncato lì e il file lo indica.
- Una cella CSV che inizia con =, +, - o @ riceve un apostrofo iniziale, così il programma di fogli di calcolo la mostra come testo invece di eseguirla come formula.
Farlo da codice
Gli sviluppatori possono fare lo stesso tramite l'API di Posty5 con una chiave API: POST /api/short-link/bulk crea fino a 100 righe in una sola richiesta e restituisce un risultato per riga, mentre POST /api/link-bulk-jobs invia un intero file come job da interrogare periodicamente. Entrambi applicano gli stessi controlli e limiti della dashboard. Le route sono documentate nel riferimento API.
Domande frequenti
Quanti URL posso importare in una volta?
Un file contiene al massimo 5.000 righe e 2 MB, e si possono creare in blocco fino a 20.000 righe per account al giorno.
Cosa succede a una riga con un URL errato?
La fase di controllo la elenca con numero di riga e motivo prima che venga creato qualsiasi cosa. Durante l'import, una riga che fallisce non blocca mai le altre.
Posso scegliere i miei finali personalizzati?
Sì, nella colonna customId, se il tuo piano consente finali personalizzati. Ogni finale non deve essere già in uso, nemmeno da una riga precedente dello stesso file.
Per quanto tempo posso scaricare i risultati?
I file caricati e quelli dei risultati vengono conservati per 7 giorni. I link restano nel tuo account.
Posso esportare i miei link brevi?
Sì. L'elenco dei link brevi esporta in CSV o JSON con i contatori di visite di ogni link, seguendo i filtri dell'elenco, fino a 50.000 righe per file.
