Trang này được dịch bởi Cloud Translation API.

Các nguyên tắc cơ bản về tính năng Xuất đối tượng

Đối tượng trong Google Analytics 4 cho phép bạn phân đoạn người dùng theo các 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 của mình dựa trên các thuộc tính chung.

Khi sử dụng Google Analytics Data API phiên bản 1, bạn có thể tạo các Lượt xuất đối tượng, trong đó có thông tin tổng quan nhanh về người dùng trong đối tượng đó.

Tạo tệp Xuất đối tượng

Google Analytics Data API phiên bản 1 sử dụng phương pháp không đồng bộ để tạo Lượt xuất đối tượng. Trước tiên, bạn cần yêu cầu phương thức audienceExports.create để tạo Xuất đối tượng của người dùng. Sau đó, phương thức audienceExports.query được dùng để truy xuất người dùng trong đối tượng.

Ngoài ra, bạn có thể sử dụng audienceExports.get để truy xuất siêu dữ liệu cấu hình về một Dữ liệu xuất đối tượng cụ thể và audienceExports.list để liệt kê tất cả các lần Xuất đối tượng cho một tài sản.

Chọn một thực thể báo cáo

Tất cả các phương thức của Data API phiên bản 1 đều yêu cầu bạn phải chỉ định giá trị nhận dạng thuộc tính Google Analytics 4 bên trong đường dẫn yêu cầu URL ở dạng properties/GA4_PROPERTY_ID, chẳng hạn như:

  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 được 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 phải thao tác trên đường dẫn URL yêu cầu theo cách thủ công. Hầu hết ứng dụng API đều cung cấp tham số property dự kiến sẽ có một 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.

Yêu cầu tạo tính năng Xuất đối tượng

Để tạo một 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 một yêu cầu. 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 properties/{propertyId}/audiences/{audienceId}. Bạn có thể sử dụng phương thức audiences.list của API Quản trị Google Analytics phiên bản 1 để lấy giá trị này. Trường Audience.name của phản hồi audiences.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 cho các phương diện được đề cập trong trường này mới được đưa vào Xuất đối tượng.

Ví dụ về yêu cầu tạo đối tượng Xuất:

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 đối tượng Xuất trong trường name (chẳng hạn như properties/1234567/audienceExports/123). Bạn có thể dùng tên này trong các truy vấn tiếp theo để truy xuất người dùng từ Dữ liệu xuất đối tượng.

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"
  }
}

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ể lấy trạng thái sẵn sàng cho 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 (chẳng hạn như properties/1234567/audienceExports/123) mà bạn nhận được từ phản hồi audienceExports.create để chỉ định Xuất đối tượng.

Ví dụ:

Yêu cầu HTTP

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

Trạng thái sẵn sàng của một đối tượng 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 đối tượng hoàn tất, trạng thái của quá trình này sẽ thay đổi từ CREATING thành ACTIVE.

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ể biết trạng thái của tất cả các lần Xuất đối tượng bằng cách gọi phương thức audienceExports.list.

Truy xuất người dùng trong Xuất đối tượng

Sau khi tệp Xuất đối tượng được tạo bằng phương thức audienceExports.create được tạo, hãy gọi phương thức audienceExports.query và chỉ định tên của tệp Xuất đối tượng (chẳng hạn như properties/1234567/audienceExports/123).

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Nếu tính năng Xuất đối tượng đã sẵn sàng, thì hệ thống sẽ trả về phản hồi chứa danh sách người dùng thuộc một đối tượng:

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
}

Kỳ vọng về dữ liệu Xuất đối tượng

Phần sau đây đặt ra các kỳ vọng về dữ liệu đối với tư cách thành viên của người dùng trong tính năng Xuất đối tượng.

Độ mới của dữ liệu

Độ mới của dữ liệu Xuất đối tượng là thời gian mà Google Analytics để thu thập sự kiện, xử lý sự kiện và sau đó cập nhật tư cách thành viên của người dùng trong đối tượng. Nếu toàn bộ quá trình đó mất 24 giờ, thì độ mới của dữ liệu Xuất đối tượng sẽ là 24 giờ. Xem phần Độ mới của dữ liệu để tìm hiểu thêm.

Ví dụ: nếu người dùng hoàn tất giao dịch mua hàng đầu tiên và sau đó 7 giờ, bạn tạo một Dữ liệu xuất đối tượng cho đối tượng "Người mua", thì gần như chắc chắn người dùng sẽ chưa có trong Xuất đối tượng "Người mua". Sau 14 đến 38 giờ kể từ giao dịch mua đầu tiên, người dùng đó có khả năng sẽ xuất hiện trong đối tượng mới.

Lượt xuất đối tượng là ảnh chụp nhanh

Dữ liệu xuất đối tượng là danh sách người dùng thuộc một đối tượng ở thời điểm tổng quan nhanh. Đối với tính năng tái tiếp thị của Google Ads, Google Analytics sẽ tự động và liên tục xuất người dùng thuộc đối tượng sang Google Ads. Ngược lại, với công cụ Xuất đối tượng được tạo bằng Data API phiên bản 1, bạn cần tạo một công cụ Xuất đối tượng mới để xem những người dùng mới nhất trong đối tượng đó.

Dữ liệu xuất đối tượng được tạo dựa trên những tư cách thành viên mới nhất của người dùng hiện có. Tuy nhiên, tính năng Xuất đối tượng có thể có độ mới của dữ liệu là 20 giờ, và điều đó có nghĩa là tính năng Xuất đối tượng sẽ dựa trên tất cả các sự kiện diễn ra trước thời điểm hiện tại 20 giờ.

Dữ liệu mới nhất về thành viên được cập nhật một lần mỗi ngày, thường là vào giờ ban ngày theo múi giờ của tài sản. Điều này có nghĩa là một Dữ liệu xuất đối tượng cho cùng một đối tượng lúc 9 giờ sáng và 11 giờ sáng có thể sẽ trả về cùng một dữ liệu, nhưng một lần Xuất đối tượng vào lúc 3 giờ chiều có thể khác nếu việc thêm dữ liệu của một ngày khác.

Ngày hết hạn của tệp xuất đối tượng

Dữ liệu xuất đối tượng sẽ hết hạn sau 72 giờ. Người dùng mới có thể tham gia và thoát khỏi một đối tượng mỗi ngày. Để có được thông tin tổng quan nhanh mới nhất về người dùng, bạn cần tạo các Lượt xuất đối tượng mới cho mỗi ngày.

Giới hạn đối với người dùng xuất đối tượng

Khi quy mô của một đối tượng hoặc tài sản vượt quá giới hạn người dùng, tính năng Xuất đối tượng sẽ trả về các mẫu đại diện của đối tượng đó. Các giới hạn này phụ thuộc vào loại tài sản của bạn (tức là tài sản chuẩn hoặc tài sản 360) và được áp dụng riêng trong mỗi lần Xuất đối tượng. Người dùng cũ là người dùng trong đối tượng được yêu cầu và người dùng được coi là người dùng có thể là thành viên hoặc không thuộc đối tượng đó.

Loại hạn mức	Giới hạn thuộc tính chuẩn	Hạn mức đối với tài sản Analytics 360
Số người dùng cũ tối đa	2 triệu	200 triệu
Số người dùng được cân nhắc tối đa	10 triệu	1 tỷ

Tính nhất quán về thông tin nhận dạng trong báo cáo

Thông tin nhận dạng trong báo cáo sẽ quyết định cách loại bỏ người dùng trùng lặp trong báo cáo. Hoạt động xuất đối tượng KHÔNG thay đổi dựa trên chế độ cài đặt thông tin nhận dạng trong báo cáo. Tính năng Xuất đối tượng luôn xác định người dùng theo Mã nhận dạng người dùng rồi đến mã thiết bị.

Điều này có nghĩa là các báo cáo về một đối tượng có thể cho thấy nhiều người dùng hơn so với kết quả Xuất đối tượng trả về. Ví dụ: nếu Thông tin nhận dạng trong báo cáo là "Dựa trên thiết bị" và mã nhận dạng người dùng được thu thập, thì báo cáo sẽ không loại bỏ người dùng trùng lặp dựa trên mã nhận dạng người dùng mà dữ liệu Xuất đối tượng sẽ được loại bỏ dựa trên mã nhận dạng người dùng.

Tính nhất quán trong việc thay thế đối tượng

Khi bạn tạo một Đối tượng trong Google Analytics và bật tính năng tái tiếp thị trên Google Ads, Google Analytics sẽ bổ sung những thành viên được thêm gần đây vào đối tượng đó trong Google Ads. Tuy nhiên, các báo cáo của Google Analytics và Dữ liệu xuất đối tượng KHÔNG bao gồm những thành viên được bổ sung vào đối tượng. Sau khi đối tượng được tạo, người dùng cần ghi nhật ký một sự kiện thì các báo cáo và Dữ liệu xuất đối tượng mới hiển thị người dùng trong đối tượng đó.

Ví dụ: nếu một người dùng tạo ra một sự kiện mua hàng vào ngày 20 tháng 6 và bạn tạo đối tượng "Người mua hàng" vào ngày 21 tháng 6, thì bạn có thể phải đợi đến ngày 22 tháng 6 mới có thể thấy người dùng đó trong Xuất đối tượng mới. Tuy nhiên, người dùng đó sẽ chỉ có trong Xuất đối tượng nếu họ đã ghi lại bất kỳ sự kiện nào vào ngày 21 tháng 6.