Create or update an ad group shell
10 min
use case for this api create or update the shell of an ad group in cadent ad manager api endpoint curl location 'https //api cadent app/dsp/v1/adgroup/save' \\ \ header 'x api key insert api key here' \\ \ header 'content type application/json' \\ \ data '{ "adgrouptodevicetypes" \[ { "devicetypeid" 1 }, { "devicetypeid" 3 }, { "devicetypeid" 5 } ], "bidprice" 8 000000, "frequencycappingenabled" true, "frequencytiming" 1, "frequencytype" 1, "id" 0, "impressionlimit" 4, "lineitemid" 181382, "name" "test ad group", "status" 1 }'{ "status" { "code" 200, "message" "success", "errorarray" null, "haserror" false }, "data" { "lineitemid" 181382, "status" 1, "bidprice" 8 000000, "frequencycappingenabled" true, "frequencytype" 1, "impressionlimit" 4, "frequencytiming" 1, "adgrouptodevicetypes" \[ { "devicetypeid" 1, "devicetypename" "desktop", "adgroupid" 125817 }, { "devicetypeid" 3, "devicetypename" "smartphone", "adgroupid" 125817 }, { "devicetypeid" 5, "devicetypename" "media player", "adgroupid" 125817 } ], "id" 125817, "name" "test ad group 1", "status" 1 } } parameters adgrouptodevicetypes array of devicetype objects \<font color="#3366ae">,\</font> required devices the ad group will run on bidprice \<font color="#3366ae">i\</font> nteger, required target bid price for the ad group frequencycappingenabled boolean , required determines whether or not an ad group has frequency capping or not true = enables frequency capping false = frequency capping is not enabled (default) frequencytiming \<font color="#3366ae">i\</font> nteger, required if frequencycappingenabled = true time unit used for frequency capping 1 = hour (default) 2 = day 3 = week 4 = month 5 = lifetime frequencytype \<font color="#808080b5"> \</font> integer, required if frequencycappingenabled = true type of id used for frequency capping 1 = adtheorent id (default) 2 = ip address 3 = property 4 = cookie id 5 = maid id \<font color="#808080b5"> \</font> integer, required id of the ad group 0 = for creating a new ad group shell impressionlimit \<font color="#808080b5"> \</font> integer, required if frequencycappingenabled = true number of impressions used for frequency capping lineitemid \<font color="#808080b5"> \</font> integer, required id of the parent line item name string, required ad group name maximum of 128 characters only a z , 0 9 , characters allowed isn't required to be unique status integer, required determines whether the ad group is active or disabled 1 = active 2 = disabled device type object devicetypeid integer, required the type of device the ad group can target 1 = desktop 2 = ctv / ott 3 = smartphone 4 = tablet 5 = media player 7 = dooh the permitted device types depend on the parent line item's ad channel as follows line item ad channel supported ad group device types display desktop, smartphone, tablet, and media player video desktop, smartphone, tablet, and media player ctv ctv / ott native desktop, smartphone, and tablet audio desktop, smartphone, and tablet dooh dooh


