check_first_page_bids
Identify keywords with bids below the estimated first-page bid. Compare current bid to first-page estimate to find under-bid keywords, helping diagnose low impressions before activating a campaign.
Instructions
Flag keywords whose bid is below the estimated first-page bid ("Below first page bid").
This is the API-driven version of the delivery state the UI shows as "Below first page
bid". For each keyword in the ad group it looks up the Keyword Planner first-page bid
estimate (at the keyword's own match type) and compares it against the keyword's effective
bid -- the keyword's own bid, or the ad group's default bid when the keyword has none. The
result lists the under-bid keywords first (largest shortfall first) with each one's
current_bid, estimated_first_page_bid, and bid_source, plus counts. Use it when
diagnosing low impressions, or before activating a campaign, to find keywords that won't
reach the first page at their current bid.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | Language name for the estimate, e.g. "English" (optional). | |
| ad_group_id | Yes | The ad group whose keywords to check. | |
| campaign_id | Yes | The parent campaign id -- required to read the ad group's default bid, which keywords without their own bid inherit. | |
| location_ids | No | Microsoft location ids to scope demand to; the estimate defaults to the United States ("190") when omitted. | |
| target_position | No | "FirstPage" (default), "MainLine", or "MainLine1" (top ad slot). | FirstPage |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | ||
| ad_group_id | Yes | ||
| currency_code | No | ||
| target_position | Yes | ||
| keywords_checked | Yes | ||
| undetermined_count | Yes | ||
| ad_group_default_bid | No | ||
| below_first_page_count | Yes |