Pengunggah membaca dua kolom dari berkas Anda: alamat dan alias yang diinginkan. Semua yang lain — grup, tag, parameter UTM — diatur sekali untuk seluruh kumpulan di formulir, bukan baris per baris.

Itulah hal utama yang perlu diketahui sebelum Anda menyusun berkasnya. Dari situ mengalir format, batasannya, dan separuh alasan mengapa baris-baris nanti berjatuhan.

Berikut ini: cara menyusun berkas yang lolos utuh, apa yang dilakukan ketika setiap tautan butuh parameter berbeda, berapa baris yang berangkat sekali jalan, dan cara membaca laporan ketika sebagian tautan tidak terbentuk.

Berkas seperti apa yang diterima pengunggah

CSV atau berkas teks biasa sudah cukup. Pembacaannya memaafkan, dan beberapa detail akan menghemat kerepotan Anda.

Pemisah dikenali sendiri. Pengunggah melihat baris pertama lalu memilih di antara koma, titik koma, dan tab, mana yang paling sering muncul. Ini penting karena Excel pada lokal Indonesia menyimpan CSV dengan titik koma, dan berkas semacam itu tak perlu dirombak. Ekspor dari Google Spreadsheet dengan koma sama-sama jalan, begitu pula kolom yang disalin langsung dari lembar kerja, yang datang terpisah tab.

Baris tajuk tidak wajib. Kalau baris pertama dimulai dengan url, alias, atau link, baris itu dianggap tajuk dan tidak ikut ke dalam kumpulan. Tanpa tajuk, kolom pertama adalah alamat dan kolom kedua adalah alias.

Satu kolom saja tidak masalah. Daftar alamat, satu per baris, tanpa pemisah apa pun, diterima apa adanya.

url;alias
https://example.com/katalog/diskon/sepatu-2026;sepatu
https://example.com/katalog/diskon/tas-2026;tas
https://example.com/katalog/diskon/mantel-2026

Alamat yang memuat koma harus diapit tanda kutip. Ini perilaku CSV yang biasa, tetapi justru di sinilah ekspor berparameter tersandung:

"https://example.com/cari?tags=diskon,baru";diskon-baru

Tanpa tanda kutip, baris itu terbelah pada koma tersebut dan sepotong alamat mendarat di alias. Tanda kutip ganda di dalam sebuah nilai ("") berarti satu tanda kutip harfiah — kembali, CSV standar.

Baris kosong dilewati, jadi Anda tak perlu membersihkan pergantian baris di ujung berkas.

Alias boleh dibiarkan kosong secara terpilih: tautan ketiga pada contoh di atas tak punya alias, dan sebuah kode akan dibuatkan untuknya. Mencampur baris yang beralias dan yang tidak diizinkan.

Ketika setiap tautan butuh parameter berbeda

Grup, tag, dan parameter UTM berlaku untuk seluruh kumpulan sekaligus. Nyaman ketika Anda mengunggah satu katalog atau satu kiriman; menjadi batasan begitu daftarnya melintasi beberapa kampanye.

Dua jalan keluar yang tahan uji.

Menuliskan parameter langsung ke dalam alamat. Tag UTM adalah parameter kueri biasa, jadi bisa berbeda tiap baris kalau Anda menambahkannya pada alamat itu sendiri:

url
https://example.com/a?utm_source=newsletter&utm_campaign=juni
https://example.com/b?utm_source=telegram&utm_campaign=juni

Menyusun kolom seperti itu di lembar kerja cukup dengan satu rumus penggabungan.

Memecah menjadi beberapa kumpulan. Satu kumpulan per kampanye: masing-masing dengan tag dan grupnya sendiri, dan sesudahnya statistik bisa dibaca per grup alih-alih membongkar satu daftar panjang. Jalan ini biasanya lebih bersih kalau kampanyenya tidak banyak.

Berapa tautan yang berangkat sekali jalan

Ada tiga batas, dan ketiganya berbeda sifat.

Berapa
Baris dalam satu unggahan 1000
Unggahan yang berjalan bersamaan 3
Tautan dalam satu permintaan ke API 100

Kalau berkasnya melebihi seribu baris, pecahlah: baris di atas batas memang tidak akan masuk ke unggahan. Tiga unggahan bersamaan adalah plafon untuk pekerjaan yang belum selesai, bukan kuota harian — begitu satu tuntas, Anda bisa memulai yang berikutnya.

Volume bulanan adalah urusan lain dan bergantung pada paket. Pada paket gratis pemendekan massal tidak tersedia sama sekali. Pro mengizinkan 100 tautan sebulan, cukup untuk mencobanya pada daftar sungguhan dan tahu apakah Anda memang memerlukan volumenya. Premium tidak punya plafon bulanan, tetapi berlaku batas harian 30.000 tautan.

Mengapa sebagian baris tidak terbentuk

Satu baris buruk tidak membatalkan kumpulannya. Unggahan berjalan sampai akhir, dan setiap baris membawa hasilnya sendiri. Ada tiga status, dan membedakannya berguna karena cara memperbaikinya tidak sama.

Ditolak saat pemeriksaan. Baris tidak lolos pemeriksaan, dan itu terlihat langsung setelah berkas dibaca, sebelum apa pun dipendekkan. Umumnya alamat yang rusak, alias yang kepanjangan, atau sampah di tempat yang seharusnya berisi URL.

Tidak dibuat. Barisnya benar, tetapi tautannya tak jadi — misalnya alias yang diminta sudah terpakai.

Dibuat. Selesai; tautan pendeknya ada di seberang baris itu.

Penyebab yang lazim dan apa yang harus dilakukan:

Yang terlihat Masalahnya apa Apa yang dilakukan
Baris ditolak, alamatnya tampak normal skema tidak ada — example.com bukan https://example.com tambahkan https:// dengan rumus ke seluruh kolom
Satu dari dua baris ditolak alamat berkoma tidak diapit tanda kutip apit nilainya, atau simpan berkas dengan titik koma
Di alias muncul sepotong tautan penyebab yang sama: baris terbelah di pemisah sama
Alias terpotong alias lebih panjang dari yang diizinkan pendekkan sampai 10 karakter
Tidak dibuat, alias terpakai kode itu sudah ada ganti alias atau biarkan kolomnya kosong
Baris yang terunggah lebih sedikit dari yang ada di berkas berkas melebihi 1000 baris pecah berkasnya

Kebiasaan yang layak dibentuk: jalankan dulu sepuluh baris pertama dari berkas itu. Masalah sistematis pada ekspor — skema salah, pemisah salah, satu kolom berlebih — muncul pada sepuluh baris persis seperti pada seribu, tetapi jauh lebih cepat diurai.

Kalau daftarnya dihasilkan program

Ketika tautan disiapkan oleh kode Anda, bukan oleh orang dengan lembar kerja, ada metode borongan di API: hingga 100 tautan dalam satu permintaan, dengan respons per butir yang membawa pembagian sama — dibuat, tidak dibuat, dan ditolak.

Ada satu detail tak kentara di sini yang mudah ditabrak. Satu kumpulan menghabiskan kuota permintaan sebanyak jumlah tautannya, bukan sebagai satu permintaan. Kumpulan berisi 100 tautan memotong 100 satuan. Kalau tidak begitu, metode borongan akan menjadi cara menghindari batas frekuensi, dan satu klien bisa membuat ribuan tautan per menit. Jika kuota yang tersisa tidak menutupi seluruh kumpulan, permintaan ditolak sepenuhnya dan tak ada yang dibuat — jadi sisanya diperiksa sebelum dikirim, bukan sesudah.

Parameter bersama bekerja seperti di formulir: blok defaults dilebur ke setiap baris, dan kolom pada baris itu sendiri menggantikannya. Nilai kosong pada baris berarti "tidak ditentukan", jadi nilainya diambil dari defaults, persis seperti sel kosong pada sebuah ekspor. Endpoint dan skema responsnya dijelaskan di dokumentasi API.

Apa yang dilakukan dengan daftar yang sudah jadi

Tautan pendek dari sebuah kumpulan tidak berbeda dari yang dibuat satu-satu: masing-masing punya statistik klik, geografi, dan sumbernya sendiri. Kalau Anda memberi grup bersama pada kumpulan itu, membaca statistik per grup jadi nyaman — terlihat bagaimana seluruh katalog atau seluruh kiriman bekerja sebagai satu kesatuan.

Dua langkah yang terbayar justru pada daftar besar:

  • domain milik sendiri. Pada kumpulan seribu tautan, nama domain bertemu pembaca seribu kali, dan itu bagian yang kelihatan dari bagaimana sebuah kiriman tampil. Cara menyambungkannya dan apa yang berubah ada di artikel tentang domain khusus;
  • menandai sebelum mengunggah, bukan sesudahnya. Mengubah parameter UTM pada seribu tautan yang sudah terbentuk lebih mahal daripada menyusun kolom bertanda di lembar kerja lebih dulu. Soal mengukur hasilnya sendiri dibahas di tulisan tentang cara mengukur efektivitas iklan.

Ringkasnya

Susun berkas dari satu atau dua kolom, alamat memakai skema https://, nilai yang memuat koma diapit tanda kutip. Parameter bersama ditetapkan pada kumpulan; yang berbeda-beda tuliskan ke dalam alamat atau sebar ke beberapa unggahan. Uji pada sepuluh baris, lalu unggah sisanya dan baca laporan per barisnya.

Bagian itu sendiri dan urutan langkah demi langkahnya ada di halaman pemendek tautan massal; unggah massal tersedia pada paket berbayar, jadi kumpulan pertama memerlukan akun Pro atau lebih tinggi.