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_SQUAREFEED_SINGLE_IMAGE_2TO3NATIVE_SINGLE_IMAGE_COMMUNICATION
      name
      (creative name)
      required
      min: 2, max: 128
      required
      min: 2, max: 128
      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
      required
      min: 2, max: 65
      X
      imageNo
      (creative image ID)
      requiredrequiredrequiredrequiredrequiredrequired
      linkUrl
      (landing URL)
      requiredrequiredrequiredrequiredrequiredrequired
      linkTitle
      (description 1)
      required
      min: 2, max: 12
      XXXXrequired
      min: 2, max: 40
      linkDescription
      (description 2)
      required
      min: 2, max: 12
      XXXXrequired
      min: 2, max: 50
      linkText3rd
      (description 3)
      required
      min: 2, max: 12
      XXXXX
      linkText4th
      (long description 1 for the desktop banner type)
      Xrequired
      min: 2, max: 28
      XXXX
      linkText5th
      (long description 2 for the desktop banner type)
      Xrequired
      min: 2, max: 28
      XXXX
      ctaCode
      (call-to-action ID)
      requiredrequiredrequiredrequiredrequiredrequired
      adviceMessage
      (notice message)
      optional
      max: 45
      optional
      max: 45
      XXXoptional
      max: 45
  • Creative creation with Collections is supported.

  • 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
      linkUrl
      (Landing URL)
      requiredrequiredrequiredrequired
      linkTitle
      (Description 1)
      Xrequired
      min: 2, max: 28
      XX
      linkDescription
      (Description 2)
      XXXX
      ctaCode
      (Call-to-action ID)
      requiredrequiredrequiredX

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/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​