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"=>"3", "product_group_promotion"=>[{"id"=>"8996373", "ad_group_id"=>"20015602141", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"01", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"PAUSED", "tracking_url"=>"<string>", "catalog_product_group_id"=>"9979313399", "catalog_product_group_name"=>"<string>", "creative_type"=>"COLLECTION", "collections_hero_pin_id"=>"4042150806", "collections_hero_destination_url"=>"<string>"}, {"id"=>"26530549", "ad_group_id"=>"AG03573", "bid_in_micro_currency"=>"<integer>", "included"=>"<boolean>", "definition"=>"<string>", "relative_definition"=>"<string>", "parent_id"=>"2", "slideshow_collections_title"=>"<string>", "slideshow_collections_description"=>"<string>", "is_mdl"=>"<boolean>", "status"=>"ACTIVE", "tracking_url"=>"<string>", "catalog_product_group_id"=>"4", "catalog_product_group_name"=>"<string>", "creative_type"=>"SHOWCASE", "collections_hero_pin_id"=>"32193557", "collections_hero_destination_url"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;data&quot;:{&quot;id&quot;:&quot;9218440&quot;,&quot;ad_group_id&quot;:&quot;AG5&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;7396307&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;PAUSED&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;656011&quot;,&quot;catalog_product_group_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;CAROUSEL&quot;,&quot;collections_hero_pin_id&quot;:&quot;87925658&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]},{&quot;data&quot;:{&quot;id&quot;:&quot;0371452&quot;,&quot;ad_group_id&quot;:&quot;390942318&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;736312&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;PAUSED&quot;,&quot;tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;catalog_product_group_id&quot;:&quot;336&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;785&quot;,&quot;collections_hero_destination_url&quot;:&quot;\u003cstring\u003e&quot;},&quot;exceptions&quot;:[{&quot;nullable&quot;:true},{&quot;nullable&quot;:true}]}]}