Skip to main content

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.
    • 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_BANNER creative type, creative creation for Smart Channel and mobile DA is offered. Note that some sizes may not be supported.

  • For the SINGLE_IMAGE creative 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_IMAGE creative, 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_V2NATIVE_SINGLE_IMAGE_PCFEED_SINGLE_IMAGEFEED_SINGLE_IMAGE_SQUARE
      name
      (creative name)      		required
      min: 2, max: 128      		required
      min: 2, max: 128      		required
      min: 2, max: 128      		required
      min: 2, max: 128
      message
      (ad message)      		required
      min: 2, max: 20      		required
      min: 2, max: 20      		required
      min: 2, max: 65      		required
      min: 2, max: 65
      imageNo
      (creative image ID)      		requiredrequiredrequiredrequired
      linkUrl
      (landing URL)      		requiredrequiredrequiredrequired
      linkTitle
      (description 1)      		required
      min: 2, max: 12      		required
      min: 2, max: 12      		XX
      linkDescription
      (description 2)      		required
      min: 2, max: 12      		XXX
      linkText3rd
      (description 3)      		required
      min: 2, max: 12      		XXX
      linkText4th
      (long description 1 for the desktop banner type)      		Xrequired
      min: 2, max: 28      		XX
      linkText5th
      (long description 2 for the desktop banner type)      		Xrequired
      min: 2, max: 28      		XX
      ctaCode
      (call-to-action ID)      		requiredrequiredrequiredrequired
      adviceMessage
      (notice message)      		optional
      max: 45      		optional
      max: 45      		XX

  • Creative creation with Collections is supported.

    • The API specification is described on the Create a creative with Collections page.
    • Before creating a Collections creative, you need to add your profile information from 광고 계정 관리 (Ad Account Settings) > 프로필 관리 (Profile).

  • For the video creative 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 video creative, 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_VIDEOFEED_SHORTFORM_VIDEOFEED_SINGLE_VIDEOINSTREAM_VIDEO
      name
      (Creative name)      		required
      min: 2, max: 128      		required
      min: 2, max: 128      		required
      min: 2, max: 128      		required
      min: 2, max: 128
      message
      (Ad message)      		required
      min: 2, max: 65      		required
      min: 2, max: 120      		required
      min: 2, max: 65      		X
      videoNo
      (Creative video ID)      		requiredrequiredrequiredrequired
      thumbnailImageNo
      (Creative video thumbnail ID)      		requiredrequiredrequiredX
      disableInducement
      (Indicates whether to disable call-to-action)      		required
      Fixed value: false      		required
      Fixed value: false      		required
      Value: true or false      		X
      linkUrl
      (Landing URL)      		requiredrequiredRequired when enabling call-to-action (false)required
      linkTitle
      (Description 1)      		Xrequired
      min: 2, max: 28      		XX
      linkDescription
      (Description 2)      		XXXX
      ctaCode
      (Call-to-action ID)      		requiredrequiredRequired when enabling call-to-action (false)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 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/json to 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"
      }

Manage creatives​