MOLOCO Creative Group API

openapi: 3.2.0
info:
  title: Moloco Creative Group API
  version: '1.10'
  contact:
    name: Moloco Inc.
    url: https://www.moloco.com
  description: 'Operations tagged CreativeGroup across 2 of this provider''s published API definitions: moloco-ads-campaign-management-api.json, moloco-ads-campaign-management-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.moloco.cloud
security:
- Bearer: []
tags:
- name: CreativeGroup
paths:
  /cm/v1/creative-groups:
    get:
      summary: List up CreativeGroups.
      description: List up all CreativeGroups of the AdAccount or the Product.
      operationId: DspApi_ListCreativeGroups
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesListCreativeGroupsResponse'
        default:
          description: Error. Detailed cause can be found in the `details` field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesListCreativeGroupsError'
      parameters:
      - name: ad_account_id
        description: The AdAccount ID of the listing CreativeGroups belong to.
        in: query
        required: true
        schema:
          type: string
      - name: product_id
        description: The Product ID to which the CreativeGroups belong.
        in: query
        required: false
        schema:
          type: string
      - name: inquiry_option
        description: "InquiryOption to specify which information to retrieve.\n\n - INQUIRY_ENTITY: Only the target entity itself is returned in response.\nThis InquiryOption is faster than other options as it reads the single entity from the database.\n - INQUIRY_OVERVIEW: The target entity's overview information is returned in response.\nIn general, the overview information includes the brief content of the target entity and its related entities.\nThis InquiryOption is slower than INQUIRY_ENTITY but the returned data size is usually smaller than that.\n - INQUIRY_ALL: The target entity and its summary information is returned in response.\nThis InquiryOption is equivalent to INQUIRY_ENTITY + INQUIRY_OVERVIEW, and it's slow and big."
        in: query
        required: false
        schema:
          type: string
          enum:
          - UNKNOWN_INQUIRY_OPTION
          - INQUIRY_ENTITY
          - INQUIRY_OVERVIEW
          - INQUIRY_ALL
          default: UNKNOWN_INQUIRY_OPTION
      tags:
      - CreativeGroup
    delete:
      summary: Delete existing CreativeGroups.
      description: Delete existing CreativeGroups.
      operationId: DspApi_DeleteCreativeGroupsBulk
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesDeleteCreativeGroupsBulkResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      parameters:
      - name: ad_account_id
        description: The AdAccount ID of the CreativeGroups to be deleted.
        in: query
        required: true
        schema:
          type: string
      - name: creative_group_ids
        description: The ID of the CreativeGroups to be deleted.
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
      tags:
      - CreativeGroup
    post:
      summary: Create a new CreativeGroup.
      description: Create a new CreativeGroup of the Product.
      operationId: DspApi_CreateCreativeGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesCreateCreativeGroupResponse'
        default:
          description: Error. Detailed cause can be found in the `details` field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesCreateCreativeGroupError'
      parameters:
      - name: ad_account_id
        description: The AdAccount ID to which the CreativeGroup belongs to.
        in: query
        required: true
        schema:
          type: string
      - name: product_id
        description: The Product ID to which the CreativeGroup belongs to.
        in: query
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dspCreativeGroup'
        description: The CreativeGroup data to be created.
        required: true
      tags:
      - CreativeGroup
    servers:
    - url: https://api.moloco.cloud
  /cm/v1/creative-groups/sync-clones:
    post:
      summary: Copy CreativeGroups synchronously.
      description: Copy selected CreativeGroups from one Product to another(or the same) Product within an AdAccount synchronously.
      operationId: DspApi_CopyCreativeGroupsSync
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesCopyCreativeGroupsSyncResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/messagesCopyCreativeGroupsSyncRequest'
        required: true
      tags:
      - CreativeGroup
    servers:
    - url: https://api.moloco.cloud
  /cm/v1/creative-groups/{creative_group_id}:
    get:
      summary: Read an existing CreativeGroup.
      description: Read an existing CreativeGroup.
      operationId: DspApi_ReadCreativeGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesReadCreativeGroupResponse'
        default:
          description: Error. Detailed cause can be found in the `details` field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesReadCreativeGroupError'
      parameters:
      - name: creative_group_id
        description: The ID of the CreativeGroup to be retrieved.
        in: path
        required: true
        schema:
          type: string
      - name: inquiry_option
        description: "InquiryOption to specify which information to retrieve.\n\n - INQUIRY_ENTITY: Only the target entity itself is returned in response.\nThis InquiryOption is faster than other options as it reads the single entity from the database.\n - INQUIRY_OVERVIEW: The target entity's overview information is returned in response.\nIn general, the overview information includes the brief content of the target entity and its related entities.\nThis InquiryOption is slower than INQUIRY_ENTITY but the returned data size is usually smaller than that.\n - INQUIRY_ALL: The target entity and its summary information is returned in response.\nThis InquiryOption is equivalent to INQUIRY_ENTITY + INQUIRY_OVERVIEW, and it's slow and big."
        in: query
        required: false
        schema:
          type: string
          enum:
          - UNKNOWN_INQUIRY_OPTION
          - INQUIRY_ENTITY
          - INQUIRY_OVERVIEW
          - INQUIRY_ALL
          default: UNKNOWN_INQUIRY_OPTION
      tags:
      - CreativeGroup
    delete:
      summary: Delete an existing CreativeGroup.
      description: Delete an existing CreativeGroup.
      operationId: DspApi_DeleteCreativeGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesDeleteCreativeGroupResponse'
        default:
          description: Error. Detailed cause can be found in the `details` field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesDeleteCreativeGroupError'
      parameters:
      - name: creative_group_id
        description: The ID of the CreativeGroup to be deleted.
        in: path
        required: true
        schema:
          type: string
      tags:
      - CreativeGroup
    put:
      summary: Update an existing CreativeGroup.
      description: Update an existing CreativeGroup.
      operationId: DspApi_UpdateCreativeGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesUpdateCreativeGroupResponse'
        default:
          description: Error. Detailed cause can be found in the `details` field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messagesUpdateCreativeGroupError'
      parameters:
      - name: creative_group_id
        description: The ID of the CreativeGroup to be updated.
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dspCreativeGroup'
        description: The CreativeGroup data to be updated.
        required: true
      tags:
      - CreativeGroup
    servers:
    - url: https://api.moloco.cloud
components:
  schemas:
    messagesUpdateCreativeGroupErrorAPIErrorInfoErrorReason:
      type: string
      enum:
      - ERROR_REASON_UNKNOWN
      - CREATIVE_GROUP_FEATURE_TYPE_NOT_MATCH_CREATIVE_FEATURE_TYPE
      - CREATIVE_GROUP_NEEDS_PRODUCT
      - CREATIVE_GROUP_STATUS_CHANGE_NOT_ALLOWED
      - CREATIVE_GROUP_VIDEO_AD_EVENT_TRACKERS_EXCEED_LIMIT
      default: ERROR_REASON_UNKNOWN
      description: " - CREATIVE_GROUP_FEATURE_TYPE_NOT_MATCH_CREATIVE_FEATURE_TYPE: The feature type of Creative should match the feature type of Creative Group.\n - CREATIVE_GROUP_NEEDS_PRODUCT: CreativeGroup with TrackingLink or LandingUrl needs Product.\n - CREATIVE_GROUP_STATUS_CHANGE_NOT_ALLOWED: Change to requested status is not allowed.\n - CREATIVE_GROUP_VIDEO_AD_EVENT_TRACKERS_EXCEED_LIMIT: The number of trackers used from VideoAdEventTrackers exceeds limit. The limit is up to 3 per event."
    adcloudcommonEventType:
      type: string
      enum:
      - UNKNOWN_EVENT_TYPE
      - BID_MADE
      - BID_WON
      - IMPRESSION
      - IMPRESSION_EXTRA
      - CLICK
      - INSTALL
      - CUSTOM
      default: UNKNOWN_EVENT_TYPE
      description: "Enumeration of event types supported by Moloco Ads.\n\nThis value is not part of the specification.\n\n - BID_MADE: A bid has been made for a bid request.\n - BID_WON: The bid has won the auction.\n - IMPRESSION: The ad impression has been served to the user.\n - IMPRESSION_EXTRA: Extra ad impression tracking info, e.g. 50% of a video ad has been shown.\n - CLICK: The ad has been clicked by the user.\n - INSTALL: The ad impression or click has been attributed with an app install.\n - CUSTOM: Custom actions that happen after install."
    adcloudcommonInterval:
      type: object
      properties:
        start:
          type: integer
          format: int32
        end:
          type: integer
          format: int32
      description: Interval represents a contiguous integer range [start, end).
    CampaignGoalOptimizeClicksToApp:
      type: object
      properties:
        target_cpc:
          $ref: '#/components/schemas/adcloudcommonMoney'
          description: 'Target cost per click in AdAccount-wide currency.

            Required when the mode is TARGET_CPC_CENTRIC.'
        mode:
          $ref: '#/components/schemas/CampaignGoalOptimizeClicksToAppMode'
          description: Optimization mode.
        rate:
          type: number
          format: double
          description: 'Budget-centric uses one ratio of daily budget for the autopilot to spend. It''s only for DCPM.

            Required when the mode is BUDGET_CENTRIC.

            Its rate should be in (0, 2].'
      description: Detailed configuration of OPTIMIZE_CPC_FOR_APP_UA goal.
    commonEnablingState:
      type: string
      enum:
      - UNSPECIFIED
      - ENABLED
      - DISABLED
      default: UNSPECIFIED
      description: Enumeration of the enabling states with a default UNSPECIFIED state.
    messagesDeleteCreativeGroupErrorAPIErrorInfoErrorReason:
      type: string
      enum:
      - ERROR_REASON_UNKNOWN
      default: ERROR_REASON_UNKNOWN
    messagesReadCreativeGroupResponse:
      type: object
      properties:
        creative_group:
          $ref: '#/components/schemas/dspCreativeGroup'
          description: 'The retrieved CreativeGroup data.

            This field is valid if the inquiry_option of the request is UNKNOWN_INQUIRY_OPTION or INQUIRY_ENTITY or INQUIRY_ALL.'
        creative_group_overview:
          $ref: '#/components/schemas/dspReadCreativeGroupOverview'
          description: 'The retrieved CreativeGroup overview information.

            This field is valid if the inquiry_option of the request is INQUIRY_OVERVIEW or INQUIRY_ALL.'
        creatives:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspCreative'
          description: The Creatives in the retrieved CreativeGroup.
        tracking_link:
          $ref: '#/components/schemas/dspTrackingLink'
          description: The TrackingLink used in the retrieved CreativeGroup.
    CampaignGoalOptimizeAppInstallsMode:
      type: string
      enum:
      - UNKNOWN_MODE
      - TARGET_CPI_CENTRIC
      - BUDGET_CENTRIC
      - MARGIN_CENTRIC
      - FIXED
      default: UNKNOWN_MODE
      description: ' - FIXED: Read-only for AdCloud.'
    commonCircle:
      type: object
      properties:
        center:
          $ref: '#/components/schemas/commonLatLng'
        radius:
          type: number
          format: double
      description: Circle defines a circle with a center geo location and radius in km.
    CampaignGoalOptimizeCpaForWebUaMode:
      type: string
      enum:
      - UNKNOWN_MODE
      - BUDGET_CENTRIC
      default: UNKNOWN_MODE
    dspCreativeDynamicHtmlSrcPolicy:
      type: object
      properties:
        function:
          $ref: '#/components/schemas/PolicyPolicyFunction'
          description: 'Algorithm for selecting CatalogItems or CreativeElements for a game.

            PolicyFunction can be thought of as a function: PolicyFunctionConfig -> Policy -> CatalogItem list.

            In case a PolicyFunction does not need PolicyFunctionConfig, it can be thought of as

            Policy -> CatalogItem/CreativeElement list.'
        function_config:
          $ref: '#/components/schemas/PolicyPolicyFunctionConfig'
        num_items:
          type: integer
          format: int32
          description: Number of items to be selected.
        catalog:
          type: string
          description: Catalog ID. To know the types of catalogs supported, contact customer support.
        item_capper:
          $ref: '#/components/schemas/PolicyItemCapper'
      description: Policy defines how to select CatalogItems.
    dspCreativeGroupAction:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the Action. Automatically set by server on creation.
        user_id:
          type: string
          description: ID of the user who initiated this action if it's applicable.
        user_display_name:
          type: string
          description: Display name of the user by whom the action was taken.
        action_type:
          $ref: '#/components/schemas/CreativeGroupActionType'
          description: The type of an action.
        comment:
          type: string
          description: Comment for the action.
        created_at:
          type: string
          format: date-time
          description: Created time.
          readOnly: true
      description: The details of an action taken on the CreativeGroup.
    dspCreativeDynamicHtmlSrc:
      type: object
      properties:
        template_id:
          type: string
          description: ID of the template used to render this Creative.
        template_env:
          type: object
          additionalProperties:
            type: string
          description: Environment used to render this Creative.
        rendered_entry_html:
          type: string
          description: The entry HTML of the rendered Creative.
        html_requirement_attributes:
          $ref: '#/components/schemas/dspCreativeHtmlRequirementAttributes'
          description: 'Requirements of this Creative. Based on this field and inventory''s excludable Creative attributes,

            Moloco can filter out this Creative at serving time.'
        html_size_attributes:
          $ref: '#/components/schemas/dspCreativeHtmlSizeAttributes'
          description: Size-related attributes of this Creative.
        policy:
          $ref: '#/components/schemas/dspCreativeDynamicHtmlSrcPolicy'
          description: Policy defines how to select CatalogItems.
      description: '(Will be supported soon) Dynamic Creative. An instance of this would be used for Creatives to be rendered when

        the Creative is shown to user, i.e. an impression takes place, unlike bid-time rendering

        for static images.'
      required:
      - template_id
      - rendered_entry_html
    dspAdvertiserInfo:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the advertiser.
        title:
          type: string
          description: A descriptive name of the advertiser.
        description:
          type: string
          description: A description of the advertiser.
      description: 'AdvertiserInfo contains some basic information about an advertiser.

        It may be returned to Creative reviewers or other users with other non-advertiser roles

        to perform their duty without leaking any private advertiser information.'
    CampaignGoalOptimizeAppRoas:
      type: object
      properties:
        target_roas:
          type: number
          format: double
          description: 'Target return on advertising spend (ROAS) in percent.

            For example, a value 312.5 denotes 312.5% ROAS.'
        revenue_actions:
          type: array
          items:
            type: string
          description: 'In-app action events having revenue value the AdAccount wants to achieve.


            Remarkable notes:

            - Case-sensitive as specified in the post-back from MMP.

            - ROAS computation will rely on the accompanied revenue value to each action.'
        target_cpi:
          $ref: '#/components/schemas/adcloudcommonMoney'
          description: 'Target cost per install in AdAccount-wide currency.


            Remarkable notes:

            - As of June 2019, this value is meaningful only for Campaigns of APP_USER_ACQUISITION type.'
        mode:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppRoasMode'
          description: Optimization mode.
        rate:
          type: number
          format: double
          description: 'The ratio of the daily budget for the autopilot to spend. Required when the mode is BUDGET_CENTRIC.

            The rate should be in (0, 2].'
        margin:
          type: number
          format: double
          description: 'The ratio of the margin for the autopilot to spend. Required when the mode is MARGIN_CENTRIC.

            The rate should be in [-1.0, 1.0].'
      required:
      - revenue_actions
    dspCreativeGroupOverview:
      type: object
      properties:
        id:
          type: string
          description: ID of the CreativeGroup.
        title:
          type: string
          description: Descriptive name of the CreativeGroup.
        description:
          type: string
          description: Optional description about this CreativeGroup.
        tracking_link_id:
          type: string
          description: ID of the TrackingLink used in this CreativeGroup.
        tracking_link_title:
          type: string
          description: Title of the TrackingLink used in this CreativeGroup.
        landing_url:
          type: string
          description: Landing URL used in this CreativeGroup.
        image_creatives_count:
          type: integer
          format: int64
          description: Number of image Creatives.
        video_creatives_count:
          type: integer
          format: int64
          description: Number of video Creatives.
        native_creatives_count:
          type: integer
          format: int64
          description: Number of native Creatives.
        etc_creatives_count:
          type: integer
          format: int64
          description: Number of Creatives which are not image, video, native type.
        enabling_state:
          $ref: '#/components/schemas/commonEnablingState'
          description: Enabling state of the CreativeGroup set by user.
        state:
          $ref: '#/components/schemas/commonEnablingState'
          description: 'CreativeGroup''s overall state which represents it''s ready for bidding or not

            by evaluating it''s related entities.

            It''s ENABLED if and only if it''s included in the enabled campaign.

            More details can be found in `inactive_reasons` field if it''s DISABLED.'
        inactive_reasons:
          type: array
          items:
            $ref: '#/components/schemas/dspCreativeGroupInactiveReason'
          description: "Inactive reasons of CreativeGroup if the CreativeGroup is not used for bidding.\n\n - NO_CREATIVE: It implies that the CreativeGroup has no Creative.\n - NO_ADGROUP: It implies that the CreativeGroup is not linked to any AdGroup.\n - SCHEDULED: It implies that the CreativeGroup is scheduled to run at a future day/time.\n - NO_ENABLED_CREATIVE: It implies that the CreativeGroup has no enabled Creative. If a CreativeGroup has NO_CREATIVE as inactive reasons, NO_ENABLED_CREATIVE won't be included.\n - NO_ENABLED_ADGROUP: It implies that the CreativeGroup is not linked to any enabled AdGroup. If a CreativeGroup has NO_ADGROUP as inactive reasons, NO_ENABLED_ADGROUP won't be included.\n - NO_ENABLED_CAMPAIGN: It implies that the CreativeGroup is not linked to any enabled Campaign. If a CreativeGroup has NO_ADGROUP as inactive reasons, which implies it doesn't belongs to any campaign too, so NO_ENABLED_CAMPAIGN won't be included.\n - DISABLED_CREATIVE_GROUP: It implies that the CreativeGroup's enabling state is set as DISABLED.\n - ENDED: It implies that the CreativeGroup has passed its schedule end date."
        creative_group_referrer_infos:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/dspCreativeGroupReferrerInfo'
          description: CreativeGroupReferrerInfo is data of the CreativeGroup's relational entities which use the CreativeGroup.
        feature_type:
          $ref: '#/components/schemas/adcloudcommonCreativeFeatureType'
          description: Feature type of the CreativeGroup.
        created_at:
          type: string
          format: date-time
          description: Created time.
          readOnly: true
        updated_at:
          type: string
          format: date-time
          description: Last updated time. Should not modify on the client side.
      description: 'CreativeGroupOverview is an overview information of CreativeGroup entity.

        Retrieved when the inquiry_option = INQUIRY_OVERVIEW.'
    CampaignGoalOptimizeAppRetention:
      type: object
      properties:
        mode:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppRetentionMode'
          description: Optimization mode.
        target_cpi:
          $ref: '#/components/schemas/adcloudcommonMoney'
          description: 'Target cost per install in AdAccount-wide currency.

            Required when the mode is BUDGET_CENTRIC and rate is unset.'
        rate:
          type: number
          format: double
          description: 'The ratio of the daily budget for the autopilot to spend.

            Required when the mode is BUDGET_CENTRIC and target_cpi is unset.

            The rate should be in (0, 2].'
        margin:
          type: number
          format: double
          description: 'The ratio of the margin for the autopilot to spend.

            Required when the mode is MARGIN_CENTRIC.

            The rate should be in [-1.0, 1.0].'
      description: Detailed configuration of OPTIMIZE_RETENTION_FOR_APP_UA goal.
    dspCreativeVastVideoSrc:
      type: object
      properties:
        vast_tag:
          type: string
          description: 'VAST tag to be used in VAST wrapper.

            E.g. [Example here](https://github.com/InteractiveAdvertisingBureau/VAST_Samples/blob/master/VAST%201-2.0%20Samples/Tremor-Video-Samples/vast_wrapper_linear_1.xml).'
        width:
          type: integer
          format: int64
          description: Width of the Creative.
          readOnly: true
        height:
          type: integer
          format: int64
          description: Height of the Creative.
          readOnly: true
        length_seconds:
          type: integer
          format: int64
          description: Vast video length in seconds.
      description: Source of VAST (Video Ad Serving Template) video Creative.
      required:
      - vast_tag
    PolicyFunctionConfigGameConfig:
      type: object
      properties:
        game_id:
          type: string
          description: Game id. it should correspond to GameID of dcr/api.proto.
    messagesReadCreativeGroupError:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/messagesReadCreativeGroupErrorAPIErrorInfo'
    dspCampaignGoal:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/dspCampaignGoalType'
          description: Type of the goal.
        optimize_app_installs:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppInstalls'
        optimize_cpa_for_app_ua:
          $ref: '#/components/schemas/CampaignGoalOptimizeCpaForAppUa'
        optimize_app_roas:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppRoas'
        optimize_clicks_to_web:
          $ref: '#/components/schemas/CampaignGoalOptimizeClicksToWeb'
        optimize_clicks_to_app:
          $ref: '#/components/schemas/CampaignGoalOptimizeClicksToApp'
        optimize_roas_for_app_re:
          $ref: '#/components/schemas/CampaignGoalOptimizeRoasForAppRe'
        optimize_cpc_for_app_re:
          $ref: '#/components/schemas/CampaignGoalOptimizeCpcForAppRe'
        optimize_fixed_cpm:
          $ref: '#/components/schemas/CampaignGoalOptimizeFixedCpm'
        optimize_cpa_for_app_re:
          $ref: '#/components/schemas/CampaignGoalOptimizeCpaForAppRe'
        optimize_app_retention:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppRetention'
        optimize_app_reattribution:
          $ref: '#/components/schemas/CampaignGoalOptimizeAppReattribution'
        optimize_cpa_repeated_for_app_ua:
          $ref: '#/components/schemas/CampaignGoalOptimizeCpaRepeatedForAppUa'
        optimize_fixed_cpm_pacing:
          $ref: '#/components/schemas/CampaignGoalOptimizeFixedCpmPacing'
        optimize_landing_for_web_ua:
          $ref: '#/components/schemas/CampaignGoalOptimizeLandingForWebUa'
        optimize_cpa_for_web_ua:
          $ref: '#/components/schemas/CampaignGoalOptimizeCpaForWebUa'
        kpi_actions:
          type: array
          items:
            type: string
          description: List of KPI actions.
      description: CampaignGoal describes the details of goal of a Campaign.
      required:
      - type
    commonTagsThrottleCondition:
      type: object
      properties:
        tags:
          type: array
          items:
            type: string
        throttle_rate:
          type: number
          format: float
      description: 'Tags Thrrottle Condition. It specifies a throttle rate for a list of tags.

        All the tags in a list will have same throttle rate.'
    googlerpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/protobufAny'
    messagesUpdateCreativeGroupError:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/messagesUpdateCreativeGroupErrorAPIErrorInfo'
    AudienceTargetingConditionCoppaAcceptance:
      type: string
      enum:
      - UNKNOWN_COPPA
      - ACCEPT_COPPA_ONLY
      - DENY_COPPA
      default: UNKNOWN_COPPA
      description: "Indicates whether to bid according to the COPPA(Children's Online Privacy Protection Act)\nvalue of BidRequest.\n\n - UNKNOWN_COPPA: Doesn't filter BidRequest according to the coppa value.\n - ACCEPT_COPPA_ONLY: Bids to BidRequest with coppa=1.\n - DENY_COPPA: Bids to BidRequest with coppa=0 or empty coppa field."
    CreativeFeatureDynamicCreative:
      type: object
      properties:
        app_icon_url:
          type: string
          description: An app icon URL used by MRAID template.
        brand_logo_url:
          type: string
          description: A brand image URL used by MRAID template.
        business_title:
          type: string
          description: A business title used by template.
        cta_text:
          type: string
          description: Call-To-Action text.
        cta_color:
          type: string
          description: CTA button(background) color, do not confuse with cta_text_color.
        image_border_color:
          type: string
          description: Border color around image from catalog.
        title_preamble:
          type: string
          description: preamble for title.
        main_text:
          type: string
          description: A custom text for some templates.
        main_text_color:
          type: string
          description: Main text color.
        cta_text_color:
          type: string
          description: CTA text color, do not confuse with cta_color.
        background_color:
          type: string
          description: background color of dynamic creative.
        price_locale:
          type: string
          description: Locale for creatives. It is used to render prices.
        disclaimer_text:
          type: string
          description: Disclaimer text.
        disclaimer_text_color:
          type: string
          description: Disclaimer text color.
        sponsored_by:
          type: string
          description: Brand name of the sponsor/advertiser.
      description: Detailed configuration of DYNAMIC_CREATIVE feature.
    dspCreativeRichCustomHtmlSrc:
      type: object
      properties:
        entry_html:
          type: string
          description: 'The entry HTML code of the Creative.


            This field is read only. For write purposes, use playable_ad_source instead.'
          readOnly: true
        html_requirement_attributes:
          $ref: '#/components/schemas/dspCreativeHtmlRequirementAttributes'
          description: 'Requirements of this Creative.


            Based on this field and inventory''s excludable Creative attributes, Moloco

            can filter out this Creative.'
        html_size_attributes:
          $ref: '#/components/schemas/dspCreativeHtmlSizeAttributes'
          description: Size-related attributes of this Creative.
        max_video_duration_seconds:
          type: integer
          format: int64
          description: 'Max duration of video sources, in seconds. It will be 

# --- truncated at 32 KB (150 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/moloco/refs/heads/main/openapi/moloco-creativegroup-api-openapi.yml