Cookbook kueri

Panduan ini menyediakan kueri Bahasa Kueri Google Ads (GAQL) yang menampilkan data yang sama dengan layar UI Google Ads umum dan mencari konstanta geografis. Gunakan kueri ini tanpa modifikasi atau sesuaikan untuk alur kerja pelaporan Anda.

Untuk pemetaan laporan UI yang lebih luas ke resource API, lihat Laporan di UI Google Ads. Gunakan Ekstensi Pelaporan Google Ads API untuk memeriksa resource dan kolom API di UI Google Ads. Gunakan Pembuat Kueri Interaktif untuk membuat dan memvalidasi kueri kustom.

Menetapkan variabel lingkungan curl

Tab curl mengirimkan permintaan streaming terkompresi ke endpoint REST searchStream. Sebelum menjalankan perintah curl, tetapkan variabel lingkungan berikut di shell Anda:

• API_VERSION: Nomor versi API tanpa awalan v (misalnya, 26).
• CUSTOMER_ID: ID pelanggan klien target 10 digit tanpa tanda hubung.
• MANAGER_CUSTOMER_ID: ID akun pengelola 10 digit tanpa tanda hubung. Jika Anda melakukan autentikasi langsung sebagai akun klien target, tetapkan MANAGER_CUSTOMER_ID ke CUSTOMER_ID atau hapus header login-customer-id (lihat ID pelanggan login).
• OAUTH2_ACCESS_TOKEN: Token akses OAuth 2.0 yang valid.

Mereplikasi layar UI Google Ads

Bagian ini menampilkan kueri API yang menampilkan data yang sama dengan layar default UI Google Ads. Jika Anda membuat aplikasi yang menampilkan metrik dan data yang mirip dengan Google Ads, kueri ini dapat membantu Anda mengambil data yang serupa dari API.

Catatan: Kecuali jika dinyatakan lain, semua kueri bertanggal dalam panduan ini secara default menampilkan data dari tujuh hari terakhir. Jika panel ruang kerja UI Google Ads Anda mengecualikan entitas induk yang dihapus, tambahkan AND campaign.status != 'REMOVED' atau AND ad_group.status != 'REMOVED' ke kueri entitas turunan.

Tips: Untuk menghilangkan kolom resource_name yang tidak digunakan dan memperkecil payload searchStream, tambahkan klausa PARAMETERS omit_unselected_resource_names = true (lihat parameter omit_unselected_resource_names).

Kampanye

Ambil data dari layar ringkasan Kampanye default di UI 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

Grup iklan

Ambil data dari layar ringkasan Grup iklan default di UI 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

Iklan

Ambil data dari layar ringkasan Iklan default di UI Google Ads. Kueri ini mengambil judul dan deskripsi AdTextAsset iklan penelusuran responsif, URL final, dan Daya Iklan untuk kolom Ad dan Ad strength.

Catatan: Iklan jenis lain yang tidak dihapus masih muncul dengan kolom responsive_search_ad yang tidak ditetapkan. Untuk membatasi hasil pada iklan penelusuran responsif, tambahkan AND ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' ke klausa 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

Kata kunci penelusuran

Ambil data dari layar ringkasan Kata kunci penelusuran default di UI 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

Istilah penelusuran

Ambil data dari layar ringkasan Istilah penelusuran default di UI Google Ads.

Catatan: Resource search_term_view digabungkan di tingkat grup iklan dan tidak menyertakan kampanye Performa Maksimal. Untuk istilah penelusuran Performa Maksimal, buat kueri resource campaign_search_term_view (lihat Performa istilah penelusuran).

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

Audiens

Ambil data dari layar ringkasan Audiens default di UI Google Ads.

Poin Penting: Reporting API menampilkan audiens berdasarkan ID kriterianya. Untuk mendapatkan nama tampilannya, cari ID di tabel referensi yang disediakan di halaman Kode dan format. Anda dapat menggunakan kolom ad_group_criterion.type untuk menentukan tabel jenis kriteria yang akan digunakan.

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

Usia (Demografi)

Ambil data dari layar ringkasan demografi Usia default di UI 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

Gender (Demografi)

Ambil data dari layar ringkasan demografi Gender default di UI 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

Lokasi

Ambil data dari layar ringkasan Lokasi default di UI Google Ads.

Poin Penting: Reporting API menampilkan lokasi berdasarkan ID kriterianya. Untuk mendapatkan nama tampilan, cari kolom campaign_criterion.location.geo_target_constant di data target geografis, atau gunakan API untuk mengkueri resource geo_target_constant. Untuk lokasi fisik atau minat pengguna dari Locations > Geographic report, buat kueri resource 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

Penempatan

Ambil data untuk penempatan yang ditargetkan secara eksplisit dari layar Konten > Penempatan di UI Google Ads dengan mengkueri resource managed_placement_view.

Poin Penting: Untuk memilih antara resource managed_placement_view, group_placement_view, detail_placement_view, dan performance_max_placement_view, lihat Melacak penempatan dan performa iklan.

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

Tempat iklan tampil

Ambil data penempatan domain, aplikasi seluler, dan channel YouTube dari layar Konten > Tempat iklan tampil di UI Google Ads dengan mengkueri resource group_placement_view.

Catatan: API akan menghilangkan penempatan yang tidak memenuhi nilai minimum aktivitas, bukan menampilkan baris ringkasan Total: Lainnya di UI. Lihat Baris "Total: Lainnya" dan Baris dengan detail penempatan yang tidak tersedia.

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

Detail penempatan

Ambil metrik penempatan tingkat URL dan tingkat video dari Konten > Tempat iklan ditampilkan > Lihat detail di UI Google Ads dengan mengkueri resource detail_placement_view.

Catatan: Karena resource detail_placement_view mengevaluasi nilai minimum aktivitas per URL atau video, total barisnya dapat lebih rendah daripada total group_placement_view. Lihat Perbedaan metrik antara tampilan penempatan dan Baris dengan detail penempatan yang tidak tersedia.

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

Penempatan Performa Maksimal

Ambil tayangan iklan penempatan dari laporan standar Penempatan kampanye Performa Maksimal di Insight dan laporan > Editor laporan dengan mengkueri resource performance_max_placement_view.

Catatan: Resource performance_max_placement_view hanya mengekspos metrik metrics.impressions. Di v24 dan yang lebih baru, tambahkan kolom segments.ad_network_type untuk menyegmentasikan tayangan iklan menurut jaringan (lihat Tampilan penempatan Performa Maksimal).

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

Halaman landing

Ambil data dari layar Halaman landing default di UI Google Ads dengan membuat kueri resource landing_page_view.

Catatan: Resource campaign dan ad_group menyegmentasikan metrik landing_page_view, dan memilih kolom ad_group akan mengecualikan kampanye Performa Maksimal. Untuk total URL tingkat akun, hapus kolom campaign.name. Untuk URL setelah penggantian ValueTrack dan perluasan URL Final, buat kueri resource 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

Grup aset

Ambil data dari layar Grup aset untuk kampanye Performa Maksimal di UI Google Ads dengan mengkueri resource 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

Produk

Ambil metrik tingkat produk dari layar Produk untuk kampanye Shopping dan Performa Maksimal di UI Google Ads dengan mengkueri resource shopping_performance_view.

Catatan: Saat melaporkan kampanye Performa Maksimal, jangan pilih kolom ad_group, karena resource ad_group mengelompokkan metrik shopping_performance_view dan mengecualikan baris Performa Maksimal. Untuk membedakan penawaran di beberapa feed, tambahkan kolom segments.product_merchant_id, segments.product_channel, segments.product_language, dan segments.product_feed_label. Untuk memeriksa kelayakan produk saat ini, masalah diagnostik, atau inventaris tanpa tayangan iklan, buat kueri resource shopping_product (lihat Pelaporan produk untuk iklan Shopping).

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

Mencari konstanta geografis

Halaman Kode dan format menyediakan tabel referensi untuk sebagian besar konstanta yang digunakan dalam API. Namun, Anda juga dapat mencari beberapa konstanta secara dinamis menggunakan Bahasa Kueri Google Ads.

Contoh ini menunjukkan cara mencari lokasi berdasarkan nama resource atau nama tampilannya.

Menurut nama resource

Cari cepat Mountain View, CA, berdasarkan nama resource-nya 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

Menurut nama tampilan

Cari "Mountain View" sebagai nama kota di Amerika Serikat.

Catatan: Saat mengkueri lokasi berdasarkan nama, Anda mungkin akan menerima beberapa kecocokan. Filter menurut geo_target_constant.country_code, geo_target_constant.target_type, dan geo_target_constant.status, lalu periksa geo_target_constant.canonical_name untuk membedakan daftar hasil dalam kode klien Anda.

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