광고 소재

광고 소재 목록

광고 소재 목록 API에 주요 스펙이 정의되어 있습니다.
요청 파라미터를 이용해서, 여러 조건으로 검색이 가능합니다.
- 기본으로는 광고계정ID(adAccountNo) 하위 전체를 조회합니다.
- 광고그룹ID(adSetNo) 값을 넣으면, 해당 광고그룹 하위만 조회합니다.
응답 결과는 페이징 처리가 되어 있습니다.

광고 그룹 상세 API를 이용해 광고 그룹별 생성 가능한 소재의 소재 타입(creativeType) / 소재 템플릿(creativeTemplateCode)을 확인할 수 있습니다.
소재 타입 이미지 배너 중 스마트채널 및 모바일DA 소재 생성이 가능합니다. 단, 일부 사이즈는 지원되지 않을 수 있습니다.
- 광고 소재 생성(이미지 배너) API에 주요 스펙이 정의되어 있습니다.

소재 타입 네이티브 이미지 중 네이티브 피드형/배너형 소재 생성이 가능합니다. 단, 일부 사이즈는 지원되지 않을 수 있습니다.

템플릿별 소재 생성을 위해 아래와 같은 파라미터 정보를 참고하세요.

	NATIVE_SINGLE_IMAGE_V2	NATIVE_SINGLE_IMAGE_PC	FEED_SINGLE_IMAGE	FEED_SINGLE_IMAGE_SQUARE
name (소재 이름)	required min: 2, max: 128	required min: 2, max: 128	required min: 2, max: 128	required min: 2, max: 128
message (광고 문구)	required min: 2, max: 20	required min: 2, max: 20	required min: 2, max: 65	required min: 2, max: 65
imageNo (소재 이미지 ID)	required	required	required	required
linkUrl (랜딩 URL)	required	required	required	required
linkTitle (설명 문구1)	required min: 2, max: 12	required min: 2, max: 12	X	X
linkDescription (설명 문구2)	required min: 2, max: 12	X	X	X
linkText3rd (설명 문구3)	required min: 2, max: 12	X	X	X
linkText4th (PC 배너형 긴 설명문구 1)	X	required min: 2, max: 28	X	X
linkText5th (PC 배너형 긴 설명문구 2)	X	required min: 2, max: 28	X	X
ctaCode (행동 유도 ID)	required	required	required	required
adviceMessage (고지 문구)	optional max: 45	optional max: 45	X	X

소재 타입 컬렉션 소재 생성이 가능합니다.
- 광고 소재 생성(컬렉션) API에 주요 스펙이 정의되어 있습니다.
- 컬렉션 소재 생성을 위해, 광고 계정 관리> 프로필 관리에서 프로필 정보을 선 등록하는 과정이 필요합니다.

소재 타입 동영상 중 피드형/배너형/인스트림 소재 생성이 가능합니다. 단, 일부 사이즈는 지원되지 않을 수 있습니다.

템플릿별 소재 생성을 위해 아래와 같은 파라미터 정보를 참고하세요.

	NATIVE_SINGLE_VIDEO	FEED_SHORTFORM_VIDEO	FEED_SINGLE_VIDEO	INSTREAM_VIDEO
name (소재 이름)	required min: 2, max: 128	required min: 2, max: 128	required min: 2, max: 128	required min: 2, max: 128
message (광고 문구)	required min: 2, max: 65	required min: 2, max: 120	required min: 2, max: 65	X
videoNo (소재 동영상 ID)	required	required	required	required
thumbnailImageNo (소재 동영상 썸네일 ID)	required	required	required	X
disableInducement (행동 유도를 사용하지 않음 여부)	required 고정 값: false	required 고정 값: false	required 값: true or false	X
linkUrl (랜딩 URL)	required	required	행동유도 사용(false)시, 필수	required
linkTitle (설명 문구1)	X	required min: 2, max: 28	X	X
linkDescription (설명 문구2)	X	X	X	X
ctaCode (행동 유도 ID)	required	required	행동유도 사용(false)시, 필수	X

광고 소재 동영상 업로드 API에 주요 스펙이 정의되어 있습니다.
동영상 업로드 API의 응답 정보는 소재 생성시 사용됩니다.
동영상 업로드 API는 광고 계정당 동시에 1회 호출이 가능합니다.
동영상 파일은 100MB 이내만 업로드가 가능합니다. 100MB 이상인 경우 네이버 성과형 디스플레이 광고 사이트를 통해 직접 업로드할 수 있습니다.
동영상 업로드시, 업로드/인코딩 등의 내부 작업 진행 완료 및 실패 여부를 파악할 수 있도록 callbackUrl을 등록할 수 있습니다.
- 콜백을 받음으로써 해당 동영상 소재의 등록 가능 시점의 조절이 가능합니다.
CallBack 요청
- 동영상 업로드시 지정한 callbackUrl로, Content-type: application/json의 body 를 갖고 있는 HTTP POST 요청을 보냅니다.
- 동영상 등록 완료시 응답 BODY 예제
```
{
    "no": 1,
    "status": "COMPLETED",
    "sizeGroupNo": 4,
    "createdAt": "2024-01-01T01:59:59.000+0000"
}
```
- 동영상 등록 실패시 응답 BODY 예제
  - "status": FAILED - 동영상 업로드 실패
  - "status": NOT_AVAILABLE - 동영상 사용 불가
```
{
    "no": 1,
    "status": "FAILED",
    "sizeGroupNo": 4,
    "createdAt": "2024-01-01T01:59:59.000+0000",
    "failMessage": "can not upload by file size"
}
```