Der Uploader liest aus der Datei zwei Spalten: die Adresse und den gewünschten Alias. Alles andere — Gruppe, Tags, UTM-Parameter — wird im Formular einmal für den gesamten Stapel gesetzt, nicht je Zeile.
Das ist das Wichtigste, bevor Sie die Datei zusammenstellen. Daraus folgen das Format, die Obergrenzen und die Hälfte der Gründe, aus denen später Zeilen scheitern.
Im Folgenden: wie man eine Datei baut, die vollständig durchgeht; was zu tun ist, wenn einzelne Links unterschiedliche Parameter brauchen; wie viele Zeilen auf einmal durchlaufen; und wie der Bericht zu lesen ist, wenn ein Teil der Links nicht entsteht.
Welche Datei der Uploader annimmt
Eine CSV-Datei oder eine gewöhnliche Textdatei genügt. Die Auswertung ist nachsichtig, und ein paar Details ersparen Ihnen Nacharbeit.
Das Trennzeichen wird selbst erkannt. Der Uploader sieht sich die erste Zeile an und wählt unter Komma, Semikolon und Tabulator dasjenige, das am häufigsten vorkommt. Das ist wichtig, weil Excel im deutschen Gebietsschema CSV mit Semikolon speichert — eine solche Datei muss nicht umgebaut werden. Ein kommagetrennter Export aus Google Tabellen funktioniert genauso, und ebenso eine direkt aus der Tabelle kopierte Spalte, die tabulatorgetrennt ankommt.
Eine Kopfzeile ist optional. Beginnt die erste Zeile mit url, alias oder link, gilt sie als Kopfzeile und bleibt aus dem Stapel heraus. Ohne Kopfzeile ist die erste Spalte die Adresse und die zweite der Alias.
Eine einzige Spalte ist in Ordnung. Eine Liste von Adressen, eine pro Zeile, ganz ohne Trennzeichen, wird so angenommen, wie sie ist.
url;alias
https://example.com/katalog/sale/schuhe-2026;schuhe
https://example.com/katalog/sale/taschen-2026;taschen
https://example.com/katalog/sale/mantel-2026
Eine Adresse mit einem Komma darin muss in Anführungszeichen stehen. Das ist gewöhnliches CSV-Verhalten, aber genau daran scheitern Exporte mit Parametern:
"https://example.com/suche?tags=sale,neu";sale-neu
Ohne die Anführungszeichen bricht die Zeile an diesem Komma auf, und ein Stück der Adresse landet im Alias. Ein verdoppeltes Anführungszeichen innerhalb eines Werts ("") steht für ein wörtliches Anführungszeichen — wiederum Standard-CSV.
Leerzeilen werden übersprungen, überzählige Zeilenumbrüche am Dateiende müssen Sie also nicht wegräumen.
Aliasse lassen sich gezielt leer lassen: der dritte Link im Beispiel hat keinen, für ihn wird ein Code erzeugt. Zeilen mit und ohne Alias zu mischen ist erlaubt.
Wenn einzelne Links unterschiedliche Parameter brauchen
Gruppe, Tags und UTM-Parameter gelten für den gesamten Stapel auf einmal. Bequem, solange Sie einen Katalog oder einen Versand hochladen; eine Einschränkung, sobald die Liste mehrere Kampagnen umfasst.
Zwei belastbare Auswege.
Die Parameter direkt in die Adressen schreiben. UTM-Tags sind gewöhnliche Query-Parameter, können also je Zeile verschieden sein, wenn Sie sie in den Adressen selbst anhängen:
url
https://example.com/a?utm_source=newsletter&utm_campaign=juni
https://example.com/b?utm_source=telegram&utm_campaign=juni
Diese Spalte in der Tabelle zusammenzusetzen ist eine Formel mit Textverkettung.
In mehrere Stapel aufteilen. Ein Stapel je Kampagne: jeder mit eigenen Tags und eigener Gruppe, und hinterher lesen Sie die Statistik nach Gruppe statt eine lange Liste zu zerlegen. Dieser Weg bleibt meist sauberer, wenn es nur wenige Kampagnen sind.
Wie viele Links auf einmal durchlaufen
Es gibt drei Grenzen, und sie sind verschiedener Art.
| Wie viele | |
|---|---|
| Zeilen in einem Upload | 1000 |
| Gleichzeitige Uploads | 3 |
| Links in einer API-Anfrage | 100 |
Hat die Datei mehr als tausend Zeilen, teilen Sie sie: Zeilen über der Grenze gelangen gar nicht in den Upload. Drei gleichzeitige Uploads sind eine Obergrenze für unfertige Aufträge, kein Tageskontingent — sobald einer durch ist, können Sie den nächsten starten.
Das Monatsvolumen ist eine andere Sache und hängt vom Tarif ab. Im kostenlosen Tarif gibt es Massenkürzung überhaupt nicht. Pro erlaubt 100 Links im Monat, genug, um es an einer echten Liste auszuprobieren und herauszufinden, ob Sie das Volumen brauchen. Premium hat keine Monatsgrenze, dafür gilt eine Tagesobergrenze von 30 000 Links.
Warum ein Teil der Zeilen nicht entsteht
Eine schlechte Zeile hebt den Stapel nicht auf. Der Upload läuft bis zum Ende, und jede Zeile trägt ihr eigenes Ergebnis. Es gibt drei Zustände, und sie zu unterscheiden lohnt sich, weil sie unterschiedlich behoben werden.
Bei der Prüfung abgewiesen. Die Zeile ist durch die Prüfung gefallen, und das sehen Sie direkt nach dem Einlesen der Datei, noch vor dem Kürzen. Meist eine fehlerhafte Adresse, ein zu langer Alias oder Unrat an der Stelle, an der eine URL stehen sollte.
Nicht erstellt. Die Zeile war korrekt, der Link ist aber nicht zustande gekommen — etwa weil der gewünschte Alias schon belegt war.
Erstellt. Fertig, der Kurzlink steht neben der Zeile.
Typische Ursachen und was dagegen hilft:
| Was zu sehen ist | Woran es liegt | Was zu tun ist |
|---|---|---|
| Zeile abgewiesen, Adresse sieht normal aus | Schema fehlt — example.com statt https://example.com |
https:// per Formel über die ganze Spalte ergänzen |
| Jede zweite Zeile abgewiesen | Adressen mit Kommas nicht in Anführungszeichen | Werte einfassen oder die Datei mit Semikolon speichern |
| Im Alias steckt ein Stück des Links | gleiche Ursache: die Zeile brach am Trennzeichen auf | dasselbe |
| Alias abgeschnitten | Alias länger als erlaubt | auf 10 Zeichen kürzen |
| Nicht erstellt, Alias belegt | dieser Code existiert bereits | Alias ändern oder das Feld leer lassen |
| Weniger Zeilen geladen als in der Datei | Datei hat mehr als 1000 Zeilen | Datei aufteilen |
Eine Gewohnheit, die sich auszahlt: schicken Sie zuerst die ersten zehn Zeilen durch. Ein systematisches Problem des Exports — falsches Schema, falsches Trennzeichen, eine Spalte zu viel — zeigt sich an zehn Zeilen genauso wie an tausend, lässt sich aber erheblich schneller entwirren.
Wenn die Liste von einem Programm erzeugt wird
Bereitet Ihre Software die Links vor und nicht ein Mensch mit einer Tabelle, gibt es eine Stapelmethode in der Schnittstelle: bis zu 100 Links in einer Anfrage, mit einer Antwort je Element und derselben Aufteilung in erstellt, nicht erstellt und abgewiesen.
Hier steckt ein unauffälliges Detail, in das man leicht läuft. Ein Stapel verbraucht Anfragekontingent je Link, nicht als eine einzige Anfrage. Ein Stapel mit 100 Links zieht 100 Einheiten ab. Sonst würde die Stapelmethode zum Weg um die Ratenbegrenzung herum, und ein Kunde könnte Tausende Links pro Minute anlegen. Deckt das verbleibende Kontingent den ganzen Stapel nicht, wird die Anfrage vollständig abgewiesen und nichts erstellt — den Rest prüft man also vor dem Senden, nicht danach.
Gemeinsame Parameter verhalten sich wie im Formular: der Block defaults wird in jede Zeile eingemischt, und die Felder der Zeile selbst überschreiben ihn. Ein leerer Wert in der Zeile bedeutet „nicht angegeben", der Wert kommt also aus defaults, genau wie eine leere Zelle in einem Export. Endpunkt und Antwortschema stehen in der API-Dokumentation.
Was mit der fertigen Liste zu tun ist
Kurzlinks aus einem Stapel unterscheiden sich nicht von einzeln erstellten: jeder hat seine eigene Klickstatistik, Geografie und Quellen. Haben Sie dem Stapel eine gemeinsame Gruppe gegeben, lässt sich die Statistik bequem nach dieser Gruppe lesen — man sieht, wie der ganze Katalog oder der ganze Versand als Einheit gelaufen ist.
Zwei Schritte, die sich gerade bei großen Listen rechnen:
- eigene Domain. Bei einem Stapel von tausend Links begegnet der Domainname dem Leser tausendmal, und das ist ein sichtbarer Teil davon, wie ein Versand wirkt. Wie man sie anbindet und was sich ändert, steht im Beitrag über individuelle Domains;
- vor dem Upload auszeichnen, nicht danach. Die UTM-Parameter von tausend bereits bestehenden Links zu ändern kostet mehr, als vorher in der Tabelle eine ausgezeichnete Spalte zusammenzusetzen.
Kurz gefasst
Bauen Sie eine Datei aus einer oder zwei Spalten, Adressen mit dem Schema https://, Werte mit Kommas in Anführungszeichen. Gemeinsame Parameter setzen Sie am Stapel; abweichende schreiben Sie in die Adressen selbst oder verteilen sie über mehrere Uploads. Testen Sie an zehn Zeilen, laden Sie dann den Rest und lesen Sie den Bericht je Zeile.
Den Bereich selbst und die Schritt-für-Schritt-Reihenfolge finden Sie auf der Seite Links massenhaft kürzen; der Massen-Upload steht in den bezahlten Tarifen zur Verfügung, für den ersten Stapel braucht es also ein Konto mit Pro oder höher.