Create product group promotions

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

Add one or more product groups from your catalog to an existing ad group. (Product groups added to an ad group are a 'product group promotion.')

Request Body

{"ad_group_id"=>"1", "product_group_promotion"=>[{"id"=>"810951", "ad_group_id"=>"AG11918861", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"6414572", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"DELETED_DRAFT", "tracking_url"=>"<string>", "catalog_product_group_id"=>"87", "catalog_product_group_name"=>"<string>", "creative_type"=>"SHOPPING", "collections_hero_pin_id"=>"41", "collections_hero_destination_url"=>"<string>", "grid_click_type"=>"DIRECT_TO_DESTINATION"}, {"id"=>"00077665", "ad_group_id"=>"4057514255", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"83869", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"DELETED_DRAFT", "tracking_url"=>"<string>", "catalog_product_group_id"=>"45516832", "catalog_product_group_name"=>"<string>", "creative_type"=>"VIDEO", "collections_hero_pin_id"=>"655477", "collections_hero_destination_url"=>"<string>", "grid_click_type"=>"DIRECT_TO_DESTINATION"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;data&quot;:{&quot;id&quot;:&quot;13497860&quot;,&quot;ad_group_id&quot;:&quot;AG09&quot;,&quot;bid_in_micro_currency&quot;:&quot;\u003cinteger\u003e&quot;,&quot;included&quot;:&quot;\u003cboolean\u003e&quot;,&quot;definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;relative_definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;31865541&quot;,&quot;slideshow_collections_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;slideshow_collections_description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_mdl&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;657979668&quot;,&quot;catalog_product_group_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;REGULAR&quot;,&quot;collections_hero_pin_id&quot;:&quot;5539&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;grid_click_type&quot;:&quot;DIRECT_TO_DESTINATION&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]},{&quot;data&quot;:{&quot;id&quot;:&quot;11040587752&quot;,&quot;ad_group_id&quot;:&quot;AG546752481&quot;,&quot;bid_in_micro_currency&quot;:&quot;\u003cinteger\u003e&quot;,&quot;included&quot;:&quot;\u003cboolean\u003e&quot;,&quot;definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;relative_definition&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;406160551&quot;,&quot;slideshow_collections_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;slideshow_collections_description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_mdl&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;858622&quot;,&quot;catalog_product_group_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;IDEA&quot;,&quot;collections_hero_pin_id&quot;:&quot;329&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;grid_click_type&quot;:&quot;CLOSEUP&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]}]}