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

> ## 입찰 전략 업데이트

입찰 전략 구성을 저장하거나 업데이트합니다. 광고 제공 중 입찰 가격을 계산하는 데 사용됩니다.



## OpenAPI

````yaml /openapi/decision.api.ko-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: |-
    ### 소개
    이 문서는 Decision API의 Ad Serving API 및 Recommendation API 구성 요소를 다룹니다.
  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: |
      광고 전환, 노출, 클릭 로그를 수신하는 API — 광고 성능 추적 및 최적화에 필수적입니다.
    name: Ad Serving
  - description: >-
      광고 서빙 서버 캐시 관리 API


      ### **중요**

      Serving 서버의 광고 또는 추천 관련 캐시 데이터를 직접 조작하는 경우, Ad Manager를 통해 광고 또는 추천 데이터를
      **동시에 수정하지 않을 것을 강력히 권장합니다.**

      Serving 서버에서 수행된 변경 사항은 Ad Manager에 반영되지 않으며,

      이는 **데이터 무결성**을 위협할 수 있습니다.
    name: Cache Management
  - description: 광고 서빙 서버 설정 API
    name: Configuration
  - description: |
      광고 전환, 노출, 클릭 로그를 수신하는 API — 광고 성능 추적 및 최적화에 필수적입니다.
    name: Ad Serving
paths:
  /api/cache/bid-strategy:
    post:
      tags:
        - Configuration
      summary: Update Bid Strategy
      description: |-
        ## 입찰 전략 업데이트

        입찰 전략 구성을 저장하거나 업데이트합니다. 광고 제공 중 입찰 가격을 계산하는 데 사용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BidStrategy'
        required: true
      responses:
        '204':
          description: 성공
        '400':
          description: 잘못된 요청 형식입니다.
        '500':
          description: 내부 서버 오류.
      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

````