---
title: "Update an existing AdGroup."
method: PUT
path: "/cm/v1/ad-groups/{ad_group_id}"
tags: ["AdGroup"]
---

# Update an existing AdGroup.

`PUT /cm/v1/ad-groups/{ad_group_id}`

Update an existing AdGroup.

## Path parameters

- `ad_group_id` string, required

## Query parameters

- `campaign_id` string, required

## Request body

- DspAdGroup — AdGroup represents the seed information for a full AdGroup used by bidders.
  - `id` string — Unique identifier of the AdGroup. Automatically set by server on creation.
  - `title` string, required — A descriptive name of the AdGroup.
  - `campaign_id` string — ID of the Campaign the AdGroup belongs to.
  - `product_id` string — ID of the Product the AdGroup belongs to.
  - `ad_account_id` string — ID of the AdAccount the AdGroup belongs to.
  - `experiment_id` string — ID of the Experiment the AdGroup is involved in.
  - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state.
  - `audience` AdclouddspAudience — Audience is a final form of AudienceTargeting specification. It is represented by a list of IDs of SharedAudienceTargets and an ad-hoc target condition. All conditions in the audience specification must be met to accept a bid-request. IDs of the SharedAudienceTargets can be either at global or AdAccount level.
    - `shared_audience_target_ids` string[] — A list of IDs for the named AudienceTargets referenced by this audience specification.
    - `targeting_condition` DspAudienceTargetingCondition — AudienceTargetingCondition specifies conditions for AudienceTargeting. This condition object contains various filters on multiple dimensions of bid-request, app, and user. Advertisers can selectively configure desired filters to form a meaningful AudienceTarget condition collectively. The configured individual filters must be satisfied unanimously in order for the resulting collective condition to be satisfied. Only filters with values will be effective. When a filter condition accepts a list of values, i.e., list of countries for "allowed_countries", the filter condition will be met when any match is found among the list. String literals are case insensitive unless specified otherwise; i.e. "USA" and "usa" equally represents the United States of America.
      - `allowed_countries` string[] — Allowed countries in ISO_3166-1_alpha-3 format.
      - `blocked_countries` string[] — Blocked countries in ISO_3166-1_alpha-3 format.
      - `placement_reasons` AudienceTargetingConditionPlacementReason[]
      - `custom_placement_reason` string — The reason of the placement in free-form text.
      - `allowed_app_bundles` string[] — App bundles. A bid-request having a matching publisher app bundle from the list will be accepted. Example to target com.moloco.game or com.moloco.travel apps: "allowed_app_bundles": [ "com.moloco.game", "com.moloco.travel" ] Example to exclude com.moloco.office app: "blocked_app_bundles": [ "com.moloco.office" ]
      - `blocked_app_bundles` string[] — See the documentation for `allowed_app_bundles`.
      - `allowed_content_categories` string[] — Filter for allowed publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "allowed_content_categories": [ "IAB26-1" ]
      - `blocked_content_categories` string[] — Filter for blocked publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "blocked_content_categories": [ "IAB26-1" ]
      - `allowed_cities` string[] — Allowed cities. A bid-request will be accepted when there is at least one match from the city list. Note that each element must be in the form of "city, region" such as "Seattle, WA" in order to disambiguate the same city but different regions. The entry is case-insensitive and whitespace will be ignored. Example to target Seattle or Newyork: "allowed_cities": [ "Seattle, WA", "Newyork, ny" ]
      - `blocked_cities` string[] — Blocked cities.
      - `allowed_creative_types` AdcloudcommonCreativeType[] — Allowed Creative types.
      - `blocked_creative_types` AdcloudcommonCreativeType[] — Blocked Creative types.
      - `allowed_websites` string[] — Allowed websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "allowed_websites": [ "*youtube.com" ].
      - `blocked_websites` string[] — Blocked websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "blocked_websites": [ "*example.com" ].
      - `allowed_geofences` CommonCircle[] — Allowed geofences.
        - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
          - `latitude` number, double
          - `longitude` number, double
        - `radius` number, double
      - `blocked_geofences` CommonCircle[] — Blocked geofences.
        - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
          - `latitude` number, double
          - `longitude` number, double
        - `radius` number, double
      - `allowed_exchanges` CommonAdExchange[] — Allowed ad exchanges. Restricts targeting to bid only on the listed exchanges; an empty list places no restriction. MOLOCO_SDK is automatically included whenever the list is non-empty: submitting a non-empty list that omits MOLOCO_SDK will have it appended on the server side.
      - `blocked_exchanges` CommonAdExchange[] — Blocked ad exchanges. Excludes the listed exchanges from targeting. Adding MOLOCO_SDK to this list is rejected with PERMISSION_DENIED.
      - `allowed_idfas` string[] — Allowed user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f".
      - `blocked_idfas` string[] — Blocked user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f".
      - `allowed_zipcodes` string[] — Allowed zipcodes.
      - `blocked_zipcodes` string[] — Blocked zipcodes.
      - `allowed_device_models` string[] — Allowed device models. For example: "allowed_device_models": [ "KFFOWI", "KFGIWI", "KFTT", "KFJWA" ]
      - `blocked_device_models` string[] — Blocked device models.
      - `allowed_user_audience_tags` string[] — Allowed user custom audience tags.
      - `blocked_user_audience_tags` string[] — Blocked user custom audience tags.
      - `allowed_languages` string[] — Allowed languages. Languages in use mostly follow ISO 639-1 code(https://www.loc.gov/standards/iso639-2/php/code_list.php), e.g. "ko" for Korean and "en" for English.
      - `blocked_languages` string[] — Blocked languages.
      - `allowed_device_types` CommonDeviceType[] — Allowed device types. For example: "allowed_device_types": [ "HIGHEND_PHONE", "TABLET" ]
      - `blocked_device_types` CommonDeviceType[] — Blocked device types. For example: "allowed_device_types": [ "SET_TOP_BOX" ]
      - `allowed_mostly_visited_countries` string[] — This filter checks user's history of mostly visited countries against the specified countries in the condition, and passes a request if there is at least one common entry in both lists.
      - `blocked_mostly_visited_countries` string[]
      - `allowed_regions` string[] — Regions are to filter a bid-request based on its region information.
      - `blocked_regions` string[]
      - `allowed_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] — Recent Campaign activities filter a bid-request by user's recent activity such as click or install in the last n days. The filter is satisfied if there is at least one satisfying condition among the list. Example to target a user who has a click event for com.moloco.gameapp: "allowed_recent_campaign_activities": [ { "campaign_id": "com.moloco.gameapp", "event": "CLICK" } ] Example to block a user who has a install event for com.moloco.officeapp within the past five days: "blocked_recent_campaign_activities": [ { "campaign_id": "com.moloco.officeapp", "event": "INSTALL", "last_n_days": 5 } ]
        - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install.
        - `campaign_id` string, required — ID of the Campaign to filter on.
        - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
      - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[]
        - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install.
        - `campaign_id` string, required — ID of the Campaign to filter on.
        - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
      - `allowed_locations` AudienceTargetingConditionLocationFilter[] — Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence.
        - `cities` string[]
        - `regions` string[]
        - `zipcodes` string[]
        - `geofences` CommonCircle[]
          - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
            - `latitude` number, double
            - `longitude` number, double
          - `radius` number, double
      - `blocked_locations` AudienceTargetingConditionLocationFilter[]
        - `cities` string[]
        - `regions` string[]
        - `zipcodes` string[]
        - `geofences` CommonCircle[]
          - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
            - `latitude` number, double
            - `longitude` number, double
          - `radius` number, double
      - `genders` CommonGender[]
      - `connection_types` string[] — Connection_types include ETHERNET, WIFI, CELL_UNKNOWN, CELL_2G, CELL_3G, CELL_4G. For example: "connection_types": [ "WIFI", "CELL_4G" ]
      - `allowed_direct_deal_ids` string[] — IDs of the allowed direct deals. A bid-request is accepted only if there is at least one matching id. For example: "allowed_direct_deal_ids": [ "ip_9161499632014fe8b9ef60673a51b745", "ip_e13c0cb23dd54a8ea742b2af61e0712d", "ip_0cfeaebb190d47df8b86399232853e23" ]
      - `blocked_direct_deal_ids` string[] — IDs of the blocked direct deals.
      - `device_oses` AudienceTargetingConditionDeviceOsFilter[] — Device OS requirements if specified.
        - `os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product.
        - `min_version` string
        - `max_version` string
      - `media_channel_type` 'UNKNOWN_MEDIA_CHANNEL_TYPE' | 'APP' | 'WEB' — - UNKNOWN_MEDIA_CHANNEL_TYPE: This value is not part of the specification.
      - `new_users` AudienceTargetingConditionNewUserFilter — Filter to target new users only.
        - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
      - `advertiser_id_types` CommonAdvertiserIdType[] — Filter on advising ID types, including "ANDROID_IDFA" or "IOS_IDFA".
      - `allowed_video_types` DspAudienceTargetingConditionVideoType[] — Video type filter. Ignored when the bid request is not for video ads.
      - `blocked_video_types` DspAudienceTargetingConditionVideoType[]
      - `weekly_schedules` AudienceTargetingConditionWeeklyScheduleFilter[] — Weekly schedule specifies more fine-grained time range filtering for days of a week. For example, this list can be used to specify commute time ranges in the morning and evening on workdays. Example to target 7-9 am and 5-7 pm during week days: "weekly_schedules": [ { "hour_range": { "start": 7, "end": 9 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] }, { "hour_range": { "start": 17, "end": 19 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] } ] Example to target 10pm to 2am on Fridays and Saturdays: "weekly_schedules": [ { "range": { "start": 22, "end": 2 }, "days": [ "FRI", "SAT" ] } ]
        - `timezone_policy` 'UNKNOWN_TIME' | 'DEVICE_TIME' | 'UTC_TIME' | 'AD_ACCOUNT_TIME' | 'ADVERTISER_TIME' — TimezonePolicy defines the time configuration. - DEVICE_TIME: Time object is given in the device's time (depends on user device timezone). - UTC_TIME: Time object is given in the fixed UTC time (depends on nothing). - AD_ACCOUNT_TIME: Given time is given in fixed ad account time (depends on ad account timezone).
        - `hour_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `days` AdcloudcommonDayOfWeek[], required — Days of week to filter on. At least one is required.
      - `allowed_gender_score` AdcloudcommonFloatingPointRange
        - `start` number, double
        - `end` number, double
      - `blocked_gender_score` AdcloudcommonFloatingPointRange
        - `start` number, double
        - `end` number, double
      - `allowed_ages` AdcloudcommonInterval[] — Age is used to filter based on user's approximate age. A valid value must be in the exclusive range of (0, 100).
        - `start` integer
        - `end` integer
      - `blocked_ages` AdcloudcommonInterval[]
        - `start` integer
        - `end` integer
      - `allowed_ip_ranges` string[] — IP net based condition. The CIDR format must be used for an entry such as https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Note that both of IP v4 and v6 could be used at the same time. Example to block bid-requests with any IP within 32.76.52.0 - 32.76.52.255 or 127.0.0.0 - 127.255.255.255: "blocked_ip_ranges": [ "32.76.52.0/24", "127.0.0.0/8" ]
      - `blocked_ip_ranges` string[]
      - `allowed_device_carriers` string[] — Device carrier filter. Example to target SKT: "allowed_device_carriers": [ "SKTelecom" ] Example to exclude T-MOBILE and XFINITY Mobile "blocked_device_carriers": [ "T-MOBILE", "XFINITY Mobile" ]
      - `blocked_device_carriers` string[]
      - `allowed_keywords` string[] — Filter regarding 'keywords' field in a bid request. If specified, an ad request must have at least one of the allowed keywords to satisfy the filter.
      - `blocked_keywords` string[] — Filter regarding 'keywords' field in a bid request. An ad request must not have any of the blocked keywords to satisfy the filter.
      - `user_buckets` AdcloudcommonInterval[] — Filter for the user buckets.
        - `start` integer
        - `end` integer
      - `allowed_ad_units` string[] — // Target timetree_i_prod or timetree_a_prod ad_units "condition": { "allowed_ad_units": [ "timetree_i_prod", "timetree_a_prod" ] } // Exclude timetree_i_test ad_unit "condition": { "blocked_ad_units": [ "timetree_i_test" ] }
      - `blocked_ad_units` string[]
      - `allowed_placements` string[] — placement (a group of ad_units) names. It is untied to ad_units, and follow the ad_unit's filtering rule.
      - `blocked_placements` string[]
      - `allowed_banner_apis` CommonBannerApi[] — // Target MRAID_2 banner only "condition": { "allowed_banner_apis": [ "MRAID_2" ] }
      - `blocked_banner_apis` CommonBannerApi[]
      - `schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
        - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
        - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
      - `audience_data` CommonAudienceData — Audience Data. It is a filter based on AudienceData stored in UPT.
        - `provider` string
        - `condition` string
      - `allowed_apps_by_checksum` string[] — Allow apps by their checksum value.
      - `blocked_apps_by_checksum` string[] — Block apps by their checksum value.
      - `allowed_postback_event_counts` CommonPostbackEventCount[] — PostbackEventCount condition checks the number of specified events and accepts if there is one event that falls within given range of [start, end). In the example, User's event named "Transaction confirmation" must have been appeared 16 times or more to accept for zigbang app. Example: "condition": { "allowed_postback_event_counts": [ { "app_bundle": "com.chbreeze.jikbang4a", "range": { "start": 16, "end": 0 }, "events": [ "Transaction confirmation" ] } ] }
        - `app_bundle` string
        - `range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `events` string[]
      - `auction_types` string[] — Auction types including first price or second price auctions. Example: "condition": { "auction_types": [ "first", "second" ] }
      - `throttle_apt_tags` CommonTagsThrottleCondition — Tags Thrrottle Condition. It specifies a throttle rate for a list of tags. All the tags in a list will have same throttle rate.
        - `tags` string[]
        - `throttle_rate` number, float
      - `allowed_dev_makes` string[] — Allowed device make. Example: "condition":{ "allowed_dev_makes": [ "Apple" ] }
      - `blocked_dev_makes` string[] — Blocked device make. See the example of `allowed_dev_makes`.
      - `display_manager_versions` CommonDisplayManagerVersion[] — DisplayManager Version. Example: "condition": { "display_manager_versions": [ { "min": "1.2", "max": "4.5.6" } ] } // With minimum version requirement: "condition": { "display_manager_versions": [ { "min": "3.0" } ] } // With maximum version requirement: "condition": { "display_manager_versions": [ { "max": "5" } ] }
        - `min` string
        - `max` string
      - `allowed_audiences` string[] — Allowed audiences.
      - `blocked_audiences` string[] — Blocked audiences.
      - `allowed_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Postback event condition filter a bid-request by user's postback summary. Note that audience name and events are of case-sentitive string types. Each entry of allowed_postback_has_all_events_conditions will be satisfied when all listed events are found from user's postback summary.
        - `audiences` string[] — Audience name. i.e. app bundle.
        - `events` string[] — List of events such as install and purchase.
        - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
        - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
          - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
          - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
        - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
        - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
      - `blocked_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_all_events_conditions will be satisfied when all listed events are not found from user's postback summary.
        - `audiences` string[] — Audience name. i.e. app bundle.
        - `events` string[] — List of events such as install and purchase.
        - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
        - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
          - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
          - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
        - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
        - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
      - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[]
        - `audiences` string[] — Audience name. i.e. app bundle.
        - `events` string[] — List of events such as install and purchase.
        - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
        - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
          - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
          - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
        - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
        - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
      - `blocked_postback_has_any_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_any_events_conditions will be satisfied when there is at least one event not matched by the condition from user's postback summary. See the documentation for `allowed_postback_has_any_events_conditions`.
        - `audiences` string[] — Audience name. i.e. app bundle.
        - `events` string[] — List of events such as install and purchase.
        - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
        - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
        - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
          - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
          - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
        - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
        - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
          - `start` integer
          - `end` integer
      - `allowed_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used.
        - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target.
        - `zipcodes` LocationSetZipCodeSet[]
          - `zipcodes` string[] — Zipcodes to represent areas to target.
          - `country` string — Uppercase Country code in ISO 3166-1 alpha-2.
      - `blocked_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used.
        - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target.
        - `zipcodes` LocationSetZipCodeSet[]
          - `zipcodes` string[] — Zipcodes to represent areas to target.
          - `country` string — Uppercase Country code in ISO 3166-1 alpha-2.
      - `allowed_apt_tags` string[]
      - `blocked_apt_tags` string[]
      - `coppa_acceptance` 'UNKNOWN_COPPA' | 'ACCEPT_COPPA_ONLY' | 'DENY_COPPA' — Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act) value of BidRequest. - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value. - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1. - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field.
      - `skan_traffic` 'UNKNOWN_SKAN' | 'TARGET_SKAN_ONLY' | 'TARGET_NON_SKAN' — Indicates whether to bid according to bid requests that support SKAN(SKAdNetwork) or not. - UNKNOWN_SKAN: Doesn't filter BidRequest according to support skan or not in this filter. - TARGET_SKAN_ONLY: Bids only for skan support traffic. - TARGET_NON_SKAN: Bids only for non-skan traffic.
      - `contains_custom_audience` boolean — Whether it contains a `custom_audience` targeting condition. The `custom_audience` targeting condition is legacy, and may contain some internal information. Therefore, we do not reveal them by the API but only signals its non-emptiness with this field.
      - `custom_audience_set` AudienceTargetingConditionCustomAudienceSet — CustomAudienceSet represents a group of target users to whom we're going to show an ad. CustomAudienceSet is consist of a dynamic (not pre-determined) set of target users based on App-events described in the postback messages and pre-defined CustomerSets.
        - `include_having_all` CustomAudienceSetCustomAudienceCondition
          - `app_events` CustomAudienceSetAppEvent[]
            - `product_id` string — The ID of the Product of which PostbackIntegration info is used.
            - `event` string — A case-sensitive string name of an event. (e.g. install, purchase).
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
          - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
          - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
            - `product_id` string — The ID of the Product.
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
        - `include_having_any` CustomAudienceSetCustomAudienceCondition
          - `app_events` CustomAudienceSetAppEvent[]
            - `product_id` string — The ID of the Product of which PostbackIntegration info is used.
            - `event` string — A case-sensitive string name of an event. (e.g. install, purchase).
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
          - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
          - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
            - `product_id` string — The ID of the Product.
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
        - `exclude_having_all` CustomAudienceSetCustomAudienceCondition
          - `app_events` CustomAudienceSetAppEvent[]
            - `product_id` string — The ID of the Product of which PostbackIntegration info is used.
            - `event` string — A case-sensitive string name of an event. (e.g. install, purchase).
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
          - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
          - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
            - `product_id` string — The ID of the Product.
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
        - `exclude_having_any` CustomAudienceSetCustomAudienceCondition
          - `app_events` CustomAudienceSetAppEvent[]
            - `product_id` string — The ID of the Product of which PostbackIntegration info is used.
            - `event` string — A case-sensitive string name of an event. (e.g. install, purchase).
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
          - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
          - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
            - `product_id` string — The ID of the Product.
            - `sliding_window_duration` CommonTimeDuration — Represents a time duration with an amount and a unit.
              - …
  - `capper` AdclouddspAdCapper — AdCapper represents capping settings for an AdGroup.
    - `imp_interval` CommonTimeDuration — Represents a time duration with an amount and a unit.
      - `amount` string, int64
      - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
  - `pricing_model_id` string — PricingModel id.
  - `creative_group_ids` string[] — CreativeGroup IDs. These CreativeGroups' Product IDs must match the Product ID of the current Campaign. A Campaign eligible for serving must have at least one enabled CreativeGroup with enabled Creatives.
  - `user_buckets` AdcloudcommonInterval[] — User buckets for traffic control.
    - `start` integer
    - `end` integer
  - `audience_extension` DspAdGroupAudienceExtension — AdGroupAudienceExtension holds the ad_group settings for PAS audience extension.
    - `paired_ad_group_id` string — Audience extension paired ad group id.
    - `is_secondary` boolean — True for the secondary ad_group, otherwise false.
  - `created_at` string, date-time — Created time.
  - `updated_at` string, date-time — Last updated time. Should not modify on the client side.
  - `aud_size` string, int64 — Original audience size information.
  - `matchable_aud_size` string, int64 — Matchable audience size information.
  - `last_aud_size_computed_at` string, date-time — Last updated time of the audience size information.

## Response `200`

A successful response.

- MessagesUpdateAdGroupResponse
  - `ad_group` DspAdGroup — AdGroup represents the seed information for a full AdGroup used by bidders.
    - `id` string — Unique identifier of the AdGroup. Automatically set by server on creation.
    - `title` string, required — A descriptive name of the AdGroup.
    - `campaign_id` string — ID of the Campaign the AdGroup belongs to.
    - `product_id` string — ID of the Product the AdGroup belongs to.
    - `ad_account_id` string — ID of the AdAccount the AdGroup belongs to.
    - `experiment_id` string — ID of the Experiment the AdGroup is involved in.
    - `enabling_state` 'UNSPECIFIED' | 'ENABLED' | 'DISABLED' — Enumeration of the enabling states with a default UNSPECIFIED state.
    - `audience` AdclouddspAudience — Audience is a final form of AudienceTargeting specification. It is represented by a list of IDs of SharedAudienceTargets and an ad-hoc target condition. All conditions in the audience specification must be met to accept a bid-request. IDs of the SharedAudienceTargets can be either at global or AdAccount level.
      - `shared_audience_target_ids` string[] — A list of IDs for the named AudienceTargets referenced by this audience specification.
      - `targeting_condition` DspAudienceTargetingCondition — AudienceTargetingCondition specifies conditions for AudienceTargeting. This condition object contains various filters on multiple dimensions of bid-request, app, and user. Advertisers can selectively configure desired filters to form a meaningful AudienceTarget condition collectively. The configured individual filters must be satisfied unanimously in order for the resulting collective condition to be satisfied. Only filters with values will be effective. When a filter condition accepts a list of values, i.e., list of countries for "allowed_countries", the filter condition will be met when any match is found among the list. String literals are case insensitive unless specified otherwise; i.e. "USA" and "usa" equally represents the United States of America.
        - `allowed_countries` string[] — Allowed countries in ISO_3166-1_alpha-3 format.
        - `blocked_countries` string[] — Blocked countries in ISO_3166-1_alpha-3 format.
        - `placement_reasons` AudienceTargetingConditionPlacementReason[]
        - `custom_placement_reason` string — The reason of the placement in free-form text.
        - `allowed_app_bundles` string[] — App bundles. A bid-request having a matching publisher app bundle from the list will be accepted. Example to target com.moloco.game or com.moloco.travel apps: "allowed_app_bundles": [ "com.moloco.game", "com.moloco.travel" ] Example to exclude com.moloco.office app: "blocked_app_bundles": [ "com.moloco.office" ]
        - `blocked_app_bundles` string[] — See the documentation for `allowed_app_bundles`.
        - `allowed_content_categories` string[] — Filter for allowed publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "allowed_content_categories": [ "IAB26-1" ]
        - `blocked_content_categories` string[] — Filter for blocked publisher IAB categories. Valid category values can be found in section "5.1 Content Categories" in the "OpenRTB API Specification": https://github.com/openrtb/OpenRTB/blob/master/OpenRTB-API-Specification-Version-2-3-1-FINAL.pdf For example: "blocked_content_categories": [ "IAB26-1" ]
        - `allowed_cities` string[] — Allowed cities. A bid-request will be accepted when there is at least one match from the city list. Note that each element must be in the form of "city, region" such as "Seattle, WA" in order to disambiguate the same city but different regions. The entry is case-insensitive and whitespace will be ignored. Example to target Seattle or Newyork: "allowed_cities": [ "Seattle, WA", "Newyork, ny" ]
        - `blocked_cities` string[] — Blocked cities.
        - `allowed_creative_types` AdcloudcommonCreativeType[] — Allowed Creative types.
        - `blocked_creative_types` AdcloudcommonCreativeType[] — Blocked Creative types.
        - `allowed_websites` string[] — Allowed websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "allowed_websites": [ "*youtube.com" ].
        - `blocked_websites` string[] — Blocked websites. A glob pattern can be used for matching. Ignored for app inventories. For example: "blocked_websites": [ "*example.com" ].
        - `allowed_geofences` CommonCircle[] — Allowed geofences.
          - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
            - `latitude` number, double
            - `longitude` number, double
          - `radius` number, double
        - `blocked_geofences` CommonCircle[] — Blocked geofences.
          - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
            - `latitude` number, double
            - `longitude` number, double
          - `radius` number, double
        - `allowed_exchanges` CommonAdExchange[] — Allowed ad exchanges. Restricts targeting to bid only on the listed exchanges; an empty list places no restriction. MOLOCO_SDK is automatically included whenever the list is non-empty: submitting a non-empty list that omits MOLOCO_SDK will have it appended on the server side.
        - `blocked_exchanges` CommonAdExchange[] — Blocked ad exchanges. Excludes the listed exchanges from targeting. Adding MOLOCO_SDK to this list is rejected with PERMISSION_DENIED.
        - `allowed_idfas` string[] — Allowed user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f".
        - `blocked_idfas` string[] — Blocked user IDFAs. IDFA supports glob; e.g. use "*f" to match all IDFAs ending with "f".
        - `allowed_zipcodes` string[] — Allowed zipcodes.
        - `blocked_zipcodes` string[] — Blocked zipcodes.
        - `allowed_device_models` string[] — Allowed device models. For example: "allowed_device_models": [ "KFFOWI", "KFGIWI", "KFTT", "KFJWA" ]
        - `blocked_device_models` string[] — Blocked device models.
        - `allowed_user_audience_tags` string[] — Allowed user custom audience tags.
        - `blocked_user_audience_tags` string[] — Blocked user custom audience tags.
        - `allowed_languages` string[] — Allowed languages. Languages in use mostly follow ISO 639-1 code(https://www.loc.gov/standards/iso639-2/php/code_list.php), e.g. "ko" for Korean and "en" for English.
        - `blocked_languages` string[] — Blocked languages.
        - `allowed_device_types` CommonDeviceType[] — Allowed device types. For example: "allowed_device_types": [ "HIGHEND_PHONE", "TABLET" ]
        - `blocked_device_types` CommonDeviceType[] — Blocked device types. For example: "allowed_device_types": [ "SET_TOP_BOX" ]
        - `allowed_mostly_visited_countries` string[] — This filter checks user's history of mostly visited countries against the specified countries in the condition, and passes a request if there is at least one common entry in both lists.
        - `blocked_mostly_visited_countries` string[]
        - `allowed_regions` string[] — Regions are to filter a bid-request based on its region information.
        - `blocked_regions` string[]
        - `allowed_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[] — Recent Campaign activities filter a bid-request by user's recent activity such as click or install in the last n days. The filter is satisfied if there is at least one satisfying condition among the list. Example to target a user who has a click event for com.moloco.gameapp: "allowed_recent_campaign_activities": [ { "campaign_id": "com.moloco.gameapp", "event": "CLICK" } ] Example to block a user who has a install event for com.moloco.officeapp within the past five days: "blocked_recent_campaign_activities": [ { "campaign_id": "com.moloco.officeapp", "event": "INSTALL", "last_n_days": 5 } ]
          - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install.
          - `campaign_id` string, required — ID of the Campaign to filter on.
          - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
        - `blocked_recent_campaign_activities` AudienceTargetingConditionRecentCampaignActivityFilter[]
          - `event` 'UNKNOWN_EVENT_TYPE' | 'BID_MADE' | 'BID_WON' | 'IMPRESSION' | 'IMPRESSION_EXTRA' | 'CLICK' | 'INSTALL' | 'CUSTOM', required — Enumeration of event types supported by Moloco Ads. This value is not part of the specification. - BID_MADE: A bid has been made for a bid request. - BID_WON: The bid has won the auction. - IMPRESSION: The ad impression has been served to the user. - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown. - CLICK: The ad has been clicked by the user. - INSTALL: The ad impression or click has been attributed with an app install. - CUSTOM: Custom actions that happen after install.
          - `campaign_id` string, required — ID of the Campaign to filter on.
          - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
        - `allowed_locations` AudienceTargetingConditionLocationFilter[] — Location filter targets specific geo-locational audience using combined conditions of different types such as city, region, zipcode and geofence.
          - `cities` string[]
          - `regions` string[]
          - `zipcodes` string[]
          - `geofences` CommonCircle[]
            - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
              - …
            - `radius` number, double
        - `blocked_locations` AudienceTargetingConditionLocationFilter[]
          - `cities` string[]
          - `regions` string[]
          - `zipcodes` string[]
          - `geofences` CommonCircle[]
            - `center` CommonLatLng — Point defines a geo location by latitude, longitude.
              - …
            - `radius` number, double
        - `genders` CommonGender[]
        - `connection_types` string[] — Connection_types include ETHERNET, WIFI, CELL_UNKNOWN, CELL_2G, CELL_3G, CELL_4G. For example: "connection_types": [ "WIFI", "CELL_4G" ]
        - `allowed_direct_deal_ids` string[] — IDs of the allowed direct deals. A bid-request is accepted only if there is at least one matching id. For example: "allowed_direct_deal_ids": [ "ip_9161499632014fe8b9ef60673a51b745", "ip_e13c0cb23dd54a8ea742b2af61e0712d", "ip_0cfeaebb190d47df8b86399232853e23" ]
        - `blocked_direct_deal_ids` string[] — IDs of the blocked direct deals.
        - `device_oses` AudienceTargetingConditionDeviceOsFilter[] — Device OS requirements if specified.
          - `os` 'UNKNOWN_DEVICE_OS' | 'ANDROID' | 'IOS' | 'VERSATILE' | 'MOBILE_WEB' | 'MACOS' | 'WINDOWS' | 'NEXT_VERSATILE', required — Enumeration of device OS types supported by Moloco Ads. This value is not part of the specification. - ANDROID: Android device OS. - IOS: iOS device OS. - VERSATILE: Product with multiple OSes. Specifically for CTV. - MOBILE_WEB: OS for mobile web traffic. - MACOS: OS for MacOS traffic. - WINDOWS: OS for Windows traffic. - NEXT_VERSATILE: OS for Next web product.
          - `min_version` string
          - `max_version` string
        - `media_channel_type` 'UNKNOWN_MEDIA_CHANNEL_TYPE' | 'APP' | 'WEB' — - UNKNOWN_MEDIA_CHANNEL_TYPE: This value is not part of the specification.
        - `new_users` AudienceTargetingConditionNewUserFilter — Filter to target new users only.
          - `last_n_days` integer, required — Target only new users with earliest known activities falling into the window of last N days.
        - `advertiser_id_types` CommonAdvertiserIdType[] — Filter on advising ID types, including "ANDROID_IDFA" or "IOS_IDFA".
        - `allowed_video_types` DspAudienceTargetingConditionVideoType[] — Video type filter. Ignored when the bid request is not for video ads.
        - `blocked_video_types` DspAudienceTargetingConditionVideoType[]
        - `weekly_schedules` AudienceTargetingConditionWeeklyScheduleFilter[] — Weekly schedule specifies more fine-grained time range filtering for days of a week. For example, this list can be used to specify commute time ranges in the morning and evening on workdays. Example to target 7-9 am and 5-7 pm during week days: "weekly_schedules": [ { "hour_range": { "start": 7, "end": 9 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] }, { "hour_range": { "start": 17, "end": 19 }, "days": [ "MON", "TUE", "WED", "THU", "FRI" ] } ] Example to target 10pm to 2am on Fridays and Saturdays: "weekly_schedules": [ { "range": { "start": 22, "end": 2 }, "days": [ "FRI", "SAT" ] } ]
          - `timezone_policy` 'UNKNOWN_TIME' | 'DEVICE_TIME' | 'UTC_TIME' | 'AD_ACCOUNT_TIME' | 'ADVERTISER_TIME' — TimezonePolicy defines the time configuration. - DEVICE_TIME: Time object is given in the device's time (depends on user device timezone). - UTC_TIME: Time object is given in the fixed UTC time (depends on nothing). - AD_ACCOUNT_TIME: Given time is given in fixed ad account time (depends on ad account timezone).
          - `hour_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `days` AdcloudcommonDayOfWeek[], required — Days of week to filter on. At least one is required.
        - `allowed_gender_score` AdcloudcommonFloatingPointRange
          - `start` number, double
          - `end` number, double
        - `blocked_gender_score` AdcloudcommonFloatingPointRange
          - `start` number, double
          - `end` number, double
        - `allowed_ages` AdcloudcommonInterval[] — Age is used to filter based on user's approximate age. A valid value must be in the exclusive range of (0, 100).
          - `start` integer
          - `end` integer
        - `blocked_ages` AdcloudcommonInterval[]
          - `start` integer
          - `end` integer
        - `allowed_ip_ranges` string[] — IP net based condition. The CIDR format must be used for an entry such as https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Note that both of IP v4 and v6 could be used at the same time. Example to block bid-requests with any IP within 32.76.52.0 - 32.76.52.255 or 127.0.0.0 - 127.255.255.255: "blocked_ip_ranges": [ "32.76.52.0/24", "127.0.0.0/8" ]
        - `blocked_ip_ranges` string[]
        - `allowed_device_carriers` string[] — Device carrier filter. Example to target SKT: "allowed_device_carriers": [ "SKTelecom" ] Example to exclude T-MOBILE and XFINITY Mobile "blocked_device_carriers": [ "T-MOBILE", "XFINITY Mobile" ]
        - `blocked_device_carriers` string[]
        - `allowed_keywords` string[] — Filter regarding 'keywords' field in a bid request. If specified, an ad request must have at least one of the allowed keywords to satisfy the filter.
        - `blocked_keywords` string[] — Filter regarding 'keywords' field in a bid request. An ad request must not have any of the blocked keywords to satisfy the filter.
        - `user_buckets` AdcloudcommonInterval[] — Filter for the user buckets.
          - `start` integer
          - `end` integer
        - `allowed_ad_units` string[] — // Target timetree_i_prod or timetree_a_prod ad_units "condition": { "allowed_ad_units": [ "timetree_i_prod", "timetree_a_prod" ] } // Exclude timetree_i_test ad_unit "condition": { "blocked_ad_units": [ "timetree_i_test" ] }
        - `blocked_ad_units` string[]
        - `allowed_placements` string[] — placement (a group of ad_units) names. It is untied to ad_units, and follow the ad_unit's filtering rule.
        - `blocked_placements` string[]
        - `allowed_banner_apis` CommonBannerApi[] — // Target MRAID_2 banner only "condition": { "allowed_banner_apis": [ "MRAID_2" ] }
        - `blocked_banner_apis` CommonBannerApi[]
        - `schedule` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
          - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
          - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
        - `audience_data` CommonAudienceData — Audience Data. It is a filter based on AudienceData stored in UPT.
          - `provider` string
          - `condition` string
        - `allowed_apps_by_checksum` string[] — Allow apps by their checksum value.
        - `blocked_apps_by_checksum` string[] — Block apps by their checksum value.
        - `allowed_postback_event_counts` CommonPostbackEventCount[] — PostbackEventCount condition checks the number of specified events and accepts if there is one event that falls within given range of [start, end). In the example, User's event named "Transaction confirmation" must have been appeared 16 times or more to accept for zigbang app. Example: "condition": { "allowed_postback_event_counts": [ { "app_bundle": "com.chbreeze.jikbang4a", "range": { "start": 16, "end": 0 }, "events": [ "Transaction confirmation" ] } ] }
          - `app_bundle` string
          - `range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `events` string[]
        - `auction_types` string[] — Auction types including first price or second price auctions. Example: "condition": { "auction_types": [ "first", "second" ] }
        - `throttle_apt_tags` CommonTagsThrottleCondition — Tags Thrrottle Condition. It specifies a throttle rate for a list of tags. All the tags in a list will have same throttle rate.
          - `tags` string[]
          - `throttle_rate` number, float
        - `allowed_dev_makes` string[] — Allowed device make. Example: "condition":{ "allowed_dev_makes": [ "Apple" ] }
        - `blocked_dev_makes` string[] — Blocked device make. See the example of `allowed_dev_makes`.
        - `display_manager_versions` CommonDisplayManagerVersion[] — DisplayManager Version. Example: "condition": { "display_manager_versions": [ { "min": "1.2", "max": "4.5.6" } ] } // With minimum version requirement: "condition": { "display_manager_versions": [ { "min": "3.0" } ] } // With maximum version requirement: "condition": { "display_manager_versions": [ { "max": "5" } ] }
          - `min` string
          - `max` string
        - `allowed_audiences` string[] — Allowed audiences.
        - `blocked_audiences` string[] — Blocked audiences.
        - `allowed_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Postback event condition filter a bid-request by user's postback summary. Note that audience name and events are of case-sentitive string types. Each entry of allowed_postback_has_all_events_conditions will be satisfied when all listed events are found from user's postback summary.
          - `audiences` string[] — Audience name. i.e. app bundle.
          - `events` string[] — List of events such as install and purchase.
          - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
          - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
            - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
            - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
          - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
          - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
        - `blocked_postback_has_all_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_all_events_conditions will be satisfied when all listed events are not found from user's postback summary.
          - `audiences` string[] — Audience name. i.e. app bundle.
          - `events` string[] — List of events such as install and purchase.
          - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
          - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
            - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
            - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
          - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
          - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
        - `allowed_postback_has_any_events_conditions` CommonPostbackEventsCondition[]
          - `audiences` string[] — Audience name. i.e. app bundle.
          - `events` string[] — List of events such as install and purchase.
          - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
          - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
            - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
            - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
          - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
          - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
        - `blocked_postback_has_any_events_conditions` CommonPostbackEventsCondition[] — Each entry of blocked_postback_has_any_events_conditions will be satisfied when there is at least one event not matched by the condition from user's postback summary. See the documentation for `allowed_postback_has_any_events_conditions`.
          - `audiences` string[] — Audience name. i.e. app bundle.
          - `events` string[] — List of events such as install and purchase.
          - `past_time_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
          - `past_time_range_unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
          - `range` CommonTimeInterval — Interval with start and end timestamps in RFC3339 format.
            - `start` string, date-time — Start time in RFC3339 format, e.g. "2017-04-01T12:34:56+00:00".
            - `end` string, date-time — End time in RFC3339 format, e.g. "2017-05-01-T21:09:08+00:00".
          - `short_term_user_profile` boolean — If set, short-term user profile information is used to evaluate this condition.
          - `count_range` AdcloudcommonInterval — Interval represents a contiguous integer range [start, end).
            - `start` integer
            - `end` integer
        - `allowed_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used.
          - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target.
          - `zipcodes` LocationSetZipCodeSet[]
            - `zipcodes` string[] — Zipcodes to represent areas to target.
            - `country` string — Uppercase Country code in ISO 3166-1 alpha-2.
        - `blocked_location_set` AudienceTargetingConditionLocationSet — LocationSet represents target areas to allow or block. If multiple fields are set, a union of them is used.
          - `osm_ids` string[] — OpenStreetMap IDs to represent areas to target.
          - `zipcodes` LocationSetZipCodeSet[]
            - `zipcodes` string[] — Zipcodes to represent areas to target.
            - `country` string — Uppercase Country code in ISO 3166-1 alpha-2.
        - `allowed_apt_tags` string[]
        - `blocked_apt_tags` string[]
        - `coppa_acceptance` 'UNKNOWN_COPPA' | 'ACCEPT_COPPA_ONLY' | 'DENY_COPPA' — Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act) value of BidRequest. - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value. - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1. - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field.
        - `skan_traffic` 'UNKNOWN_SKAN' | 'TARGET_SKAN_ONLY' | 'TARGET_NON_SKAN' — Indicates whether to bid according to bid requests that support SKAN(SKAdNetwork) or not. - UNKNOWN_SKAN: Doesn't filter BidRequest according to support skan or not in this filter. - TARGET_SKAN_ONLY: Bids only for skan support traffic. - TARGET_NON_SKAN: Bids only for non-skan traffic.
        - `contains_custom_audience` boolean — Whether it contains a `custom_audience` targeting condition. The `custom_audience` targeting condition is legacy, and may contain some internal information. Therefore, we do not reveal them by the API but only signals its non-emptiness with this field.
        - `custom_audience_set` AudienceTargetingConditionCustomAudienceSet — CustomAudienceSet represents a group of target users to whom we're going to show an ad. CustomAudienceSet is consist of a dynamic (not pre-determined) set of target users based on App-events described in the postback messages and pre-defined CustomerSets.
          - `include_having_all` CustomAudienceSetCustomAudienceCondition
            - `app_events` CustomAudienceSetAppEvent[]
              - …
            - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
            - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
              - …
          - `include_having_any` CustomAudienceSetCustomAudienceCondition
            - `app_events` CustomAudienceSetAppEvent[]
              - …
            - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
            - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
              - …
          - `exclude_having_all` CustomAudienceSetCustomAudienceCondition
            - `app_events` CustomAudienceSetAppEvent[]
              - …
            - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
            - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
              - …
          - `exclude_having_any` CustomAudienceSetCustomAudienceCondition
            - `app_events` CustomAudienceSetAppEvent[]
              - …
            - `user_lists` string[] — IDs of pre-defined CustomerSets. IP CustomerSet is not included.
            - `apps` CustomAudienceSetApp[] — Matches users by app engagement regardless of event type.
              - …
    - `capper` AdclouddspAdCapper — AdCapper represents capping settings for an AdGroup.
      - `imp_interval` CommonTimeDuration — Represents a time duration with an amount and a unit.
        - `amount` string, int64
        - `unit` 'UNKNOWN_TIME_UNIT' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' — A unit of time, e.g. second, minute, etc. This value is not part of the specification.
    - `pricing_model_id` string — PricingModel id.
    - `creative_group_ids` string[] — CreativeGroup IDs. These CreativeGroups' Product IDs must match the Product ID of the current Campaign. A Campaign eligible for serving must have at least one enabled CreativeGroup with enabled Creatives.
    - `user_buckets` AdcloudcommonInterval[] — User buckets for traffic control.
      - `start` integer
      - `end` integer
    - `audience_extension` DspAdGroupAudienceExtension — AdGroupAudienceExtension holds the ad_group settings for PAS audience extension.
      - `paired_ad_group_id` string — Audience extension paired ad group id.
      - `is_secondary` boolean — True for the secondary ad_group, otherwise false.
    - `created_at` string, date-time — Created time.
    - `updated_at` string, date-time — Last updated time. Should not modify on the client side.
    - `aud_size` string, int64 — Original audience size information.
    - `matchable_aud_size` string, int64 — Matchable audience size information.
    - `last_aud_size_computed_at` string, date-time — Last updated time of the audience size information.

## Other responses

- `default` — Error. Detailed cause can be found in the `details` field.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)