> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Bid Strategy

> 
Partially updates the global bid strategy configuration used during ad serving.
The update applies only `language`, `currency`, `floor_cpm`, `ceiling_cpm`, `yield_roas_balance`, and `ext`.
Missing or incorrectly typed scalar values retain their current values.
`min_imp_for_cpc` and `min_clk_for_cpc` are not updated by this endpoint.




## OpenAPI

````yaml /openapi/decision.api.en-dev.json post /app/api/cache/bid_strategy
openapi: 3.1.0
info:
  contact:
    email: a2support@aiderx.io
    name: A2 Support
    url: https://aiderx.io
  description: >+

    ### Introduction

    The Decision API is responsible for selecting and distributing ads or
    content based on user requests or contextual information, all in real time.

    Its rapid response and dynamic capabilities enable the **optimal** ad or
    recommendation to be served, ensuring users receive the highest possible
    value.


    A variety of algorithms, machine learning models, and rule-based logic can
    be applied, allowing the system to **adapt flexibly** to constantly changing
    conditions.

  title: Decision APIs
  version: dev
  x-logo:
    altText: A2 Logo
    url: >-
      https://cdn.prod.website-files.com/668de9e1f25ab5675d87758d/6690cf1bdce95af5e3522c25_a2_logo_800_250.png
servers: []
security: []
tags:
  - description: >

      Ad Serving APIs for requesting ads and configuring cache settings and
      other parameters of the ad serving modules.
    name: Ad Serving
  - description: |

      Recommendation Serving APIs for requesting recommendations.
    name: Recommendation Serving
  - description: >-

      APIs for manipulating caches of the serving server.


      ### **Important**

      If you directly manipulate the cached data related to advertising or
      recommendations on the Serving server,

      we **strongly advise** against also modifying the advertising or
      recommendation data through the Ad Manager.


      Alternatively, we **recommend** handling any advertising or recommendation
      data modifications via the Ad Manager APIs.

      Any changes made on the Serving server will **not** be reflected in the Ad
      Manager,

      which can compromise **data integrity**.
    name: Cache Management
  - description: |-

      APIs for manipulating configurations of the serving server
    name: Configuration
  - description: >

      APIs for receiving conversion, impression, and click logs related to ads
      or recommendations.
    name: Ad Log
paths:
  /app/api/cache/bid_strategy:
    post:
      tags:
        - Configuration
      summary: Update Bid Strategy
      description: >

        Partially updates the global bid strategy configuration used during ad
        serving.

        The update applies only `language`, `currency`, `floor_cpm`,
        `ceiling_cpm`, `yield_roas_balance`, and `ext`.

        Missing or incorrectly typed scalar values retain their current values.

        `min_imp_for_cpc` and `min_clk_for_cpc` are not updated by this
        endpoint.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BidStrategy'
        required: true
      responses:
        '204':
          description: Success
        '400':
          description: Invalid request format.
        '415':
          content:
            text/plain:
              schema:
                type: string
          description: 'Expected request with `Content-Type: application/json`'
        '422':
          content:
            text/plain:
              schema:
                type: string
          description: Failed to deserialize the JSON body into the target type
        '500':
          description: Internal Server Error.
      security:
        - '': []
components:
  schemas:
    BidStrategy:
      properties:
        ceiling_cpm:
          default: 0
          description: >-
            Maximum cost-per-mille (CPM) allowed for bidding. If set to 0, no
            maximum is enforced.
          examples:
            - 100
          format: double
          type: number
        currency:
          default: krw
          description: Currency used for bidding (e.g., "USD", "KRW").
          examples:
            - krw
          type: string
        ext:
          default: {}
          description: Optional A2 specific extensions.
          examples:
            - {}
        floor_cpm:
          default: 0
          description: >-
            Minimum cost-per-mille (CPM) allowed for bidding. If set to 0, no
            minimum is enforced.
          examples:
            - 0
          format: double
          type: number
        language:
          default: ko
          description: Language code relevant to the ad context (e.g., "en", "ko").
          examples:
            - ko
          type: string
        min_clk_for_cpc:
          default: 0
          description: Minimum clicks required for CPC bidding to be considered.
          examples:
            - 0
          format: double
          type: number
        min_imp_for_cpc:
          default: 5
          description: Minimum impressions required for CPC bidding to be considered.
          examples:
            - 5
          format: double
          type: number
        yield_roas_balance:
          default: 0
          description: >-
            Trade-off ratio between yield (fill rate) and ROAS (return e.g.
            impressions on ad spend).

            Values closer to 1 prioritize yield; closer to 0 prioritize ROAS.
          examples:
            - 0
          format: double
          type: number
      type: object

````