Update ad groups

PATCH {{baseUrl}}/ad_accounts/:ad_account_id/ad_groups

Update multiple existing ad groups.

Request Body

{"0"=>{"id"=>"1019837", "name"=>"<string>", "status"=>"ACTIVE", "budget_in_micro_currency"=>"<integer>", "bid_in_micro_currency"=>"<integer>", "optimization_goal_metadata"=>{"conversion_tag_v3_goal_metadata"=>{"attribution_windows"=>{"click_window_days"=>"<integer>", "engagement_window_days"=>"<integer>", "view_window_days"=>"<integer>"}, "conversion_event"=>"CUSTOM", "conversion_tag_id"=>"658455", "cpa_goal_value_in_micro_currency"=>"80985", "is_roas_optimized"=>"<boolean>", "learning_mode_type"=>nil}, "frequency_goal_metadata"=>{"frequency"=>"<integer>", "timerange"=>"TEN_MINUTE"}, "scrollup_goal_metadata"=>{"scrollup_goal_value_in_micro_currency"=>"5872561"}}, "budget_type"=>"DAILY", "start_time"=>"<integer>", "end_time"=>"<integer>", "targeting_spec"=>{"AGE_BUCKET"=>["65+", "45-49"], "APPTYPE"=>["web_mobile", "web"], "AUDIENCE_EXCLUDE"=>["7868", "96"], "AUDIENCE_INCLUDE'"=>["99151", "3805328388"], "GENDER"=>["unknown", "male"], "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"=>["FIND_NEW_CUSTOMERS", "CHOOSE_YOUR_OWN"]}, "lifetime_frequency_cap"=>"<integer>", "tracking_urls"=>{"impression"=>["<string>", "<string>"], "click"=>["<string>", "<string>"], "engagement"=>["<string>", "<string>"], "buyable_button"=>["<string>", "<string>"], "audience_verification"=>["<string>", "<string>"]}, "auto_targeting_enabled"=>"<boolean>", "placement_group"=>"ALL", "pacing_delivery_type"=>"STANDARD", "campaign_id"=>"C5", "billable_event"=>"IMPRESSION", "bid_strategy_type"=>"MAX_BID"}}

HEADERS

RESPONSES

status: OK

{"items":[{"data":{"name":"\u003cstring\u003e","status":"ACTIVE","budget_in_micro_currency":"\u003cinteger\u003e","bid_in_micro_currency":"\u003cinteger\u003e","optimization_goal_metadata":{"conversion_tag_v3_goal_metadata":{"attribution_windows":{"click_window_days":"\u003cinteger\u003e","engagement_window_days":"\u003cinteger\u003e","view_window_days":"\u003cinteger\u003e"},"conversion_event":"WATCH_VIDEO","conversion_tag_id":"53635509","cpa_goal_value_in_micro_currency":"296384134","is_roas_optimized":"\u003cboolean\u003e","learning_mode_type":"NOT_ACTIVE"},"frequency_goal_metadata":{"frequency":"\u003cinteger\u003e","timerange":"TWENTY_FOUR_HOUR"},"scrollup_goal_metadata":{"scrollup_goal_value_in_micro_currency":"9877855"}},"budget_type":"DAILY","start_time":"\u003cinteger\u003e","end_time":"\u003cinteger\u003e","targeting_spec":{"AGE_BUCKET":["25-34","35-44"],"APPTYPE":["android_tablet","iphone"],"AUDIENCE_EXCLUDE":["68792677","150869"],"AUDIENCE_INCLUDE'":["1","29346"],"GENDER":["male","unknown"],"GEO":["\u003cstring\u003e","\u003cstring\u003e"],"INTEREST":["\u003cstring\u003e","\u003cstring\u003e"],"LOCALE":["\u003cstring\u003e","\u003cstring\u003e"],"LOCATION":["\u003cstring\u003e","\u003cstring\u003e"],"SHOPPING_RETARGETING":[{"lookback_window":"\u003cinteger\u003e","tag_types":["\u003cinteger\u003e","\u003cinteger\u003e"],"exclusion_window":"\u003cinteger\u003e"},{"lookback_window":"\u003cinteger\u003e","tag_types":["\u003cinteger\u003e","\u003cinteger\u003e"],"exclusion_window":"\u003cinteger\u003e"}],"TARGETING_STRATEGY":["FIND_NEW_CUSTOMERS","FIND_NEW_CUSTOMERS"]},"lifetime_frequency_cap":"\u003cinteger\u003e","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"auto_targeting_enabled":"\u003cboolean\u003e","placement_group":"SEARCH","pacing_delivery_type":"STANDARD","campaign_id":"9030939867","billable_event":"VIDEO_V_50_MRC","bid_strategy_type":"TARGET_AVG","id":"95","ad_account_id":"57","created_time":"\u003cinteger\u003e","updated_time":"\u003cinteger\u003e","type":"adgroup","conversion_learning_mode_type":"ACTIVE","summary_status":"ARCHIVED","feed_profile_id":"\u003cstring\u003e","dca_assets":{"description":"[DCA] The Dynamic creative assets to use for DCA. Dynamic Creative Assembly (DCA) accepts basic creative assets of an ad (image, video, title, call to action, logo etc). Then it automatically generates optimized ad combinations based on these assets."}},"exceptions":[{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"},{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"}]},{"data":{"name":"\u003cstring\u003e","status":"ACTIVE","budget_in_micro_currency":"\u003cinteger\u003e","bid_in_micro_currency":"\u003cinteger\u003e","optimization_goal_metadata":{"conversion_tag_v3_goal_metadata":{"attribution_windows":{"click_window_days":"\u003cinteger\u003e","engagement_window_days":"\u003cinteger\u003e","view_window_days":"\u003cinteger\u003e"},"conversion_event":"PAGE_VISIT","conversion_tag_id":"2","cpa_goal_value_in_micro_currency":"7429030","is_roas_optimized":"\u003cboolean\u003e","learning_mode_type":"ACTIVE"},"frequency_goal_metadata":{"frequency":"\u003cinteger\u003e","timerange":"TEN_MINUTE"},"scrollup_goal_metadata":{"scrollup_goal_value_in_micro_currency":"66746832186"}},"budget_type":"DAILY","start_time":"\u003cinteger\u003e","end_time":"\u003cinteger\u003e","targeting_spec":{"AGE_BUCKET":["35-44","45-49"],"APPTYPE":["web_mobile","ipad"],"AUDIENCE_EXCLUDE":["99","6084914"],"AUDIENCE_INCLUDE'":["4091871","165"],"GENDER":["unknown","male"],"GEO":["\u003cstring\u003e","\u003cstring\u003e"],"INTEREST":["\u003cstring\u003e","\u003cstring\u003e"],"LOCALE":["\u003cstring\u003e","\u003cstring\u003e"],"LOCATION":["\u003cstring\u003e","\u003cstring\u003e"],"SHOPPING_RETARGETING":[{"lookback_window":"\u003cinteger\u003e","tag_types":["\u003cinteger\u003e","\u003cinteger\u003e"],"exclusion_window":"\u003cinteger\u003e"},{"lookback_window":"\u003cinteger\u003e","tag_types":["\u003cinteger\u003e","\u003cinteger\u003e"],"exclusion_window":"\u003cinteger\u003e"}],"TARGETING_STRATEGY":["FIND_NEW_CUSTOMERS","RECONNECT_WITH_USERS"]},"lifetime_frequency_cap":"\u003cinteger\u003e","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"auto_targeting_enabled":"\u003cboolean\u003e","placement_group":"ALL","pacing_delivery_type":"ACCELERATED","campaign_id":"C804","billable_event":"VIDEO_V_50_MRC","bid_strategy_type":"TARGET_AVG","id":"29305338","ad_account_id":"02","created_time":"\u003cinteger\u003e","updated_time":"\u003cinteger\u003e","type":"adgroup","conversion_learning_mode_type":"NOT_ACTIVE","summary_status":"COMPLETED","feed_profile_id":"\u003cstring\u003e","dca_assets":{"description":"[DCA] The Dynamic creative assets to use for DCA. Dynamic Creative Assembly (DCA) accepts basic creative assets of an ad (image, video, title, call to action, logo etc). Then it automatically generates optimized ad combinations based on these assets."}},"exceptions":[{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"},{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"}]}]}