iOS 開發筆記 - 使用 Swift 完成 GA Measurement Protocol 實作

大概去年夏天，偶爾會寫一點 Swift 程式，雖然對 Objective c 比較熟，但時勢變遷就該順應潮流。那時採用 GoogleAnalytics 套件，但 Google Analytics for App 要在今年秋天下線了，Google一直要大家改用 Firebase ，且 Google 牌 cocoapods GoogleAnalytics 也的確幾年沒更新了。只是 Firebase 就明顯要人多花錢，例如要先把 Firebase 的數據匯入到 GA 上免錢，但有些查詢又要搞到 BigQuery 才行，雖然 BigQuery 有免費額度 啦 XD 因此趁 GA Measurement Protocol 還沒下線前，多用用他吧！把以前是 App Screen 就設法轉成 Web Pageview 吧，唯一的缺點是 Session 這類，若要硬做也是一招啦，在此就都不管了。

在此只包裝成 3 個函式供人使用即可，分別是取得 clientID、回報 pageview、回報 event 既可：

override func viewDidLoad() {
super.viewDidLoad()
// Do any additional setup after loading the view.

GAEvent(trackingID: "UA-########-#", clientID: getClientID(), eventCategory: "TestEC", eventAction: "TestEA", eventLabel: "TestEL", eventValue: 0)

GAPageView(trackingID: "UA-########-#", clientID: getClientID(), path:"/")
}

func getClientID() -> String {
// example
return UUID().uuidString
}

func GAPageView(trackingID:String, clientID:String, path:String ) {
var url = URLComponents(string: "https://www.google-analytics.com/collect")!
if trackingID.isEmpty || clientID.isEmpty || path.isEmpty {
return
}
url.queryItems = [
URLQueryItem(name: "v", value: "1"),
URLQueryItem(name: "tid", value: trackingID),
URLQueryItem(name: "cid", value: clientID),
URLQueryItem(name: "t", value: "pageview"),
URLQueryItem(name: "dh", value: "example.com"),
URLQueryItem(name: "dp", value: path),
]
//#if DEBUG
//url.queryItems?.append(URLQueryItem(name: "cd1", value: "DEBUG"))
//#endif
//if let appVersion = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, appVersion.isEmpty {
//    url.queryItems?.append(URLQueryItem(name: "cd2", value: appVersion))
//}

let request = URLRequest(url: url.url!)
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
//guard let data = data else { return }
//print(String(data: data, encoding: .utf8)!)
if let httpResponse = response as? HTTPURLResponse {
print("GAPageView: \(httpResponse.statusCode)" )
}
}
task.resume()
}

func GAEvent(trackingID:String, clientID:String, eventCategory:String, eventAction:String, eventLabel:String, eventValue:Int) {
var url = URLComponents(string: "https://www.google-analytics.com/collect")!
if trackingID.isEmpty || clientID.isEmpty || path.isEmpty {
return
}

url.queryItems = [
URLQueryItem(name: "v", value: "1"),
URLQueryItem(name: "tid", value: trackingID),
URLQueryItem(name: "cid", value: clientID),
URLQueryItem(name: "t", value: "event"),
URLQueryItem(name: "ec", value: eventCategory),
]
//#if DEBUG
//url.queryItems?.append(URLQueryItem(name: "cd1", value: "DEBUG"))
//#endif
//if let appVersion = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, appVersion.isEmpty {
//    url.queryItems?.append(URLQueryItem(name: "cd2", value: appVersion))
//}

if !eventAction.isEmpty {
url.queryItems?.append(URLQueryItem(name: "ea", value: eventAction))
if !eventLabel.isEmpty {
url.queryItems?.append(URLQueryItem(name: "el", value: eventAction))
if eventValue >= 0 {
url.queryItems?.append(URLQueryItem(name: "ev", value: "\(eventValue)"))
}
}
}

let request = URLRequest(url: url.url!)
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
//guard let data = data else { return }
//print(String(data: data, encoding: .utf8)!)
if let httpResponse = response as? HTTPURLResponse {
print("GAEvent: \(httpResponse.statusCode)" )
}
}
task.resume()
}

其中 getClientID() 只是個示意，因為每次呼叫 UUID().uuidString 都會產生一組新的，可以把它存起來使用，或是針對某些情境設計規劃，像是服務有提供登入機制時，就改用從 user id 計算得出等那類即可。

Google Analytics 筆記 - 透過 gtag.js 回報 pageview 時，進行 Custom dimensions 回報

在 gtag 的自訂維度的文件上，是以 event 來教學的：gtagjs/custom-dims-mets 且 gtag 的 pageview 文件也是滿精簡：gtagjs/pages

遙想以前 ga 可以很直觀地靠 set 指令 處理：

ga('create', 'UA-XXXX-Y', 'auto');
// 設定指數 1 的自訂維度值。
ga('set', 'cd1', 'Level 1');
// 送出自訂維度值及瀏覽量匹配資料。
ga('send', 'pageview');

最後東摸摸西摸摸，找到一招，就是要發送自訂維度時，一口氣完成定義跟使用：

var params = {
'send_page_view': true,
'page_title' : title,
'page_path': path,
};

var custom_value = getSpecialInfo();
if (custom_value) {
params['ab_user'] = custom_value;
params['custom_map'] = {
'dimension1': 'ab_user',
};
}
gtag('config', 'UA-XXXX-Y', params);

而為何需要使用到這些，其實就是想多做更多的用戶分類，例如 A/B Test 時，更細膩的追蹤用戶行為。若採用 Google Analytics 實驗功能，可以直接靠 實驗/實驗ID 來區分。另外 Google 實驗在 2019/08/07 起已經移師到 Google 最佳化工具囉。只是使用 optimize.google.com 服務時，有些使用情境不太適合，像是網頁一初始畫面就要依照 A/B Test 分群做 UI 改變時，設計上只能先等 optimize.google.com js sdk 初始化才能做事，這就會稍微給人體驗不佳。如果操作上跟網頁初始化無關，如用戶點擊按鈕才依照 A/B Test 分群做不一樣的效果，那就還滿適合善用 optimize.google.com 提供的功能。

目前單靠 google analytics 自訂維度，再靠土炮 A/B 分群方式，把用戶標籤記錄在 cookie 使用：

// AB Test
function getRandomValue(min,max){
return Math.floor(Math.random()*(max-min+1))+min;
}

if (!getCookie(ab_test_cookie_name)) {
var user_flag = getRandom(1,10) > 5 ? '201908-a' : '201908-b';
setCookie(ab_test_cookie_name, user_flag, 365, '/');
}

後續在 google analytics 專案內的行為流程中，就可以在"新增區隔"，從 "進階條件" 撈出自訂維度來看行為。