Question 1

첫 QR 코드를 만들고 게시하기

Accepted Answer

콘텐츠 종류를 고르고, 특별한 이유가 없다면 동적 모드를 선택하고, 코드를 꾸미고, 게시한 다음, 어디로 내보내기 전에 내보낸 파일 자체를 실제 휴대폰으로 스캔해 보세요.

Question 2

정적이냐 동적이냐, 무엇을 고를까

Accepted Answer

정적 코드는 내용을 매트릭스 자체에 담기에 영원히 작동하지만 결코 바꾸거나 측정할 수 없습니다. 동적 코드는 Mosaqo가 관리하는 주소를 담기에 대상은 계속 수정할 수 있고 모든 스캔이 집계됩니다.

Question 3

믿고 쓰기 전에 QR 코드를 시험하기

Accepted Answer

미리보기가 아니라 내보낸 파일을, 최소한 두 기종에서, 코드가 실제로 놓일 조명 아래에서 시험하고, 대상의 리디렉션 사슬을 끝까지 따라가 보세요.

Question 4

URL 코드와 앱 링크

Accepted Answer

URL 코드는 웹 주소를 담습니다. 앱 링크는 모바일 운영체제가 설치된 앱의 것으로 인식하는 URL을 담으며, 앱이 없으면 웹으로 되돌아갑니다.

Question 5

Wi-Fi QR 코드

Accepted Answer

Wi-Fi 코드는 네트워크 이름, 보안 방식, 비밀번호를 담고, 스캔하는 순간 휴대폰이 접속을 제안합니다. 정보가 매트릭스 안에 있으므로, 코드를 사진 찍은 사람은 그 비밀번호를 가진 셈입니다.

Question 6

PDF, vCard, 텍스트 코드

Accepted Answer

PDF 코드는 호스팅된 문서를 가리키고, vCard는 휴대폰이 곧바로 저장하는 연락처를 담으며, 텍스트 코드는 열 것이 없는 짧은 문구를 보여 줍니다. 네트워크가 필요한 것은 PDF뿐입니다.

Question 7

이미 인쇄된 코드가 향하는 곳 바꾸기

Accepted Answer

워크스페이스에서 동적 코드를 열고, 대상을 바꾸고, 변경을 게시하세요. 인쇄된 매트릭스는 손대지 않습니다. 그것은 Mosaqo가 관리하는 주소를 가리키고, 바뀐 것은 그 주소가 내주는 내용뿐입니다.

Question 8

Mosaqo의 리디렉션이 작동하는 방식

Accepted Answer

매트릭스는 짧은 Mosaqo 주소를 담습니다. 스캔이 그 주소를 열면 Mosaqo가 스캔을 기록하고 현재 대상으로의 리디렉션을 응답하며, 휴대폰이 그것을 따라갑니다. 바꿀 수 있는 모든 것은 Mosaqo 쪽에 있습니다.

Question 9

코드의 게시, 보관, 복원

Accepted Answer

게시하면 동적 코드가 대상을 내주기 시작합니다. 보관하면 그것이 멈추지만, 이미 인쇄된 것이 무효가 되지는 않습니다. 복원한 뒤 다시 게시하면 같은 인쇄 매트릭스가 그대로 되살아납니다.

Question 10

코드를 망가뜨리지 않고 로고 넣기

Accepted Answer

QR 코드에는 오류 정정이 들어 있고, 로고는 그것을 소모합니다. 로고는 가운데에 두고, 매트릭스에 비해 작게 유지하고, 바꿀 때마다 다시 시험하세요. 스캔되지 않게 되는 지점은 갑자기 옵니다.

Question 11

대비와 여백 구역

Accepted Answer

모듈은 밝은 배경 위에서 어두워야 하고, 대비는 실제로 충분해야 하며, 코드에는 사방으로 빈 여백이 필요합니다. 반전된 코드와 잠식된 여백은 읽히지 않는 코드의 가장 흔한 두 원인입니다.

Question 12

프레임, 행동 유도 문구, 스티커

Accepted Answer

벽에 붙은 맨 코드는, 아래에 세 단어가 붙은 같은 코드보다 적게 스캔됩니다. 프레임과 스티커가 그 힌트를 줍니다. 여백 구역 밖에 있기만 하다면요.

Question 13

PNG, SVG, PDF — 무엇으로 내보낼까

Accepted Answer

인쇄로 갈 것에는 SVG나 PDF를 쓰세요. 벡터라서 어떤 크기에서도 선명합니다. 화면에는 PNG를 쓰세요. 포스터용으로 확대한 PNG는 흐릿해 읽히지 않는 코드의 가장 흔한 원인입니다.

Question 14

코드를 얼마나 크게 만들어야 하나

Accepted Answer

독자가 멀리 설수록 코드는 커야 합니다. 쓸모 있는 기준은 스캔 거리의 10분의 1입니다. 1미터에서 읽는다면 10센티미터쯤이 되고, 옥외 광고판에서는 디자이너의 짐작보다 훨씬 커집니다.

Question 15

광택, 곡면, 천, 호일

Accepted Answer

반사하고 휘고 늘어나는 것은 모두 스캔 시도를 잡아먹습니다. 광택은 눈부심을 만들고, 휜 포장은 격자를 일그러뜨리며, 천과 호일은 모듈을 밀어냅니다. 처방은 더 큰 크기, 더 강한 대비, 그리고 실물 시험입니다. 더 큰 로고는 결코 아닙니다.

Question 16

전체 스캔과 고유 스캔

Accepted Answer

전체는 스캔이라는 사건을 모두 셉니다. 고유는 집계 구간 안에서 한 기기를 한 번만 셉니다. 세 번 스캔한 사람은 앞 숫자에 셋을, 뒤 숫자에 하나를 더하므로 두 값은 결코 같아지지 않습니다.

Question 17

정적 코드에 분석이 없는 이유

Accepted Answer

정적 코드는 내용을 매트릭스에 담고 Mosaqo에 접속하지 않으므로, 관측되는 스캔이 애초에 없습니다. 분석에는 동적 코드가 필요합니다. 스캔이 일어나는 것을 볼 수 있는 것은 관리되는 리디렉션뿐이기 때문입니다.

Question 18

CSV 내보내기와 캠페인 파라미터

Accepted Answer

대시보드가 아니라 원시 행이 필요할 때는 계열을 CSV로 내보내거나 API로 읽으세요. 대상에 붙인 캠페인 파라미터가 있으면 자체 분석 도구도 그 방문을 귀속할 수 있습니다.

Question 19

첫 피드백 캠페인 실행하기

Accepted Answer

캠페인이 목표와 양식을 담고, 배치는 자체 QR을 가진 인쇄물 한 자리이며, 게시는 이 셋을 한 번의 작업으로 함께 공개합니다. 설정은 일곱 단계를 차례로 지나가며, 실제 휴대폰이 테스트 창 안에서 코드를 스캔하기 전에는 게시하지 않습니다.

Question 20

누군가 낮은 점수를 줬을 때 벌어지는 일

Accepted Answer

모든 응답은 점수와 상관없이 받은 편지함에 들어옵니다. 기준값 이하의 점수는 추가로 소유자와 관리자에게 즉시 메일을 보내고 웹훅을 발생시킬 수도 있습니다. 다만 어느 쪽도 연락처나 고객이 쓴 문장은 담지 않습니다.

Question 21

응답을 리뷰 페이지에 게시하기

Accepted Answer

지점마다 공개 리뷰 페이지를 하나 가질 수 있습니다. 거기에 오르려면 두 가지가 필요합니다. 방문자가 양식에서 게시 동의에 표시했고, 그 뒤 여러분이 받은 편지함에서 그 응답을 승인하는 것입니다.

Question 22

역할과 각 역할이 허용하는 것

Accepted Answer

Mosaqo 워크스페이스에는 다섯 역할이 있습니다. 소유자, 관리자, 편집자, 분석가, 뷰어로, 전권부터 읽기 전용까지입니다. 일이 되는 선에서 가장 좁은 역할을 주고, 소유자는 그 워크스페이스를 책임지는 사람을 위해 남겨 두세요.

Question 23

워크스페이스에 사람 초대하기

Accepted Answer

이메일 주소로 초대하고 그 자리에서 역할도 고릅니다. 초대는 그 주소의 것이므로, 그 주소를 가진 계정에서 수락해야 합니다.

Question 24

여러 워크스페이스를 오가며 일하기

Accepted Answer

워크스페이스는 코드, 템플릿, 에셋, 구성원, API 키의 경계입니다. 나눠 둔 워크스페이스는 나눠야 할 일을 나눈 채로 지킵니다. 키를 포함해 아무것도 경계를 넘지 않습니다.

Question 25

개인 템플릿과 공유 템플릿

Accepted Answer

템플릿은 완성된 모습, 곧 색과 로고와 프레임과 모듈 양식을 저장합니다. 그래서 다음 코드는 백지가 아니라 승인된 지점에서 시작합니다. 워크스페이스 템플릿은 팀과 공유되고, 개인 템플릿은 그렇지 않습니다.

Question 26

브랜드 키트

Accepted Answer

브랜드 키트는 워크스페이스가 써도 되는 색과 로고를 담습니다. 그래서 브랜드 가이드를 본 적 없는 사람이 만든 코드도 브랜드에 맞게 나옵니다.

Question 27

로고, 이미지, 스티커 관리하기

Accepted Answer

에셋이란 워크스페이스가 되풀이해 쓰는 로고, 이미지, 스티커입니다. 각자의 노트북이 아니라 공유 라이브러리에 두는 것, 그것이 템플릿을 재현 가능하게 만듭니다.

Question 28

대량 생성을 위한 CSV 준비하기

Accepted Answer

UTF-8로 내보내고, 코드 하나에 한 행씩, 헤더 행은 기대되는 그대로 두고, 수천 건을 올리기 전에 몇 행으로 확인하세요. 대량 작업 실패의 대부분은 Mosaqo가 아니라 인코딩이나 열의 문제입니다.

Question 29

미리보기와 검증 오류 읽기

Accepted Answer

검증은 어느 행에서 무엇이 잘못됐는지 알려 줍니다. 내보낸 파일이 아니라 원본 스프레드시트를 고치세요. 그래야 수정이 다음 내보내기까지 살아남습니다.

Question 30

모든 것을 두 번 만들지 않고 대량 작업 다시 돌리기

Accepted Answer

부분 실패 뒤에 파일 전체를 다시 돌리는 것, 그것이 워크스페이스에 수천 건의 중복이 쌓이는 경로입니다. 실패한 행만 다시 보내고, API로 할 때는 멱등 키를 써서 재시도가 모든 것을 두 번 만들지 않게 하세요.

Question 31

API 키를 만들고 스코프 고르기

Accepted Answer

키는 그것이 일할 워크스페이스에서 만들고, 연동에 필요한 스코프만 주고, 비밀로 보관하세요. 키는 한 번만 표시됩니다. 잃어버렸다면 폐기하고 새로 발급하세요.

Question 32

401, 403, 422, 429 가려내기

Accepted Answer

401은 키가 아예 받아들여지지 않았다는 뜻입니다. 403은 키는 통했지만 그 동작이 허용되지 않는다는 뜻입니다. 422는 요청은 이해되었고 본문이 잘못됐다는 뜻입니다. 429는 속도 한도를 넘었으니 곧바로 다시 시도하지 말고 기다리라는 뜻입니다.

Question 33

결과를 넘겨 가며 한도 안에 머무르기

Accepted Answer

목록 엔드포인트는 오프셋이 아니라 커서로 페이지를 나눕니다. 직접 계산하지 말고 응답이 주는 커서를 따라가세요. 속도 한도 헤더를 지켜보고, 전부 다시 읽는 대신 `updatedSince`로 폴링하세요.

Question 34

웹훅 서명 검증하기

Accepted Answer

서명은 JSON을 파싱하기 전, 원시 요청 본문에 대해 계산하고 상수 시간으로 비교하세요. 본문을 다시 직렬화하면 바이트가 달라지고, 서명은 다시는 맞지 않습니다.

Question 35

Make, Zapier, n8n 연결하기

Accepted Answer

Mosaqo는 자동화 플랫폼과 마켓플레이스에 올라온 커넥터가 아니라, 자체 HTTP API와 웹훅으로 연동됩니다. 그 도구들에는 모두 범용 HTTP 모듈이 있고, 그것을 쓰면 됩니다.

Question 36

Airtable, Notion, Sheets를 위한 서명된 이미지 링크

Accepted Answer

URL만 받는 도구에서 코드 이미지를 보이려면, 파일을 손으로 올리는 대신 그 도구가 직접 가져올 수 있는 링크를 주세요. 그 링크는 공유 가능한 것으로 여겨야 합니다. 가진 사람은 이미지를 봅니다.

Question 37

웹, 모바일, 확장 — 언제 무엇을

Accepted Answer

디자인은 웹 앱에서 하세요. 편집기와 대량 도구가 거기 있습니다. 스캔 확인과 현장 공유에는 모바일 앱을 쓰세요. 지금 열어 둔 페이지에서 빠르게 코드를 만들 때는 Chrome 확장을 쓰세요. 셋은 하나의 계정을 함께 씁니다.

Question 38

카메라 권한과 스캔 시험

Accepted Answer

스캔에는 운영체제의 카메라 권한이 필요합니다. 카메라 화면이 검은 채로 있거나 아예 열리지 않는다면, 언젠가 권한이 거부된 것이며 앱이 아니라 시스템 설정에서 다시 줘야 합니다.

Question 39

Chrome 확장이 저장하는 것

Accepted Answer

확장은 지금 열려 있는 페이지에서 코드를 만듭니다. 워크스페이스에 저장하지 않은 작업은 브라우저의 로컬 저장소에 남습니다. 곧 그 프로필에 묶여 있고, 그와 함께 사라집니다.

Question 40

나만 겪는 문제인지 확인하기

Accepted Answer

모두에게 한꺼번에 멈춘 코드와, 한 대의 휴대폰에서 실패하는 코드는 서로 다른 문의를 요구합니다. 5분의 점검이 어느 쪽을 쓸지 정하고, 그것이 얼마나 빨리 처리될지를 정합니다.

Question 41

지원 요청에 무엇을 담아야 하나

Accepted Answer

플랫폼과 버전, 밟은 절차, 기대한 결과, 실제 결과, 그리고 무엇이 잘못됐는지 가리키는 식별자입니다. 완결된 한 통이 짧은 다섯 통보다 빨리 답을 받습니다. 오가는 횟수마다 하루 업무일이 사라지기 때문입니다.

Question 42

요청의 우선순위가 정해지는 방식, 그리고 절대 보내면 안 되는 것

Accepted Answer

우선순위는 낱말 선택이 아니라 영향과 긴급도를 따릅니다. 그리고 어떤 요청에도 비밀번호, 액세스 토큰, API 시크릿, `Authorization` 헤더, 비공개 QR 내용이 담겨서는 안 됩니다. 본문에도, 스크린숏에도, 첨부한 로그에도 안 됩니다.

무엇을 도와드릴까요

영역별로 보기

시작하기

QR 코드의 종류

동적 코드와 리디렉션

디자인과 스캔 가능성

인쇄와 내보내기

스캔 분석

피드백과 리뷰

워크스페이스와 팀

템플릿, 브랜드 키트, 에셋

대량 생성과 CSV

공개 API

웹훅과 연동

모바일 앱과 Chrome 확장

지원팀에 연락하기

아직 막혀 있나요