為了讓大家能更順利地完成ClkLog的各項數據集成，我們總結了幾項常見問題並做了詳細的説明。
包括有：會話、瀏覽頁面事件、用户集成、自定義事件等。
希望大家通過以下説明能快速定位並處理問題。

一、基礎事件集成
在使用ClkLog作為神策SDK（如WEB JS、Android&iOS、React-Native等客户端）的數據接收端時，需注意以下幾點

1.1.會話集成
ClkLog的基礎流量統計指標中的訪問次數、平均訪問頁數、訪問時長、用户畫像列表都與會話有關，所以集成SDK後首先需要排查會話是否集成。
如果採集的日誌中事件屬性包含 $event_session_id 屬性並且有值，則説明會話集成成功。
會話的集成方法：
1）直接開啓：如Android&iOS、React-Native 的 SDK 可直接enableSession。
2）集成插件：如web js sdk需集成 session-event 。
3）自己實現：如uni-app sdk 、 unity3d sdk。

以上SDK demo 參考官網-技術指南-集成測試參考。
其他端的SDK中會話的集成請參考神策官方文檔或查看SDK源碼。

1.2.瀏覽頁面事件集成
ClkLog的基礎瀏覽統計指標中的瀏覽量指標基於瀏覽頁面事件。
由於神策不同客户端的SDK的瀏覽頁面事件的事件名稱不同，ClkLog根據神策SDK的瀏覽頁面事件定義對各種端做了不同的統計分析處理。
神策各端SDK的瀏覽頁面事件如下：
●Web：$pageview
●Android&iOS：$AppViewScreen
●小程序：$MPViewScreen
●其他端: ClkViewScreen。ClkViewScreen事件是ClkLog付費版中定義的除Web、Android&iOS、小程序端以外的其他端的SDK想要進行受訪頁面統計分析的通用事件。參考官網-技術指南-神策無全埋點的SDK集成方案

在實際應用過程中請根據不同版本的SDK去查詢相關的事件數據, 如果在ClkLog統計前端瀏覽量無數據請根據埋點項目所引用的SDK去排查採集到的日誌記錄是否有相應的瀏覽頁面事件。

二、登錄用户的集成(付費版)
當用户登錄時，需主動調用神策SDK的login接口，將用户的註冊信息（一般為用户在業務系統中的唯一身份標識）傳入。

Web JS用户登錄接口示例：sensors.login('login_user_id');

參考官網-技術指南-集成説明-核心功能-2簡易用户關聯集成

更多其他端（如Andriod、IOS、微信小程序等）用户登錄集成代碼接入方式請參考神策官方SDK集成文檔。

三、自定義事件/用户屬性集成(付費版)

3.1.元數據管理
注意：在集成自定義事件/用户屬性之前需在【元數據管理】處導入或定義事件、事件屬性及用户屬性。

元數據是按項目根據業務系統定義的自定義事件、神策預置事件的事件及屬性（事件、用户、公共）的管理。

在集成前端自定義事件/用户屬性的代碼埋點之前，需要先在【元數據管理】處下載預置事件、預置屬性、用户屬性相關模板，並根據實際情況定義好要採集的事件（預置和自定義）、事件屬性（預置和自定義）、用户屬性（預置和自定義）添加或導入【ClkLog後台】-【元數據管理】相關庫後再進行代碼埋點，否則SDK全埋點相關的事件日誌不會被同步至事件表，進而導致ClkLog後台的【自定義分析】功能統計的事件數量和原始採集的日誌數據量不一致。

相關更多説明請參考官網-技術指南-集成説明-核心功能-3.事件分析集成

3.2.日誌查詢
日誌查詢功能用於幫助開發者在事件分析相關埋點代碼集成成功後，查看埋點的相關事件及其屬性是否成功採集。
注意：日誌查詢中有數據的前提條件如下
1、ClkLog的receiver服務可以正常接收客户端採集的日誌數據並存入kafka。
2、ClKLog的processing服務可以正常依託flink，消費kafka數據並存入clickhouse。
3、ClkLog的api服務可以正常訪問。

日誌查詢數據可埋點日誌數據不一致可能出現的問題和排查方法如下：
Q1：控制枱有事件日誌，但日誌查詢中無數據。
A1：請檢查：
✓在【元事件管理-元事件】中是否定義相關事件並關聯相關屬性。

Q2: 日誌查詢中的事件屬性和控制枱打印的事件屬性數量不一致。
A2：請檢查：
✓在【元事件管理-事件屬性】中是否定義相關屬性。
✓在【元事件管理-元事件】中是否將事件屬性和事件進行關聯。

Q3：埋點設置用户屬性後控制枱有用户屬性，但日誌查詢中的事件沒有用户屬性。
A3：請檢查：
✓用户登錄後是否設置用户ID（用户ID不能是androidid之類的關鍵詞）。
✓在【元事件管理-用户屬性】中未定義項目的用户屬性（用户屬性不能是label之類的關鍵詞）。

祝大家集成順利，用得滿意！