Yükleyici dosyadan iki kolon okur: adres ve istediğiniz takma ad. Geri kalan her şey — grup, etiketler, UTM parametreleri — formda tüm parti için bir kez ayarlanır, satır satır değil.
Dosyayı toplamaya başlamadan önce bilinmesi gereken asıl şey bu. Biçim de, üst sınırlar da, sonradan satırların dökülme nedenlerinin yarısı da buradan çıkıyor.
Aşağıda: partinin tamamının geçeceği bir dosya nasıl kurulur, bağlantıların farklı parametrelere ihtiyacı olduğunda ne yapılır, bir seferde kaç satır gider ve bağlantıların bir kısmı oluşmadığında rapor nasıl okunur.
Yükleyici hangi dosyayı kabul eder
CSV ya da sıradan bir metin dosyası iş görür. Ayrıştırma hoşgörülü yazılmış ve birkaç ayrıntı sizi gereksiz uğraştan kurtarır.
Ayırıcı kendiliğinden belirlenir. Yükleyici ilk satıra bakar ve virgül, noktalı virgül ile sekme arasından en sık geçeni seçer. Bu önemli, çünkü Excel Türkçe yerel ayarda CSV'yi noktalı virgülle kaydeder ve böyle bir dosyayı yeniden düzenlemek gerekmez. Google E-Tablolar'dan virgülle ayrılmış bir dışa aktarma da aynı şekilde geçer; doğrudan tablodan kopyalanan bir kolon da öyle, o sekmeyle ayrılmış olarak gelir.
Başlık satırı zorunlu değil. İlk satır url, alias ya da link ile başlıyorsa başlık sayılır ve partiye girmez. Başlık yoksa birinci kolon adres, ikincisi takma addır.
Tek kolon da olur. Her satırda bir adres olacak şekilde, hiçbir ayırıcı içermeyen bir liste olduğu gibi kabul edilir.
url;alias
https://example.com/katalog/indirim/ayakkabi-2026;ayakkabi
https://example.com/katalog/indirim/canta-2026;canta
https://example.com/katalog/indirim/mont-2026
İçinde virgül olan adresi tırnak içine almak gerekir. Bu, CSV'nin olağan davranışı; ama parametreli dışa aktarmalar tam burada tökezliyor:
"https://example.com/arama?tags=indirim,yeni";indirim-yeni
Tırnaklar olmadan satır o virgülden bölünür ve adresin bir parçası takma ada gider. Bir değerin içindeki çiftlenmiş tırnak ("") harfi harfine tırnak anlamına gelir — yine standart CSV.
Boş satırlar atlanır, dolayısıyla dosya sonundaki fazla satır sonlarını temizlemeniz gerekmez.
Takma adlar seçmeli olarak boş bırakılabilir: yukarıdaki örnekteki üçüncü bağlantıda yok, onun için bir kod üretilecek. Takma adı olan ve olmayan satırları karıştırmak serbesttir.
Bağlantıların farklı parametrelere ihtiyacı olduğunda
Grup, etiketler ve UTM parametreleri tüm partiye birden uygulanır. Tek bir katalog ya da tek bir gönderim yüklerken rahat; liste birkaç kampanyaya yayıldığı anda kısıtlamaya dönüşüyor.
Sağlam iki çözüm.
Parametreleri doğrudan adreslerin içine yazmak. UTM etiketleri sıradan sorgu parametreleridir, yani adreslerin kendisine eklerseniz her satırda farklı olabilirler:
url
https://example.com/a?utm_source=newsletter&utm_campaign=haziran
https://example.com/b?utm_source=telegram&utm_campaign=haziran
Bu kolonu tabloda kurmak tek bir birleştirme formülü meselesidir. Hangi parametreleri ne biçimde koyacağınızdan emin değilseniz, UTM parametreleri üzerine ayrı bir çözümleme var.
Birkaç partiye bölmek. Kampanya başına bir parti: her birinin kendi etiketleri ve kendi grubu olur, sonrasında da uzun bir listeyi didiklemek yerine istatistiği gruba göre okuyabilirsiniz. Kampanya sayısı azsa bu yol genellikle daha temiz kalır.
Bir seferde kaç bağlantı gider
Üç sınır var ve nitelikleri birbirinden farklı.
| Kaç tane | |
|---|---|
| Tek yüklemedeki satır | 1000 |
| Eşzamanlı yükleme | 3 |
| Tek API isteğindeki bağlantı | 100 |
Dosyada binden fazla satır varsa bölün: sınırın üzerindeki satırlar yüklemeye hiç girmez. Üç eşzamanlı yükleme, bitmemiş işler için bir üst sınırdır, günlük kota değil — biri tamamlandığı anda bir sonrakini başlatabilirsiniz.
Aylık hacim ayrı bir konu ve plana bağlı. Ücretsiz planda toplu kısaltma hiç yok. Pro ayda 100 bağlantıya izin veriyor; gerçek bir listede denemeye ve hacme ihtiyacınız olup olmadığını anlamaya yeter. Premium'da aylık sınır yok, ama günlük 30 000 bağlantılık bir tavan işliyor.
Satırların bir kısmı neden oluşmuyor
Bozuk bir satır partiyi iptal etmez. Yükleme sonuna kadar gider ve her satır kendi sonucunu taşır. Üç durum var ve bunları ayırt etmek işe yarar, çünkü çözümleri farklıdır.
Doğrulamada reddedildi. Satır denetimleri geçemedi; bu, dosya ayrıştırıldıktan hemen sonra, henüz hiçbir şey kısaltılmadan görünür. Çoğunlukla bozuk bir adres, aşırı uzun bir takma ad ya da URL olması gereken yerde başka bir şey.
Oluşturulamadı. Satır doğruydu ama bağlantı meydana gelmedi — örneğin istenen takma ad zaten alınmıştı.
Oluşturuldu. Tamam; kısa bağlantı satırın karşısında duruyor.
Tipik nedenler ve ne yapılacağı:
| Görünen | Sorun ne | Ne yapmalı |
|---|---|---|
| Satır reddedildi, adres normal görünüyor | şema yok — https://example.com yerine example.com |
formülle tüm kolona https:// eklemek |
| Her iki satırdan biri reddediliyor | virgüllü adresler tırnağa alınmamış | değerleri tırnağa almak ya da dosyayı noktalı virgülle kaydetmek |
| Takma ada bağlantının bir parçası düşmüş | aynı neden: satır ayırıcıdan bölündü | aynısı |
| Takma ad kesilmiş | takma ad izin verilenden uzun | 10 karaktere indirmek |
| Oluşturulamadı, takma ad alınmış | bu kod zaten var | takma adı değiştirmek ya da alanı boş bırakmak |
| Dosyadakinden az satır yüklendi | dosya 1000 satırı geçiyor | dosyayı bölmek |
Edinilmeye değer bir alışkanlık: önce dosyanın ilk on satırını geçirin. Dışa aktarmadaki sistemli bir aksaklık — yanlış şema, yanlış ayırıcı, fazladan bir kolon — on satırda da binde olduğu gibi ortaya çıkar, ama çözmesi kat kat hızlıdır.
Liste bir program tarafından üretiliyorsa
Bağlantıları tabloyla uğraşan bir insan değil sizin kodunuz hazırlıyorsa, API'de toplu bir yöntem var: tek istekte en çok 100 bağlantı, yanıt öğe öğe ve aynı biçimde oluşturulan, oluşturulamayan ve reddedilen şeklinde bölünmüş.
Burada kolayca çarpılabilecek, pek belli olmayan bir ayrıntı var. Bir parti, istek kotasını bağlantı sayısı kadar harcar, tek istek gibi değil. 100 bağlantılık bir parti 100 birim düşer. Aksi halde toplu yöntem, hız sınırını dolanmanın bir yolu olurdu ve bir müşteri dakikada binlerce bağlantı oluşturabilirdi. Kalan kota partinin tamamını karşılamıyorsa istek bütünüyle reddedilir ve hiçbir şey oluşturulmaz — yani kalanı göndermeden önce kontrol etmek gerekir, sonra değil.
Ortak parametreler formdaki gibi çalışır: defaults bloğu her satıra karışır, satırın kendi alanları onu geçersiz kılar. Satırdaki boş değer "belirtilmedi" demektir, yani değer defaults'tan alınır; tam olarak bir dışa aktarmadaki boş hücre gibi. Uç nokta ve yanıt şeması API belgelerinde yazılı.
Hazır listeyle ne yapmalı
Partiden çıkan kısa bağlantılar tek tek oluşturulanlardan hiç farklı değil: her birinin kendi tıklama istatistiği, coğrafyası ve kaynakları var. Partiye ortak bir grup verdiyseniz istatistiği o gruba göre okumak rahat olur — bütün kataloğun ya da bütün gönderimin tek parça halinde nasıl çalıştığı görünür.
Özellikle büyük listelerde kendini amorti eden iki adım:
- kendi alan adınız. Bin bağlantılık bir partide alan adı okuyucunun karşısına bin kez çıkar ve bu, gönderimin görünüşünün hatırı sayılır bir parçasıdır. Nasıl bağlanacağı ve neyi değiştirdiği kısa linkler için özel alan adı yazısında;
- etiketlemeyi yüklemeden önce yapmak, sonra değil. Zaten oluşmuş bin bağlantının UTM parametrelerini değiştirmek, önceden tabloda etiketli bir kolon kurmaktan daha pahalıya gelir.
Kısaca
Dosyayı bir ya da iki kolondan kurun, adresler https:// şemasıyla, virgül içeren değerler tırnak içinde olsun. Ortak parametreleri partiye verin; farklılaşanları adreslerin içine yazın ya da birkaç yüklemeye dağıtın. On satırda deneyin, sonra kalanını yükleyip satır satır raporu okuyun.
Bölümün kendisi ve adım adım sıra toplu link kısaltma sayfasında; toplu yükleme ücretli planlarda bulunuyor, yani ilk parti için Pro veya üstü bir hesap gerekiyor.
