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

> ## 등록 할당

지면과 캠페인 간의 할당 정보를 저장합니다.  
중재 중에 적격한 캠페인을 결정하는 데 사용됩니다.



## OpenAPI

````yaml /openapi/decision.api.ko-0.2.2.json post /api/cache/allocations
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/allocations:
    post:
      tags:
        - Cache Management
      summary: Update Allocations
      description: |-
        ## 등록 할당

        지면과 캠페인 간의 할당 정보를 저장합니다.  
        중재 중에 적격한 캠페인을 결정하는 데 사용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/Allocation'
              type: array
        required: true
      responses:
        '204':
          description: 성공
        '404':
          description: 할당을 찾을 수 없습니다.
        '500':
          description: 내부 서버 오류.
      security:
        - '': []
components:
  schemas:
    Allocation:
      properties:
        cid:
          description: Campaign id
          type:
            - string
            - 'null'
        crid:
          description: Creative id
          type:
            - string
            - 'null'
        ext:
          $ref: '#/components/schemas/AllocationExt'
          description: for various configuration
        last_comment:
          description: Last comment
          type: string
        'no':
          description: ID of the allocation
          format: int64
          type: integer
        status:
          description: Status
          type: string
        tagid:
          description: Placement ID
          type: string
      required:
        - ext
        - last_comment
        - 'no'
        - status
        - tagid
      type: object
    AllocationExt:
      properties:
        frequency_capping:
          $ref: '#/components/schemas/FrequencyCapping'
      required:
        - frequency_capping
      type: object
    FrequencyCapping:
      properties:
        enabled:
          description: >-
            Enables frequency capping (1: enabled, 0: disabled). When enabled,
            user-level ad delivery limits are enforced.
          format: int32
          type: integer
        limit_multiple_click:
          description: >-
            Prevents multiple clicks from the same user on the same ad. 1 to
            enable, 0 to disable.
          format: int32
          type: integer
        user_limit_count:
          description: >-
            Maximum number of impressions allowed per user during
            `user_limit_days`.
          format: int32
          type: integer
        user_limit_days:
          description: >-
            Duration in days over which user impressions are counted. Used in
            combination with `user_limit_count`.
          format: int32
          type: integer
      required:
        - enabled
        - limit_multiple_click
        - user_limit_count
        - user_limit_days
      type: object

````