Get bid floors

POST {{baseUrl}}/ad_accounts/:ad_account_id/bid_floor

This endpoint is currently in beta and not available to all apps. Learn more.

List bid floors for your campaign configuration. Bid floors are given in microcurrency values based on the currency in the bid floor specification.

Microcurrency is used to track very small transactions, based on the currency field set in the advertiser's profile. A microcurrency unit is one one-millionth of the standard unit of currency selected in the advertiser's profile (e.g. a microdollar is $0.000001.)

For more on bid floors see Set your bid.

Request Body

{"targeting_spec"=>{"GEO"=>["BE-VOV"], "LOCATION"=>["US"], "LOCALE"=>["cs"], "AGE_BUCKET"=>["25-34"], "AUDIENCE_INCLUDE"=>["2542620905473"], "SHOPPING_RETARGETING"=>[{"lookback_window"=>30, "exclusion_window"=>14, "tag_types"=>[0, 6]}, {"lookback_window"=>30, "exclusion_window"=>14, "tag_types"=>[0, 6]}], "GENDER"=>["male"], "TARGETING_STRATEGY"=>["CHOOSE_YOUR_OWN"], "APPTYPE"=>["iphone"], "AUDIENCE_EXCLUDE"=>["2542620905475"], "INTEREST"=>["925056443165"]}, "bid_floor_specs"=>[{"billable_event"=>"CLICKTHROUGH", "creative_type"=>"REGULAR", "currency"=>"USD", "countries"=>["US", "US"], "optimization_goal_metadata"=>{"frequency_goal_metadata"=>{"timerange"=>"DAY", "frequency"=>5}, "conversion_tag_v3_goal_metadata"=>{"attribution_windows"=>{"view_window_days"=>1, "click_window_days"=>0, "engagement_window_days"=>6}, "conversion_tag_id"=>"conversion_tag_id", "learning_mode_type"=>"ACTIVE", "conversion_event"=>"PAGE_VISIT", "is_roas_optimized"=>true, "cpa_goal_value_in_micro_currency"=>"cpa_goal_value_in_micro_currency"}, "scrollup_goal_metadata"=>{"scrollup_goal_value_in_micro_currency"=>"scrollup_goal_value_in_micro_currency"}}}, {"billable_event"=>"CLICKTHROUGH", "creative_type"=>"REGULAR", "currency"=>"USD", "countries"=>["US", "US"], "optimization_goal_metadata"=>{"frequency_goal_metadata"=>{"timerange"=>"DAY", "frequency"=>5}, "conversion_tag_v3_goal_metadata"=>{"attribution_windows"=>{"view_window_days"=>1, "click_window_days"=>0, "engagement_window_days"=>6}, "conversion_tag_id"=>"conversion_tag_id", "learning_mode_type"=>"ACTIVE", "conversion_event"=>"PAGE_VISIT", "is_roas_optimized"=>true, "cpa_goal_value_in_micro_currency"=>"cpa_goal_value_in_micro_currency"}, "scrollup_goal_metadata"=>{"scrollup_goal_value_in_micro_currency"=>"scrollup_goal_value_in_micro_currency"}}}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"bid_floors":[100000,200000],"type":"bidfloor"}