캠페인 시트나 상품 카탈로그가 수백 행에 이르면 단축 링크를 하나씩 만드는 방식으로는 감당할 수 없습니다. Posty5의 대량 가져오기는 CSV 파일 하나를 받아 무엇이든 생성하기 전에 모든 행을 검사하고, 백그라운드에서 링크를 만든 뒤, 각 행 옆에 단축 주소를 붙인 결과 파일을 제공합니다.
- Bulk import 열기 — Posty5 대시보드에서 URL Shortener를 열고 Bulk import를 선택합니다.
- 템플릿 채우기 — CSV 템플릿을 내려받아 대상 URL마다 한 행씩 채웁니다. 필수 열은 url뿐입니다.
- 업로드 및 검사 — 파일을 업로드하고 빈 열에 쓸 기본값을 고른 뒤 검사합니다. Posty5는 무엇이든 생성하기 전에 오류가 있는 행을 모두 보여 줍니다.
- 가져오기 실행 — 가져오기를 시작하고 진행 상황을 확인하거나, 페이지를 떠나 알림을 기다립니다.
- 결과 내려받기 — 각 단축 주소가 담긴 결과 파일과, 실패한 행이 있다면 오류 파일을 내려받습니다.
시작하기 전에
로그인된 Posty5 계정이 필요합니다. 대시보드에서 URL Shortener를 열고 Bulk import를 선택하세요. 대량 생성 사용 여부는 요금제에 따라 다르며, 요금제에 포함되어 있지 않으면 페이지에 잠김으로 표시됩니다.
페이지에서 제공하는 CSV 템플릿으로 시작하세요. 올바른 헤더 행과 예시 행 하나가 들어 있으므로 예시만 내 데이터로 바꾸면 됩니다.
CSV 파일 준비하기
필수 열은 url 하나뿐입니다. 열 이름은 대소문자를 구분하지 않으며, Posty5가 알지 못하는 열은 무시되고 검사 단계에서 알려 드립니다.
url | 이동할 대상 주소입니다. 필수이며, 다른 이름으로 baseUrl도 사용할 수 있습니다. |
name | 내 목록에서 쓸 이름입니다. 비워 두면 Posty5가 대상 페이지를 바탕으로 백그라운드에서 채웁니다. |
customId | 요금제에서 사용자 지정 끝부분을 허용하는 경우, 단축 링크의 끝부분을 직접 정합니다. 같은 파일의 앞선 행을 포함해 아직 사용되지 않은 값이어야 합니다. |
tag | 나중에 링크를 묶고 필터링하기 위한 태그입니다. |
refId | 내 시스템의 상품 코드 같은 자체 참조값입니다. |
templateId | 이 행의 QR 코드 템플릿입니다. 업로드 단계에서 고른 기본값보다 우선합니다. |
파일은 쉼표로 구분하고 헤더 행이 있는 UTF-8 CSV로 저장하세요. 쉼표가 포함된 값은 큰따옴표로 감싸야 하며, 스프레드시트 앱은 CSV로 내보낼 때 이를 자동으로 처리합니다.
대량 가져오기 시작하기파일 업로드 및 검사하기
업로드한 뒤 열이 비어 있는 행에 적용할 기본값(템플릿, 태그, 참조 ID)을 고르고 파일을 검사하세요. Posty5는 아무것도 생성하지 않고 모든 행을 읽은 뒤, 오류가 있는 행을 헤더 바로 아래 행부터 센 행 번호와 함께 보여 줍니다. 다음과 같은 경우 행이 실패합니다.
- URL이 없거나, 올바른 웹 주소가 아니거나, 2,048자를 넘는 경우
- 단일 링크를 만들 때와 똑같은 기준으로 URL이 안전하지 않은 주소로 차단된 경우
- 이름, 태그 또는 참조값이 255자를 넘는 경우
- 사용자 지정 끝부분이 요금제에서 허용되지 않거나, 올바르지 않거나, 이미 사용 중인 경우
- 템플릿이 존재하지 않거나 내 것이 아닌 경우
가져오기 실행하기
검사 결과가 괜찮으면 가져오기를 시작하세요. 작업은 백그라운드에서 진행되며, 페이지에 처리된 행, 생성된 행, 실패한 행의 수가 표시됩니다. 페이지를 떠나도 가져오기가 끝나면 알림으로 알려 드립니다.
진행 중인 가져오기는 취소할 수 있습니다. 취소 전에 만들어진 링크는 계정에 그대로 남습니다.
페이지 제목과 앱 딥 링크는 각 링크를 만든 뒤에 가져오므로, 새 링크의 이름이 잠시 동안 호스트 이름으로 표시될 수 있습니다.
- 파일 하나에는 최대 5,000행, 2 MB까지 담을 수 있습니다.
- 대량 생성은 계정당 하루(UTC) 최대 20,000행까지 가능하며, 모든 가져오기와 API 호출을 합산합니다.
- 가져오기는 한 번에 하나씩 실행되며, 그 뒤에 최대 세 개까지 대기할 수 있습니다.
- 가져오기 도중 계정의 크레딧이 떨어지면 해당 행과 그 이후의 모든 행이 실패하며, 이미 만들어진 링크는 그대로 남습니다.
결과 내려받기
가져오기가 끝나면 결과 파일을 내려받으세요. 원본 파일의 행마다 한 줄씩 행 번호, 상태(생성됨, 실패, 건너뜀, 또는 가져오기가 그 행에 도달하기 전에 멈춘 경우 처리되지 않음), 새 링크의 ID와 단축 주소, 그리고 실패한 경우 그 이유가 담겨 있습니다.
두 번째 파일에는 실패한 행만 원래 값 그대로 들어 있으므로, 수정한 뒤 그 파일을 다시 업로드할 수 있습니다.
지난 가져오기는 상태와 건수와 함께 목록으로 표시되므로, 나중에 열어서 파일을 다시 내려받을 수 있습니다. 업로드한 파일과 결과 파일은 7일 동안, 가져오기 기록은 30일 동안 보관되니 그 전에 필요한 파일을 내려받으세요. 링크 자체는 절대 삭제되지 않습니다.
나중에 링크 내보내기
- 단축 링크 목록에서 Export CSV 또는 Export JSON을 선택하면 링크를 방문 수 카운터와 함께 내려받을 수 있습니다.
- 내보내기에는 목록에 적용된 필터가 반영되므로, 캠페인 하나만 내보내려면 먼저 태그로 필터링하세요.
- 내보내기 한 번에 최신순으로 최대 50,000행까지 담기며, 목록이 더 길면 그 지점에서 잘리고 파일에 그 사실이 표시됩니다.
- =, +, - 또는 @로 시작하는 CSV 셀에는 앞에 아포스트로피가 붙어, 스프레드시트 앱에서 수식으로 실행되지 않고 텍스트로 표시됩니다.
코드로 처리하기
개발자는 API 키로 Posty5 API를 통해 같은 작업을 할 수 있습니다. POST /api/short-link/bulk는 요청 한 번에 최대 100행을 만들고 행마다 결과를 하나씩 돌려주며, POST /api/link-bulk-jobs는 파일 전체를 작업으로 제출하고 상태를 폴링할 수 있게 합니다. 둘 다 대시보드와 같은 검사와 한도가 적용됩니다. 각 경로는 API 레퍼런스에 문서화되어 있습니다.
자주 묻는 질문
한 번에 몇 개의 URL을 가져올 수 있나요?
파일 하나에 최대 5,000행, 2 MB까지 담을 수 있고, 대량 생성은 계정당 하루 최대 20,000행까지 가능합니다.
URL이 잘못된 행은 어떻게 되나요?
검사 단계에서 무엇이든 생성되기 전에 행 번호와 이유와 함께 표시됩니다. 가져오기 중에 실패한 행이 있어도 다른 행의 처리는 멈추지 않습니다.
단축 링크의 끝부분을 직접 정할 수 있나요?
네. 요금제에서 사용자 지정 끝부분을 허용한다면 customId 열에서 정할 수 있습니다. 각 끝부분은 같은 파일의 앞선 행을 포함해 아직 사용되지 않은 값이어야 합니다.
결과는 언제까지 내려받을 수 있나요?
업로드한 파일과 결과 파일은 7일 동안 보관됩니다. 링크 자체는 계정에 그대로 남습니다.
단축 링크를 내보낼 수 있나요?
네. 단축 링크 목록에서 각 링크의 방문 수 카운터와 함께 CSV 또는 JSON으로 내보낼 수 있으며, 목록의 필터가 반영되고 파일당 최대 50,000행입니다.
