功能概述
本模塊主要針對埋點開發者使用,在埋點開發時為開發者自動生成「與埋點方案關聯的埋點代碼」,開發者僅需復制粘貼至開發代碼中,進行值賦予即可。
埋點方案和埋點API在開發前已經為固定的內容,開發者做的是將埋點方案中的每一個事件編碼、事件屬性key,賦予相關值后,通過同一埋點API上報。因此,QuickTracking提供了代碼模板模塊,開發者可以直接在產品后臺選擇埋點方案和埋點代碼模板生成埋點代碼,粘貼至工程代碼中改造。減少了重復工作,且避免了事件編碼或者屬性key拼寫錯誤。
代碼模板共分為兩個模塊:代碼模板管理和代碼生成。本文將為您詳細講解使用方法。
操作說明
1.代碼模板
代碼模板的管理和創建進入路徑為:數據采集--埋點開發--開發埋點--代碼模板。
使用代碼模板生成埋點代碼的位置在「數據采集--埋點管理--事件/屬性/方案管理」中。
1)默認模板
該模塊進入后,默認會提供7類基礎模板:
模板名稱 | 技術棧 | 模板描述 |
Android PX系列預置模板 | Android NATIVE | 針對Android PX系列 SDK(版本號以PX結尾的SDK)標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
Android P系列預置模板 | Android NATIVE | 針對Android P系列 SDK(版本號以P結尾的SDK)標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
iOS PX系列預置模板 | iOS NATIVE | 針對iOS PX系列 SDK(版本號以PX結尾的SDK)標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
iOS P系列預置模板 | iOS NATIVE | 針對iOS P系列 SDK(版本號以P結尾的SDK)標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
小程序 1.X版本預置模板 | 小程序 | 針對小程序1.X版本SDK標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
小程序 2.X及以上版本預置模板 | 小程序 | 針對小程序2.X版本SDK標準官方API生成的微信小程序頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
Web/H5 預置模板 | H5 | 針對H5/Web SDK標準官方API生成的頁面瀏覽事件、點擊事件、自定義事件、全局屬性、用戶屬性默認代碼模板 |
上述模板為默認模板,您可以直接使用、查看,但是不能編輯或者刪除。
2)新建模板
若您希望創建自己的代碼模板,可以點擊「新建代碼模板」開始創建。
代碼模板可針對“頁面瀏覽事件”、“控件點擊事件”、“控件曝光事件”、“自定義事件”、“全局屬性”、“用戶屬性”六類創建模板。
在創建模板時,需要填寫基本信息:
模板名稱:為您的模板命名專屬名稱;
技術棧:提供的技術棧有“Android NATIVE”、“iOS NATIVE”、小程序、H5四類,不同的基礎棧在您創建時,提供不同的基礎模板供您修改編輯,
負責人:該負責人將會負責該模板后續的編輯或者刪除。
模板描述:您可以填寫該模板的相關信息,該輸入框為非必填項。
完成基礎信息填寫后,您可以開始進行代碼模板的編寫,QuickTracking平臺使用的模板語言為velocity(基于Java的模板引擎)。選擇模板生效的事件類型后,會直接為您展示基礎模板代碼,您可以在其基礎上編輯。編寫完成后,您可以點擊「模板測試」查看生成的模板代碼是否正確。
2.代碼生成
上述描述的都為代碼模板的管理和創建,最終使用代碼模板生成埋點代碼的位置在「數據采集--埋點管理--事件/屬性/方案管理中。」
您在事件管理、方案管理和屬性管理的全局屬性與用戶屬性中,勾選您需要埋點的事件和屬性。
點擊「埋點代碼」,可以查看當前事件/屬性的埋點代碼,點擊「生成代碼」則可以查看目前勾選的所有事件/屬性的埋點代碼。
在生成代碼前,您可以選擇對應的代碼模板,平臺會根據代碼模板和事件/屬性生成埋點代碼。生成后,您可以在平臺直接查看復制,也可以下載為Excel文件。