Skip to content

Google Ads Filters

LightLead builds a GAQL WHERE clause from filters based on aliases. Logic: AND / OR.

Filterable Fields (aliases → GAQL)

AliasGAQLNote
account_idcustomer.id
account_namecustomer.descriptive_nameLIKE / NOT LIKE
campaign_idcampaign.idminResource: campaign
campaign_namecampaign.name
campaign_statuscampaign.status
adset_idad_group.idminResource: ad_group
adset_namead_group.name
adgroup_statusad_group.status
ad_idad_group_ad.ad.idminResource: ad_group_ad
ad_namead_group_ad.ad.name
keyword_textad_group_criterion.keyword.textminResource: keyword_view
devicesegments.devicesegment
networksegments.ad_network_typesegment
spendmetrics.cost_microsvalue × 1e6
clicksmetrics.clicksmetric filter
impressionsmetrics.impressionsmetric filter
conversionsmetrics.conversionsmetric filter

A filter on a field with a minResource above the current report resource is ignored.

LightLead Operators → GAQL

LightLeadGAQL
EQUAL=
GREATER_THAN>
LESS_THAN<
CONTAINLIKE '%…%'
NOT_CONTAINNOT LIKE '%…%'

Date

sql
segments.date DURING LAST_30_DAYS
segments.date BETWEEN '2026-07-01' AND '2026-07-25'

Default — LAST_30_DAYS.

Examples

sql
WHERE campaign.status = 'ENABLED'
  AND metrics.impressions > 0
  AND segments.date DURING LAST_30_DAYS
sql
WHERE campaign.name LIKE '%brand%'
  AND metrics.cost_micros > 10000000

Limitations

  • Metric filters (spend/clicks/impressions/conversions) apply to numeric values; for spend — converted to micros
  • The device/network segments split rows
  • Computed roas / cost_per_result cannot be filtered directly

Maintained by the LightLead Documentation Team · Last verified: 2026-07-26