開發者工具 · URL 編碼器和解碼器
為什麼 UTM 值中未編碼的 & 和 = 會悄悄損壞您的行銷活動報告
· 為什麼它很重要
url 編碼 utm 跟踪 分析
包含 & 或 = 的行銷活動名稱在連結中看起來不錯，但每個分析工具都會將其分為兩個參數。這篇文章展示了發生的情況、如何安全地編碼值以及如何在發布之前檢查連結。
當 UTM 參數在未編碼的 & 字元處拆分時
包含 & 或 = 的行銷活動名稱在連結中輸入時看起來不錯，但每個分析系統都會在 & 符號處將其拆分，並將其餘部分視為新參數。春季和夏季成為报告中两個独立的营銷活動值。值內的等號會產生類似的中斷：utm_campaign=2024=best 默默地破壞鍵值對。這些字元在查詢語法中保留用於結構，而不是內容，因此每個解析 URL 的工具都會將它們讀取為分隔符號。
URL 解析器無法知道您將它們視為資料。將它們編碼為 %26 和 %3D 會將它們保留為值內的文字字元。如果不進行編碼，您的分析儀表板會收到不完整或損壞的活動名稱，並將流量分散到非預期的部分。如果名稱包含多個特殊字符，則單一共享連結可能會產生六個虛擬行銷活動。
如何解析查询字符串 — & 分隔對，= 分隔鍵和值，除非您提供，否則不會轉义
查詢字串的解析方式揭示了為什麼「&」和「等於」在值中是危險的。 & 符號分隔獨立的鍵=值對： ?utm_source=email&utm_campaign=sale 表示兩個單獨的參數。在值內，未轉義的 & 符號結束目前對並開始新的對。等號將鍵與值分開：如果 utm_campaign=Q3&2024，解析器會看到 utm_campaign=Q3，然後看到沒有值的孤立「2024」參數。
這種解析發生在多個層：瀏覽器讀取 URL，伺服器接收請求，然後您的分析平台再次解碼查詢字串。每層都應用相同的规則，並就参數的開始和結束位置得出相同的結论。您無法警告下游消費者您的＆符号是特殊的； URL 結構是确定性且明确的。
哪些字符需要在 UTM 值中进行編碼 - &、=、#、?、空格和非 ASCII，以及為什么 # 是最隐蔽的
UTM 值中需要編碼的字元包括與號、等於、雜湊、問號、空格和任何非 ASCII 字母或符號。哈希字符是最狡猾的：#anything 被視為片段標識符，瀏覽器根本不會將其發送到伺服器。以哈希結尾的活動名稱會在請求離開您的瀏覽器之前丟失其後的所有內容。由於相同的結構原因，空格必須變為 %20：在未編碼的 URL 中無效。
非 ASCII（如重音 e 或中文字元）編碼為 UTF-8 位元組，然後進行百分比轉義：重音 e 變成 %C3%A9。仔细構建連結或使用為您編碼的表單。允許您貼上行銷活動名稱並產生完整連結的工具通常會自動處理此步驟，但電子表格公式或手動串聯則需要您負責。
工作範例：將「Q3 Sale & Launch」編碼為 utm_campaign — 之前和之後，以及報告如何讀取每個版本
工作範例：將「Q3 Sale & Launch」編碼為 utm_campaign 清楚地顯示了問題。如果不進行編碼，URL 以「&」符號結尾：?utm_campaign=Q3 Sale &。其餘部分消失或成為格式錯誤的新參數。正確編碼後，%26 會替換 & 符號：?utm_campaign=Q3%20Sale%20%26%20Launch。空格也被編碼為 %20。現在，整個字串完整地到達您的分析平台，並作為單一活動進行報告。
將未編碼版本和編碼版本貼到單獨的 URL 解碼器中，並觀察它們有何不同。編碼形式解碼回原始文字，並保留所有特殊字元。在與團隊成員分享或在電子郵件活動或社交媒體平台中發布之前，使用 URL 編碼器驗證任何 UTM 連結。
電子表格公式和連結產生器 - 常見工作流程中編碼發生或失敗的情況，一般描述
電子表格公式和自訂連結產生器經常失敗，因為它們連接字串而不進行編碼。連接公式建立 URL 可能會產生看起來完全有效的文字，但在作為連結打開時會中斷。編碼必須發生在公式內部，而不是之後。許多連結縮短服務和電子郵件追蹤平台會自動為您編碼，因此測試產生的連結而不是假設手動建立是安全的。
Google Analytics、HubSpot 和類似平台中的拖放活動建構器在內部處理編碼。如果您在電子表格中手動建立連結或將其貼到 Slack 中，請假設它們不會自動編碼。在分發連結之前，透過解碼器執行最終 URL，以驗證所有特殊字元均表示為 %XX。
常見錯誤 — 對整個 URL 進行編碼，並混合 + 和 %20，使一個活動變成兩個
常見錯誤包括對整個 URL 進行編碼，這透過在 https://. 中編碼冒號和斜杠來破壞其結構。另一個錯誤將加號和 %20 混合用於空格：某些系統使用加號（傳統形式編碼），而現代標準使用 %20。如果一個廣告系列值使用加號，而另一個值使用 %20，則即使代表相同的文字，它們也會顯示為不同的廣告系列。保持一致並對 URL 元件使用 %20。
當連結產生器編碼一次並再次編碼時，也會發生雙重編碼，產生 %2526 而不是 %26。解碼一次後，您將得到 %26 而不是 & 符號。字元變成文字百分二六字串而不是＆符號。檢查建置過程中的中間步驟，以確保每個值僅發生一次編碼。
這不包括什麼 - 分析平台配置和歸因模型
分析配置和歸因建模完全取決於獲得一致且準確的行銷活動資料。如果您的 UTM 值出現亂碼或分裂，則報告無法正確匹配行銷活動，且多點觸控歸因模型無法準確分配功勞。單一編碼錯誤會在每個使用參數的報告中傳播，從而顯著扭曲每月或行銷活動之間的比較。
在完全啟動之前測試您的活動連結。將它們貼到 URL 解碼器中，並確認活動名稱中的每個特殊字元都已正確編碼。 URL 編碼器並排顯示編碼和解碼形式，因此您可以驗證編碼是否發生以及解碼是否準確恢復原始文字。
重點：對每個值進行一次編碼 — URL 編碼器和解碼器如何從任何行銷活動名稱產生安全的查詢值
重點很簡單：使用正確的百分比編碼規則對每個值進行一次編碼。在 URL 最終確定和發布之前，UTM 參數內的「&」或等號必須變成 %26 或 %3D。單值模式下的 URL 編碼器會自動可靠地為您執行此編碼。貼上您的活動名稱，選擇值模式，將編碼結果複製到連結範本中。
每個處理 URL 的分析工具都套用相同的解析規則。沒有辦法繞過它，也沒有任何工具可以猜測您的意圖或意圖。編碼步驟不是可選的；這是在查詢字串值中保留特殊字元的唯一方法。在與利害關係人分享或在行銷活動中發布之前，請先驗證您的連結是否如預期運作。