1. Giới thiệu
Ngày cập nhật gần đây nhất: 30/4/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 các 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 Google Analytics 4 cho một Trang/trang web.
Kiến thức bạn sẽ học được
- Các bước để thực hiện lệnh gọi đầu tiên của bạn trong MP
- Hiểu rõ những tham số bắt buộc phải có cho lệnh gọi
- Gửi và xác thực lệnh gọi thử nghiệm của bạn
- Tạo một tập lệnh mẫu bằng Python để thực hiện lệnh gọi
Bạn cần có
- Trang web
- Mọi IDE để thực hiệ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 mã thông báo bí mật cho API trong GA4
Chuyển đến GA4 rồi tạo khoá 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 > Tạo
Bạn có thể cung cấp biệt hiệu bất kỳ và giá trị bí mật sẽ xuất hiện. Bạn có thể sử dụng giá trị này trong lệnh gọi
Thu thập client_id
Bạn có thể sử dụng bất kỳ phương thức nào dưới đây để thu thập client_id.
- Thu thập thông qua gTag
Cả hai điều này đều được giải thích chi tiết bên dưới
Thu thập thông qua gTag
Bạn có thể truy xuất client_id thông 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 cuộc gọi
Bạn có thể tạo một lệnh gọi mẫu bằng Trình tạo sự kiện trong GA4. (Bạn đăng nhập và bật cookie để thực hiện việc này). Đảm bảo rằng nút bật/tắt được đặt thành "gtag.js"
Bạn cần điền vào các trường sau
- api_secret – Đã được tạo trước đó trên GA4
- measurement_id – Để lấy mã này, bạn có thể chuyển đến mục Quản trị > Luồng dữ liệu > chọn luồng của bạn . Nội dung này sẽ xuất hiện như bên dưới
- client_id – Bạn đã truy xuất giá trị này
- user_id không bắt buộc. Bạn có thể để trống trường này ở thời điểm hiện tại
- Danh mục – thay đổi danh mục này thành "Tuỳ chỉnh" trong trình đơn thả xuống và nhập tên sự kiện bất kỳ mà bạn chọn (không sử dụng bất kỳ sự kiện được thu thập tự động nào). Ở đây, chúng ta đang sử dụng "test_from_codelab"
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 (không bắt buộc)
Sau khi điền tất cả thông tin, bạn sẽ thấy một giao diện như thế này, có nút "Xác thực sự kiện"
Sau khi bạn đạt đến bước này, hãy nhấp vào "XÁC THỰC SỰ KIỆN" (nút được đánh dấu màu cam). Thông báo dưới đây sẽ xuất hiện, cho biết sự kiện hợp lệ và bạn sẽ thấy nút "GỬI ĐẾN GA". Tại thời điểm này, nếu sự kiện xuất hiện dưới dạng không hợp lệ, công cụ sẽ cho bạn biết chính xác trường có vấn đề, bạn có thể khắc phục vấn đề đó và thử lại
Giờ đây, 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 kiểm thử đế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 và kiểm tra báo cáo Theo thời gian thực. Bạn sẽ thấy sự kiện xuất hiện
Có thể mất khoảng 24 giờ để các sự kiện truyề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 sự kiện này ngay lập tức trong báo cáo sự kiện thông thường!
5. Tạo tập lệnh Python
Giờ đây, sau khi thử nghiệm, bạn có thể kiểm tra lệnh gọi API và tải trọng sự kiện để tạo một cấu trúc tương tự bằng 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 theo tần suất mong muốn và đưa vào hoạt động. Đối với phần này, bạn có thể sử dụng bất kỳ IDE nào mà bạn chọn có hỗ trợ Python hoặc chỉ cần sử dụng một sổ tay Google Colab mà không cần cài đặt trên thiết bị của bạn
Quay lại Trình tạo sự kiện GA4, bạn sẽ thấy rằng điểm cuối có dạng như sau
POST /mp/collect?measurement_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
Phần tải 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 đoạn mã này sang Python bằng cách sử dụng một đoạn mã tương tự 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 lệnh này với các giá trị phù hợp, bạn cũng sẽ thấy sự kiện được phản ánh theo thời gian thực trong GA4.
6. Xin chúc mừng
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ác cấu trúc giải pháp mạnh mẽ để gửi dữ liệu có ý nghĩa hơn đến Google Analytics và cải thiện hoạt động phân tích tiếp thị và kinh doanh của mình. Để tận dụng tối đa tính năng 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 số phù hợp để thực hiện các lệnh gọi MP
- Cách gửi và xác thực sự kiện kiểm thử
- Cách tạo tập lệnh để gửi cuộc gọi MP