長網址直接看很難審閱

行銷活動網址或 API 的 GET 請求中,常會排著 ?utm_source=...&utm_medium=...&id=... 這麼多參數。網址短時還能用肉眼看,但值一多,就容易漏掉重複的鍵、拼字錯誤、不需要的追蹤值。

如何將 URL 參數轉成 JSON:減少 UTM 與 API 查詢的疏漏

使用 DevToolKits 的 URL 參數 JSON 轉換工具,只要貼上網址或查詢字串,就能以 JSON 格式確認鍵與值。

UTM 檢查的重點

廣告或社群貼文用的網址中,utm_source、utm_medium、utm_campaign 的值會直接影響成效數據。若有大小寫或寫法不一致,分析工具可能會將其計為不同的活動。

發布前,建議對照 JSON 化後的參數,確認是否符合既定的命名規則。

也能用於 API 除錯

API 的 GET 請求中,搜尋條件、頁碼、排序條件等會放在查詢參數。整理成 JSON 後,較容易貼到規格書或 Issue,團隊也更容易重現相同條件。

例如審閱下面這樣的網址時:

https://example.com/search?q=jwt&page=2&sort=updated&tag=security&tag=api

JSON 化後,較容易確認 page 是否以字串傳遞、tag 是否被指定多次、是否混入空值。也能及早發現 API 端期待 tag=security,api、但前端卻送出 tag=security&tag=api 的落差。

若值經過 URL 編碼,可用 URL 編碼/解碼工具 確認字串的意義。

寫進 Issue 時的方式

回報問題時,比起只貼上完整網址,把拆解後的 JSON 與期望值一起留下,能讓重現更快。

{
  "q": "jwt",
  "page": "2",
  "sort": "updated",
  "tag": ["security", "api"]
}

這種形式下,可以分別確認「搜尋字詞」「分頁」「排序」「篩選條件」。減少閱讀長網址的負擔,審閱者也能只專注於差異。

編碼與陣列寫法的陷阱

審閱 URL 參數時,編碼與陣列的寫法是容易忽略的地方。

  • + 與 %20 的差別:在查詢字串中,空白可能被編碼成 +(依 application/x-www-form-urlencoded 規範),路徑部分則使用 %20。兩者都代表空白,但若解碼方式弄錯,+ 就會原樣保留。
  • 陣列的寫法因服務而異:同樣是「多個值」,有 tag=a&tag=b(重複)、tag=a,b(逗號分隔)、tag[]=a&tag[]=b(中括號)等做法。前端與 API 的前提不一致時,就只有一邊收得到。
  • 漏掉編碼:值中含有 & 或 = 卻沒有編碼時,會在該處被切成另一個參數。

轉成 JSON 確認陣列與鍵的形狀,並用 URL 編碼 / 解碼工具 查看編碼後值的原意,就能及早發現這類不一致。

實際的轉換結果

這是把下面的 URL 輸入到 URL 參數轉 JSON 工具所得到的結果。

https://example.com/?utm_source=news&utm_medium=email&tag=a&tag=b&q=%E6%9D%B1%E4%BA%AC&empty=&flag
{
  "utm_source": "news",
  "utm_medium": "email",
  "tag": ["a", "b"],
  "q": "東京",
  "empty": "",
  "flag": ""
}
  • 值會被解碼:q=%E6%9D%B1%E4%BA%AC 會顯示為 "東京"
  • 同名的鍵會變成陣列:tag=a&tag=b 是 ["a", "b"]
  • 值為空的鍵與沒有 = 的鍵,都會變成空字串:empty= 與 flag 沒有區別
  • 所有的值都是字串:page=2 也不是數字 2,而是 "2"
  • a[]=1&a[]=2 這類方括號寫法不會被展開:鍵名仍是 "a[]",值則是陣列。b[x]=3 也是 "b[x]": "3"。若想當成巢狀物件來讀,請對照接收端框架的解讀方式
  • 可以輸入整個 URL、? 之後的部分,或像 a=1&a=2 這樣只有查詢的部分

結語

URL 參數只要一個小小的輸入錯誤,就會改變成效數據或 API 行為。與其盯著長網址看,光是拆解成 JSON 來確認,就能提升審閱的準確度。

常見問題

含有重複鍵的網址會如何處理?

當同一個鍵出現多次,例如 tag=security&tag=api,JSON 化後會以陣列呈現。這能讓你更容易發現 API 端期待逗號分隔的 tag=security,api、卻收到多個參數的落差。請依規格確認應為哪一種格式。

使用 UTM 參數要注意什麼?

utm_source、utm_medium、utm_campaign 的值會直接成為你的分析結果。大小寫或寫法不一致(如 Twitter 與 twitter)會被計為不同活動。發布前先 JSON 化,確認值符合命名規則較為安全。

值是 %20 這類編碼,看不懂。

URL 參數的值含有保留字元時會被百分號編碼。%20 是空格,%2F 是斜線。用 URL 編碼/解碼工具 解碼,即可確認原始字串的意義。

為什麼空白會變成 +?

在查詢字串中,依 application/x-www-form-urlencoded 規範,空白可能被編碼成 +。路徑部分或符合 RFC 3986 的編碼則使用 %20。兩者都代表空白,但解碼時若沒有考慮這個差異,+ 就會原樣保留,請配合處理該值的系統確認。