Skip to main content
POST
광고 단위 생성

인증

Authorization
string
header
필수

Bearer 인증. 액세스 토큰을 Authorization: Bearer <token> 헤더로 전달합니다.

본문

application/json

POST /ad-units 요청 본문.

경로 해석 규칙:

  • parent_id 없음: path = code
  • parent_id 있음: path = {parent.path}/{code}
code
string
필수

광고 단위 코드 식별자. 광고 태그에 사용됩니다. 생성 후 변경 불가. (1-100자)

Required string length: 1 - 100
name
string
필수

광고 단위 표시 이름 (1-255자).

Required string length: 1 - 255
ad_unit_sizes
AdUnitSize · object[] | null

타게팅 메타데이터 크기. 서빙·렌더링을 좌우하는 display/video.w/h와는 별개입니다.

description
string | null

광고 단위 설명.

display
DisplayPlacement · object

디스플레이 게재 위치 설정.

ext
AdUnitExt · object

광고 단위 확장 필드.

gpid
string | null

OpenRTB imp.ext.gpid에 사용되는 표준 지면 ID.

instl
enum<integer>
기본값:0

인터스티셜 지면 여부. 0 = 아니오, 1 = 예. 디스플레이·동영상·네이티브 전체에 적용됩니다.

사용 가능한 옵션:
0,
1
is_active
boolean
기본값:true

광고 단위 활성 여부.

native
NativePlacement · object

네이티브 지면임을 나타내는 지면 서브타입 객체입니다. (AdCOM 표준이 아닌 OpenRTB Native Ads 1.2 Native Markup Request Object 기반)

parent_id
string<uuid> | null

상위 광고 단위 ID. 계층을 결정합니다. 생성 후 변경 불가.

recommendation
RecommendationPlacement · object
video
VideoPlacement · object

비디오 게재 위치 설정.

응답

성공 응답

광고 단위 변경(생성/수정) 응답 스키마.

code
string
필수

광고 단위 코드 식별자.

created_by
string<uuid>
필수

광고 단위를 생성한 사용자 ID.

id
string<uuid>
필수

광고 단위 ID (uuid7)

name
string
필수

광고 단위 이름.

path
string
필수

광고 단위의 계층 경로 (예: "parent_id/child_id").

ad_unit_sizes
AdUnitSize · object[] | null

타게팅 메타데이터 크기. 서빙·렌더링을 좌우하는 display/video.w/h와는 별개입니다.

created_at
string<date-time> | null
description
string | null

광고 단위 설명.

display
DisplayPlacement · object

디스플레이 게재 위치 설정.

ext
AdUnitExt · object

광고 단위 확장 필드.

gpid
string | null

OpenRTB imp.ext.gpid에 사용되는 표준 지면 ID.

instl
enum<integer>
기본값:0

인터스티셜 지면 여부. 0 = 아니오, 1 = 예. 디스플레이·동영상·네이티브 전체에 적용됩니다.

사용 가능한 옵션:
0,
1
is_active
boolean | null

광고 단위 활성 여부.

native
NativePlacement · object

네이티브 지면임을 나타내는 지면 서브타입 객체입니다. (AdCOM 표준이 아닌 OpenRTB Native Ads 1.2 Native Markup Request Object 기반)

no
integer | null
recommendation
RecommendationPlacement · object
updated_at
string<date-time> | null
video
VideoPlacement · object

비디오 게재 위치 설정.