Các chỉ số và phương diện API

Các phương diện và chỉ số này được hỗ trợ trong báo cáo phễu Analytics Data API.

Kích thước

Bạn có thể yêu cầu các phương diện sau trong báo cáo phễu cho mọi tài sản. Chỉ định "Tên API" trong trường name của tài nguyên Dimension.

Tên API Tên giao diện người dùng Có sẵn trong Phân khúc Nội dung mô tả
achievementId Mã thành tích Mã thành tích trong trò chơi cho một sự kiện. Được điền sẵn bằng thông số sự kiện achievement_id.
adFormat Định dạng quảng cáo Mô tả giao diện và vị trí của quảng cáo. Các định dạng thông thường bao gồm Interstitial, Banner, RewardedNative advanced.
adSourceName Nguồn quảng cáo Không Mạng nguồn đã phân phát quảng cáo. Các nguồn thông thường bao gồm AdMob Network, Liftoff, Facebook Audience NetworkMediated house ads.
adUnitName Đơn vị quảng cáo Không Tên mà bạn đã chọn để mô tả Đơn vị quảng cáo này. Đơn vị quảng cáo là các vùng chứa mà bạn đặt vào ứng dụng của mình để hiển thị quảng cáo cho người dùng.
appVersion Phiên bản ứng dụng Tên phiên bản của ứng dụng (Android) hoặc phiên bản của gói dạng ngắn (iOS).
audienceId Mã đối tượng Không Giá trị nhận dạng bằng số của Đối tượng. Người dùng được báo cáo trong đối tượng chứa họ trong phạm vi ngày của báo cáo. Hành vi hiện tại của người dùng không ảnh hưởng đến tư cách thành viên trước đây của đối tượng trong báo cáo.
audienceName Tên đối tượng Không Tên của một Đối tượng. Người dùng được báo cáo trong đối tượng chứa họ trong phạm vi ngày của báo cáo. Hành vi hiện tại của người dùng không ảnh hưởng đến tư cách thành viên trước đây của đối tượng trong báo cáo.
brandingInterest Sở thích Không Những mối quan tâm mà những người dùng ở phần cao hơn trong phễu mua sắm thể hiện. Người dùng có thể được tính trong nhiều danh mục mối quan tâm. Ví dụ: Shoppers, Lifestyles & Hobbies/Pet Lovers hoặc Travel/Travel Buffs/Beachbound Travelers.
browser Trình duyệt Các trình duyệt mà người dùng sử dụng để xem trang web của bạn.
campaignId Mã chiến dịch Không Giá trị nhận dạng của chiến dịch tiếp thị. Chỉ hiển thị cho sự kiện chuyển đổi.
campaignName Chiến dịch Không Tên của chiến dịch tiếp thị. Chỉ hiển thị cho sự kiện chuyển đổi.
ký tự Ký tự Nhân vật do người chơi điều khiển trong một trò chơi cho một sự kiện. Được điền sẵn bằng thông số sự kiện character.
thành phố Thành phố Thành phố bắt nguồn hoạt động của người dùng.
cityId Mã thành phố Mã địa lý của thành phố nơi hoạt động của người dùng bắt nguồn từ địa chỉ IP của người dùng.
nhóm thuần tập Nhóm thuần tập Không Tên của nhóm thuần tập trong yêu cầu. Nhóm thuần tập là một tập hợp gồm những người dùng đã bắt đầu sử dụng trang web hoặc ứng dụng của bạn trong bất kỳ nhóm ngày liên tiếp nào. Nếu tên nhóm thuần tập không được chỉ định trong yêu cầu, thì các nhóm thuần tập sẽ được đặt tên theo chỉ mục dựa trên 0, ví dụ: nhóm thuần tập_0, nhóm thuần tập 1.
cohortNthDay Nhóm thuần tập hàng ngày Không Mức chênh lệch ngày tương ứng với firstSessionDate cho người dùng trong nhóm thuần tập. Ví dụ: nếu một nhóm thuần tập được chọn có ngày bắt đầu và ngày kết thúc là 01/03/2020, thì đối với ngày 2020-03-02, nhóm thuần tập sẽ là 0001.
cohortNthMonth Nhóm thuần tập hàng tháng Không Chênh lệch tháng tương ứng với firstSessionDate cho người dùng trong nhóm thuần tập. Ranh giới tháng phù hợp với ranh giới tháng theo lịch. Ví dụ: nếu một nhóm thuần tập được chọn có ngày bắt đầu và ngày kết thúc là tháng 3 năm 2020, thì đối với bất kỳ ngày nào trong tháng 4 năm 2020, nhóm thuần tập NthMonth sẽ là 0001.
cohortNthWeek Nhóm thuần tập hàng tuần Không Mức chênh lệch tuần tương ứng với firstSessionDate cho người dùng trong nhóm thuần tập. Tuần bắt đầu vào Chủ Nhật và kết thúc vào thứ Bảy. Ví dụ: nếu một nhóm được chọn có ngày bắt đầu và ngày kết thúc trong khoảng từ 2020-11-08 đến 2020-11-14, thì đối với các ngày trong khoảng 2020-11-15 đến 2020-11-21, nhóm thuần tập NthWeek sẽ là 0001.
contentGroup Nhóm nội dung Một danh mục áp dụng cho các mục trong nội dung đã xuất bản. Được điền sẵn bằng thông số sự kiện content_group.
contentId Content ID Giá trị nhận dạng của nội dung đã chọn. Được điền sẵn bằng thông số sự kiện content_id.
contentType Loại nội dung Danh mục của nội dung đã chọn. Được điền sẵn bằng thông số sự kiện content_type.
country Quốc gia Quốc gia nơi bắt nguồn hoạt động của người dùng.
countryId Mã quốc gia Mã địa lý của quốc gia nơi hoạt động của người dùng bắt nguồn, bắt nguồn từ địa chỉ IP của người dùng. Được định dạng theo tiêu chuẩn ISO 3166-1 alpha-2.
date Ngày Ngày diễn ra sự kiện, có định dạng YYYYMMDD.
dateHour Ngày giờ (YYYYMMDDHH) Không Giá trị kết hợp của ngày và giờ có định dạng là YYYYMMDDHH.
dateHourMinute Ngày giờ và phút Không Giá trị kết hợp của ngày, giờ và phút có định dạng là YYYYMMDDHHMM.
ngày Ngày Ngày trong tháng – là một số có hai chữ số, từ 01 đến 31.
dayOfWeek Ngày trong tuần Ngày trong tuần. Phương thức này trả về các giá trị trong dải ô [0,6], trong đó Chủ Nhật là ngày đầu tiên của tuần.
defaultChannelGrouping Nhóm kênh mặc định Không Nhóm kênh mặc định của lượt chuyển đổi này chủ yếu dựa trên nguồn và phương tiện. Một bảng liệt kê bao gồm Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, VideoDisplay.
deviceCategory Danh mục thiết bị Loại thiết bị: Máy tính để bàn, Máy tính bảng hoặc Thiết bị di động.
deviceModel Mẫu thiết bị Mẫu thiết bị di động (ví dụ: iPhone 10,6).
eventName Tên sự kiện Tên của sự kiện.
fileExtension Đuôi tệp Đuôi của tệp đã tải xuống (ví dụ: pdf hoặc txt). Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện file_extension.
fileName Tên tệp Đường dẫn trang của tệp đã tải xuống (ví dụ: /menus/dinner-menu.pdf). Tự động điền nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện file_name.
firstSessionDate Ngày diễn ra phiên đầu tiên Ngày mà phiên đầu tiên của người dùng xảy ra, có định dạng là YYYYMMDD.
firstUserCampaignId Mã chiến dịch thu nạp người dùng lần đầu Không Giá trị nhận dạng của chiến dịch tiếp thị đầu tiên thu nạp được người dùng. Bao gồm cả các chiến dịch trên Google Ads.
firstUserCampaignName Chiến dịch có người dùng lần đầu Tên của chiến dịch tiếp thị đầu tiên thu nạp được người dùng. Bao gồm cả Google Ads và chiến dịch thủ công.
firstUserDefaultChannelGrouping Nhóm kênh mặc định có người dùng lần đầu Nhóm kênh mặc định đầu tiên thu nạp được người dùng. Nhóm kênh mặc định chủ yếu dựa trên nguồn và phương tiện. Một bảng liệt kê bao gồm Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, VideoDisplay.
firstUserGoogleAdsAccountName Tên tài khoản Google Ads của người dùng đầu tiên Không Tên tài khoản trên Google Ads đầu tiên thu nạp được người dùng.
firstUserGoogleAdsAdGroupId Mã nhóm quảng cáo trên Google Ads của người dùng đầu tiên Không Mã nhóm quảng cáo trong Google Ads đầu tiên thu nạp được người dùng.
firstUserGoogleAdsAdGroupName Tên nhóm quảng cáo trên Google Ads đầu tiên cho người dùng Không Tên nhóm quảng cáo trong Google Ads đầu tiên thu nạp được người dùng.
firstUserGoogleAdsAdNetworkType Loại mạng quảng cáo đầu tiên trên Google Ads của người dùng Mạng quảng cáo đầu tiên thu nạp được người dùng. Một bản liệt kê bao gồm Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social(universal campaign).
firstUserGoogleAdsCampaignType Loại chiến dịch trên Google Ads của người dùng lần đầu Không Loại chiến dịch của chiến dịch trên Google Ads đã thu nạp người dùng đầu tiên. Loại chiến dịch xác định nơi khách hàng nhìn thấy quảng cáo của bạn, các chế độ cài đặt và lựa chọn dành cho bạn trong Google Ads. Loại chiến dịch là một bản liệt kê, bao gồm: chiến dịch Tìm kiếm, chiến dịch Hiển thị, chiến dịch Mua sắm, chiến dịch Video, chiến dịch Khám phá, chiến dịch Quảng cáo ứng dụng, chiến dịch Thông minh, chiến dịch Khách sạn, chiến dịch Địa phương và chiến dịch Tối đa hoá hiệu suất. Để tìm hiểu thêm, hãy xem bài viết Chọn loại chiến dịch phù hợp.
firstUserGoogleAdsCreativeId ID mẫu quảng cáo trên Google Ads của người dùng đầu tiên Không Mã của mẫu quảng cáo trên Google Ads đầu tiên thu nạp được người dùng. Mã mẫu quảng cáo giúp xác định các quảng cáo riêng lẻ.
firstUserGoogleAdsCustomerId Mã khách hàng Google Ads của người dùng đầu tiên Không Mã khách hàng trên Google Ads đầu tiên thu nạp được người dùng. Mã khách hàng trong Google Ads được xác định duy nhất bằng các tài khoản Google Ads.
firstUserGoogleAdsKeyword Văn bản từ khóa Google Ads của người dùng đầu tiên Không Từ khoá phù hợp đầu tiên thu nạp được người dùng. Từ khoá là những từ hoặc cụm từ mô tả sản phẩm hoặc dịch vụ mà bạn chọn để hiển thị quảng cáo cho khách hàng phù hợp. Để tìm hiểu thêm về Từ khoá, hãy xem bài viết Từ khoá: Định nghĩa.
firstUserGoogleAdsQuery Truy vấn Google Ads của người dùng đầu tiên Không Cụm từ tìm kiếm đầu tiên thu nạp được người dùng.
firstUserManualAdContent Nội dung quảng cáo được tạo thủ công có người dùng lần đầu Nội dung quảng cáo đầu tiên thu nạp được người dùng. Được điền sẵn bằng thông số utm_content.
firstUserManualTerm Thời hạn được đặt thủ công có người dùng lần đầu Từ khoá đầu tiên thu nạp được người dùng. Được điền sẵn bằng thông số utm_term.
firstUserMedium Phương tiện có người dùng lần đầu Phương tiện đầu tiên thu nạp người dùng đến trang web hoặc ứng dụng của bạn.
firstUserSource Nguồn có người dùng lần đầu Nguồn đầu tiên thu nạp được người dùng cho trang web hoặc ứng dụng của bạn.
firstUserSourceMedium Nguồn/phương tiện có người dùng lần đầu Không Giá trị kết hợp của các phương diện firstUserSourcefirstUserMedium.
firstUserSourcePlatform Nền tảng nguồn có người dùng lần đầu Không Nền tảng nguồn đầu tiên thu nạp được người dùng. Đừng phụ thuộc vào trường này trả về Manual cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ trả về Manual thành (not set) trả về cho lần ra mắt tính năng sắp tới.
fullPageUrl URL đầy đủ của trang Không Tên máy chủ, đường dẫn trang và chuỗi truy vấn cho các trang web được truy cập; ví dụ: phần fullPageUrl của https://www.example.com/store/contact-us?query_string=truewww.example.com/store/contact-us?query_string=true.
funnelStepName Bước Không Tên mô tả được chỉ định cho bước phễu. Ví dụ: việc chỉ định name = Purchase trong bước phễu thứ ba trong yêu cầu sẽ tạo ra 3. Purchase cho phương diện funnelStepName này trong phản hồi báo cáo phễu.
funnelStepNewVsContinuing Mới so với hiện có Không Người dùng đang tiếp tục trong các bước phễu nếu họ đã có mặt ở bước trước đó trong phễu. Nếu không, người dùng đó là người dùng mới. Phương diện này chỉ có ý nghĩa cho phễu mở và trả về hai giá trị: newcontinuing.
funnelStepNextAction Hành động tiếp theo trong phễu Không Hành động tiếp theo là giá trị phương diện tiếp theo mà người dùng nhận được sau khi hoàn tất bước hiện tại (bao gồm cả việc hoàn tất bước tiếp theo). Ví dụ: nếu phương diện hành động tiếp theo được yêu cầu là eventName, thì phương diện này sẽ trả về tên của sự kiện tiếp theo sau khi đạt đến bước thứ i; hành động tiếp theo này không bao gồm sự kiện đã đạt được bước thứ i và bao gồm sự kiện đã đạt được bước thứ i+1.
googleAdsAccountName Tên tài khoản Google Ads Không Tên tài khoản trên Google Ads cho chiến dịch đã dẫn đến sự kiện chuyển đổi. Tương ứng với customer.descriptive_name trong API Google Ads.
googleAdsAdGroupId Mã nhóm quảng cáo trên Google Ads Không Mã nhóm quảng cáo được phân bổ cho sự kiện chuyển đổi.
googleAdsAdGroupName Tên nhóm quảng cáo trên Google Ads Không Tên nhóm quảng cáo được phân bổ cho sự kiện chuyển đổi.
googleAdsAdNetworkType Loại mạng quảng cáo trên Google Ads Không Loại mạng quảng cáo của lượt chuyển đổi. Một bản liệt kê bao gồm Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social(universal campaign).
googleAdsCampaignType Loại chiến dịch trên Google Ads Không Loại chiến dịch của chiến dịch trên Google Ads được phân bổ cho sự kiện chuyển đổi. Loại chiến dịch xác định nơi khách hàng nhìn thấy quảng cáo của bạn, các chế độ cài đặt và lựa chọn dành cho bạn trong Google Ads. Loại chiến dịch là một bản liệt kê, bao gồm: chiến dịch Tìm kiếm, chiến dịch Hiển thị, chiến dịch Mua sắm, chiến dịch Video, chiến dịch Khám phá, chiến dịch Quảng cáo ứng dụng, chiến dịch Thông minh, chiến dịch Khách sạn, chiến dịch Địa phương và chiến dịch Tối đa hoá hiệu suất. Để tìm hiểu thêm, hãy xem bài viết Chọn loại chiến dịch phù hợp.
googleAdsCreativeId ID quảng cáo Google Ads Không Mã của mẫu quảng cáo Google Ads được phân bổ cho sự kiện chuyển đổi. Mã mẫu quảng cáo giúp xác định các quảng cáo riêng lẻ.
googleAdsCustomerId Mã khách hàng Google Ads Không Mã khách hàng trên Google Ads cho chiến dịch đã dẫn đến sự kiện chuyển đổi. Mã khách hàng trong Google Ads được xác định duy nhất bằng các tài khoản Google Ads.
googleAdsKeyword Văn bản từ khoá trên Google Ads Không Từ khóa được so khớp đã dẫn đến sự kiện chuyển đổi. Từ khoá là những từ hoặc cụm từ mô tả sản phẩm hoặc dịch vụ mà bạn chọn để hiển thị quảng cáo cho khách hàng phù hợp. Để tìm hiểu thêm về Từ khoá, hãy xem bài viết Từ khoá: Định nghĩa.
googleAdsQuery Cụm từ tìm kiếm trên Google Ads Không Cụm từ tìm kiếm đã dẫn đến sự kiện chuyển đổi.
groupId Mã nhóm Mã nhóm người chơi trong một trò chơi cho một sự kiện. Được điền sẵn bằng thông số sự kiện group_id.
hostName Tên máy chủ Bao gồm cả miền con và tên miền của một URL; ví dụ: tên máy chủ của www.example.com/contact.html là www.example.com.
giờ Giờ Giờ dưới dạng hai chữ số trong ngày mà sự kiện được ghi lại. Phương diện này nằm trong khoảng từ 0 đến 23 và được báo cáo theo múi giờ của tài sản.
isConversionEvent Là sự kiện chuyển đổi Chuỗi true nếu sự kiện là lượt chuyển đổi. Các sự kiện được đánh dấu là lượt chuyển đổi tại thời điểm thu thập. Những thay đổi đối với cách đánh dấu lượt chuyển đổi của một sự kiện sẽ áp dụng từ thời điểm thay đổi trở đi. Bạn có thể đánh dấu bất kỳ sự kiện nào là lượt chuyển đổi trong Google Analytics và một số sự kiện (ví dụ: first_open, purchase) được đánh dấu là lượt chuyển đổi theo mặc định. Để tìm hiểu thêm, hãy xem bài viết Giới thiệu về lượt chuyển đổi.
itemAffiliation Đơn vị liên kết của mặt hàng Không Tên hoặc mã của đơn vị liên kết (đối tác/nhà cung cấp; nếu có) được liên kết với một mặt hàng riêng lẻ. Được điền sẵn bằng thông số mục affiliation.
itemBrand Thương hiệu của mặt hàng Không Tên thương hiệu của mặt hàng.
itemCategory Danh mục mặt hàng Không Danh mục phân cấp mà mặt hàng được phân loại. Ví dụ: Trong Trang phục/Nam/Mùa hè/Áo/Áo phông, thì Trang phục là danh mục mặt hàng.
itemCategory2 Danh mục mặt hàng 2 Không Danh mục phân cấp mà mặt hàng được phân loại. Ví dụ: Trong Trang phục/Nam/Mùa hè/Áo/Áo phông, thì Nam là danh mục mặt hàng 2.
itemCategory3 Danh mục mặt hàng 3 Không Danh mục phân cấp mà mặt hàng được phân loại. Ví dụ: Trong Trang phục/Nam/Mùa hè/Áo/Áo phông, thì Mùa hè là danh mục mặt hàng 3.
itemCategory4 Danh mục mặt hàng 4 Không Danh mục phân cấp mà mặt hàng được phân loại. Ví dụ: trong Trang phục/Nam/Mùa hè/Áo/Áo phông, thì Áo là danh mục mặt hàng 4.
itemCategory5 Danh mục mặt hàng 5 Không Danh mục phân cấp mà mặt hàng được phân loại. Ví dụ: trong Trang phục/Nam/Mùa hè/Áo/Áo phông, thì Áo phông là danh mục mặt hàng 5.
itemId Mã mặt hàng Không Mã của mặt hàng.
itemListId Mã danh sách mặt hàng Không Mã của danh sách mặt hàng.
itemListName Tên danh sách mặt hàng Không Tên của danh sách mặt hàng.
itemName Tên mặt hàng Không Tên mặt hàng.
itemPromotionCreativeName Tên mẫu quảng cáo trong chương trình khuyến mãi của mặt hàng Không Tên của mẫu quảng cáo quảng bá mặt hàng.
itemPromotionId Mã chương trình khuyến mãi của mặt hàng Không Mã của chương trình khuyến mãi mặt hàng.
itemPromotionName Tên chương trình khuyến mãi của mặt hàng Không Tên của chương trình khuyến mại cho mặt hàng.
itemVariant Biến thể của mặt hàng Không Biến thể cụ thể của một sản phẩm. Ví dụ: XS, S, M, L cho kích thước; hoặc Đỏ, Xanh dương, Xanh lục, Đen cho màu sắc. Được điền sẵn bằng thông số item_variant.
landingPage Trang đích Đường dẫn trang + chuỗi cụm từ tìm kiếm được liên kết với lượt xem trang đầu tiên trong một phiên hoạt động.
language Ngôn ngữ Chế độ cài đặt ngôn ngữ trên trình duyệt hoặc thiết bị của người dùng (ví dụ: tiếng Anh)
languageCode Mã ngôn ngữ Chế độ cài đặt ngôn ngữ (ISO 639) của trình duyệt hoặc thiết bị của người dùng. Ví dụ: en-us
cấp lần truy cập, Cấp Cấp của người chơi trong một trò chơi. Được điền sẵn bằng thông số sự kiện level.
linkClasses Các loại đường liên kết Thuộc tính lớp HTML cho một đường liên kết ra ngoài. Ví dụ: nếu người dùng nhấp vào đường liên kết <a class="center" href="www.youtube.com">, phương diện này sẽ trả về center. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện link_classes.
linkDomain Miền liên kết Miền đích của đường liên kết ra ngoài. Ví dụ: nếu người dùng nhấp vào đường liên kết <a href="www.youtube.com">, phương diện này sẽ trả về youtube.com. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện link_domain.
linkId Mã liên kết Thuộc tính mã HTML cho một đường liên kết ra ngoài hoặc tệp tải xuống. Ví dụ: nếu người dùng nhấp vào đường liên kết <a id="socialLinks" href="www.youtube.com">, phương diện này sẽ trả về socialLinks. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện link_id.
linkText Văn bản có đường liên kết Văn bản liên kết của tệp tải xuống. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện link_text.
linkUrl URL đường liên kết URL đầy đủ cho một đường liên kết ra ngoài hoặc tệp tải xuống. Ví dụ: nếu người dùng nhấp vào đường liên kết <a href="https://www.youtube.com/results?search_query=analytics">, phương diện này sẽ trả về https://www.youtube.com/results?search_query=analytics. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện link_url.
manualAdContent Nội dung quảng cáo được tạo thủ công Không Nội dung quảng cáo được phân bổ cho sự kiện chuyển đổi. Được điền sẵn bằng thông số utm_content.
manualTerm Thời hạn được đặt thủ công Không Cụm từ được phân bổ cho sự kiện chuyển đổi. Được điền sẵn bằng thông số utm_term.
trung bình Phương tiện Không Phương tiện đã phân bổ cho sự kiện chuyển đổi.
method Phương thức Phương thức kích hoạt một sự kiện. Được điền sẵn bằng thông số sự kiện method.
phút Phút Không Phút gồm hai chữ số trong giờ mà sự kiện được ghi lại. Phương diện này nằm trong khoảng từ 0 đến 59 và được báo cáo theo múi giờ của tài sản.
mobileDeviceBranding Thương hiệu của thiết bị Nhà sản xuất hoặc tên thương hiệu (ví dụ: Samsung, HTC, Verizon, T-Mobile).
mobileDeviceMarketingName Thiết bị Tên thiết bị mang thương hiệu (ví dụ: Galaxy S10 hoặc P30 Pro).
mobileDeviceModel Mẫu thiết bị di động Tên mẫu thiết bị di động (ví dụ: iPhone X hoặc SM-G950F).
tháng Tháng Tháng diễn ra sự kiện, là số nguyên hai chữ số từ 01 đến 12.
newVsReturning Mới/cũ Người dùng mới có 0 phiên hoạt động trước đây và người dùng cũ có 1 phiên hoạt động trở lên trước đây. Phương diện này trả về hai giá trị: new hoặc returning.
nthDay Ngày thứ n Không Số ngày kể từ khi bắt đầu phạm vi ngày.
nthHour Giờ thứ n Không Số giờ kể từ thời điểm bắt đầu phạm vi ngày. Giờ bắt đầu là 0000.
nthMinute Phút thứ n Không Số phút kể từ thời điểm bắt đầu phạm vi ngày. Phút bắt đầu là 0000.
nthMonth Tháng thứ n Không Số tháng kể từ khi bắt đầu phạm vi ngày. Tháng bắt đầu là 0000.
nthWeek Tuần thứ n Không Một số đại diện cho số tuần kể từ thời điểm bắt đầu một phạm vi ngày.
nthYear Năm thứ n Không Số năm kể từ khi bắt đầu phạm vi ngày. Năm bắt đầu là 0000.
operatingSystem Hệ điều hành Hệ điều hành mà khách truy cập đã dùng để truy cập vào ứng dụng hoặc trang web của bạn. Bao gồm các hệ điều hành dành cho máy tính và thiết bị di động, chẳng hạn như Windows và Android.
operatingSystemVersion Phiên bản hệ điều hành Các phiên bản hệ điều hành mà khách truy cập đã dùng để truy cập vào trang web hoặc ứng dụng của bạn. Ví dụ: phiên bản của Android 10 là 10 và phiên bản của iOS 13.5.1 là 13.5.1.
operatingSystemWithVersion Hệ điều hành kèm theo phiên bản Hệ điều hành và phiên bản. Ví dụ: Android 10 hoặc Windows 7.
orderCoupon Phiếu giảm giá cho đơn đặt hàng Mã cho phiếu giảm giá cấp đơn đặt hàng.
ngoài thành phố Đường liên kết dẫn ra ngoài Trả về true nếu đường liên kết dẫn đến một trang web không thuộc miền của tài sản. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện outbound.
pageLocation Vị trí trang Giao thức, tên máy chủ, đường dẫn trang và chuỗi truy vấn của các trang web được truy cập; ví dụ: phần pageLocation của https://www.example.com/store/contact-us?query_string=truehttps://www.example.com/store/contact-us?query_string=true. Được điền sẵn bằng thông số sự kiện page_location.
pagePath Đường dẫn trang Không Phần URL giữa tên máy chủ và chuỗi truy vấn đối với các trang web được truy cập; ví dụ: phần pagePath của https://www.example.com/store/contact-us?query_string=true/store/contact-us.
pagePathPlusQueryString Đường dẫn trang + chuỗi truy vấn Phần của URL đứng sau tên máy chủ cho các trang web được truy cập; ví dụ: phần pagePathPlusQueryString của https://www.example.com/store/contact-us?query_string=true/store/contact-us?query_string=true.
pageReferrer Đường liên kết giới thiệu trang URL giới thiệu đầy đủ, bao gồm cả tên máy chủ và đường dẫn. URL giới thiệu này là URL trước đây của người dùng và có thể là miền của trang web này hoặc các miền khác. Được điền sẵn bằng thông số sự kiện page_referrer.
pageTitle Tiêu đề trang Các tiêu đề trang web đã dùng trên trang web của bạn.
percentScrolled Tỷ lệ cuộn (theo phần trăm) Tỷ lệ phần trăm trên chiều dài trang mà người dùng đã cuộn xuống (ví dụ: 90). Tự động được điền nếu tính năng Đo lường nâng cao đang bật. Được điền sẵn bằng thông số sự kiện percent_scrolled.
platform Nền tảng Nền tảng mà ứng dụng hoặc trang web của bạn đã chạy; ví dụ: web, iOS hoặc Android. Để xác định loại luồng trong báo cáo, hãy sử dụng cả nền tảng và streamId.
platformDeviceCategory Danh mục nền tảng/thiết bị Nền tảng và loại thiết bị mà trang web hoặc ứng dụng di động của bạn chạy trên đó. (ví dụ: Android / thiết bị di động)
region Khu vực Khu vực địa lý nơi hoạt động của người dùng bắt nguồn từ địa chỉ IP của người dùng.
screenResolution Độ phân giải màn hình Độ phân giải màn hình của người dùng. Ví dụ: 1920x1080.
searchTerm Cụm từ tìm kiếm Cụm từ mà người dùng tìm kiếm. Ví dụ: nếu người dùng truy cập vào /some-page.html?q=some-term, phương diện này sẽ trả về some-term. Tự động điền sẵn nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện search_term.
phân khúc Phân khúc Không Phân đoạn là một nhóm nhỏ chứa dữ liệu Analytics của bạn. Ví dụ: một phân đoạn có thể bao gồm những người dùng đến từ một quốc gia hoặc thành phố cụ thể trong tổng số người dùng. Để tìm hiểu thêm, hãy xem bài viết Trình tạo phân đoạn. Phương diện phân khúc trả về tên được gán cho phân khúc trong yêu cầu với tiền tố dựa trên 1 (nghĩa là nếu phân khúc đầu tiên có tên là Paid Traffic trong yêu cầu thì phân khúc này sẽ là 1. Paid Traffic trong phản hồi). Nếu tên phân khúc không được chỉ định trong yêu cầu, thì tên phân khúc sẽ được đặt theo tên dựa trên 1 (tức là 1. Segment, 2. Segment, v.v.).
sessionCampaignId Mã chiến dịch của phiên hoạt động Không Mã chiến dịch tiếp thị của một phiên hoạt động. Bao gồm Chiến dịch thủ công và Chiến dịch từ các mối liên kết tích hợp như Google Ads và Search Ads 360.
sessionCampaignName Chiến dịch dẫn đến phiên Tên chiến dịch tiếp thị của một phiên hoạt động. Bao gồm Chiến dịch thủ công và Chiến dịch từ các mối liên kết tích hợp như Google Ads và Search Ads 360.
sessionDefaultChannelGrouping Nhóm kênh mặc định của phiên hoạt động Nhóm kênh mặc định của phiên hoạt động chủ yếu dựa trên nguồn và phương tiện. Một bảng liệt kê bao gồm Direct, Organic Search, Paid Social, Organic Social, Email, Affiliates, Referral, Paid Search, VideoDisplay.
sessionGoogleAdsAccountName Tên tài khoản Google Ads trong phiên Không Tên tài khoản trên Google Ads đã dẫn đến phiên. Tương ứng với customer.descriptive_name trong API Google Ads.
sessionGoogleAdsAdGroupId Mã nhóm quảng cáo trên Google Ads của phiên Không Mã nhóm quảng cáo trong Google Ads của một phiên hoạt động.
sessionGoogleAdsAdGroupName Tên nhóm quảng cáo trên Google Ads trong phiên Không Tên nhóm quảng cáo trong Google Ads của một phiên hoạt động.
sessionGoogleAdsAdNetworkType Loại mạng quảng cáo trên Google Ads trong phiên Mạng quảng cáo đã dẫn đến phiên. Một bản liệt kê bao gồm Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social(universal campaign).
sessionGoogleAdsCampaignType Loại chiến dịch trên Google Ads của phiên hoạt động Không Loại chiến dịch dành cho chiến dịch trên Google Ads đã dẫn đến phiên này. Loại chiến dịch xác định nơi khách hàng nhìn thấy quảng cáo của bạn, các chế độ cài đặt và lựa chọn dành cho bạn trong Google Ads. Loại chiến dịch là một bản liệt kê, bao gồm: chiến dịch Tìm kiếm, chiến dịch Hiển thị, chiến dịch Mua sắm, chiến dịch Video, chiến dịch Khám phá, chiến dịch Quảng cáo ứng dụng, chiến dịch Thông minh, chiến dịch Khách sạn, chiến dịch Địa phương và chiến dịch Tối đa hoá hiệu suất. Để tìm hiểu thêm, hãy xem bài viết Chọn loại chiến dịch phù hợp.
sessionGoogleAdsCreativeId ID mẫu quảng cáo trên Google Ads của phiên hoạt động Không Mã mẫu quảng cáo Google Ads dẫn đến một phiên trên trang web hoặc ứng dụng của bạn. Mã mẫu quảng cáo xác định từng quảng cáo riêng lẻ.
sessionGoogleAdsCustomerId Mã khách hàng Google Ads của phiên Không Mã khách hàng trên Google Ads đã dẫn đến phiên. Mã khách hàng trong Google Ads được xác định duy nhất bằng các tài khoản Google Ads.
sessionGoogleAdsKeyword Văn bản từ khoá trên Google Ads trong phiên Không Từ khoá khớp đã dẫn đến phiên. Từ khoá là những từ hoặc cụm từ mô tả sản phẩm hoặc dịch vụ mà bạn chọn để hiển thị quảng cáo cho khách hàng phù hợp. Để tìm hiểu thêm về Từ khoá, hãy xem bài viết [Từ khoá: Định nghĩa

](//support.google.com/google-ads/answer/6323). sessionGoogleAdsQuery | Cụm từ tìm kiếm trên Google Ads của phiên | Không | Cụm từ tìm kiếm đã dẫn đến phiên. sessionManualAdContent | Nội dung quảng cáo được tạo thủ công của phiên | Có | Nội dung quảng cáo đã dẫn đến một phiên. Được điền sẵn bằng thông số utm_content. sessionManualTerm | Thuật ngữ được đặt thủ công của phiên | Có | Cụm từ đã dẫn đến một phiên. Được điền sẵn bằng thông số utm_term. sessionMedium | Phương tiện của phiên | Có | Phương tiện đã bắt đầu một phiên trên trang web hoặc ứng dụng của bạn. phiênSa360AdGroupName | Tên nhóm quảng cáo trên SA360 | Không | Tên nhóm quảng cáo trên Search Ads 360 đã dẫn đến phiên này. phiênSa360CampaignName của phiên hoạt động | Không có | Tên phiên quảng cáo 360 cho mẫu quảng cáo này trong Search Ads360 Ví dụ: Responsive search ad hoặc Expanded text ad. Để tìm hiểu thêm, hãy xem bài viết Phương diện nguồn lưu lượng truy cập GA4. sessionSa360EngineAccountId | Mã tài khoản công cụ SA360 của phiên | Không | Mã của tài khoản công cụ trong SA360 đã dẫn đến phiên này. sessionSa360EngineAccountName | Tên tài khoản công cụ SA360 của phiên | Không | Tên tài khoản công cụ trong SA360 loại phiên này | Không có loại tài khoản Search Engine trong SA360phiên Ví dụ: google ads, bing hoặc baidu. sessionSa360Keyword | Văn bản từ khoá trên Search Ads 360 của phiên | Không | Từ khoá trên công cụ tìm kiếm trên Search Ads 360 đã dẫn đến phiên này. phiênSa360Medium | Phương tiện trên SA360 của phiên | Không | Từ khoá trên công cụ tìm kiếm trên Search Ads 360 đã dẫn đến phiên này. Ví dụ: cpc. sessionSa360Query | Cụm từ tìm kiếm trên SA360 của phiên | Không | Cụm từ tìm kiếm trên Search Ads 360 đã dẫn đến phiên này. sessionSa360Source | Nguồn trên SA360 của phiên | Không | Nguồn lưu lượng truy cập từ Search Ads 360 đã dẫn đến phiên này. Ví dụ: example.com hoặc google. sessionSource | Nguồn của phiên | Có | Nguồn đã bắt đầu một phiên trên trang web hoặc ứng dụng của bạn. sessionSourceMedium | Nguồn / phương tiện của phiên | Không | Giá trị kết hợp của phương diện sessionSourcesessionMedium. sessionSourcePlatform | Nền tảng nguồn của phiên | Không | Nền tảng nguồn của chiến dịch của phiên. Đừng phụ thuộc vào trường này trả về Manual cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ trả Manual thành (not set) trả về để ra mắt tính năng sắp tới. shippingTier | Cấp vận chuyển | Không | Cấp vận chuyển (ví dụ: Đường bộ, Hàng không, Ngày tiếp theo) được chọn để giao mặt hàng đã mua. Được điền sẵn bằng thông số sự kiện shipping_tier. signedInWithUserId | Đã đăng nhập bằng mã nhận dạng người dùng | Có | Chuỗi yes nếu người dùng đã đăng nhập bằng tính năng User-ID. Để tìm hiểu thêm về User-ID, hãy xem bài viết Đo lường hoạt động trên nhiều nền tảng bằng User-ID. nguồn | Nguồn | Không | Nguồn được phân bổ cho sự kiện chuyển đổi. sourceMedium | Nguồn / phương tiện | Không | Giá trị kết hợp của phương diện sourcemedium. sourcePlatform | Nền tảng nguồn | Không | Nền tảng nguồn của chiến dịch của sự kiện chuyển đổi. Đừng phụ thuộc vào trường này trả về Manual cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ trả về Manual thành trả về (not set) cho lần ra mắt tính năng sắp tới. streamId | Mã luồng | Có | Giá trị nhận dạng luồng dữ liệu dạng số cho ứng dụng hoặc trang web của bạn. streamName | Tên luồng | Có | Tên luồng dữ liệu cho ứng dụng hoặc trang web của bạn. testDataFilterName | Tên bộ lọc dữ liệu thử nghiệm | Không | Tên bộ lọc dữ liệu ở trạng thái thử nghiệm. Bạn sử dụng bộ lọc dữ liệu để thêm hoặc loại trừ dữ liệu sự kiện khỏi báo cáo của mình dựa trên các giá trị thông số sự kiện. Để tìm hiểu thêm, hãy xem phần Bộ lọc dữ liệu. transactionId | Mã giao dịch trên màn hình | Có | Có | Tên của giao dịch thương mại điện tử | Tên màn hình thống nhất hoặc Tên màn hình. Cóyoutube Được điền sẵn bằng thông số sự kiện video_provider. videoTitle | Tiêu đề video | Có | Tiêu đề của video. Hệ thống sẽ tự động điền sẵn dữ liệu cho các video được nhúng nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện video_title. videoUrl | URL của video | Có | URL của video. Hệ thống sẽ tự động điền sẵn dữ liệu cho các video được nhúng nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện video_url. VirtualcurrencyName | Tên loại tiền ảo | Có | Tên của loại tiền ảo mà người dùng đang tương tác. Ví dụ: chi tiêu hoặc mua ngọc trong trò chơi. Được điền sẵn bằng thông số sự kiện virtual_currency_name. hiển thị | Hiển thị | Có | Trả về true nếu nội dung hiển thị. Hệ thống sẽ tự động điền sẵn dữ liệu cho các video được nhúng nếu bạn bật tính năng Đo lường nâng cao. Được điền sẵn bằng thông số sự kiện visible. tuần | Tuần | Có | Tuần diễn ra sự kiện, số có hai chữ số từ 01 đến 53. Mỗi tuần bắt đầu vào Chủ Nhật. Ngày 1 tháng 1 luôn nằm trong tuần 01. Tuần đầu tiên và tuần cuối cùng của năm có ít hơn 7 ngày trong hầu hết các năm. Các tuần không phải tuần đầu tiên và tuần cuối cùng của năm luôn có 7 ngày. Đối với những năm mà ngày 1 tháng 1 là Chủ Nhật, thì tuần đầu tiên của năm đó và tuần cuối cùng của năm trước sẽ có 7 ngày. năm | Năm | Có | Năm gồm bốn chữ số của sự kiện, chẳng hạn như năm 2020.

Phương diện tuỳ chỉnh

Data API có thể tạo báo cáo về Phương diện tuỳ chỉnh ở phạm vi sự kiện và người dùng. Xem bài viết Báo cáo về phương diện và chỉ số tuỳ chỉnh trong phạm vi sự kiệnThuộc tính người dùng tuỳ chỉnh để tìm hiểu thêm về phương diện tuỳ chỉnh. Phương diện tuỳ chỉnh được chỉ định trong yêu cầu báo cáo API theo tên và phạm vi của thông số. Ví dụ: đưa "customEvent:achievement_id" vào yêu cầu API dữ liệu để tạo báo cáo cho Phương diện tuỳ chỉnh ở phạm vi sự kiện có tên thông số là "achievement_id". Yêu cầu API này sẽ không thành công nếu tài sản chưa đăng ký Phương diện tuỳ chỉnh ở phạm vi sự kiện này.

Nếu đăng ký một Phương diện tuỳ chỉnh ở phạm vi sự kiện trước tháng 10 năm 2020, thì bạn phải chỉ định phương diện đó trong yêu cầu API kèm theo tên sự kiện. Ví dụ: thêm "customEvent:achievement_id\[level_up\]" cho Phương diện tuỳ chỉnh ở phạm vi sự kiện có tên thông số "achievement_id" và tên sự kiện "level_up". Vào tháng 10 năm 2020, Analytics đã thay thế Báo cáo thông số tuỳ chỉnh bằng báo cáo chỉ số và phương diện tuỳ chỉnh trong phạm vi sự kiện.

Sau đây là cú pháp chung cho Phương diện tuỳ chỉnh. Bạn có thể truy vấn phương thức API siêu dữ liệu để liệt kê tất cả các Phương diện tuỳ chỉnh cho một thuộc tính. Sau đây là ví dụ về cách sử dụng phương thức API siêu dữ liệu.

Tên API chung Có sẵn trong Phân khúc Nội dung mô tả
customEvent:parameter_name Phương diện tùy chỉnh ở phạm vi sự kiện cho parameter_name
customEvent:parameter_name[event_name] Phương diện tuỳ chỉnh ở phạm vi sự kiện cho parameter_name nếu được đăng ký trước tháng 10 năm 2020
customUser:parameter_name Phương diện tùy chỉnh trong phạm vi người dùng cho parameter_name

Nhóm kênh tuỳ chỉnh

Data API có thể tạo báo cáo về Nhóm kênh tuỳ chỉnh. Để tìm hiểu thêm về Nhóm kênh tuỳ chỉnh, hãy xem bài viết Nhóm kênh tuỳ chỉnh trong GA4. Nhóm kênh tuỳ chỉnh được chỉ định trong yêu cầu báo cáo API theo phạm vi của phương diện và mã nhóm kênh. Ví dụ: đưa "sessionCustomChannelGroup:9432931" vào yêu cầu Data API để tạo báo cáo cho Kênh tuỳ chỉnh trong phạm vi phiên hoạt động có mã nhận dạng là 9432931. Yêu cầu API này sẽ không thành công nếu tài sản không có kênh tuỳ chỉnh có mã nhận dạng này.

Sau đây là cú pháp chung cho Nhóm kênh tuỳ chỉnh. Bạn có thể truy vấn phương thức API siêu dữ liệu để liệt kê tất cả các Nhóm kênh tuỳ chỉnh cho một thuộc tính.

Tên API chung Nội dung mô tả
sessionCustomChannelGroup:custom_channel_id Kênh tuỳ chỉnh dẫn đến phiên này.
firstUserCustomChannelGroup:custom_channel_id Kênh tuỳ chỉnh đầu tiên thu nạp được người dùng này.
customChannelGroup:custom_channel_id Kênh tuỳ chỉnh đã dẫn đến sự kiện chuyển đổi.

Chỉ số

Những chỉ số sau có thể xuất hiện trong báo cáo phễu cho bất kỳ tài sản nào.

Tên API Tên giao diện người dùng Nội dung mô tả
activeUsers Số người dùng đang hoạt động Số người dùng riêng biệt đã truy cập vào trang web hoặc ứng dụng của bạn.
funnelStepAbandonmentRate Tỷ lệ bỏ ngang Tỷ lệ phần trăm người dùng bỏ qua phễu ở bước này. Chỉ số này được trả về dưới dạng phân số; ví dụ: 0,412 có nghĩa là 41,2% người dùng đã bỏ ngang phễu ở bước này.
funnelStepAbandonments Số lần bỏ qua Số lượng người dùng tuyệt đối bỏ qua phễu ở bước này.
funnelStepCompletionRate Tỷ lệ xem hết Tỷ lệ phần trăm người dùng hoàn thành bước này trong phễu. Chỉ số này được trả về dưới dạng số thập phân; ví dụ: 0,588 có nghĩa là 58,8% người dùng đã hoàn thành bước phễu này.