Creatives
List of creatives
The API specification is described on the List of creatives page.
Data can be retrieved with multiple conditions by using request parameters.
- By default, all data under an ad account ID (
adAccountNo) are retrieved. - When a ad group ID (
adSetNo) is entered, only data under the ad group ID are retrieved.
- By default, all data under an ad account ID (
A response is paginated.
Create a creative
Available creative types (
creativeType) for each ad group and the values of creative templates (creativeTemplateCode) are described in the Ad group details page.For the
IMAGE_BANNERcreative type, creative creation for Smart Channel and mobile DA is offered. Note that some sizes may not be supported.- The API specification is described on the Create a creative of IMAGE_BANNER page.
For the
SINGLE_IMAGEcreative type, creative creation for Native Feed/Banner is offered. Note that some sizes may not be supported.The API specification is described on the Create a creative of SINGLE_IMAGE page.
Before creating a
SINGLE_IMAGEcreative, you need to add your profile information from 광고 계정 관리 (Ad Account Settings) > 프로필 관리 (Profile).The table below shows the parameters you can use when creating a creative for each template.
NATIVE_SINGLE_IMAGE_V2 NATIVE_SINGLE_IMAGE_PC FEED_SINGLE_IMAGE FEED_SINGLE_IMAGE_SQUARE FEED_SINGLE_IMAGE_2TO3 NATIVE_SINGLE_IMAGE_COMMUNICATION name
(creative name)required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128message
(ad message)required
min: 2, max: 20required
min: 2, max: 20required
min: 2, max: 65required
min: 2, max: 65required
min: 2, max: 65X imageNo
(creative image ID)required required required required required required linkUrl
(landing URL)required required required required required required linkTitle
(description 1)required
min: 2, max: 12X X X X required
min: 2, max: 40linkDescription
(description 2)required
min: 2, max: 12X X X X required
min: 2, max: 50linkText3rd
(description 3)required
min: 2, max: 12X X X X X linkText4th
(long description 1 for the desktop banner type)X required
min: 2, max: 28X X X X linkText5th
(long description 2 for the desktop banner type)X required
min: 2, max: 28X X X X ctaCode
(call-to-action ID)required required required required required required adviceMessage
(notice message)optional
max: 45optional
max: 45X X X optional
max: 45
Creative creation with
Collectionsis supported.- The API specification is described on the Create a creative with Image Collections and the Create a creative with Video Collections pages.
- Before creating a
Collectionscreative, you need to add your profile information from 광고 계정 관리 (Ad Account Settings) > 프로필 관리 (Profile).
For the
videocreative type, creative creation for Feed/Banner/In-Stream is offered. Note that some sizes may not be supported.The API specification is described on the Create a creative in in-stream type of video and the Create a creative in out-stream type of video pages.
Before creating a
videocreative, you need to add your profile information from 광고 계정 관리 (Ad Account Settings) > 프로필 관리 (Profile).The table below shows the parameters you can use when creating a creative for each template.
NATIVE_SINGLE_VIDEO FEED_SHORTFORM_VIDEO FEED_SINGLE_VIDEO INSTREAM_VIDEO name
(Creative name)required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128required
min: 2, max: 128message
(Ad message)required
min: 2, max: 65required
min: 2, max: 120required
min: 2, max: 65X videoNo
(Creative video ID)required required required required thumbnailImageNo
(Creative video thumbnail ID)required required required X linkUrl
(Landing URL)required required required required linkTitle
(Description 1)X required
min: 2, max: 28X X linkDescription
(Description 2)X X X X ctaCode
(Call-to-action ID)required required required X
Upload creative images
The API specification is described on the Upload creative images page.
The API responses are used for creative creation.
Upload creative videos
The API specification is described on the Upload creative videos page.
The status of a video being uploaded / encoded can be checked through the ad creative video status retrieval API.
The API responses are used for creative creation.
This API can be simultaneously requested once per ad account.
Video files should be under 100 MB for uploading. If it exceeds the size of 100 MB, it can be uploaded through the NAVER Performance DA website.
When uploading a video, you can register callbackUrl to check whether tasks such as upload and encoding have been completed or failed.
- By receiving a callback, you can determine the optimal time for uploading the video creative.
CallBack request
- Send an HTTP POST request with the body of Content-type:
application/jsonto the callbackUrl specified when uploading the video. - Example of body response for successful video upload
{
"no": 1,
"status": "COMPLETED",
"sizeGroupNo": 4,
"createdAt": "2024-01-01T01:59:59.000+0000"
} - Example of body response for video upload failure
- "status":
FAILED- Video upload failure - "status":
NOT_AVAILABLE- Video not available
{
"no": 1,
"status": "FAILED",
"sizeGroupNo": 4,
"createdAt": "2024-01-01T01:59:59.000+0000",
"failMessage": "can not upload by file size"
} - "status":
- Send an HTTP POST request with the body of Content-type:
Manage creatives
- Here is a list of supported APIs related with creative management.