Trình tải lên chỉ đọc hai cột trong tệp của bạn: địa chỉ và bí danh bạn muốn. Mọi thứ còn lại — nhóm, thẻ, tham số UTM — được đặt một lần cho cả lô trong biểu mẫu, chứ không theo từng dòng.
Đó là điều chính cần biết trước khi bạn bắt tay dựng tệp. Định dạng, các mức giới hạn, và một nửa số lý do khiến dòng bị loại về sau đều bắt nguồn từ đây.
Dưới đây: cách dựng một tệp đi qua trọn vẹn, làm gì khi mỗi liên kết cần tham số khác nhau, một lần chạy được bao nhiêu dòng, và đọc báo cáo thế nào khi một phần liên kết không được tạo.
Trình tải lên chấp nhận tệp nào
Một tệp CSV hoặc tệp văn bản thường đều được. Việc phân tích viết theo hướng dễ tính, và vài chi tiết sẽ giúp bạn khỏi loay hoay.
Dấu phân cách được nhận ra tự động. Trình tải lên xem dòng đầu rồi chọn trong dấu phẩy, dấu chấm phẩy và dấu tab cái nào xuất hiện nhiều nhất. Điều này có ích khi bạn sao chép thẳng một cột từ bảng tính: thứ nhận được sẽ cách nhau bằng tab, và vẫn dùng được ngay. Tệp CSV xuất ra cách nhau bằng dấu phẩy cũng vậy.
Dòng tiêu đề không bắt buộc. Nếu dòng đầu bắt đầu bằng url, alias hoặc link thì nó được coi là tiêu đề và không vào lô. Không có tiêu đề thì cột thứ nhất là địa chỉ, cột thứ hai là bí danh.
Một cột cũng không sao. Danh sách địa chỉ, mỗi dòng một cái, không có dấu phân cách nào, được nhận đúng như vậy.
url,alias
https://example.com/catalog/sale/shoes-2026,shoes
https://example.com/catalog/sale/bags-2026,bags
https://example.com/catalog/sale/coats-2026
Địa chỉ có dấu phẩy bên trong phải được đặt trong dấu ngoặc kép. Đây là lệ thường của CSV, nhưng đúng chỗ này là nơi các bản xuất có tham số sa chân:
"https://example.com/search?tags=sale,new",sale-new
Không có dấu ngoặc kép thì dòng sẽ vỡ ra tại dấu phẩy đó, và một mẩu địa chỉ chạy sang ô bí danh. Dấu ngoặc kép viết lặp hai lần bên trong một giá trị ("") có nghĩa là một dấu ngoặc kép theo nghĩa chữ — cũng vẫn là CSV chuẩn.
Dòng trống được bỏ qua, nên bạn không phải dọn những lần xuống dòng còn sót ở cuối tệp.
Bí danh có thể để trống tùy dòng: liên kết thứ ba trong ví dụ trên không có bí danh, và dòng đó sẽ được sinh mã tự động. Trộn lẫn dòng có bí danh và dòng không có là được phép.
Khi mỗi liên kết cần tham số khác nhau
Nhóm, thẻ và tham số UTM áp dụng cho cả lô một lượt. Tiện khi bạn tải lên một catalog hoặc một đợt gửi thư; thành ra hạn chế ngay khi danh sách trải qua nhiều chiến dịch.
Hai lối đi vòng đứng vững được.
Viết tham số thẳng vào chính các địa chỉ. Thẻ UTM là tham số truy vấn bình thường, nên chúng có thể khác nhau ở từng dòng nếu bạn nối thêm vào bản thân địa chỉ:
url
https://example.com/a?utm_source=newsletter&utm_campaign=june
https://example.com/b?utm_source=telegram&utm_campaign=june
Dựng cột như vậy trong bảng tính chỉ cần một công thức nối chuỗi.
Chia thành nhiều lô. Mỗi chiến dịch một lô: mỗi lô có thẻ riêng và nhóm riêng, sau đó bạn đọc số liệu theo nhóm thay vì phải bóc tách một danh sách dài. Khi số chiến dịch không nhiều, đường này thường gọn hơn.
Một lần chạy được bao nhiêu liên kết
Có ba mức giới hạn, và chúng khác nhau về bản chất.
| Bao nhiêu | |
|---|---|
| Dòng trong một lần tải lên | 1000 |
| Số lần tải lên chạy song song | 3 |
| Liên kết trong một yêu cầu tới API | 100 |
Nếu tệp vượt một nghìn dòng, hãy chia ra: những dòng vượt giới hạn đơn giản là không vào lần tải lên đó. Ba lần tải lên song song là mức trần cho các công việc chưa xong, không phải định mức mỗi ngày — một cái vừa xong là bạn có thể khởi động cái tiếp theo.
Khối lượng mỗi tháng là chuyện khác và tùy vào gói. Gói miễn phí không có chức năng rút gọn hàng loạt. Gói Pro cho 100 liên kết mỗi tháng — đủ để thử trên một danh sách thật và biết mình có cần khối lượng đó hay không. Gói Premium không có trần tháng, nhưng có mức chặn 30.000 liên kết mỗi ngày.
Vì sao một phần dòng không được tạo
Một dòng hỏng không hủy cả lô. Việc tải lên chạy đến hết, và mỗi dòng mang kết cục riêng của nó. Có ba trạng thái, và phân biệt được chúng là có ích, vì cách sửa khác nhau.
Bị từ chối khi kiểm tra. Dòng không qua được các bước kiểm, và điều này thấy ngay sau khi tệp được đọc, lúc chưa rút gọn gì cả. Thường là địa chỉ sai dạng, bí danh dài quá, hoặc một thứ khác nằm ở chỗ lẽ ra phải là địa chỉ.
Không được tạo. Bản thân dòng thì đúng, nhưng liên kết không thành — chẳng hạn bí danh được yêu cầu đã có người dùng.
Đã tạo. Xong, liên kết ngắn nằm đối diện dòng đó.
Nguyên nhân thường gặp và cách xử lý:
| Thấy gì | Vấn đề nằm ở đâu | Làm gì |
|---|---|---|
| Dòng bị từ chối, địa chỉ trông bình thường | thiếu lược đồ — example.com thay vì https://example.com |
dùng công thức thêm https:// cho cả cột |
| Cứ hai dòng thì một dòng bị từ chối | địa chỉ có dấu phẩy không được đặt trong ngoặc kép | đặt giá trị vào ngoặc kép, hoặc lưu tệp phân cách bằng dấu chấm phẩy |
| Trong ô bí danh có một mẩu liên kết | cùng nguyên nhân: dòng vỡ tại dấu phân cách | như trên |
| Bí danh bị cắt | bí danh dài hơn mức cho phép | rút xuống 10 ký tự |
| Không được tạo, bí danh đã dùng | mã đó đã tồn tại | đổi bí danh hoặc để trống ô |
| Số dòng tải vào ít hơn số có trong tệp | tệp vượt 1000 dòng | chia tệp ra |
Một thói quen nên tập: cho mười dòng đầu của tệp đi qua trước. Lỗi mang tính hệ thống của bản xuất — sai lược đồ, sai dấu phân cách, dư một cột — sẽ lộ ra ở mười dòng y như ở một nghìn dòng, nhưng gỡ thì nhanh hơn hẳn.
Nếu danh sách do chương trình sinh ra
Khi liên kết do mã của bạn chuẩn bị, chứ không phải do một người ngồi với bảng tính, API có phương thức theo lô: tối đa 100 liên kết trong một yêu cầu, phản hồi theo từng phần tử với cùng cách chia thành đã tạo, không được tạo và bị từ chối.
Ở đây có một chi tiết không lộ ra mà lại dễ đụng phải. Một lô tiêu tốn hạn mức yêu cầu theo số liên kết, không tính như một yêu cầu đơn. Lô 100 liên kết trừ đi 100 đơn vị. Nếu không thế thì phương thức theo lô sẽ thành cách lách giới hạn tần suất, và một khách hàng có thể tạo hàng nghìn liên kết mỗi phút. Nếu hạn mức còn lại không đủ cho cả lô, yêu cầu bị từ chối toàn bộ và không có gì được tạo — vậy nên hãy kiểm phần còn lại trước khi gửi, đừng sau khi gửi.
Tham số dùng chung hoạt động như trong biểu mẫu: khối defaults hòa vào từng dòng, và các trường của chính dòng đó ghi đè lên nó. Giá trị trống trong dòng nghĩa là "không chỉ định", nên giá trị được lấy từ defaults, hệt như một ô trống trong bản xuất. Điểm cuối và cấu trúc phản hồi được mô tả trong tài liệu API.
Làm gì với danh sách đã xong
Liên kết ngắn ra từ một lô không khác gì liên kết tạo lẻ từng cái: mỗi liên kết có thống kê lượt nhấp, địa lý và nguồn riêng. Nếu bạn đã gán một nhóm chung cho cả lô thì đọc thống kê theo nhóm đó rất tiện — thấy được cả catalog hoặc cả đợt gửi thư đã chạy ra sao với tư cách một khối.
Nếu trước khi đi xa hơn bạn muốn hiểu bản thân việc rút gọn diễn ra thế nào, nó được mô tả trong bài về cách hoạt động của dịch vụ rút gọn liên kết. Hai việc đáng làm chính ở các danh sách lớn: dùng tên miền riêng, vì với lô một nghìn liên kết thì tên miền gặp người đọc một nghìn lần — cách kết nối và những gì thay đổi nằm trong bài về tên miền tùy chỉnh; và gắn thẻ trước khi tải lên chứ không phải sau, vì sửa tham số UTM của một nghìn liên kết đã tạo thì đắt hơn việc dựng sẵn một cột đã gắn thẻ trong bảng tính.
Ngắn gọn
Dựng tệp gồm một hoặc hai cột, địa chỉ mang lược đồ https://, giá trị có dấu phẩy thì đặt trong ngoặc kép. Tham số dùng chung đặt ở mức lô; những cái phải khác nhau thì viết vào chính địa chỉ hoặc rải ra nhiều lần tải lên. Thử với mười dòng, rồi tải phần còn lại và đọc báo cáo theo từng dòng.
Bản thân mục này và trình tự từng bước nằm ở trang rút gọn link hàng loạt; tải lên hàng loạt có ở các gói trả phí, nên lô đầu tiên cần một tài khoản Pro trở lên.
