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

# 입찰 전략 수정

> 글로벌 입찰 전략을 부분 갱신합니다. 광고 제공 중 입찰에 사용됩니다.
갱신 대상은 `language`, `currency`, `floor_cpm`, `ceiling_cpm`, `yield_roas_balance`, `ext`입니다.
누락되었거나 타입이 잘못된 스칼라 값은 기존 값을 유지합니다.
`min_imp_for_cpc`와 `min_clk_for_cpc`는 이 endpoint에서 갱신되지 않습니다.



## OpenAPI

````yaml /openapi/decision.api.ko-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: |-
    ### 소개
    Decision API는 사용자 요청 또는 컨텍스트 정보를 바탕으로 광고나 콘텐츠를 실시간으로 선택하고 배포합니다.
    빠른 응답과 동적 기능을 통해 최적의 광고 또는 추천을 제공하여 사용자가 가능한 가장 높은 가치를 얻도록 합니다.

    다양한 알고리즘, 머신러닝 모델 및 규칙 기반 로직을 적용할 수 있어 시스템이 끊임없이 변하는 조건에 유연하게 적응할 수 있습니다.
  title: Decision API
  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: 광고 요청, 캐시 설정 및 광고 제공 모듈의 기타 매개변수를 구성하기 위한 API입니다.
    name: Ad Serving
  - description: 추천 요청을 위한 API
    name: Recommendation Serving
  - description: >-
      광고 제공 서버의 캐시를 조작하기 위한 API입니다.


      ### **중요**

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


      대신 모든 광고 또는 추천 데이터 변경은 Ad Manager API를 통해 처리하는 것을 **권장합니다.**

      Serving 서버에서 변경한 내용은 Ad Manager에 반영되지 않으므로 **데이터 무결성**이 손상될 수 있습니다.
    name: Cache Management
  - description: 광고 서빙 서버 설정 API
    name: Configuration
  - description: 광고 또는 추천과 관련된 전환, 노출 및 클릭 로그를 수신하는 API입니다.
    name: Ad Log
paths:
  /app/api/cache/bid_strategy:
    post:
      tags:
        - Configuration
      summary: 입찰 전략 수정
      description: >-
        글로벌 입찰 전략을 부분 갱신합니다. 광고 제공 중 입찰에 사용됩니다.

        갱신 대상은 `language`, `currency`, `floor_cpm`, `ceiling_cpm`,
        `yield_roas_balance`, `ext`입니다.

        누락되었거나 타입이 잘못된 스칼라 값은 기존 값을 유지합니다.

        `min_imp_for_cpc`와 `min_clk_for_cpc`는 이 endpoint에서 갱신되지 않습니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BidStrategy'
        required: true
      responses:
        '204':
          description: 성공
        '400':
          description: 잘못된 요청 형식입니다.
        '415':
          content:
            text/plain:
              schema:
                type: string
          description: '`Content-Type: application/json`인 요청이 필요합니다.'
        '422':
          content:
            text/plain:
              schema:
                type: string
          description: JSON 본문을 대상 형식으로 역직렬화하지 못했습니다.
        '500':
          description: 내부 서버 오류.
      security:
        - '': []
components:
  schemas:
    BidStrategy:
      properties:
        ceiling_cpm:
          default: 0
          description: 입찰 시 허용되는 최대 CPM(1,000회당 노출 비용). 0으로 설정하면 최대값 제한이 적용되지 않습니다.
          examples:
            - 100
          format: double
          type: number
        currency:
          default: krw
          description: '입찰에 사용되는 통화입니다 (예: "USD", "KRW")'
          examples:
            - krw
          type: string
        ext:
          default: {}
          description: 선택적인 A2 전용 확장 정보입니다.
          examples:
            - {}
        floor_cpm:
          default: 0
          description: 입찰 시 허용되는 최소 CPM(1,000회당 노출 비용). 0으로 설정하면 최소값 제한이 적용되지 않습니다.
          examples:
            - 0
          format: double
          type: number
        language:
          default: ko
          description: '광고 문맥에 해당하는 언어 코드 (예: "en", "ko")'
          examples:
            - ko
          type: string
        min_clk_for_cpc:
          default: 0
          description: CPC 입찰을 고려하는 데 필요한 최소 클릭 수입니다.
          examples:
            - 0
          format: double
          type: number
        min_imp_for_cpc:
          default: 5
          description: CPC 입찰을 고려하는 데 필요한 최소 노출 수입니다.
          examples:
            - 5
          format: double
          type: number
        yield_roas_balance:
          default: 0
          description: |-
            수익률(fill rate)과 ROAS(광고비 대비 수익)의 균형 비율입니다.
            1에 가까운 값은 수익률을, 0에 가까운 값은 ROAS를 우선합니다.
          examples:
            - 0
          format: double
          type: number
      type: object

````