Google Ads API cung cấp một số chế độ xem để phân tích vị trí quảng cáo của bạn đã xuất hiện và hiệu suất của quảng cáo:
managed_placement_view,
group_placement_view,
detail_placement_view và
performance_max_placement_view. Mỗi chế độ xem cung cấp một
góc nhìn khác nhau về dữ liệu vị trí của bạn. Để biết các truy vấn Ngôn ngữ truy vấn Google Ads (GAQL) và curl sẵn sàng chạy, sao chép màn hình vị trí trong giao diện người dùng Google Ads, hãy xem Sách hướng dẫn truy vấn.
Chế độ xem vị trí được quản lý
- Nội dung: Tài nguyên
managed_placement_viewcung cấp dữ liệu hiệu suất được tổng hợp theo tiêu chí vị trí tích cực mà bạn nhắm đến trong các nhóm quảng cáo của mình. Chế độ xem này bao gồm tất cả 5 loại tiêu chí được quản lý trong mục Nội dung > Vị trí trong giao diện người dùng Google Ads: trang web, kênh YouTube, video trên YouTube, ứng dụng di động và danh mục ứng dụng di động. - Tương đương trên giao diện người dùng: Nội dung > Vị trí
- Trình tạo truy vấn: Khám phá trong Trình tạo truy vấn
Loại tiêu chí vị trí được nhắm mục tiêu
Mỗi hàng trong tài nguyên managed_placement_view sẽ điền vào trường AdGroupCriterion khớp với giá trị ad_group_criterion.type của hàng đó và không đặt các trường vị trí khác:
| Loại vị trí giao diện người dùng | Giá trị ad_group_criterion.type |
Trường thông tin chi tiết về tiêu chí | Ghi chú |
|---|---|---|---|
| Trang web | PLACEMENT |
ad_group_criterion.placement.url |
URL của trang web hoặc miền mục tiêu. |
| Kênh YouTube | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
Mã nhận dạng kênh YouTube. Trường ad_group_criterion.display_name trả về tên kênh. |
| Video trên YouTube | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
Mã video trên YouTube. Trường ad_group_criterion.display_name trả về tiêu đề video. |
| Quảng cáo ứng dụng | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
Mã ứng dụng ở định dạng {platform}-{platform_native_id} (1- cho iOS, 2- cho Android) và tên ứng dụng. |
| Danh mục ứng dụng | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
Tên tài nguyên ở định dạng mobileAppCategoryConstants/{mobile_app_category_id}. Xem Tên và hệ thống phân cấp danh mục ứng dụng di động. |
Cụm từ tìm kiếm ví dụ
Để tìm nạp chỉ số hiệu suất trên tất cả các loại vị trí được nhắm mục tiêu trong 30 ngày qua, hãy chọn trường ad_group_criterion.type cùng với các trường theo loại cụ thể:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Tên và hệ thống phân cấp danh mục ứng dụng di động
Trong giao diện người dùng Google Ads, các danh mục ứng dụng di động được nhắm mục tiêu sẽ hiển thị đường dẫn đầy đủ đến cửa hàng ứng dụng, chẳng hạn như Danh mục ứng dụng > Apple App Store > Giáo dục. Khi truy vấn API Google Ads, hãy lưu ý những hành vi sau:
- Hằng số danh mục ứng dụng di động phân bổ: Tài nguyên
mobile_app_category_constantkhông phải là tài nguyên được phân bổ của tài nguyênmanaged_placement_view. Thay vào đó, hãy chọn trườngad_group_criterion.mobile_app_category.mobile_app_category_constant(ví dụ:mobileAppCategoryConstants/60503) hoặc truy vấn tài nguyênad_group_criterionkhi bạn không cần chỉ số. - Tên hiển thị chỉ có danh mục con: Cả hai trường
ad_group_criterion.display_namevàmobile_app_category_constant.namechỉ trả về tên danh mục con, chẳng hạn như"Education"hoặc"Games". Cả hai trường đều không bao gồm đường dẫn cửa hàng ứng dụng mẹ. - Giải quyết đường dẫn cửa hàng ứng dụng: Google Play và Apple App Store chia sẻ tên danh mục lá trên các mã tiêu chí riêng biệt. Ví dụ: mã tiêu chí
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education) và60503(/All Apps/Apple App Store/Education) đều trả về"Education"trong các trườngnamevàdisplay_name. Trích xuất hậu tố{mobile_app_category_id}từ tên tài nguyên và tra cứu đường dẫn phân cấp đầy đủ của hậu tố đó trong bảng hoặc tệp CSV Danh mục ứng dụng di động.
Chế độ xem vị trí nhóm
- Nội dung: Tài nguyên
group_placement_viewcho biết nơi quảng cáo của bạn thực sự được phân phát trên Mạng Hiển thị và YouTube, bất kể vị trí đó được nhắm mục tiêu rõ ràng hay được hệ thống của Google tự động phát hiện. Vị trí có thể là trang web, kênh hoặc video trên YouTube và ứng dụng. - Tương đương trong giao diện người dùng: Nội dung > Nơi quảng cáo được hiển thị
- Trình tạo truy vấn: Khám phá trong Trình tạo truy vấn
Cụm từ tìm kiếm ví dụ
Truy vấn sau đây tìm nạp các chỉ số hiệu suất cho miền, ứng dụng di động và kênh YouTube nơi quảng cáo được hiển thị trong 30 ngày qua:
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
Hàng "Tổng: Khác"
Để đẩy nhanh quá trình tạo báo cáo, các tài nguyên group_placement_view và detail_placement_view sẽ loại trừ những vị trí riêng lẻ không đáp ứng ngưỡng hoạt động tối thiểu về số lượt hiển thị hoặc số lượt tương tác.
- Trong giao diện người dùng Google Ads: Giao diện người dùng tổng hợp các vị trí không đáp ứng ngưỡng hoạt động này vào một hàng tóm tắt có nhãn Tổng cộng: Khác.
- Trong Google Ads API: API này sẽ bỏ qua những vị trí không đáp ứng ngưỡng hoạt động trong kết quả báo cáo và không trả về hàng tóm tắt có trường
group_placement_view.placementhoặcdetail_placement_view.placementmang giá trị"Other".
Do đó, tổng số hàng vị trí riêng lẻ trong tài nguyên group_placement_view và detail_placement_view có thể thấp hơn tổng số liệu cho nhóm quảng cáo hoặc chiến dịch. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về báo cáo "Nơi quảng cáo được hiển thị". Để biết thông tin chi tiết về mức độ ảnh hưởng của ngưỡng và siêu dữ liệu bị thiếu đến việc so sánh giữa các chế độ xem, hãy xem bài viết Sự khác biệt về chỉ số giữa các chế độ xem vị trí và Các hàng có thông tin chi tiết về vị trí không có sẵn.
Cài đặt nhắm mục tiêu theo vị trí
Hành vi và tiện ích của
group_placement_view chịu ảnh hưởng của
TargetingSetting cho phương diện PLACEMENT
ở cấp nhóm quảng cáo. Chế độ cài đặt này chứa danh sách
target_restrictions, mỗi chế độ cài đặt có một trường boolean
bid_only cho biết quảng cáo của bạn chỉ hiển thị trên các vị trí được nhắm mục tiêu hay trên
các vị trí khác. Xem bài viết Giới thiệu về chế độ cài đặt "Nhắm mục tiêu" và "Quan sát".
bid_only = false: Giá trị này tương ứng với Nhắm mục tiêu trong giao diện người dùng Google Ads cho vị trí. Nếu nhóm quảng cáo của bạn được đặt thành "Nhắm mục tiêu", thì quảng cáo của bạn chỉ xuất hiện ở những vị trí mà bạn đã thêm rõ ràng làm tiêu chí. Bạn có thể chọn áp dụng mức điều chỉnh giá thầu cho những vị trí này. Trong trường hợp này,group_placement_viewphần lớn phản ánhmanaged_placement_view, nhưng vẫn phải tuân theo ngưỡng hoạt động tối thiểu.bid_only = true: Giá trị này tương ứng với Quan sát trong giao diện người dùng Google Ads cho vị trí. Nếu nhóm quảng cáo của bạn được đặt thành "Quan sát", thì quảng cáo của bạn có thể xuất hiện ở bất kỳ vị trí đủ điều kiện nào trên Mạng Hiển thị và YouTube. Bạn cũng có thể áp dụng mức điều chỉnh giá thầu cho bất kỳ vị trí nào mà bạn đã nhắm đến. Trong trường hợp này,group_placement_viewlà yếu tố quan trọng để khám phá những vị trí mới mà quảng cáo của bạn đang xuất hiện, sau đó bạn có thể chọn thêm những vị trí này làm vị trí được quản lý hoặc tiêu chí loại trừ.
Chế độ xem vị trí chi tiết
- Nội dung: Tài nguyên
detail_placement_viewcung cấp thông tin chi tiết hơn về vị trí, cung cấp thông tin chi tiết ngoài cấp miền hoặc cấp kênh. Ví dụ: báo cáo này có thể cho biết các URL hoặc mã video cụ thể trên YouTube nơi quảng cáo của bạn xuất hiện. - Tương đương trong giao diện người dùng: Tương đương với việc chọn các hàng trong mục Nội dung > Nơi quảng cáo xuất hiện, sau đó nhấp vào Xem chi tiết.
- Trình tạo truy vấn: Khám phá trong Trình tạo truy vấn
- Những điểm quan trọng cần lưu ý: Tương tự như tài nguyên
group_placement_view, chế độ xem này bỏ qua những vị trí có mức độ hoạt động thấp không đáp ứng ngưỡng hoạt động tối thiểu (xem phần hàng "Tổng: Khác").
Cụm từ tìm kiếm ví dụ
Để giới hạn số lượng kết quả, truy vấn sau đây sẽ tìm nạp các chỉ số vị trí ở cấp URL và cấp video trong khoảng thời gian 7 ngày. Đối với các tài khoản lớn, hãy lọc thêm theo trường campaign.id hoặc ad_group.id:
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
Để loại trừ những hàng không có siêu dữ liệu về vị trí, hãy thêm AND
detail_placement_view.target_url IS NOT NULL (xem phần Hàng không có thông tin chi tiết về vị trí). Khi bạn không cần
trả về các trường resource_name, hãy thêm mệnh đề PARAMETERS
omit_unselected_resource_names = true.
Sự khác biệt về chỉ số giữa các chế độ xem vị trí
Ngưỡng hoạt động tối thiểu được đánh giá độc lập ở từng cấp độ chi tiết:
- Tài nguyên
group_placement_viewđánh giá ngưỡng trên miền, ứng dụng di động hoặc kênh YouTube tổng hợp. - Tài nguyên
detail_placement_viewđánh giá ngưỡng riêng biệt cho từng URL trang hoặc video trên YouTube.
Tài nguyên detail_placement_view bỏ qua các URL trang riêng lẻ hoặc video trên YouTube không đáp ứng ngưỡng. Do đó, việc tính tổng các hàng detail_placement_view cho một miền hoặc kênh YouTube (được lọc theo trường detail_placement_view.group_placement_target_url) có thể trả về ít lượt hiển thị hơn so với hàng group_placement_view tương ứng.
Các hàng có thông tin chi tiết về Place Details không có sẵn
Một truy vấn đối với tài nguyên group_placement_view hoặc detail_placement_view có thể trả về nhiều hàng trong cùng một nhóm quảng cáo có các trường placement, display_name và target_url chưa được đặt và giá trị resource_name giống hệt nhau (ví dụ: kết thúc bằng ~MTRf).
Hành vi này xảy ra vì những lý do sau:
- Nhóm vị trí nội bộ: Cả hai chế độ xem đều nhóm các chỉ số hiệu suất theo một giá trị nhận dạng vị trí nội bộ duy nhất thay vì theo các trường chuỗi
resource_namehoặcplacement. - Siêu dữ liệu vị trí không có sẵn: Trong giao diện người dùng Google Ads, những vị trí không có siêu dữ liệu trong bảng tìm kiếm phụ trợ sẽ xuất hiện dưới dạng Không xác định, Kênh không còn hoạt động hoặc Video không còn hoạt động. Trong API, mỗi giá trị nhận dạng vị trí riêng biệt vẫn trả về một hàng chỉ số, trong đó các trường
placement,display_namevàtarget_urlkhông được đặt. - Tên tài nguyên tổng hợp: Hậu tố
{base64_placement}trong trườngresource_nameđược mã hoá Base64 từ{type_id}_{placement}, trong đó{type_id}là giá trị nhận dạng loại vị trí nội bộ chứ không phải số enumPlacementType. Khi trườngplacement_typelàWEBSITE(mã nhận dạng nội bộ14) và trườngplacementkhông được đặt, chuỗi"14_"sẽ mã hoá thànhMTRf(tương tự,MOBILE_APPLICATIONmã hoá"55_"thànhNTVf,YOUTUBE_VIDEOmã hoá"89_"thànhODlfvàYOUTUBE_CHANNELmã hoá"90_"thànhOTBf). Do đó, nhiều vị trí cùng loại có siêu dữ liệu không có sẵn trong cùng một nhóm quảng cáo sẽ có cùng giá trịresource_nametrong khi báo cáo các hàng chỉ số riêng biệt.
Khi xử lý kết quả group_placement_view hoặc detail_placement_view trong mã ứng dụng, đừng chỉ loại bỏ các hàng trùng lặp theo trường resource_name, vì việc này có thể ghi đè các chỉ số trên những vị trí riêng biệt có siêu dữ liệu không có sẵn.
Để loại trừ các hàng có siêu dữ liệu không có sẵn trong GAQL, hãy lọc theo trường target_url hoặc display_name, vì bạn không thể lọc theo trường placement và resource_name. Ví dụ: sử dụng WHERE group_placement_view.target_url IS
NOT NULL hoặc WHERE detail_placement_view.target_url IS NOT NULL.
Chế độ xem vị trí của chiến dịch Tối đa hoá hiệu suất
- Nội dung: Tài nguyên
performance_max_placement_viewcung cấp dữ liệu về lượt hiển thị (metrics.impressions) cho những vị trí mà quảng cáo Tối đa hoá hiệu suất đã phân phát. Trong phiên bản 24 trở lên, bạn có thể phân đoạnperformance_max_placement_viewtheosegments.ad_network_type(không được hỗ trợ trong phiên bản 23). - Tương đương trên giao diện người dùng: Thông tin chi tiết và báo cáo > Trình chỉnh sửa báo cáo > Vị trí của các chiến dịch Tối đa hoá hiệu suất
- Trình tạo truy vấn: Khám phá trong Trình tạo truy vấn
Cụm từ tìm kiếm ví dụ
Truy vấn sau đây tìm nạp số lượt hiển thị vị trí được phân đoạn theo loại mạng quảng cáo cho chiến dịch Tối đa hoá hiệu suất trong 30 ngày qua:
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
Chọn một chế độ xem vị trí đặt quảng cáo
- Sử dụng
managed_placement_viewđể đánh giá hiệu suất của những vị trí mà bạn đang nhắm mục tiêu và đặt giá thầu. - Sử dụng
group_placement_viewđể hiểu rõ toàn bộ phạm vi nơi quảng cáo của bạn xuất hiện, đặc biệt là khi sử dụng chế độ cài đặt "Quan sát", để khám phá các cơ hội nhắm mục tiêu hoặc tiêu chí loại trừ mới. - Sử dụng
detail_placement_viewđể xem thông tin chi tiết nhất về những URL hoặc video cụ thể mà quảng cáo của bạn đã xuất hiện, thường được dùng sau khi xác định một miền hoặc kênh mà bạn quan tâm tronggroup_placement_view. - Sử dụng
performance_max_placement_viewđể kiểm tra số lượt hiển thị của vị trí cho chiến dịch Tối đa hoá hiệu suất.