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

# /dmp/v0/log

> 광고 최적화 및 분석을 위한 광고 상호작용 이벤트를 기록합니다.

지원되는 이벤트 유형:
- 노출(imp): 광고 노출 이벤트 기록
- 클릭(clk): 광고 클릭 이벤트 기록
- 전환(conv): 구매, 설치, 구독 등 노출 후 전환 이벤트 기록

참고: 모든 요청에 대해 200 OK를 반환합니다. 유효하지 않은 스키마는 자동으로 무시됩니다.



## OpenAPI

````yaml /openapi/decision.api.ko-0.2.2.json post /dmp/v0/log
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:
  /dmp/v0/log:
    post:
      tags:
        - Ad Log
      summary: /dmp/v0/log
      description: |-
        광고 최적화 및 분석을 위한 광고 상호작용 이벤트를 기록합니다.

        지원되는 이벤트 유형:
        - 노출(imp): 광고 노출 이벤트 기록
        - 클릭(clk): 광고 클릭 이벤트 기록
        - 전환(conv): 구매, 설치, 구독 등 노출 후 전환 이벤트 기록

        참고: 모든 요청에 대해 200 OK를 반환합니다. 유효하지 않은 스키마는 자동으로 무시됩니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LogType'
        required: true
      responses:
        '200':
          description: OK
      security:
        - '': []
components:
  schemas:
    LogType:
      anyOf:
        - $ref: '#/components/schemas/AdLog'
    AdLog:
      properties:
        action:
          $ref: '#/components/schemas/ActionType'
          description: 이벤트 유형 - `clk`, `imp`, `conv` 중 하나
        ad_log:
          description: Decision API 응답의 광고 추적 식별자(ext.ad_log 필드)
          type: string
        price:
          description: 전환의 금전적 가치(선택사항). 정확한 값이 있을 때만 포함하세요.
          format: double
          type:
            - number
            - 'null'
        type:
          $ref: '#/components/schemas/AdLogType'
      required:
        - action
        - ad_log
        - type
      type: object
    ActionType:
      oneOf:
        - description: Click event - Records when a user clicks on an advertisement
          enum:
            - clk
          type: string
        - description: >-
            Impression event - Records when an advertisement is displayed to a
            user.


            Note: While optional in A2, impression logging is recommended for
            accurate metrics
          enum:
            - imp
          type: string
        - description: >-
            Conversion event - Records when a user performs a valuable action
            after viewing an ad. Conversions can be defined based on your
            business goals.


            Example conversion activities include:


            * Product purchase

            * Cart addition

            * Application installation

            * Service subscription

            * File download

            * Link click

            * Timed content consumption


            You can define any meaningful user action as a conversion based on
            your advertising objectives.
          enum:
            - conv
          type: string
    AdLogType:
      enum:
        - ad_log
      type: string

````