Updatable Ad Group Metadata Fields

The following table shows ad group metadata fields that are updatable via
PUT and PATCH /api/v1/adGroups

API Field NameDisplay Label in MatrixDraftScheduledLivePausedCompleteArchivedNotes
nameAd Group Name✅✅✅✅⚠️❌Updatable only if endDate is extended into future
startDateStart Date✅✅❌❌❌❌—
endDateEnd Date✅✅✅✅✅❌
Ad groups created to run definitely can be updated later to include an end date.
budgetTypeBudget Type✅❌❌❌❌❌Immutable
dailyBudget, totalBudgetBudget (Daily & Total)✅✅✅✅⚠️❌1. For evergreen campaigns, only Daily budget supported.
2. Extend endDate to edit if Complete
deliverySpeedDelivery Speed✅❌❌❌❌❌Frontloaded pacing not supported if budgetType is daily
frequencyCapDay, frequencyCapWeek, frequencyCapMonthFrequency Cap✅✅✅✅⚠️❌Extend endDate if Complete
targeting.contextualTargeting Tactic – Contextual✅Add/RemoveAdd/RemoveAdd/Remove⚠️❌1. Tactic only changeable in Draft. Else you can only add/remove taxonomies.
2. Extend endDate to edit if Complete
targeting.behavioralTargeting Tactic – Behavioral✅Add/RemoveAdd/RemoveAdd/Remove⚠️❌1. Tactic only changeable in Draft. Else you can only add/remove audiences.
2. Extend endDate to edit if Complete
targeting.keywordsTargeting Tactic – Keywords✅Add/RemoveAdd/RemoveAdd/Remove⚠️❌1. Tactic only changeable in Draft. Else you can only add/remove keywords.
2. Extend endDate to edit if Complete
targeting.runOfSiteTargeting Tactic – ROS✅❌❌❌⚠️❌1. Tactic only changeable in Draft.
2. Extend endDate to edit if Complete
targeting.geoTargetsGeo targeting✅✅✅✅⚠️❌Extend endDate if Complete
creativeRotationModeCreative rotation mode✅✅✅✅⚠️❌Extend endDate if Complete
creativeRotationModeCreative rotation mode✅✅✅✅⚠️❌Extend endDate if Complete
attributesSetOnAdGroupLevel———————Configuration flag; not user-editable
rateTypeRate Type——————Immutable
creationDate, lastUpdatedDate———————Metadata only


Did this page help you?