編輯導(dǎo)語：產(chǎn)品經(jīng)理的許多工作都需要使用數(shù)據(jù)來進(jìn)行輔助，如：利用用戶使用數(shù)據(jù)為后續(xù)的產(chǎn)品迭代提供依據(jù)、如何向上級領(lǐng)導(dǎo)匯報(bào)產(chǎn)品成果、如何做精細(xì)化的運(yùn)營活動(dòng)等，這些都需要通過埋點(diǎn)文檔獲取的數(shù)據(jù)來實(shí)現(xiàn)。那么，一份專業(yè)性的埋點(diǎn)文檔應(yīng)該如何制作呢？

埋點(diǎn)文檔的撰寫，各家規(guī)范要求各不相同，但是我們理解它的核心后其實(shí)都能快速上手。

撰寫埋點(diǎn)文檔這不是一個(gè)人就能完成的工作，撰寫的時(shí)候，我們需要去請教數(shù)據(jù)分析師和前端后端研發(fā)，大家一起來確立明確的指標(biāo)，并且讓這份文檔有可讀性而不是自嗨性。

搜索埋點(diǎn)文檔，我們都可以搜索出一大堆相關(guān)的文檔方案。這些方案確實(shí)是有用的，但是卻忽略了大部分產(chǎn)品本身沒有技術(shù)背景，很難去看懂或是理解這些文檔。

同時(shí)大部分公司也不需要那么復(fù)雜的埋點(diǎn)文檔用于管理埋點(diǎn)，因此對于埋點(diǎn)文檔我們理性看待，不要為了裝逼而裝逼。

一、日常的埋點(diǎn)需求

工作中，埋點(diǎn)數(shù)據(jù)需求量最大的無疑是產(chǎn)品的營銷運(yùn)營。這類營銷運(yùn)營會(huì)分為常態(tài)化專題運(yùn)營和熱點(diǎn)營銷活動(dòng)兩類。

常態(tài)化運(yùn)營特點(diǎn)是短平快，要周期性的更新活動(dòng)主題和內(nèi)容，核心目的是穩(wěn)固影響力。熱點(diǎn)營銷活動(dòng)主打的是以近期熱點(diǎn)作為主題，進(jìn)行以業(yè)務(wù)目標(biāo)為導(dǎo)向的活動(dòng)。

在這種日?；顒?dòng)中就不適合使用那種完整的埋點(diǎn)文檔，我們只需要在需求文檔中簡單的寫明你需要的數(shù)據(jù)，交付給研發(fā)的時(shí)候在特別說明下即可。

例如：本次埋點(diǎn)需求

1. 統(tǒng)計(jì)頁面PV（點(diǎn)擊瀏覽量）和UV（去重后的點(diǎn)擊瀏覽量）
2. 統(tǒng)計(jì)頁面中A、B、C、D四個(gè)按鈕的點(diǎn)擊量（點(diǎn)擊的PV）和點(diǎn)擊人數(shù)（點(diǎn)擊的UV）
3. 統(tǒng)計(jì)本次活動(dòng)的業(yè)務(wù)訂購量

甚至可以讓研發(fā)單獨(dú)將這部分寫成插件，后續(xù)活動(dòng)直接調(diào)用即可，這也花不了多少的時(shí)候。這樣一個(gè)能用的埋點(diǎn)需求就完成了。而接下來的實(shí)施部分，可以直接交給研發(fā)進(jìn)行處理，你可以在隨后的環(huán)節(jié)中和研發(fā)進(jìn)行討論確認(rèn)一些細(xì)節(jié)。

例如：記錄UV的時(shí)候，我們是用什么來作為唯一憑證？

1. 手機(jī)號：實(shí)際能夠接收到短信的手機(jī)號為準(zhǔn)，但會(huì)因?yàn)樾枰邮茯?yàn)證碼或要求登錄從而對參與性要求較高。
2. IP：當(dāng)前用戶訪問頁面時(shí)所在網(wǎng)絡(luò)的IP地址，會(huì)因?yàn)榍袚Q網(wǎng)絡(luò)或使用代理進(jìn)行變更。
3. Cookie：瀏覽器內(nèi)保存的標(biāo)識，包含用戶私密信息，可通過服務(wù)器進(jìn)行修改生成，但因大部分手機(jī)瀏覽器不支持而局限。
4. IMEI：移動(dòng)設(shè)備的身份證，具有唯一性。一般需要使用app去獲取安卓設(shè)備的底層權(quán)限，網(wǎng)頁H5獲取使用，在iOS設(shè)備上無法獲取。一遍手機(jī)都可以修改，需要獲取root（最高）權(quán)限，在使用軟件修改即可。
5. DeviceCheck：iOS設(shè)備特有唯一設(shè)備碼，之前使用uuid，但是因?yàn)樘O果隱私問題iOS6后就禁止使用了。這個(gè)唯一編碼只要不退出蘋果ID并還原設(shè)備，就不會(huì)重置，唯一性較高。但是相同的問題，需要app去獲取權(quán)限，很多H5并不支持。

注：唯一標(biāo)識，是需求系統(tǒng)的核心指標(biāo)，常用來作為推薦系統(tǒng)、數(shù)據(jù)系統(tǒng)等的唯一標(biāo)識。

二、專業(yè)性埋點(diǎn)文檔

相比較上面十分隨意的埋點(diǎn)需求描述，在大公司面對完善的產(chǎn)品時(shí)，因?yàn)樾枨髽?gòu)建復(fù)雜的分析體系，就需要使用有深度規(guī)范的埋點(diǎn)文檔進(jìn)行管理，以便更好的在各層次中對埋點(diǎn)的理解達(dá)成一致。

所以復(fù)雜專業(yè)的埋點(diǎn)文檔一般是公司體系大，產(chǎn)品完善度高的公司才會(huì)使用。

1. 存儲(chǔ)類型

我們常見埋點(diǎn)文檔中出現(xiàn)String、bool、key、value等類型注名，但并不理解他們的含量，這先做一個(gè)簡單的講解。

1. String（字符串）：表現(xiàn)直接存儲(chǔ)一段文本內(nèi)容，可以是中文，也可以是英文，我們可用來記錄用戶搜索的內(nèi)容獲取發(fā)表的內(nèi)容。
2. bool（布爾）：只能表示true（是）和false（否），我們已經(jīng)用戶記錄用戶是否點(diǎn)擊按鈕。
3. int（整型）：記錄自然數(shù)，從-2,147,483,648到2,147,483,647之間的數(shù)都可以使用。
4. float（浮點(diǎn)）：這也是我們常說的小數(shù)點(diǎn)如1.21、5.20、13.14等等。

除了上面4個(gè)類型以外其實(shí)還有l(wèi)ong、char等等類型，但是為了實(shí)用性，我們只要了解上面的4個(gè)類型，基本對我們撰寫文檔來說就沒太大的問題了。

在撰寫較為專業(yè)的埋點(diǎn)文檔的時(shí)候，我們都需要基于需求去撰寫。

例如：我們的目標(biāo)是想了解一段時(shí)間內(nèi)我們的app使用率是否處于正常水平了解app（H5頁面）的喚醒（打開）率以便評估是否處于均值。有了目標(biāo)之后就進(jìn)入第二部分事件拆分。為了完成我們的目標(biāo)，用戶會(huì)經(jīng)歷哪些操作事件？

我們一一進(jìn)行拆解。首先用戶會(huì)先拿出手機(jī)，其次打開或登錄我們的app（頁面），最后再進(jìn)行其他的瀏覽、購買行為。

到了這里這就是一個(gè)十分簡單的登錄（瀏覽）事件，有了事件接下來就需要我們明確數(shù)據(jù)指標(biāo)。在登錄（瀏覽）事件中，我們首先要梳理的是哪個(gè)指標(biāo)可以作為用戶在我們系統(tǒng)中的唯一標(biāo)識。

有了標(biāo)識后我們要明確用戶什么樣的行為算一個(gè)有效的登錄，是只需要打開app、加載頁面就算，還是需要進(jìn)行后續(xù)滑動(dòng)、點(diǎn)擊等交互行為后才算。這兩個(gè)確定后我們就可以撰寫文檔了。

文檔撰寫每個(gè)公司要求都不一樣，但是我們按照“便于理解”，“避免爭議”的邏輯去寫問題就不大。我們先將他們進(jìn)行分類，本次埋點(diǎn)屬于登錄（瀏覽）事件，我們是以用戶是否成功瀏覽頁面作為評判標(biāo)準(zhǔn)，那么我們他們歸于頁面瀏覽這一大類中。

隨后我們進(jìn)行細(xì)化，頁面的瀏覽也會(huì)因?yàn)轫撁娴姆倍喽祀s，這里因?yàn)槲覀儗儆谑醉搩?nèi)容的瀏覽，因此它的第二類就算首頁頁面。有了這兩個(gè)分類，我們就可以在后續(xù)有需要查詢埋點(diǎn)的時(shí)候快速理解定位埋點(diǎn)，隨后就是具體的埋點(diǎn)參數(shù)了。

這里假設(shè)我們使用IMEI作為用戶唯一標(biāo)識，之后因?yàn)槲覀兪切枰ㄟ^登錄情況去了解我們的用戶，這里我們可以判斷她是否是首次登錄，用于刪選重復(fù)登錄的用戶，這樣一個(gè)簡單的埋點(diǎn)文檔有雛形了。

同時(shí)因?yàn)榇a是字母編碼，所以我們要將文檔中的中文名稱給確定一個(gè)英文名稱，這樣我們后續(xù)就知道埋點(diǎn)在系統(tǒng)中叫什么。

不然直接給中文，可能會(huì)因?yàn)槊總€(gè)人英語水平問題，造成埋點(diǎn)名稱各不相同。例如手機(jī)號我取名叫number，你取名叫iPhone，他取名叫Telephone number這就亂了。因此我們最好加上他們的英文名稱。

2. 擴(kuò)展：預(yù)置屬性

到后去業(yè)務(wù)埋點(diǎn)需求越來越多之后，我們的埋點(diǎn)會(huì)越來越多，最后在沒有更好的管理下，直接每次找埋點(diǎn)找的崩潰。

所以我們不時(shí)對埋點(diǎn)進(jìn)行整理，將通用的數(shù)據(jù)進(jìn)行抽離，將他們單獨(dú)抽離出來，抽離后形成一張新表，代表每個(gè)埋點(diǎn)在搜集數(shù)據(jù)時(shí)，都需要同時(shí)收集這張表上的預(yù)置內(nèi)容。

這樣后續(xù)我們只要慢慢根據(jù)我們的目標(biāo)進(jìn)行完善埋點(diǎn)即可。

3. 擴(kuò)展：共性提取（key value）

除了預(yù)置屬性以外，我們要需要一個(gè)代碼類型《鍵值對》（我們理解為一個(gè)主鍵一個(gè)數(shù)值對應(yīng)）。為什么理解？因?yàn)榫退闶褂妙A(yù)置屬性我們還是會(huì)面對埋點(diǎn)數(shù)據(jù)過多的問題，因?yàn)橐粋€(gè)成熟產(chǎn)品最少都擁有10個(gè)以上的頁面，更別說更加成熟產(chǎn)品了（淘寶、拼多多）。

面對大量頁面不同，統(tǒng)計(jì)數(shù)據(jù)相同的埋點(diǎn)，我們要選擇一套高效的管理手段。所以我們需要了解《鍵值對》（方法都是方便文檔管理，而實(shí)際數(shù)據(jù)庫存儲(chǔ)是由研發(fā)設(shè)計(jì)規(guī)劃，所以建議及時(shí)和研發(fā)進(jìn)行溝通）。

鍵值對：按照名稱，key值，value值進(jìn)行存儲(chǔ)。其中一個(gè)名稱對應(yīng)多個(gè)key值，一個(gè)key值對應(yīng)多個(gè)value值，這里不想去理解key和value代表什么，畢竟我們不是研發(fā)。我們只需要他們所對應(yīng)的格式即可，就像一級分類，二級分類，三級分類一樣。

例如：

• 頁面瀏覽（鍵值對的名稱）— 首頁頁面（鍵值對的key）— 訪問次數(shù)（鍵值對的value）
• 頁面瀏覽（鍵值對的名稱）— 詳情頁面（鍵值對的key）— 訪問次數(shù)（鍵值對的value）
• 頁面瀏覽（鍵值對的名稱）— 購物車頁面（鍵值對的key）— 訪問次數(shù)（鍵值對的value）

（我這種方式我感覺只是文檔管理方便，對于研發(fā)來說，還是需要看需求是否只是需要總數(shù)還是詳情來設(shè)計(jì)數(shù)據(jù)庫存儲(chǔ)，一樣麻煩。）

三、最后

埋點(diǎn)文檔其實(shí)沒你想象中那么難，也沒你想象中那么簡單。現(xiàn)在有太多的數(shù)據(jù)平臺，神策、諸葛io、友盟、growingio等等，都是一套的解決方案，從采集到存儲(chǔ)以及分析可視化等等。

所以其實(shí)去了解下他們的分析解決方案即可，沒必要自己進(jìn)行搭建整個(gè)一套，就像我開頭說的，如果只是日常需要，就直接寫想要什么數(shù)據(jù)給到研發(fā)就行，強(qiáng)行搭建費(fèi)時(shí)費(fèi)力，并且還不一定好。如果真要搭建那么還需要你多和研發(fā)進(jìn)行溝通，畢竟代碼是實(shí)現(xiàn)功能的基礎(chǔ)。

作者：wcof，在努力做產(chǎn)品不做產(chǎn)品經(jīng)理的人；微信公眾號：Wcof（ID：wcofPM）

本文由 @Wcof 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理，未經(jīng)作者許可，禁止轉(zhuǎn)載

題圖來自Unsplash，基于CC0協(xié)議。