1. Giới thiệu
Lần cập nhật gần đây nhất: ngày 30 tháng 04 năm 2019
Sản phẩm bạn sẽ tạo ra
- Trong lớp học lập trình này, bạn sẽ tìm hiểu cách gửi sự kiện bên ngoài đến GA4 bằng Measurement Protocol.
- Lớp học lập trình này giả định rằng bạn đã triển khai một trang/trang web khác bằng Google Analytics 4.
Kiến thức bạn sẽ học được
- Các bước để thực hiện cuộc gọi MP đầu tiên
- Tìm hiểu các thông số cần thiết cho lệnh gọi
- Gửi và xác thực cuộc gọi thử
- Tạo tập lệnh mẫu trong Python để thực hiện lệnh gọi
Bạn cần có
- Trang web
- Mọi IDE cần thay đổi
- Tài khoản GA4
- Không bắt buộc – Môi trường phát triển Python (hoặc Colab)
2. Thu thập các trường bắt buộc
Tạo Khoá bí mật API trong GA4
Chuyển đến GA4 rồi tạo mã thông báo bí mật mới cho API bằng cách chuyển đến mục Quản trị > Luồng dữ liệu > chọn luồng của bạn > Measurement Protocol > Sáng tạo
Bạn có thể cung cấp biệt hiệu bất kỳ. Giá trị bí mật sẽ xuất hiện. Bạn có thể dùng giá trị này trong cuộc gọi
Thu thập client_id
Bạn có thể sử dụng bất kỳ phương thức nào bên dưới để thu thập client_id của mình.
- Đang thu thập qua gTag
Cả hai đều được giải thích chi tiết bên dưới
Thu thập qua gTag
Bạn có thể truy xuất client_id qua trang web của mình bằng cách sử dụng :
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
Dưới đây là các đường liên kết khác, tuỳ thuộc vào cơ sở hạ tầng của bạn
3. Tạo nên cuộc gọi
Bạn có thể tạo lệnh gọi mẫu bằng Trình tạo sự kiện trong GA4. (Bạn sẽ phải đăng nhập và bật cookie). Đảm bảo nút bật/tắt này được đặt thành "gtag.js"
Bạn cần phải điền vào các trường sau
- api_secret – Đã được tạo trước đó trên GA4
- Measurement_id- Để xem thông tin này, bạn có thể chuyển đến trang Quản trị > Luồng dữ liệu > chọn luồng của bạn . Mã sẽ hiển thị như bên dưới
- client_id - Bạn đã truy lục giá trị này
- user_id là không bắt buộc. Hiện tại, bạn có thể để trống trường này
- Danh mục - thay đổi danh mục này thành "Tùy chỉnh" trên trình đơn thả xuống rồi nhập tên sự kiện bất kỳ mà bạn chọn (không sử dụng sự kiện được thu thập tự động). Ở đây, chúng ta đang dùng "test_from_codelab"
(Không bắt buộc) Bạn cũng có thể chọn cung cấp thông số sự kiện và/hoặc thuộc tính người dùng bằng cách nhấp vào các nút bên dưới
Sau khi điền mọi thông tin, bạn sẽ thấy như sau, với nút để "Xác thực sự kiện"
Khi bạn đến nơi, nhấp vào "XÁC THỰC SỰ KIỆN" , nút được làm nổi bật bằng màu cam. Hệ thống sẽ hiển thị thông báo bên dưới, trong đó xác định rằng sự kiện này là hợp lệ và bạn sẽ thấy một nút để hiện thông báo "GỬI ĐẾN GA". Tại thời điểm này, nếu sự kiện được coi là không hợp lệ, công cụ này sẽ cho bạn biết trường chính xác xảy ra vấn đề để bạn có thể khắc phục vấn đề đó rồi thử lại
Bây giờ, bạn có thể nhấp vào nút này và nút này sẽ gửi một sự kiện thử nghiệm đến GA4
4. Xác thực sự kiện trong GA4
Sau khi gửi sự kiện, bạn có thể chuyển đến tài khoản GA4 của mình và kiểm tra Báo cáo theo thời gian thực. Bạn sẽ thấy sự kiện diễn ra
Có thể mất khoảng 24 giờ để các sự kiện chuyển từ chế độ xem theo thời gian thực sang thẻ báo cáo sự kiện thực tế. Vì vậy, bạn không cần lo lắng nếu không thấy ngay thông tin này trong báo cáo sự kiện thông thường!
5. Tạo tập lệnh Python
Giờ thì bạn đã kiểm thử xong, bạn có thể kiểm tra lệnh gọi API và tải trọng sự kiện để xây dựng một cấu trúc tương tự trong Python (hoặc bằng bất kỳ ngôn ngữ nào bạn chọn) có thể thực hiện lệnh gọi này. Sau đó, bạn có thể lên lịch cho việc này với tần suất mong muốn và vận hành chiến dịch. Đối với phần này, bạn có thể sử dụng một IDE bất kỳ có hỗ trợ Python theo lựa chọn của mình hoặc chỉ cần sử dụng một sổ tay Google Colab không yêu cầu cài đặt trên thiết bị của bạn
Khi xem lại Trình tạo sự kiện GA4, bạn sẽ thấy điểm cuối như bên dưới
POST /mp/collect?measurement_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
Tải trọng sự kiện như bên dưới
{
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
Bạn có thể dịch nội dung này sang python bằng cách sử dụng mã như sau
import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)
Sau khi thực thi giá trị này với giá trị phù hợp, bạn sẽ thấy sự kiện này được phản ánh theo thời gian thực trong GA4.
6. Xin chúc mừng
Xin chúc mừng! Bạn đã sử dụng thành công Measurement Protocol trong GA4. Giờ đây, bạn có thể xây dựng cấu trúc giải pháp mạnh mẽ để gửi dữ liệu có ý nghĩa hơn đến Google Analytics, đồng thời cải thiện hoạt động tiếp thị và phân tích kinh doanh của mình. Để khai thác tối đa sự kiện này, bạn cũng nên kết nối với Google Ads và nhập những sự kiện này dưới dạng lượt chuyển đổi.
Bạn đã tìm hiểu
- Cách thu thập các biến phù hợp để thực hiện lệnh gọi MP
- Cách gửi và xác thực sự kiện thử nghiệm
- Cách tạo tập lệnh để gửi lệnh gọi MP