GoogleAdsFieldService là một công cụ mạnh mẽ trong Google Ads API, cho phép bạn truy xuất danh mục các tài nguyên, trường, phân đoạn và chỉ số có sẵn. Bằng cách sử dụng dịch vụ này, bạn có thể xác thực các trường truy vấn và xây dựng các lệnh trong Ngôn ngữ truy vấn Google Ads một cách chính xác và hiệu quả. Bài viết này sẽ hướng dẫn bạn cách gửi yêu cầu và xử lý phản hồi từ GoogleAdsFieldService để truy xuất siêu dữ liệu quan trọng phục vụ cho việc tối ưu hóa chiến dịch quảng cáo.
Bạn có thể sử dụng GoogleAdsFieldService để truy vấn danh mục các tài nguyên, trường tài nguyên, phân đoạn và chỉ số có sẵn trong các phương thức Search và SearchStream của GoogleAdsService. Dịch vụ này cung cấp siêu dữ liệu mà các nhà phát triển sử dụng API Google Ads có thể dùng để xác thực và xây dựng truy vấn theo Ngôn ngữ truy vấn Google Ads một cách chính xác.
Yêu cầu và phản hồi HTTP mẫu
Lưu ý: Mặc dù ví dụ này chỉ đưa ra yêu cầu HTTP/JSON cơ bản, bạn nên sử dụng một trong các thư viện ứng dụng dựa trên gRPC để gửi yêu cầu.
Yêu cầu HTTP GET được gửi đến máy chủ API Google Ads qua URL sau:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
Dưới đây là một ví dụ về yêu cầu và phản hồi từ GoogleAdsFieldService cho tài nguyên ad_group:
Yêu cầu
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
Phản hồi
{
"resourceName": "googleAdsFields/ad_group",
"name": "ad_group",
"category": "RESOURCE",
"selectable": false,
"filterable": false,
"sortable": false,
"selectableWith": [
"campaign",
"customer",
"metrics.average_cpc",
"segments.device"
],
"attributeResources": [
"customer",
"campaign"
],
"metrics": [
"metrics.conversions",
"metrics.search_budget_lost_impression_share",
"metrics.average_cost",
"metrics.clicks"
],
"segments": [
"segments.date",
"segments.ad_network_type",
"segments.device"
]
}
Trong ví dụ này, các mảng quan trọng là:
- attributeResources: Các tài nguyên liên kết ngầm với tài nguyên trong mệnh đề FROM.
- metrics: Các chỉ số có thể được chọn cùng tài nguyên trong mệnh đề FROM. Chúng chỉ được điền cho các trường có category là RESOURCE.
- segments: Các khoá phân đoạn có thể được chọn với tài nguyên trong mệnh đề FROM. Các phân đoạn này dùng để phân tích các chỉ số được chỉ định trong truy vấn. Chỉ điền cho các trường thuộc category là RESOURCE.
- selectableWith: Các trường có thể được chọn cùng với trường hiện tại khi không nằm trong mệnh đề FROM. Ví dụ, nếu bạn chọn ad_group.id và segments.date từ ad_group, và muốn thêm các thuộc tính từ campaign, bạn cần kiểm tra xem segments.date có nằm trong selectableWith của campaign không để đảm bảo rằng trường này có thể được chọn cùng với trường hiện tại.
Thông tin chi tiết về siêu dữ liệu
Bạn có thể sử dụng GoogleAdsFieldService để yêu cầu danh mục siêu dữ liệu ở các cấp sau:
- Tài nguyên: Các tài nguyên chính trong Google Ads API.
- Ví dụ:
googleAdsFields/campaign.
- Ví dụ:
- Trường tài nguyên: Các thuộc tính cụ thể trong một tài nguyên.
- Ví dụ:
googleAdsFields/campaign.name.
- Ví dụ:
- Trường phân đoạn: Các phân đoạn được sử dụng để phân tích dữ liệu theo các tiêu chí cụ thể.
- Ví dụ:
googleAdsFields/segments.ad_network_type.
- Ví dụ:
- Chỉ số: Các chỉ số đo lường hiệu suất và kết quả của chiến dịch.
- Ví dụ:
googleAdsFields/metrics.clicks.
- Ví dụ:
Việc sử dụng GoogleAdsFieldService giúp bạn truy xuất và hiểu rõ các siêu dữ liệu liên quan đến tài nguyên, phân đoạn và chỉ số trong Google Ads. Điều này không chỉ hỗ trợ bạn xây dựng các truy vấn mạnh mẽ và chính xác mà còn tối ưu hóa chiến dịch quảng cáo của bạn. Để khai thác tối đa tiềm năng của Google Ads API, hãy đảm bảo rằng bạn sử dụng GoogleAdsFieldService một cách hiệu quả trong việc xác thực và truy xuất dữ liệu.
