Tổng quan
Các trang này liệt kê những tài nguyên có thể được truy vấn trong API bằng cách sử dụng SearchAds360Service.SearchStream hoặc SearchAds360Service.Search. Tên tài nguyên được liên kết với trang riêng của tài nguyên đó. Trên mỗi trang, các danh sách sau sẽ xuất hiện:
- Cấu phần phần mềm (tài nguyên, phân khúc hoặc chỉ số) có thể được dùng trong cùng một mệnh đề SELECT với tài nguyên
- Những tài nguyên được phân bổ có các trường sẽ không phân đoạn chỉ số, khi được đưa vào cùng một mệnh đề SELECT và WHERE của các trường tài nguyên này
Sau các danh sách đó là các bảng bao gồm tên của các trường tài nguyên, phân đoạn và chỉ số có thể được đưa vào cụm từ tìm kiếm, khi tài nguyên này được chỉ định trong mệnh đề FROM. Mỗi tên được liên kết với bảng chứa siêu dữ liệu của tên đó:
categorydata typetype URLfilterableselectablesortablerepeated
- Có thể lọc
- Hàng này cho biết liệu trường có thể được dùng trong các điều kiện của mệnh đề
WHEREcủa truy vấn hay không. - Có thể chọn
- Hàng này cho biết liệu bạn có thể chỉ định trường trong mệnh đề
SELECTcủa truy vấn hay không. - Sortable
- Hàng này cho biết liệu trường có thể được sắp xếp và sử dụng trong mệnh đề
ORDER BYcủa truy vấn hay không. - Trường
- Hàng này cho biết trường có lặp lại hay không, trường này phải được xử lý dưới dạng danh sách.
Danh sách tất cả tài nguyên
| Loại tài nguyên | |
|---|---|
| accessible_bidding_strategy | Biểu thị một chế độ xem về BiddingStrategies thuộc sở hữu của khách hàng và được chia sẻ với khách hàng. Trái ngược với BiddingStrategy, tài nguyên này bao gồm các chiến lược do người quản lý của khách hàng sở hữu và chia sẻ với khách hàng này, ngoài các chiến lược do khách hàng này sở hữu. Tài nguyên này không cung cấp chỉ số và chỉ hiển thị một nhóm nhỏ các thuộc tính BiddingStrategy. |
| ad_group | Một nhóm quảng cáo. |
| ad_group_ad | Quảng cáo trong nhóm quảng cáo. |
| ad_group_ad_effective_label | Mối quan hệ giữa quảng cáo trong nhóm quảng cáo và nhãn hiệu quả. Nhãn có hiệu lực là nhãn được kế thừa hoặc được chỉ định trực tiếp cho quảng cáo trong nhóm quảng cáo này. |
| ad_group_ad_label | Mối quan hệ giữa quảng cáo trong nhóm quảng cáo và nhãn. |
| ad_group_asset | Mối liên kết giữa một nhóm quảng cáo và một thành phần. |
| ad_group_asset_set | AdGroupAssetSet là mối liên kết giữa một nhóm quảng cáo và một bộ thành phần. Việc tạo AdGroupAssetSet sẽ liên kết một bộ thành phần với một nhóm quảng cáo. |
| ad_group_audience_view | Chế độ xem đối tượng của nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ danh sách mối quan tâm và danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và Mạng YouTube, cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp ở cấp đối tượng. |
| ad_group_bid_modifier | Đại diện cho hệ số điều chỉnh giá thầu nhóm quảng cáo. |
| ad_group_criterion | Tiêu chí nhóm quảng cáo. Báo cáo ad_group_criterion chỉ trả về những tiêu chí đã được thêm rõ ràng vào nhóm quảng cáo. |
| ad_group_criterion_effective_label | Mối quan hệ giữa một tiêu chí của nhóm quảng cáo và một nhãn hiệu lực. Nhãn có hiệu lực là nhãn được kế thừa hoặc được chỉ định trực tiếp cho tiêu chí nhóm quảng cáo này. |
| ad_group_criterion_label | Mối quan hệ giữa một tiêu chí của nhóm quảng cáo và một nhãn. |
| ad_group_effective_label | Mối quan hệ giữa một nhóm quảng cáo và một nhãn hiệu lực. Nhãn có hiệu lực là nhãn được kế thừa hoặc được chỉ định trực tiếp cho nhóm quảng cáo này. |
| ad_group_label | Mối quan hệ giữa một nhóm quảng cáo và một nhãn. |
| age_range_view | Chế độ xem nhóm tuổi. Đại diện cho chế độ xem chỉ số hiệu suất của khách hàng (như số lượt hiển thị và số lượt nhấp) được tổng hợp theo nhóm tuổi. Tất cả số liệu thống kê đều được tổng hợp ở cấp nhóm quảng cáo. Lưu ý: Mặc dù bạn có thể phân đoạn các chỉ số theo nhóm tuổi bằng age_range_view hoặc theo giới tính bằng gender_view, nhưng Search Ads 360 API không hỗ trợ phân đoạn các chỉ số theo cả nhóm tuổi và giới tính cùng một lúc trong một truy vấn. Search Ads 360 API không hỗ trợ việc phân tích hiệu suất trên cả hai phương diện kết hợp. |
| thành phần | Thành phần là một phần của quảng cáo và có thể được dùng chung cho nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YoutubeVideoAsset), v.v. Thành phần là không thể thay đổi và không thể xoá. Để ngừng phân phát một thành phần, hãy xoá thành phần đó khỏi thực thể đang sử dụng thành phần đó. |
| asset_group | Một nhóm thành phần. AssetGroupAsset được dùng để liên kết một thành phần với nhóm thành phần. AssetGroupSignal được dùng để liên kết một tín hiệu với một nhóm thành phần. |
| asset_group_asset | AssetGroupAsset là mối liên kết giữa một thành phần và một nhóm thành phần. Việc thêm AssetGroupAsset sẽ liên kết một thành phần với một nhóm thành phần. |
| asset_group_listing_group_filter | AssetGroupListingGroupFilter đại diện cho một nút cây bộ lọc nhóm trang thông tin trong một nhóm thành phần. |
| asset_group_signal | AssetGroupSignal đại diện cho một tín hiệu trong một nhóm thành phần. Sự tồn tại của tín hiệu cho chiến dịch Tối đa hoá hiệu suất biết ai có nhiều khả năng chuyển đổi nhất. Chiến dịch Tối đa hoá hiệu suất sử dụng tín hiệu để tìm những người dùng mới có ý định tương tự hoặc rõ ràng hơn nhằm thu hút các lượt chuyển đổi trên Mạng Tìm kiếm, Mạng Hiển thị, Video, v.v. |
| asset_group_top_combination_view | Một chế độ xem về mức sử dụng các kiểu kết hợp thành phần hàng đầu của nhóm thành phần. |
| asset_set | Một bộ thành phần đại diện cho một tập hợp các thành phần. Sử dụng AssetSetAsset để liên kết một thành phần với bộ thành phần. |
| asset_set_asset | AssetSetAsset là mối liên kết giữa một thành phần và một bộ thành phần. Việc thêm AssetSetAsset sẽ liên kết một thành phần với một bộ thành phần. |
| đối tượng | Đối tượng là một lựa chọn nhắm mục tiêu hiệu quả, cho phép bạn kết hợp các thuộc tính phân khúc (chẳng hạn như thông tin chi tiết về nhân khẩu học và đối tượng chung sở thích) để tạo ra những đối tượng thể hiện các phần trong phân khúc mục tiêu của bạn. |
| bidding_strategy | Chiến lược đặt giá thầu. |
| chiến dịch | Chiến dịch. |
| campaign_asset | Mối liên kết giữa một Chiến dịch và một Thành phần. |
| campaign_asset_set | CampaignAssetSet là mối liên kết giữa một chiến dịch và một bộ thành phần. Việc thêm CampaignAssetSet sẽ liên kết một bộ thành phần với một chiến dịch. |
| campaign_audience_view | Chế độ xem đối tượng của chiến dịch. Bao gồm dữ liệu hiệu suất từ danh sách mối quan tâm và danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và Mạng YouTube, cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo chiến dịch và tiêu chí đối tượng. Chế độ xem này chỉ bao gồm những đối tượng được đính kèm ở cấp chiến dịch. |
| campaign_budget | Ngân sách chiến dịch. |
| campaign_criterion | Tiêu chí chiến dịch. |
| campaign_effective_label | Biểu thị mối quan hệ giữa một chiến dịch và một nhãn hiệu quả. Nhãn có hiệu lực là nhãn được kế thừa hoặc được chỉ định trực tiếp cho chiến dịch này. |
| campaign_label | Đại diện cho mối quan hệ giữa một chiến dịch và một nhãn. |
| cart_data_sales_view | Chế độ xem doanh số dữ liệu giỏ hàng. Cung cấp thông tin về những sản phẩm đã được mua nếu bạn triển khai tính năng lượt chuyển đổi có dữ liệu giỏ hàng. Các chỉ số hiệu suất như doanh thu, lợi nhuận gộp, chỉ số về khách hàng tiềm năng/bán kèm, v.v. và các thuộc tính trong Merchant Center như thương hiệu, danh mục, v.v. được cung cấp cho những sản phẩm được xác định trong nguồn cấp dữ liệu kho hàng và được bán nhờ quảng cáo do Google phân phát. Đối với các giao dịch mua được phân bổ cho lượt nhấp vào quảng cáo Mua sắm, bạn có thể xem cùng lúc các phương diện của cả sản phẩm được nhấp vào và sản phẩm đã bán. |
| lượt chuyển đổi | Lượt chuyển đổi. |
| conversion_action | Một hành động chuyển đổi. |
| conversion_custom_variable | Biến tuỳ chỉnh lượt chuyển đổi. Xem bài viết "Giới thiệu về các chỉ số và phương diện Floodlight tuỳ chỉnh trong Search Ads 360 mới" tại https://support.google.com/sa360/answer/13567857 |
| khách hàng | Một khách hàng. |
| customer_asset | Mối liên kết giữa khách hàng và thành phần. |
| customer_asset_set | CustomerAssetSet là mối liên kết giữa một khách hàng và một bộ thành phần. Việc thêm CustomerAssetSet sẽ liên kết một bộ thành phần với một khách hàng. |
| customer_client | Mối liên kết giữa khách hàng đã cho và khách hàng của khách hàng. CustomerClients chỉ tồn tại cho khách hàng là người quản lý. Tất cả khách hàng trực tiếp và gián tiếp của khách hàng đều được bao gồm, cũng như chính người quản lý. |
| customer_manager_link | Biểu thị mối quan hệ liên kết giữa khách hàng và người quản lý. |
| dynamic_search_ads_search_term_view | Chế độ xem cụm từ tìm kiếm cho quảng cáo tìm kiếm động. |
| gender_view | Tài nguyên chế độ xem giới tính. Đại diện cho chế độ xem các chỉ số hiệu suất của khách hàng được tổng hợp theo giới tính. Tất cả số liệu thống kê đều được tổng hợp ở cấp nhóm quảng cáo. Lưu ý: Mặc dù bạn có thể phân đoạn các chỉ số theo nhóm tuổi bằng age_range_view hoặc theo giới tính bằng gender_view, nhưng Search Ads 360 API không hỗ trợ phân đoạn các chỉ số theo cả nhóm tuổi và giới tính cùng một lúc trong một truy vấn. Search Ads 360 API không hỗ trợ việc phân tích hiệu suất trên cả hai phương diện kết hợp. |
| geo_target_constant | Hằng số mục tiêu địa lý. |
| keyword_view | Chế độ xem từ khoá. |
| label | Nhãn. |
| language_constant | Một ngôn ngữ. |
| location_view | Chế độ xem vị trí tóm tắt hiệu suất của chiến dịch theo tiêu chí Vị trí. |
| product_bidding_category_constant | Danh mục đặt giá thầu cho sản phẩm. |
| product_group_view | Chế độ xem nhóm sản phẩm. |
| shopping_performance_view | Chế độ xem hiệu suất mua sắm. Cung cấp số liệu thống kê về chiến dịch Mua sắm và chiến dịch Tối đa hoá hiệu suất được tổng hợp ở một số cấp phương diện sản phẩm. Các giá trị phương diện sản phẩm trong Merchant Center như thương hiệu, danh mục, thuộc tính tùy chỉnh, tình trạng sản phẩm và loại sản phẩm sẽ phản ánh trạng thái của từng phương diện kể từ ngày và giờ mà sự kiện tương ứng được ghi lại. Số lượt hiển thị và số lượt nhấp mà shopping_performance_view trả về số liệu thống kê có thể khác với báo cáo chiến dịch. shopping_performance_view cho biết số lượt hiển thị và số lượt nhấp vào sản phẩm xuất hiện trong quảng cáo, còn báo cáo chiến dịch cho biết số lượt hiển thị và số lượt nhấp vào chính quảng cáo đó. Tuỳ thuộc vào định dạng, một quảng cáo có thể hiển thị từ 0 đến nhiều sản phẩm, nên các con số có thể không khớp. Trong giao diện người dùng Search Ads 360, bạn có thể truy vấn số lượt hiển thị và số lượt nhấp của các sản phẩm xuất hiện trong quảng cáo bằng cách chọn một cột trong mục "Thuộc tính sản phẩm" trong trình chỉnh sửa báo cáo. Ví dụ: việc chọn cột "Thương hiệu" tương đương với việc chọn segments.product_brand. |
| user_list | Danh sách người dùng. Đây là danh sách người dùng mà khách hàng có thể nhắm đến. Khoá duy nhất của danh sách người dùng bao gồm các trường sau: id. Xin lưu ý rằng name cũng phải là duy nhất cho danh sách người dùng thuộc sở hữu của một khách hàng nhất định, ngoại trừ một số trường hợp access_reason được đặt thành SHARED. Việc vi phạm quy tắc ràng buộc về tên duy nhất sẽ gây ra lỗi: UserListError.INVALID_NAME. |
| user_location_view | Chế độ xem vị trí của người dùng. Chế độ xem vị trí của người dùng bao gồm tất cả các chỉ số được tổng hợp ở cấp quốc gia, mỗi hàng cho một quốc gia. Báo cáo này cho biết các chỉ số báo cáo tại vị trí thực tế của người dùng theo vị trí được nhắm mục tiêu hoặc không được nhắm mục tiêu. Nếu sử dụng các trường phân đoạn khác, bạn có thể nhận được nhiều hàng cho mỗi quốc gia. |
| truy cập | Một lượt truy cập. |
| webpage_view | Một lượt xem trang web. |