---
title: "AdGroupV2"
url: "https://api-catalog-test.8451.com/apis/kroger-ad-platform-api-1/versions/161b884e-bbcf-458e-9b78-9eff02a00217/schemas/AdGroupV2"
---

> Full API specification: https://api-catalog-test.8451.com/apis/kroger-ad-platform-api-1/versions/161b884e-bbcf-458e-9b78-9eff02a00217.md

# AdGroupV2

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Kroger Ad Platform API
  version: "1"
servers:
  - url: /v1
components:
  schemas:
    BudgetType:
      type: string
      enum:
        - DAILY
        - WEEKLY
        - MONTHLY
        - LIFETIME
      title: BudgetType
    AdGroupStatus:
      type: string
      enum:
        - DRAFT
        - SCHEDULED
        - ACTIVE
        - ENDED
        - PAUSED
        - FAILED
        - UNDER REVIEW
      title: AdGroupStatus
    Entity:
      properties:
        id:
          type: integer
          title: id
          description: Entity id
        subCommodityId:
          anyOf:
            - type: string
            - type: "null"
          title: subCommodityId
          description: Sub commodity id
        useBaseBid:
          type: boolean
          title: useBaseBid
          description: Whether to use base bid.
        bidAmount:
          anyOf:
            - type: number
            - type: "null"
          title: bidAmount
          description: Bid amount for this entity.
        deleted:
          type: boolean
          title: deleted
          description: Whether this entity is deleted.
      type: object
      required:
        - id
        - useBaseBid
        - deleted
      title: Entity
    Target:
      properties:
        type:
          anyOf:
            - type: string
            - type: integer
          title: type
          description: Type id of the adgroup target. 1 - Placement, 2 - Division, 3 - Day
            Parting
        id:
          anyOf:
            - type: integer
            - type: "null"
          title: id
          description: Id to use for the adgroup target. For placement targets, this
            should be the placement id. For division targets, this should be
            division id.
        values:
          anyOf:
            - items:
                type: integer
              type: array
            - type: "null"
          title: values
          description: Values to use for the adgroup target. For day parting targets, this
            should be a list of two values, which are start and end hours (1 -
            24) in the EST timezone.
      type: object
      required:
        - type
      title: Target
    KeywordBidModifier:
      properties:
        keyword:
          type: string
          title: keyword
          description: Keyword to modify.
        modifier:
          type: number
          title: modifier
          description: Modifier value for this keyword.
        deleted:
          anyOf:
            - type: boolean
            - type: "null"
          title: deleted
          description: Whether this keyword is deleted.
      type: object
      required:
        - keyword
        - modifier
      title: KeywordBidModifier
    CarouselCreativeType:
      type: string
      enum:
        - STANDARD
        - VIDEO
      title: CarouselCreativeType
    AdGroupV2:
      properties:
        adGroupId:
          anyOf:
            - type: integer
            - type: "null"
          title: adGroupId
          description: Id that identified the Ad Group.
        campaignId:
          anyOf:
            - type: integer
            - type: "null"
          title: campaignId
          description: The campaign id associated with this ad group.
        name:
          anyOf:
            - type: string
            - type: "null"
          title: name
          description: The ad group name.
        startDate:
          anyOf:
            - type: string
            - type: "null"
          title: startDate
          description: The start date of the ad group.
          default: ""
        endDate:
          anyOf:
            - type: string
            - type: "null"
          title: endDate
          description: The end date of the ad group. If null the ad group is considered
            'always-on' and will stop when/if the campaign has an end date.
        budgetType:
          anyOf:
            - $ref: "#/components/schemas/BudgetType"
            - type: "null"
          title: budgetType
          description: The type of budget.
        budgetAmount:
          anyOf:
            - type: number
            - type: "null"
          title: budgetAmount
          description: The budget of the ad group. The sum of all the budgets from the ad
            group(s) may not exceed the campaign budget.
        status:
          anyOf:
            - $ref: "#/components/schemas/AdGroupStatus"
            - type: "null"
          title: status
          description: The status of the ad group.
        baseBid:
          anyOf:
            - type: number
            - type: "null"
          title: baseBid
          description: The base bid used for all entities that have the useBaseBid flag as
            true. It must be above the highers floor price of the placement(s)
            selected.
        entities:
          anyOf:
            - items:
                $ref: "#/components/schemas/Entity"
              type: array
            - type: "null"
          title: entities
          description: The products to be advertised.
          default: []
        targets:
          items:
            $ref: "#/components/schemas/Target"
          type: array
          title: targets
          description: The target dimensions for this ad group. Includes placements,
            divisions, and day parting.
        keywordBidModifiers:
          anyOf:
            - items:
                $ref: "#/components/schemas/KeywordBidModifier"
              type: array
            - type: "null"
          title: keywordBidModifiers
          description: Adjustments to keyword bids.
        isArchived:
          anyOf:
            - type: boolean
            - type: "null"
          title: isArchived
          description: Whether this ad group is archived.
        carouselHeadline:
          anyOf:
            - type: string
            - type: "null"
          title: carouselHeadline
          description: This headline is displayed above the product cards to differentiate
            your Carousel from other listings
        carouselSubtext:
          anyOf:
            - type: string
            - type: "null"
          title: carouselSubtext
          description: Add subtext to carousel ad group.
        creativeType:
          anyOf:
            - $ref: "#/components/schemas/CarouselCreativeType"
            - type: "null"
          title: creativeType
          description: The type of creative.
      type: object
      required:
        - targets
      title: AdGroupV2
```