> ## 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

> 
Stores or updates global bid strategy configuration.
Used to calculate bidding prices during ad serving.




## OpenAPI

````yaml /openapi/decision.api.en-0.2.2.json post /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: v0.2.2
  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: >-

      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 ad conversion, impression, and click logs — essential
      for tracking and optimizing advertisement performance.
    name: Ad Serving
paths:
  /api/cache/bid-strategy:
    post:
      tags:
        - Configuration
      summary: Update Bid Strategy
      description: |

        Stores or updates global bid strategy configuration.
        Used to calculate bidding prices during ad serving.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BidStrategy'
        required: true
      responses:
        '204':
          description: Success
        '400':
          description: Invalid request format.
        '500':
          description: Internal Server Error.
      security:
        - '': []
components:
  schemas:
    BidStrategy:
      properties:
        ceiling_cpm:
          description: Maximum cost-per-mille (CPM) allowed for bidding.
          format: double
          type: number
        currency:
          description: Currency used for bidding (e.g., "USD", "KRW").
          type: string
        floor_cpm:
          description: Minimum cost-per-mille (CPM) allowed for bidding.
          format: double
          type: number
        language:
          description: Language code relevant to the ad context (e.g., "en", "ko").
          type: string
        yield_roas_balance:
          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.
          format: double
          type: number
      required:
        - ceiling_cpm
        - currency
        - floor_cpm
        - language
        - yield_roas_balance
      type: object

````