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

# 사용자 로그 기록

> 사용자 상호작용 이벤트를 기록합니다.

`type`에 해당하는 로그 필드를 포함해야 합니다.

지원되는 이벤트 유형:
- 조회 이벤트(vimp): 사용자에게 광고가 표시될 때 기록됩니다.
- 노출 이벤트(imp): 다운스트림 처리에서 수락됩니다.
- 클릭(clk): 클릭 이벤트를 기록합니다.
- 전환(conv): 사용자가 광고를 보거나 클릭한 후 원하는 작업을 완료할 때 기록됩니다.

요청은 다운스트림 DMP 처리를 위해 수락됩니다. 실제 처리와 영속화는 다운스트림에서 수행되며 이 문서에서 지정하지 않습니다.



## OpenAPI

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

    다양한 알고리즘, 머신러닝 모델 및 규칙 기반 로직을 적용할 수 있어 시스템이 끊임없이 변하는 조건에 유연하게 적응할 수 있습니다.
  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:
  /dmp/v0/log:
    post:
      tags:
        - Ad Log
      summary: 사용자 로그 기록
      description: |-
        사용자 상호작용 이벤트를 기록합니다.

        `type`에 해당하는 로그 필드를 포함해야 합니다.

        지원되는 이벤트 유형:
        - 조회 이벤트(vimp): 사용자에게 광고가 표시될 때 기록됩니다.
        - 노출 이벤트(imp): 다운스트림 처리에서 수락됩니다.
        - 클릭(clk): 클릭 이벤트를 기록합니다.
        - 전환(conv): 사용자가 광고를 보거나 클릭한 후 원하는 작업을 완료할 때 기록됩니다.

        요청은 다운스트림 DMP 처리를 위해 수락됩니다. 실제 처리와 영속화는 다운스트림에서 수행되며 이 문서에서 지정하지 않습니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LogType'
        required: true
      responses:
        '200':
          description: 다운스트림 처리를 위해 수락됨
      security:
        - '': []
components:
  schemas:
    LogType:
      anyOf:
        - $ref: '#/components/schemas/AdLog'
    AdLog:
      properties:
        action:
          allOf:
            - $ref: '#/components/schemas/ActionType'
          description: '이벤트 유형: `clk`, `vimp`, `imp`, `conv` 중 하나'
        ad_log:
          description: Decision API 응답의 광고 추적 식별자(ext.ad_log 필드)
          examples:
            - >-
              YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8NGJlMmQ4ZTYtYThhMS00NzI2LWEzMjAtNjkyNTYzMDkwZTQyfDllZjY2ZGM4LTBlMmMtNDlmMS05NDU3LWFmYmUwZGQ2ZjU3M3w1NTgxNmIzOTcxMWY5YjVhY2YzYjkwZTMxM2VkMjllNTE2NjU2MjNm
          type:
            - string
            - 'null'
        custom_targeting:
          additionalProperties: true
          description: 다운스트림 광고 로그 처리로 전달되는 선택적 custom targeting 속성
          type:
            - object
            - 'null'
        price:
          description: 전환의 금전적 가치(선택사항). 정확한 값이 있을 때만 포함하세요.
          format: double
          type:
            - number
            - 'null'
        reco_log:
          description: 다운스트림 추천 로그 처리를 위한 선택적 추천 로그 식별자
          type:
            - string
            - 'null'
        type:
          $ref: '#/components/schemas/AdLogType'
      required:
        - type
        - action
      type: object
    ActionType:
      oneOf:
        - const: clk
          description: '클릭 이벤트: 사용자가 광고를 클릭할 때 기록됩니다.'
          type: string
        - const: vimp
          description: 광고가 노출될 때 기록되는 조회 이벤트
          type: string
        - const: imp
          description: 다운스트림 처리에서 허용되는 노출 이벤트입니다.
          type: string
        - const: conv
          description: >-
            전환 이벤트: 광고를 본 후 사용자가 가치 있는 작업을 수행할 때 기록됩니다. 전환은 비즈니스 목표에 따라 정의할 수
            있습니다.


            전환 활동의 예:

            * 상품 구매

            * 장바구니 추가

            * 애플리케이션 설치

            * 서비스 구독

            * 파일 다운로드

            * 링크 클릭

            * 시간 제한 콘텐츠 소비


            광고 목표에 따라 의미 있는 사용자 행동을 전환으로 정의할 수 있습니다.
          type: string
    AdLogType:
      enum:
        - ad_log
        - reco_log
      type: string

````