Get bid floors

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

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 set in the advertiser’s profile.

A microcurrency unit is 10-6 of the standard unit of currency selected in the advertiser’ s profile.

Equivalency equations, using dollars as an example currency:

  • $1 = 1,000,000 microdollars
  • 1 microdollar = $0.000001

To convert between currency and microcurrency, using dollars as an example currency:

  • To convert dollars to microdollars, mutiply dollars by 1,000,000
  • To convert microdollars to dollars, divide microdollars by 1,000,000
For more on bid floors see Set your bid.

Request Body

{"bid_floor_specs"=>[{"billable_event"=>"VIDEO_V_50_MRC", "currency"=>"NOK", "countries"=>["GB", "TW"], "objective_type"=>"AWARENESS", "optimization_goal_metadata"=>{"conversion_tag_v3_goal_metadata"=>{"attribution_windows"=>{"click_window_days"=>"<integer>", "engagement_window_days"=>"<integer>", "view_window_days"=>"<integer>"}, "conversion_event"=>"PAGE_VISIT", "conversion_tag_id"=>"1690272081", "cpa_goal_value_in_micro_currency"=>"2963772913", "is_roas_optimized"=>"<boolean>", "learning_mode_type"=>"NOT_ACTIVE"}, "frequency_goal_metadata"=>{"frequency"=>"<integer>", "timerange"=>"TWENTY_MINUTE"}, "scrollup_goal_metadata"=>{"scrollup_goal_value_in_micro_currency"=>"3471868703"}}, "creative_type"=>"QUIZ"}, {"billable_event"=>"IMPRESSION", "currency"=>"BRL", "countries"=>["BB", "BE"], "objective_type"=>"WEB_SESSIONS", "optimization_goal_metadata"=>{"conversion_tag_v3_goal_metadata"=>{"attribution_windows"=>{"click_window_days"=>"<integer>", "engagement_window_days"=>"<integer>", "view_window_days"=>"<integer>"}, "conversion_event"=>"WATCH_VIDEO", "conversion_tag_id"=>"0970714", "cpa_goal_value_in_micro_currency"=>"8476064", "is_roas_optimized"=>"<boolean>", "learning_mode_type"=>"ACTIVE"}, "frequency_goal_metadata"=>{"frequency"=>"<integer>", "timerange"=>"DAY"}, "scrollup_goal_metadata"=>{"scrollup_goal_value_in_micro_currency"=>"898228718"}}, "creative_type"=>"COLLECTION"}], "targeting_spec"=>{"AGE_BUCKET"=>["21+", "45-49"], "APPTYPE"=>["android_tablet", "web_mobile"], "AUDIENCE_EXCLUDE"=>["8177", "5132294463"], "AUDIENCE_INCLUDE'"=>["53296648750", "2"], "GENDER"=>["unknown", "unknown"], "GEO"=>["<string>", "<string>"], "INTEREST"=>["<string>", "<string>"], "LOCALE"=>["<string>", "<string>"], "LOCATION"=>["<string>", "<string>"], "SHOPPING_RETARGETING"=>[{"lookback_window"=>"<integer>", "tag_types"=>["<integer>", "<integer>"], "exclusion_window"=>"<integer>"}, {"lookback_window"=>"<integer>", "tag_types"=>["<integer>", "<integer>"], "exclusion_window"=>"<integer>"}], "TARGETING_STRATEGY"=>["CHOOSE_YOUR_OWN", "FIND_NEW_CUSTOMERS"]}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;bid_floors&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;type&quot;:&quot;bidfloor&quot;}