대량 단축을 위해 링크 목록을 어떻게 준비할까

업로더가 파일에서 읽는 것은 두 개의 열, 곧 주소와 원하는 별칭입니다. 나머지 전부 — 그룹, 태그, UTM 파라미터 — 는 폼에서 묶음 전체에 한 번 지정하며, 행마다 따로 넣을 수는 없습니다.

파일을 만들기 전에 알아 둘 핵심이 이것입니다. 형식도, 상한도, 나중에 행이 떨어져 나가는 이유의 절반도 여기서 따라 나옵니다.

아래에서는 묶음이 통째로 통과하는 파일을 어떻게 만드는지, 링크마다 다른 파라미터가 필요할 때 어떻게 하는지, 한 번에 몇 행이 들어가는지, 그리고 일부 링크가 만들어지지 않았을 때 보고를 어떻게 읽는지를 다룹니다.

업로더가 받아들이는 파일

CSV든 평범한 텍스트 파일이든 됩니다. 해석은 관대하게 짜여 있고, 몇 가지만 알아 두면 번거로움이 줄어듭니다.

구분자는 스스로 판별됩니다. 업로더는 첫 줄을 보고 쉼표, 세미콜론, 탭 가운데 가장 자주 나오는 것을 고릅니다. 스프레드시트에서 열을 그대로 복사해 붙인 경우 탭으로 구분되어 들어오는데, 그것도 그대로 통과합니다. 쉼표로 내보낸 CSV도 마찬가지입니다.

머리글 행은 필수가 아닙니다. 첫 줄이 url, alias, link 로 시작하면 머리글로 보고 묶음에서 빼냅니다. 머리글이 없으면 첫 번째 열이 주소, 두 번째 열이 별칭입니다.

한 열만 있어도 됩니다. 한 줄에 주소 하나씩, 구분자 없이 늘어놓은 목록도 그대로 받습니다.

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

쉼표가 들어 있는 주소는 인용부호로 감싸야 합니다. CSV의 일반적인 규칙이지만, 파라미터가 붙은 내보내기가 걸려 넘어지는 지점이 바로 여기입니다.

"https://example.com/search?tags=sale,new",sale-new

인용부호가 없으면 행이 그 쉼표에서 쪼개지고, 주소의 조각이 별칭 칸으로 넘어갑니다. 값 안에서 두 번 겹쳐 쓴 인용부호("")는 글자로서의 인용부호를 뜻합니다 — 이것도 표준 CSV와 같습니다.

빈 줄은 건너뜁니다. 파일 끝에 남은 줄바꿈을 치울 필요는 없습니다.

별칭은 행별로 비워 둘 수 있습니다. 위 예시의 세 번째 링크에는 별칭이 없고, 그 행에는 코드가 자동으로 생성됩니다. 별칭이 있는 행과 없는 행을 섞는 것도 허용됩니다.

링크마다 다른 파라미터가 필요할 때

그룹, 태그, UTM 파라미터는 묶음 전체에 한꺼번에 적용됩니다. 카탈로그 하나나 발송 하나를 올릴 때는 편하지만, 목록이 여러 캠페인에 걸치는 순간 제약이 됩니다.

버틸 만한 우회로가 둘 있습니다.

파라미터를 주소 자체에 적어 넣기. UTM 태그는 평범한 질의 파라미터이므로, 주소 쪽에 덧붙이면 행마다 달라질 수 있습니다.

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

스프레드시트에서 그런 열을 만드는 일은 문자열 연결 수식 하나로 끝납니다.

여러 묶음으로 나누기. 캠페인마다 묶음 하나씩, 각자의 태그와 각자의 그룹을 갖게 하면, 나중에 긴 목록을 헤집는 대신 그룹 단위로 숫자를 읽을 수 있습니다. 캠페인 수가 적다면 이 길이 보통 더 깔끔합니다.

한 번에 몇 개가 들어가는가

상한은 세 가지이고, 성질이 서로 다릅니다.

파일이 천 행을 넘으면 쪼개십시오. 상한을 넘은 행은 애초에 업로드에 들어가지 않습니다. 동시 세 건이라는 수는 끝나지 않은 작업에 대한 상한이며 하루 할당량이 아닙니다. 하나가 끝나면 다음을 시작할 수 있습니다.

월 단위 분량은 별개의 문제이고 요금제에 달려 있습니다. 무료 요금제에는 대량 단축 기능 자체가 없습니다. Pro는 월 100개까지 — 실제 목록으로 시험해 보고 그 분량이 정말 필요한지 가늠하기에는 충분합니다. Premium에는 월 상한이 없지만, 하루 30,000개라는 천장이 작동합니다.

일부 행이 만들어지지 않는 이유

나쁜 행 하나가 묶음 전체를 취소하지는 않습니다. 업로드는 끝까지 달리고, 각 행은 자기 결말을 지닙니다. 상태는 셋이고, 구별할 수 있으면 쓸모가 있습니다. 고치는 방법이 다르기 때문입니다.

검사에서 반려. 행이 검사를 통과하지 못한 상태로, 파일을 읽어 들인 직후 아직 아무것도 단축하지 않은 단계에서 보입니다. 대개 주소 모양이 깨졌거나, 별칭이 너무 길거나, 주소가 있어야 할 자리에 다른 것이 들어 있는 경우입니다.

생성되지 않음. 행 자체는 올바른데 링크가 생기지 않은 경우입니다. 예를 들어 요청한 별칭이 이미 쓰이고 있었을 때.

생성됨. 끝났고, 그 행 맞은편에 짧은 링크가 놓입니다.

흔한 원인과 대처:

들여 두면 이득인 습관: 먼저 파일 앞쪽 열 행만 흘려보내 보십시오. 내보내기 쪽의 구조적 결함 — 스킴이 다르거나, 구분자가 다르거나, 열이 하나 남거나 — 은 열 행에서도 천 행에서와 똑같이 드러나지만, 풀어내는 데 드는 시간은 비교가 되지 않습니다.

목록을 프로그램이 만드는 경우

스프레드시트를 붙잡은 사람이 아니라 당신의 코드가 링크를 준비한다면, API에 묶음 메서드가 있습니다. 요청 하나에 최대 100개, 응답은 항목별로 오며, 생성됨·생성되지 않음·반려라는 같은 구분을 담습니다.

여기 눈에 잘 띄지 않으면서 쉽게 부딪히는 사항이 있습니다. 묶음 요청은 요청 한도를 링크 개수만큼 씁니다. 요청 한 건으로 세지 않습니다. 100개 묶음은 100단위를 깎습니다. 그렇지 않으면 묶음 메서드가 빈도 제한을 우회하는 수단이 되어, 한 고객이 분당 수천 개의 링크를 만들 수 있게 됩니다. 남은 한도가 묶음 전체를 감당하지 못하면 요청은 통째로 반려되고 아무것도 생성되지 않습니다. 그러니 잔량은 보내기 전에 확인하는 것입니다.

공통 파라미터의 동작은 폼과 같습니다. defaults 블록이 각 행에 흘러들고, 행 자신의 필드가 그것을 덮어씁니다. 행의 빈 값은 "지정하지 않음"을 뜻하므로 defaults 의 값이 쓰입니다 — 내보내기의 빈 칸과 똑같은 취급입니다. 엔드포인트와 응답 구조는 API 문서에 적혀 있습니다.

완성된 목록으로 무엇을 할까

묶음으로 만든 짧은 링크는 하나씩 만든 것과 전혀 다르지 않습니다. 각자 클릭 통계와 지역, 유입원을 갖습니다. 묶음에 공통 그룹을 붙여 두었다면 그 그룹 단위로 숫자를 읽는 것이 편합니다. 카탈로그 전체, 발송 전체가 한 덩어리로 어떻게 움직였는지가 보이기 때문입니다.

큰 목록에서 특히 본전을 뽑는 두 가지:

• 자기 도메인. 천 개 묶음이라면 도메인 이름이 읽는 사람과 천 번 마주칩니다. 발송이 어떻게 보이는지에서 무시할 수 없는 몫입니다. 연결하는 방법과 무엇이 달라지는지는 맞춤 도메인 글에 있습니다;
• 표시는 업로드 전에, 나중이 아니라. 이미 만들어 둔 천 개의 UTM 파라미터를 나중에 바꾸는 쪽이, 스프레드시트에서 미리 표시가 붙은 열을 만드는 쪽보다 비쌉니다. 성과를 어떻게 재는지는 광고 효과 측정 방법에서 따로 다룹니다.

짧게

파일은 한 열이나 두 열로 짜고, 주소에는 https:// 스킴을 붙이고, 쉼표가 든 값은 인용부호로 감쌉니다. 공통 파라미터는 묶음에 주고, 달라져야 하는 것은 주소 자체에 적거나 여러 번의 업로드로 나눕니다. 열 행으로 먼저 시험하고, 그다음 나머지를 올려 행별 보고를 읽습니다.

기능 자체와 단계별 순서는 대량 링크 단축 페이지에 있습니다. 대량 업로드는 유료 요금제의 기능이므로, 첫 묶음에는 Pro 이상의 계정이 필요합니다.