Đối tượng trong Google Analytics 4 cho phép bạn tạo phân khúc người dùng theo những cách quan trọng đối với công việc kinh doanh của bạn. Với đối tượng, bạn có thể nhóm người dùng của trang web hoặc ứng dụng dựa trên các thuộc tính dùng chung.
Bạn có thể xuất đối tượng, bao gồm cả thông tin tổng quan nhanh về người dùng của họ, bằng cách sử dụng Data API.
Hãy tham khảo hướng dẫn Kỳ vọng về dữ liệu xuất đối tượng để biết thông tin quan trọng về dữ liệu bạn thấy trong tính năng xuất đối tượng.
Tổng quan
Thực hiện các yêu cầu sau đây về Data API để tạo và truy vấn một tệp xuất đối tượng:
- Gọi phương thức
audienceExports.create
để tạo đối tượng xuất. - Gọi phương thức
audienceExports.query
được dùng để truy xuất người dùng trong đối tượng.
Để biết thêm thông tin, bạn có thể gọi audienceExports.get
để truy xuất siêu dữ liệu cấu hình về một tệp xuất đối tượng cụ thể và audienceExports.list
để liệt kê tất cả các tệp xuất đối tượng cho một tài sản cụ thể.
Chọn một pháp nhân báo cáo
Tất cả phương thức Data API đều yêu cầu bạn phải chỉ định giá trị nhận dạng tài sản Google Analytics 4 bên trong đường dẫn yêu cầu URL, dưới dạng properties/GA4_PROPERTY_ID
. Ví dụ:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Báo cáo này được tạo dựa trên dữ liệu sự kiện Google Analytics thu thập trong tài sản Google Analytics 4 đã chỉ định.
Nếu đang sử dụng một trong các thư viện ứng dụng Data API, thì bạn không cần thay đổi đường dẫn URL yêu cầu.
Hầu hết ứng dụng API đều cung cấp tham số property
dự kiến có chuỗi ở dạng properties/GA4_PROPERTY_ID
.
Hãy xem Hướng dẫn bắt đầu nhanh để biết các ví dụ về cách sử dụng thư viện ứng dụng.
Tạo dữ liệu xuất đối tượng
Để tạo tính năng xuất đối tượng, hãy gọi phương thức audienceExports.create
bằng cách sử dụng đối tượng AudienceExport
trong yêu cầu của bạn. Các tham số sau đây là bắt buộc:
- Tên đối tượng hợp lệ trong trường
audience
, có định dạng làproperties/{propertyId}/audiences/{audienceId}
. Bạn có thể sử dụng phương thứcaudiences.list
của API Quản trị của Google Analytics phiên bản 1 để lấy giá trị này. TrườngAudience.name
của phản hồiaudiences.list
chứa tên đối tượng. - Danh sách phương diện hợp lệ trong trường
dimensions
. Bạn có thể tìm thấy danh sách các phương diện mà phương thức này hỗ trợ trong tài liệu về Giản đồ xuất đối tượng. Chỉ dữ liệu của các phương diện được đề cập trong trường này mới được đưa vào tệp xuất đối tượng.
Dưới đây là yêu cầu mẫu để tạo dữ liệu xuất đối tượng:
Yêu cầu HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
Phản hồi của phương thức audienceExports.create
chứa tên của dữ liệu xuất đối tượng trong trường name
, ví dụ: properties/1234567/audienceExports/123
.
Dưới đây là phản hồi mẫu:
Phản hồi HTTP
{
"response": {
"@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
}
Bạn có thể sử dụng name
để truy vấn người dùng trong tính năng xuất đối tượng.
Truy vấn trạng thái sẵn sàng của tính năng xuất đối tượng
Có thể mất vài phút để tạo tệp xuất đối tượng sau lệnh gọi audienceExports.create
.
Bạn có thể kiểm tra trạng thái sẵn sàng của tính năng xuất đối tượng bằng cách gọi phương thức audienceExports.get
.
Sử dụng tên xuất đối tượng từ phản hồi audienceExports.create
để chỉ định việc xuất đối tượng trong yêu cầu của bạn.
Dưới đây là yêu cầu mẫu:
Yêu cầu HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Trạng thái sẵn sàng cho việc xuất đối tượng được trả về trong trường state
của phản hồi. Sau khi quá trình tạo dữ liệu xuất đối tượng hoàn tất,
trạng thái của quá trình đó sẽ thay đổi từ CREATING
thành ACTIVE
.
Dưới đây là phản hồi mẫu:
Phản hồi HTTP
{
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
Bạn có thể lấy trạng thái của tất cả các đối tượng xuất bằng cách gọi phương thức audienceExports.list
.
Truy xuất người dùng từ tệp xuất đối tượng
Sau khi tạo dữ liệu xuất đối tượng, hãy gọi phương thức audienceExports.query
và chỉ định name
của tính năng xuất đối tượng trong yêu cầu.
Dưới đây là yêu cầu mẫu:
Yêu cầu HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Nếu dữ liệu xuất đối tượng đã sẵn sàng, lệnh gọi này sẽ trả về danh sách người dùng trong đối tượng.
Dưới đây là phản hồi mẫu:
Phản hồi HTTP
{
"audienceExport": {
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "ACTIVE",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
},
"audienceRows": [
{
"dimensionValues": [
{
"value": "1000276123.1681742376"
}
]
},
{
"dimensionValues": [
{
"value": "1000374452.1668627377"
}
]
},
{
"dimensionValues": [
{
"value": "1000391956.1652750758"
}
]
},
{
"dimensionValues": [
{
"value": "1000410539.1682018694"
}
]
},
{
"dimensionValues": [
{
"value": "1000703969.1666725875"
}
]
}
],
"rowCount": 5
}