Question 1

最初のQRコードを作って公開する

Accepted Answer

内容の種類を選び、理由がなければ動的モードを選び、見た目を整えて公開し、そのうえで書き出したファイルそのものを実機のスマートフォンで読み取ってから、どこかへ出してください。

Question 2

静的か動的か、どちらを選ぶか

Accepted Answer

静的コードは内容をマトリクス自体に持つため、永久に動作し、変更も計測も一切できません。動的コードは Mosaqo が管理するアドレスを持つため、リンク先は編集でき、スキャンはすべて数えられます。

Question 3

本番に出す前にQRコードを試す

Accepted Answer

プレビューではなく書き出したファイルを、少なくとも2機種で、そのコードが実際に置かれる明るさのもとで試し、リンク先のリダイレクト連鎖を終端まで追ってください。

Question 4

URLコードとアプリリンク

Accepted Answer

URLコードはウェブアドレスを運びます。アプリリンクは、モバイルOSがインストール済みアプリのものだと認識する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

モジュールは明るい背景の上で暗く、実際に差のあるコントラストで。そしてコードには四方に空白の余白が要ります。反転したコードと詰まった余白は、読めないコードの最も多い原因2つです。

Question 12

フレーム、行動喚起、ステッカー

Accepted Answer

壁に貼られた裸のコードは、下に3語が添えられた同じコードより読み取られません。フレームやステッカーはその手がかりを与えます。クワイエットゾーンの外にあるかぎりは。

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

総数はスキャンのできごとをすべて数えます。ユニークは集計ウィンドウの中で1台を1回だけ数えます。3回読み取った人は前者に3、後者に1を足すので、2つの数字は決して一致しません。

Question 17

静的コードに分析がない理由

Accepted Answer

静的コードは内容をマトリクスに持ち、Mosaqo に接続しません。したがってスキャンが観測されることもありません。分析には動的コードが必要です。スキャンが起きたことを見られるのは、管理されたリダイレクトだけだからです。

Question 18

CSV書き出しとキャンペーンパラメータ

Accepted Answer

ダッシュボードではなく生の行が必要なときは、系列を CSV に書き出すか API から読みます。リンク先に付けたキャンペーンパラメータがあれば、自社の分析ツールでもその訪問を帰属できます。

Question 19

最初のフィードバックキャンペーンを動かす

Accepted Answer

キャンペーンが目的とフォームを持ち、掲出先は独自のQRを持つ印刷物1か所、公開はその三つを一度の操作で同時に有効にします。セットアップは7ステップを順に進み、実機がテストウィンドウ内でコードを読み取るまで公開しません。

Question 20

低い評価が付いたときに起こること

Accepted Answer

回答は評価にかかわらずすべて受信箱に届きます。しきい値以下の評価はさらに、オーナーと管理者へすぐメールを送り、ウェブフックも発火できます。ただしどちらも連絡先や、お客様が書いた文章は運びません。

Question 21

回答をレビューページに公開する

Accepted Answer

店舗ごとに公開レビューページを1つ持てます。そこへ載るには二つが必要です。訪問者がフォームで公開の同意にチェックを入れていること、そしてあなたが後から受信箱でその回答を承認することです。

Question 22

役割と、それぞれに許されること

Accepted Answer

Mosaqo のワークスペースには5つの役割があります。オーナー、管理者、編集者、アナリスト、閲覧者で、全権から読み取り専用までです。仕事が回る範囲で最も狭い役割を与え、オーナーはそのワークスペースに責任を持つ人のために取っておきます。

Question 23

ワークスペースに人を招待する

Accepted Answer

メールアドレスで招待し、その場で役割も選びます。招待はそのアドレスのものなので、そのアドレスを持つアカウントから承諾する必要があります。

Question 24

複数のワークスペースをまたいで働く

Accepted Answer

ワークスペースは、コード、テンプレート、アセット、メンバー、APIキーの境界です。分けたワークスペースは分けた仕事を分けたままにします。キーを含め、何も境界を越えません。

Question 25

個人テンプレートと共有テンプレート

Accepted Answer

テンプレートは完成した見た目、つまり色、ロゴ、フレーム、モジュールの様式を保存します。次のコードは白紙ではなく、承認された地点から始まります。ワークスペースのテンプレートはチームで共有され、個人のものは共有されません。

Question 26

ブランドキット

Accepted Answer

ブランドキットは、そのワークスペースが使ってよい色とロゴを持ちます。ブランドガイドを見たことのない人が作ったコードでも、ブランドに沿って出てくるようになります。

Question 27

ロゴ、画像、ステッカーを管理する

Accepted Answer

アセットとは、ワークスペースが繰り返し使うロゴ、画像、ステッカーのことです。各自のノートPCではなく共有ライブラリに置くことこそが、テンプレートを再現可能にします。

Question 28

一括生成のためのCSVを整える

Accepted Answer

UTF-8 で書き出し、コード1件につき1行、ヘッダー行は期待どおりのまま残し、数千行をアップロードする前に数行で確かめてください。一括処理の失敗のほとんどは、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

Webhook の署名を検証する

Accepted Answer

署名は、JSON を解析する前の生のリクエストボディに対して計算し、定数時間で比較してください。ペイロードを再直列化するとバイト列が変わり、署名は二度と一致しません。

Question 35

Make、Zapier、n8n をつなぐ

Accepted Answer

Mosaqo は自動化プラットフォームと、マーケットプレイスで公開されたコネクタではなく、自身の HTTP API と Webhook で連携します。どのツールにも汎用の HTTP モジュールがあり、それを使います。

Question 36

Airtable、Notion、Sheets 向けの署名付き画像リンク

Accepted Answer

URL しか受け付けないツールでコード画像を表示するには、手作業でファイルを上げるのではなく、ツール自身が取得できるリンクを渡します。そのリンクは共有可能なものとして扱ってください。持っている人は画像を見られます。

Question 37

ウェブ、モバイル、拡張 — いつどれを

Accepted Answer

デザインはウェブアプリで行います。エディタと一括処理の道具はそこにあります。読み取りの検証と現場での共有にはモバイルアプリを。いま開いているページから素早くコードを作るには Chrome 拡張を。3つは1つのアカウントを共有します。

Question 38

カメラの権限と読み取りテスト

Accepted Answer

読み取りには OS のカメラ権限が必要です。カメラの映像が黒いままか、そもそも開かないなら、どこかで権限が拒否されており、アプリ内ではなくシステム設定で与え直す必要があります。

Question 39

Chrome 拡張が保存するもの

Accepted Answer

拡張は、いま開いているページからコードを生成します。ワークスペースに保存していない作業はブラウザのローカルストレージに留まります。つまりそのプロフィールに結び付いており、それとともに消えます。

Question 40

自分だけの問題かどうかを確かめる

Accepted Answer

全員に対して一斉に止まったコードと、1台の端末で失敗するコードとでは、書くべき連絡が違います。5分の確認がどちらを書くかを決め、それが対応の速さを決めます。

Question 41

サポートへの連絡に入れるべきもの

Accepted Answer

プラットフォームとバージョン、実行した手順、期待した結果、実際の結果、そして何が誤ったかの識別子です。完結した1通のほうが短い5通より早く回答が返ります。やり取りが1往復増えるごとに、1営業日が失われるからです。

Question 42

優先順位の決まり方と、決して送ってはいけないもの

Accepted Answer

優先順位は言葉の選び方ではなく、影響と緊急度で決まります。そしてどの連絡にも、パスワード、アクセストークン、APIシークレット、`Authorization` ヘッダー、非公開の QR 内容を含めてはいけません。本文でも、スクリーンショットでも、添付ログでも同じです。

どうされましたか

分野から探す

はじめに

QRコードの種類

動的コードとリダイレクト

デザインと読み取りやすさ

印刷と書き出し

スキャン分析

フィードバックとレビュー

ワークスペースとチーム

テンプレート、ブランドキット、アセット

一括生成とCSV

公開API

Webhook と連携

モバイルアプリと Chrome 拡張

サポートへの連絡

まだ解決しませんか