Truy vấn sổ tay nấu ăn

Hướng dẫn này cung cấp các truy vấn Ngôn ngữ truy vấn Google Ads (GAQL) trả về cùng một dữ liệu như màn hình giao diện người dùng Google Ads phổ biến và tra cứu hằng số địa lý. Hãy sử dụng các truy vấn này mà không cần sửa đổi hoặc điều chỉnh cho phù hợp với quy trình báo cáo của bạn.

Để biết thông tin chi tiết hơn về việc liên kết báo cáo trên giao diện người dùng với tài nguyên API, hãy xem bài viết Báo cáo trong giao diện người dùng Google Ads. Sử dụng Tiện ích báo cáo API Google Ads để kiểm tra các tài nguyên và trường API trong giao diện người dùng Google Ads. Sử dụng Trình tạo truy vấn tương tác để tạo và xác thực các truy vấn tuỳ chỉnh.

Đặt biến môi trường curl

Các thẻ curl gửi yêu cầu truyền trực tuyến nén đến điểm cuối searchStream REST. Trước khi chạy lệnh curl, hãy đặt các biến môi trường sau trong shell:

• API_VERSION: Số phiên bản API không có v ở đầu (ví dụ: 26).
• CUSTOMER_ID: Mã khách hàng của khách hàng mục tiêu gồm 10 chữ số, không có dấu gạch nối.
• MANAGER_CUSTOMER_ID: Mã tài khoản người quản lý gồm 10 chữ số không có dấu gạch nối. Nếu bạn xác thực trực tiếp với tư cách là tài khoản khách hàng mục tiêu, hãy đặt MANAGER_CUSTOMER_ID thành CUSTOMER_ID hoặc bỏ qua tiêu đề login-customer-id (xem Mã khách hàng đăng nhập).
• OAUTH2_ACCESS_TOKEN: Mã truy cập OAuth 2.0 hợp lệ.

Sao chép màn hình giao diện người dùng Google Ads

Phần này trình bày các truy vấn API trả về cùng một dữ liệu với màn hình mặc định của giao diện người dùng Google Ads. Nếu bạn đang xây dựng một ứng dụng cho thấy các chỉ số và dữ liệu tương tự như Google Ads, thì những truy vấn này có thể giúp bạn lấy dữ liệu tương tự từ API.

Lưu ý: Trừ phi có quy định khác, tất cả truy vấn có ngày trong hướng dẫn này đều mặc định trả về dữ liệu của 7 ngày gần nhất. Nếu thanh không gian làm việc trong giao diện người dùng Google Ads loại trừ các thực thể mẹ đã bị xoá, hãy thêm AND campaign.status != 'REMOVED' hoặc AND ad_group.status != 'REMOVED' vào truy vấn thực thể con.

Mẹo: Để bỏ qua các trường resource_name không dùng đến và thu nhỏ tải trọng searchStream, hãy thêm mệnh đề PARAMETERS omit_unselected_resource_names = true (xem tham số omit_unselected_resource_names).

Chiến dịch

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Chiến dịch trong giao diện người dùng Google Ads.

GAQL

SELECT campaign.name,
  campaign_budget.amount_micros,
  campaign.status,
  campaign.optimization_score,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.bidding_strategy_type
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
  AND campaign.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT campaign.name,
      campaign_budget.amount_micros,
      campaign.status,
      campaign.optimization_score,
      campaign.advertising_channel_type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.bidding_strategy_type
    FROM campaign
    WHERE segments.date DURING LAST_7_DAYS
      AND campaign.status != 'REMOVED'
  "
}
EOF

Nhóm quảng cáo

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Nhóm quảng cáo trong giao diện người dùng Google Ads.

GAQL

SELECT ad_group.name,
  campaign.name,
  ad_group.status,
  ad_group.type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group.name,
      campaign.name,
      ad_group.status,
      ad_group.type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM ad_group
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group.status != 'REMOVED'
  "
}
EOF

Quảng cáo

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Quảng cáo trong giao diện người dùng Google Ads. Truy vấn này tìm nạp dòng tiêu đề và nội dung mô tả của quảng cáo tìm kiếm thích ứng AdTextAsset, URL cuối cùng và độ mạnh của quảng cáo cho các cột Quảng cáo và Độ mạnh của quảng cáo.

Lưu ý: Những quảng cáo không bị xoá thuộc các loại khác vẫn xuất hiện khi trường responsive_search_ad chưa được đặt. Để hạn chế kết quả cho quảng cáo tìm kiếm thích ứng, hãy thêm AND ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' vào mệnh đề WHERE.

GAQL

SELECT ad_group_ad.ad.responsive_search_ad.headlines,
  ad_group_ad.ad.responsive_search_ad.descriptions,
  ad_group_ad.ad.final_urls,
  campaign.name,
  ad_group.name,
  ad_group_ad.status,
  ad_group_ad.policy_summary.approval_status,
  ad_group_ad.ad.type,
  ad_group_ad.ad_strength,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group_ad
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_ad.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_ad.ad.responsive_search_ad.headlines,
      ad_group_ad.ad.responsive_search_ad.descriptions,
      ad_group_ad.ad.final_urls,
      campaign.name,
      ad_group.name,
      ad_group_ad.status,
      ad_group_ad.policy_summary.approval_status,
      ad_group_ad.ad.type,
      ad_group_ad.ad_strength,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM ad_group_ad
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_ad.status != 'REMOVED'
  "
}
EOF

Từ khoá cho quảng cáo trên Mạng Tìm kiếm

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Từ khoá cho quảng cáo trên Mạng Tìm kiếm trong giao diện người dùng Google Ads.

GAQL

SELECT ad_group_criterion.keyword.text,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.keyword.match_type,
  ad_group_criterion.approval_status,
  ad_group_criterion.final_urls,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM keyword_view
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_criterion.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.keyword.text,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.keyword.match_type,
      ad_group_criterion.approval_status,
      ad_group_criterion.final_urls,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM keyword_view
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_criterion.status != 'REMOVED'
  "
}
EOF

Cụm từ tìm kiếm

Truy xuất dữ liệu từ màn hình tổng quan Cụm từ tìm kiếm mặc định trong giao diện người dùng Google Ads.

Lưu ý: Tài nguyên search_term_view tổng hợp ở cấp nhóm quảng cáo và không bao gồm chiến dịch Tối đa hoá hiệu suất. Đối với cụm từ tìm kiếm trong chiến dịch Tối đa hoá hiệu suất, hãy truy vấn tài nguyên campaign_search_term_view (xem phần Hiệu suất của cụm từ tìm kiếm).

GAQL

SELECT search_term_view.search_term,
  segments.keyword.info.match_type,
  search_term_view.status,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM search_term_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT search_term_view.search_term,
      segments.keyword.info.match_type,
      search_term_view.status,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM search_term_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Đối tượng

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Đối tượng trong giao diện người dùng Google Ads.

Lưu ý quan trọng: API báo cáo trả về đối tượng theo mã tiêu chí của họ. Để lấy tên hiển thị của các mã này, hãy tra cứu mã nhận dạng trong bảng tham chiếu được cung cấp trên trang Mã và định dạng. Bạn có thể dựa vào trường ad_group_criterion.type để xác định bảng loại tiêu chí cần sử dụng.

GAQL

SELECT ad_group_criterion.resource_name,
  ad_group_criterion.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM ad_group_audience_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.resource_name,
      ad_group_criterion.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM ad_group_audience_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Độ tuổi (Nhân khẩu học)

Truy xuất dữ liệu từ màn hình tổng quan về thông tin nhân khẩu học Tuổi mặc định trong giao diện người dùng Google Ads.

GAQL

SELECT ad_group_criterion.age_range.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM age_range_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.age_range.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM age_range_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Giới tính (Nhân khẩu học)

Truy xuất dữ liệu từ màn hình tổng quan về thông tin nhân khẩu học mặc định theo Giới tính trong giao diện người dùng Google Ads.

GAQL

SELECT ad_group_criterion.gender.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM gender_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.gender.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM gender_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Địa điểm

Truy xuất dữ liệu từ màn hình tổng quan mặc định về Vị trí trong giao diện người dùng Google Ads.

Lưu ý quan trọng: API báo cáo trả về các vị trí theo mã tiêu chí. Để lấy tên hiển thị của các vị trí này, hãy tra cứu trường campaign_criterion.location.geo_target_constant trong dữ liệu mục tiêu địa lý hoặc sử dụng API để truy vấn tài nguyên geo_target_constant. Đối với vị trí thực tế hoặc vị trí mà người dùng quan tâm trong mục Vị trí > Báo cáo địa lý, hãy truy vấn tài nguyên geographic_view.

GAQL

SELECT campaign_criterion.location.geo_target_constant,
  campaign.name,
  campaign_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM location_view
WHERE segments.date DURING LAST_7_DAYS
  AND campaign_criterion.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT campaign_criterion.location.geo_target_constant,
      campaign.name,
      campaign_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM location_view
    WHERE segments.date DURING LAST_7_DAYS
      AND campaign_criterion.status != 'REMOVED'
  "
}
EOF

Vị trí

Truy xuất dữ liệu cho các vị trí được nhắm mục tiêu rõ ràng trên màn hình Nội dung > Vị trí trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên managed_placement_view.

Lưu ý quan trọng: Để chọn giữa các tài nguyên managed_placement_view, group_placement_view, detail_placement_view và performance_max_placement_view, hãy xem bài viết Theo dõi vị trí đặt quảng cáo và hiệu suất.

GAQL

SELECT ad_group_criterion.placement.url,
  campaign.name,
  ad_group.name,
  ad_group_criterion.status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_criterion.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.placement.url,
      campaign.name,
      ad_group.name,
      ad_group_criterion.status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM managed_placement_view
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_criterion.status != 'REMOVED'
  "
}
EOF

Vị trí hiển thị quảng cáo

Truy xuất dữ liệu vị trí của miền, ứng dụng di động và kênh YouTube từ màn hình Nội dung > Nơi quảng cáo được hiển thị trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên group_placement_view.

Lưu ý: API này bỏ qua những vị trí không đáp ứng ngưỡng hoạt động tối thiểu thay vì trả về hàng tóm tắt Tổng cộng: Khác của giao diện người dùng. Xem Hàng "Tổng cộng: Khác" và Hàng có thông tin chi tiết về vị trí không có sẵn.

GAQL

SELECT group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT group_placement_view.display_name,
      group_placement_view.target_url,
      group_placement_view.placement_type,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM group_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Chi tiết vị trí

Truy xuất các chỉ số vị trí ở cấp URL và cấp video trong mục Nội dung > Vị trí hiển thị quảng cáo > Xem chi tiết trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên detail_placement_view.

Lưu ý: Vì tài nguyên detail_placement_view đánh giá ngưỡng hoạt động theo từng URL hoặc video, nên tổng số hàng của tài nguyên này có thể thấp hơn tổng số hàng của group_placement_view. 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 không có thông tin chi tiết về vị trí.

GAQL

SELECT detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT detail_placement_view.display_name,
      detail_placement_view.target_url,
      detail_placement_view.group_placement_target_url,
      detail_placement_view.placement_type,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM detail_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Vị trí của chiến dịch Tối đa hoá hiệu suất

Truy xuất số lượt hiển thị của vị trí từ báo cáo tạo sẵn Vị trí của các chiến dịch Tối đa hoá hiệu suất trong mục Thông tin chi tiết và báo cáo > Trình chỉnh sửa báo cáo bằng cách truy vấn tài nguyên performance_max_placement_view.

Lưu ý: Tài nguyên performance_max_placement_view chỉ hiển thị chỉ số metrics.impressions. Trong phiên bản 24 trở lên, hãy thêm trường segments.ad_network_type để phân đoạn số lượt hiển thị theo mạng (xem Chế độ xem vị trí của chiến dịch Tối đa hoá hiệu suất).

GAQL

SELECT performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  campaign.name,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT performance_max_placement_view.display_name,
      performance_max_placement_view.target_url,
      performance_max_placement_view.placement_type,
      campaign.name,
      metrics.impressions
    FROM performance_max_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Trang đích

Truy xuất dữ liệu từ màn hình Trang đích mặc định trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên landing_page_view.

Lưu ý: Tài nguyên campaign và ad_group phân đoạn các chỉ số landing_page_view, và việc chọn các trường ad_group sẽ loại trừ chiến dịch Tối đa hoá hiệu suất. Đối với tổng số URL ở cấp tài khoản, hãy bỏ qua trường campaign.name. Đối với các URL sau khi thay thế ValueTrack và mở rộng URL cuối cùng, hãy truy vấn tài nguyên expanded_landing_page_view.

GAQL

SELECT landing_page_view.unexpanded_final_url,
  campaign.name,
  metrics.mobile_friendly_clicks_percentage,
  metrics.speed_score,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM landing_page_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT landing_page_view.unexpanded_final_url,
      campaign.name,
      metrics.mobile_friendly_clicks_percentage,
      metrics.speed_score,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM landing_page_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Nhóm thành phần

Truy xuất dữ liệu từ màn hình Nhóm thành phần cho chiến dịch Tối đa hoá hiệu suất trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên asset_group.

GAQL

SELECT asset_group.name,
  campaign.name,
  asset_group.status,
  asset_group.ad_strength,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.conversions
FROM asset_group
WHERE segments.date DURING LAST_7_DAYS
  AND asset_group.status != 'REMOVED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT asset_group.name,
      campaign.name,
      asset_group.status,
      asset_group.ad_strength,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      metrics.conversions
    FROM asset_group
    WHERE segments.date DURING LAST_7_DAYS
      AND asset_group.status != 'REMOVED'
  "
}
EOF

Sản phẩm

Truy xuất các chỉ số ở cấp sản phẩm trên màn hình Sản phẩm cho chiến dịch Mua sắm và chiến dịch Tối đa hoá hiệu suất trong giao diện người dùng Google Ads bằng cách truy vấn tài nguyên shopping_performance_view.

Lưu ý: Khi báo cáo về chiến dịch Tối đa hoá hiệu suất, đừng chọn các trường ad_group vì tài nguyên ad_group sẽ phân đoạn các chỉ số shopping_performance_view và loại trừ các hàng của chiến dịch Tối đa hoá hiệu suất. Để phân biệt các mặt hàng trên nhiều nguồn cấp dữ liệu, hãy thêm các trường segments.product_merchant_id, segments.product_channel, segments.product_language và segments.product_feed_label. Để kiểm tra điều kiện hiện tại của sản phẩm, các vấn đề chẩn đoán hoặc kho hàng không có lượt hiển thị, hãy truy vấn tài nguyên shopping_product (xem phần Báo cáo về sản phẩm cho quảng cáo Mua sắm).

GAQL

SELECT segments.product_item_id,
  segments.product_title,
  segments.product_brand,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_7_DAYS

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT segments.product_item_id,
      segments.product_title,
      segments.product_brand,
      campaign.name,
      campaign.advertising_channel_type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      metrics.conversions
    FROM shopping_performance_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

Tra cứu hằng số địa lý

Trang Mã và định dạng cung cấp các bảng tham chiếu cho hầu hết hằng số được dùng trong API. Tuy nhiên, bạn cũng có thể tra cứu linh động một số hằng số bằng Ngôn ngữ truy vấn của Google Ads.

Mẫu này cho biết cách tra cứu một vị trí theo tên tài nguyên hoặc tên hiển thị của vị trí đó.

Theo tên tài nguyên

Tra cứu Mountain View, CA theo tên tài nguyên geoTargetConstants/1014044.

GAQL

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT geo_target_constant.canonical_name,
      geo_target_constant.country_code,
      geo_target_constant.id,
      geo_target_constant.name,
      geo_target_constant.status,
      geo_target_constant.target_type
    FROM geo_target_constant
    WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'
  "
}
EOF

Theo tên hiển thị

Tra cứu "Mountain View" dưới dạng tên thành phố ở Hoa Kỳ.

Lưu ý: Khi truy vấn vị trí theo tên, bạn có thể sẽ nhận được nhiều kết quả trùng khớp. Lọc theo geo_target_constant.country_code, geo_target_constant.target_type và geo_target_constant.status, đồng thời kiểm tra geo_target_constant.canonical_name để phân biệt danh sách kết quả trong mã ứng dụng khách.

GAQL

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.country_code = 'US'
  AND geo_target_constant.target_type = 'City'
  AND geo_target_constant.name = 'Mountain View'
  AND geo_target_constant.status = 'ENABLED'

curl

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT geo_target_constant.canonical_name,
      geo_target_constant.country_code,
      geo_target_constant.id,
      geo_target_constant.name,
      geo_target_constant.status,
      geo_target_constant.target_type
    FROM geo_target_constant
    WHERE geo_target_constant.country_code = 'US'
      AND geo_target_constant.target_type = 'City'
      AND geo_target_constant.name = 'Mountain View'
      AND geo_target_constant.status = 'ENABLED'
  "
}
EOF