Form Attribution 是零依赖的轻量脚本,用于自动捕获营销归因数据并以隐藏字段注入网页表单,便于在表单提交时一并传回来源信息。
用途:记录访客的来源渠道与首次触达信息,用于表单线索归因。
主要能力:自动捕获的 URL 参数默认包括 utm_source、utm_medium、utm_campaign、utm_term、utm_content、utm_id、ref;自动记录 landing_page、current_page、referrer_url、first_touch_timestamp;开启点击 ID 后捕获 gclid、fbclid、msclkid、ttclid、li_fat_id、twclid。数据存入 sessionStorage 并自动注入所有表单隐藏字段。
使用方式:在 </body> 前加入脚本 <script src="https://cdn.jsdelivr.net/npm/form-attribution@latest/dist/script.min.js" defer></script>。可通过 script 标签的 data 属性配置:data-storage(sessionStorage/localStorage/cookie)、data-field-prefix、data-extra-params、data-exclude-forms、data-click-ids、data-debug、data-privacy、data-storage-key;cookie 模式下还有 data-cookie-domain、data-cookie-path、data-cookie-expires、data-cookie-samesite。提供 JS API:getData、getParam、getForms、clear、refresh。
适用场景:需要在 Webflow、HubSpot、WordPress、Marketo 等平台的表单中附带渠道归因信息;跨子域跟踪可用 cookie 模式并设置域名与有效期。
限制:默认遵守 GPC/DNT,检测到时不会捕获数据,可用 data-privacy="false" 覆盖。平台专属模式见 references/platforms.md,常见问题见 references/faq.md。其他细节暂未提供。