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

# 네이티브 포맷과 스타일

> 네이티브 소재가 제공할 필드를 정하고 광고 단위에 맞는 표현을 준비합니다.

네이티브 광고를 직접 등록해 게재하려면 관리자 또는 운영자 권한으로 **포맷**과 **스타일**을 준비합니다. 포맷은 소재가 제공해야 하는 필드의 이름과 입력 조건을 정하고, 스타일은 그 필드를 광고 화면에 배치하고 꾸밉니다. 광고 단위에는 포맷별 스타일을 연결합니다.

![네이티브 포맷이 필드를 정하고, 소재가 값을 채우고, 스타일이 배치해 광고 단위에서 렌더링되는 구조](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-structure.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=8fe68b09e7d393595132ea2eeeca8b15)

외부 광고 네트워크가 보내는 에셋을 사용하는 경우에는 직접 만든 스타일이 필요하지 않을 수 있습니다. 광고 단위의 [네이티브 렌더링 방식](https://docs.aiderx.io/guides/for-retailers/ko/placement.md#3-네이티브-광고-단위-준비하기)과 서비스 연동 방식을 먼저 확인하세요.

![네이티브 준비 3단계: 포맷 만들기와 활성화, 스타일 만들기와 활성화, 광고 단위에 포맷별 스타일 연결](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-setup.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=4d327f9dbf9c69c8390d7c7448510f91)

## 네이티브 포맷 만들기

1. **네이티브 → 포맷**에서 **포맷 생성**을 선택합니다.
2. **포맷명**을 입력하고, 필요하면 **설명**을 추가합니다.
3. **필드 추가**를 눌러 소재에서 받을 항목을 정의합니다.
4. 각 필드의 **종류**, **식별자**, **라벨**, **필수 여부**를 입력합니다. 필요하면 설명과 제약 조건도 설정한 뒤 저장합니다.
5. 필드 목록에서 이름, 입력 타입, 필수 여부와 제약을 다시 확인하고 **포맷 생성**을 선택합니다.
6. 새 포맷은 **비활성** 상태로 만들어집니다. 포맷 상세에서 **활성화**를 선택합니다. 비활성 포맷은 스타일을 만들 때 목록에 나타나지 않습니다.

| 필드 설정 | 용도와 선택 |
| - | - |
| 종류 | 제목, 이미지, 데이터, 링크 중 선택합니다. 이미지와 데이터는 세부 타입도 선택합니다. |
| 식별자 | 시스템이 필드를 구분하는 이름입니다. 영문 소문자와 밑줄만 사용하며, 포맷 안에서 중복되지 않아야 합니다. 예: `main_image` |
| 라벨 | 소재를 입력하는 사람이 알아볼 이름입니다. 식별자와 같은 값으로 표시하도록 선택할 수도 있습니다. |
| 필수 여부 | 소재마다 값이 반드시 있어야 하는 필드인지 정합니다. |
| 제약 조건 | 텍스트의 최대 길이, 숫자의 최소·최대값, 이미지 비율, 링크에 허용할 URL 스킴 등을 필요에 따라 정합니다. |

현재 포맷 편집기에서 사용할 수 있는 종류는 **제목**, **이미지**, **데이터**, **링크**입니다. 데이터는 텍스트 또는 숫자 입력으로 설정할 수 있습니다. 이미지와 데이터는 해당 종류에 맞는 세부 타입도 선택해야 합니다. 포맷 편집기에서는 동영상 종류를 사용할 수 없습니다.

> 포맷에 스타일이나 소재가 연결되면 필드를 추가·수정·삭제할 수 없습니다. 필드 구성을 바꾸려면 새 포맷을 만들고 스타일과 소재를 다시 연결하세요. 포맷을 비활성화하거나 삭제할 때도 게재 중인 배정, 연결된 스타일과 소재가 있으면 제한될 수 있습니다.

![네이티브 포맷 목록](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-formats.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=a8208e7f544236ccef9c7278954f061c)

![네이티브 포맷 상세의 필드 목록](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-format-detail.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=f0d65090908c12cf38687813165e91ce)

## 네이티브 스타일 만들기

1. **네이티브 → 스타일**에서 **스타일 생성**을 선택합니다.
2. 편집 방식으로 **디자인 편집기** 또는 **HTML / CSS 편집기**를 선택합니다.
3. **스타일 이름**과 필요하면 **설명**을 입력하고, **네이티브 크기**에서 **유동형** 또는 **고정형**을 선택합니다. 고정형은 목록에서 크기를 고르거나 너비·높이를 입력합니다.
4. 사용할 **네이티브 포맷**을 지정합니다. 디자인 편집기를 선택한 경우 사용할 템플릿도 고릅니다.
5. 디자인 단계에서 템플릿의 레이아웃과 스타일을 조정합니다. HTML / CSS 편집기를 선택한 경우 코드를 입력하거나 포맷 필드에 맞춘 시작 코드를 생성해 수정합니다.
6. 미리보기에서 필드 값이 의도한 순서와 모양으로 표시되는지 확인한 뒤 저장합니다.
7. 새 스타일도 **비활성** 상태로 만들어집니다. 스타일 상세에서 **활성화**를 선택합니다. 비활성 포맷이나 스타일은 광고 단위에 연결할 수 없습니다.

디자인 편집기는 표준 포맷에서 사용할 수 있습니다. 사용자 정의 포맷을 선택하려면 **HTML / CSS 편집기**를 사용하세요. 포맷 목록에는 활성 상태인 포맷만 나타납니다. 스타일을 만들 때 정한 포맷과 편집 방식은 나중에 바꿀 수 없으므로 저장 전에 확인합니다.

![네이티브 스타일 목록](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-styles.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=2610351083a2fda9786994cb2c6c611b)

![네이티브 스타일 상세의 미리보기 탭](https://mintcdn.com/aiderx/3w8S0Q6Mwjs-sYoU/images/guides/ko/native-style-detail.png?fit=max\&auto=format\&n=3w8S0Q6Mwjs-sYoU\&q=85\&s=d288f13673534d1bfba6384e1405d0e9)

## 스타일을 광고 단위에 연결하기

1. [광고 단위 상세](https://docs.aiderx.io/guides/for-retailers/ko/placement.md#3-네이티브-광고-단위-준비하기)의 **네이티브 스타일** 탭을 엽니다.
2. **스타일 추가**를 누릅니다.
3. 연결할 **네이티브 포맷**과 그 포맷으로 만든 **스타일**을 선택하고 저장합니다.
4. 목록에서 연결된 포맷과 스타일을 확인합니다.

광고 단위 하나에는 포맷별로 하나의 스타일을 연결합니다. 광고 단위가 **Asset** 렌더링 방식이면 스타일을 새로 연결하거나 바꿀 수 없습니다. 기존 연결을 조회하거나 해제할 수는 있습니다. 게재 중인 배정이 현재 해당 포맷과 스타일을 사용 중이면 연결 변경이 제한될 수 있으므로, 변경 전 운영 담당자와 게재 영향을 확인하세요.

## 저장 후 확인

* 포맷 상세에서 필요한 필드가 모두 있고 필수 여부와 제약 조건이 올바른지 확인합니다.
* 스타일 상세의 미리보기에서 실제 소재 값과 비슷한 예시가 잘 배치되는지 확인합니다.
* 광고 단위 상세에서 선택한 포맷과 스타일이 연결되어 있는지 확인합니다.
* Asset 렌더링 방식에서도 네이티브 응답과 원본 에셋을 확인할 수 있습니다. 스타일이 적용된 결과를 확인하려면 서비스가 HTML 방식으로 연동되어 있어야 합니다. [광고 단위와 게재 위치 관리](https://docs.aiderx.io/guides/for-retailers/ko/placement.md)의 연동 절차를 참고하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.