Skip to main content

Response

Page​

  • The table below shows information about the pagination parameters in a response.

  • The maximum value in size is 100.

ValueTypeDescription
contentsObject[]Content list
pageIntegerPage number
sizeIntegerNumber of items in each page
totalElementsLongTotal number of items
totalPagesIntegerTotal number of pages
sortObjectSorting order
firstbooleanIndicates whether the requested page is the first page of results.
lastbooleanIndicates whether the requested page is the last page of results.

Response codes​

HTTP status codes​

CodeMessageDescription
200OKThe request was successful.
400Bad RequestThe request was wrong or inaccurate.
401UnauthorizedFailed to authenticate the request.
403ForbiddenThe server cannot process the request due to lack of permission or authorization.
422Unprocessable EntityThe syntax of the request entity is correct, but it was unable to process the contained instructions.
429Too Many RequestsThe user has sent too many requests in a given amount of time.
500Internal Server ErrorServer error. If this error persists, you need to report it.

Troubleshoot error codes​

  • 400 Bad Request
    • You need to fix wrong parameters in a request and then call it again.
{
"error": {
"code": "BAD_REQUEST",
"message": "Bad Request",
"description": "An ad group ([123]) which does not belong to an ad account (1017) exists."
}
}
  • 422 Unprocessable Entity
    • detailCode: There is a corresponding code value for each case. See the description for the detail code.
{
"error": {
"code": "CONDITION_DOES_NOT_MEET",
"detailCode": "AD__BID_PRICE_OUT_OF_RANGE",
"message": "The bidPrice field value is outside of the valid range.",
"description": "Allowed minimum amount: 10, Maximum amount: 1000000, Input value (adSetNo: 99145, bidPrice: 10000000000000)"
}
}

Code​

  • This section describes what each code means.

  • It consists of codes associated with some of the HTTP status codes above.

HTTP status codeCode
400BAD_REQUEST
401AUTH_ERROR
422CONDITION_DOES_NOT_MEET
DATA_NOT_EXIST
INVALID_PARAMETER
500UNKNOWN_ERROR

Detail code​

  • This section describes what each detailCode means.

  • You can find how to troubleshoot each error.

CodeDescription
AD__BID_STRATEGY_VALUE_OUT_OF_RANGEThe bid limit is outside the allowed range.
AD__BID_PRICE_OUT_OF_RANGEThe bid amount is outside the allowed range.
AD__AD_SET_BUDGET_OUT_OF_RANGEThe 'ad group budget' is outside the allowed range.
AD__AD_SET_CANNOT_CREATE_EXCEED_MAXCannot create a new ad group because the maximum number of ad groups has been reached.
AD__AD_SET_CANNOT_SELECTThe ad group cannot be selected.
AD__AD_SET_GENDER_MUST_BE_SELECTED_AT_LEAST_ONEAt least one gender must be selected. (Excluding unknown)
AD__AD_SET_NOT_EXISTThe ad group information does not exist.
AD__AD_SET_CAMPAIGN_NOT_EXISTThe campaign linked to the ad group does not exist.
AD__AD_SET_CANNOT_CREATECannot create the ad group.
AD__AD_SET_TARGETING_TYPE_NOT_NULLThe targeting type must not be empty.
AD__AD_SET_INVALID_NAME_FORMATThe ad group name must be between 2 and 128 characters.
AD__AD_SET_CONTEXT_TARGETING_TYPE_NOT_AVAILABLE_CAMPAIGN_OBJECTIVEThe [Context] targeting type cannot be used in ad groups under the current campaign objective {objective}.
AD__AD_SET_INVALID_TARGETING_TYPEThe targeting type is invalid.
AD__AD_SET_BROAD_TARGET_CAN_USE_AT_CATALOGExpanded targeting can be set only for catalog campaign ads.
AD__AD_SET_INCLUDE_FEED_AUTO_TARGETING_NOT_SUPPORTED_SHOPPING_CAMPAIGNFeed ad automatic targeting expansion cannot be set in shopping campaigns.
AD__AD_SET_NOT_ALLOWEDYou do not have permission to access the ad group.
AD__AD_SET_NOT_EXIST_AT_AD_SET_NOThe ad group information {adSetNo} does not exist.
AD__AD_SET_CUSTOM_TARGET_NOT_ALLOWEDYou do not have permission to retrieve audience information.
AD__AD_SET_CUSTOM_TARGET_CANNOT_INCLUDE_SEED_COUNTThis population can be used for target exclusion only.
AD__AD_SET_CUSTOM_TARGET_CANNOT_USEThe audience information cannot be used or has been deleted.
AD__AD_SET_CUSTOM_TARGET_EXCEED_MAXThe maximum number of audiences allowed per ad group has been exceeded.
AD__AD_SET_CUSTOM_TARGET_NOT_EXISTThe audience information does not exist.
AD__AD_SET_CUSTOM_TARGET_DISABLEDThe audience is unavailable.
AD__AD_SET_CUSTOM_TARGET_COUNT_EXCEEDEDUp to n targets can be registered. To register a new target, delete an unused target.
AD__AD_SET_CUSTOM_TARGET_NOT_AVAILABLEThe audience is not in an available state.
AD__AD_SET_CUSTOM_TARGET_FILE_COUNT_EXCEEDEDUp to n 'customer files' can be registered. To register a new 'customer file', delete an unused 'customer file'.
AD__AD_SET_CUSTOM_TARGET_CONNECTED_CANNOT_BE_REMOVEDCannot delete the target. It cannot be deleted because it is in use by an ad group. To delete the target, first remove it from the audience settings of the ad groups shown in the target usage status.
AD__AD_SET_CUSTOM_TARGET_CONNECTED_LOOKALIKE_CANNOT_BE_REMOVEDCannot delete the target. It cannot be deleted because it is in use by a lookalike target. To delete the target, first remove the lookalike targets created from it.
AD__AD_SET_CUSTOM_TARGET_NEED_MORE_COUNTThe include (targeting) setting requires a target population of at least n.
AD__AD_SET_CANNOT_SET_SOME_TARGETINGSYou have set targeting that is not allowed for the selected media.
AD__AD_SET_CUSTOM_TARGET_MAT_TARGETS_WITH_SAME_CONDITIONS_EXISTA MAT target created with the same conditions (linked partner, collected event, collection period) is already registered.
AD__AD_SET_CUSTOM_TARGET_MAT_CODE_UNREMOVABLEThis conversion key is already linked and cannot be deleted.
AD__AD_SET_CUSTOM_TARGET_MAT_CODE_COUNT_EXCEEDEDThe maximum number of conversion keys has been exceeded.
AD__AD_SET_CUSTOM_TARGET_LOOKALIKE_COUNT_EXCEEDEDUp to n 'lookalike targets' can be registered. To register a new 'lookalike target', delete an unused 'lookalike target'.
AD__AD_SET_CUSTOM_TARGET_LOOKALIKE_SAME_CONDITIONS_EXISTA lookalike target with the same target size for the same SEED target cannot be newly created. Please check again and register.
AD__AD_SET_CUSTOM_TARGET_INVALID_CAMPAIGN_OBJECTIVENAVER Shopping targets cannot be set in ad groups under the current campaign objective. Please check the audience settings of the ad group again.
AD__AD_SET_CUSTOM_TARGET_INVALID_CAMPAIGN_URLSome NAVER Shopping targets cannot be set because of the representative URL set in the campaign. Please check the audience settings of the ad group again.
AD__AD_SET_CUSTOM_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support audience target settings.
AD__AD_SET_CANNOT_TARGET_AIPL_BY_CAMPAIGN_OBJECTIVECustomer journey targets cannot be set for engagement/app conversion campaigns.
AD__AD_SET_CANNOT_TARGET_AIPL_BY_BIZ_CHANNELCustomer journey targets are provided only when the shopping mall type is 'Smart Store/Brand Store', or when the shopping mall type is 'CPC/CPS' and you have the brandAnalytics permission.
AD__AD_SET_DEMOGRAPHIC_AGE_RANGE_INVALIDThe age range is invalid. The valid ranges are: {age range}
AD__AD_SET_DEMOGRAPHIC_AGE_RANGE_UNKNOWN_MUST_BE_WITH_OTHERAt least one age range must be selected. (Excluding unknown)
AD__AD_SET_DEMOGRAPHIC_ADULT_ONLY_CANNOT_EDITAdult targeting cannot be turned off once set.
AD__AD_SET_DEMOGRAPHIC_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support demographic target settings.
AD__AD_SET_EXTENDED_DEMOGRAPHIC_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support extended demographic target settings.
AD__AD_SET_ADULT_ONLY_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support adult targeting settings.
AD__AD_SET_EXTENDED_DEMO_CODE_INVALIDThe extended demographic target code ({code}) is invalid.
AD__AD_SET_INTEREST_INTERSECTION_INVALIDThe target matching method can be set only when both interest targeting and purchase intent targeting are defined.
AD__AD_SET_INTEREST_DEPTH_INVALIDThe depth of an interest target can only be 1, 2, 3, or 4.
AD__AD_SET_INTEREST_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support interest target settings.
AD__AD_SET_PURCHASE_INTENT_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support purchase intent target settings.
AD__AD_SET_INTEREST_FIRST_CODE_INVALIDThe first-depth interest target code ({code}) is invalid.
AD__AD_SET_INTEREST_SECOND_CODE_INVALIDThe second-depth interest target code ({code}) is invalid.
AD__AD_SET_INTEREST_THIRD_CODE_INVALIDThe third-depth interest target code ({code}) is invalid.
AD__AD_SET_INTEREST_FOURTH_CODE_INVALIDThe fourth-depth interest target code ({code}) is invalid.
AD__AD_SET_INTEREST_CODE_NOT_SETThe interest target code is not set.
AD__AD_SET_PURCHASE_INTENT_CODE_INVALIDThe purchase intent target code ({code}) is invalid.
AD__AD_SET_DEVICE_DEVICE_TYPE_NOT_EMPTYDeviceType must not be empty.
AD__AD_SET_DEVICE_MOBILE_NEEDWhen the platform is set to [ANDROID/IOS], the 'MOBILE' device type must be set.
AD__AD_SET_DEVICE_PLATFORMS_NOT_EMPTYWhen the 'MOBILE' device type is set, the platform [ANDROID/IOS] must not be empty.
AD__AD_SET_DEVICE_INVALID_PLATFORMSThe platform cannot be set.
AD__AD_SET_DEVICE_INVALID_PLATFORMS_ALL_DEVICEWhen all devices are selected, all platforms must be entered.
AD__AD_SET_DEVICE_INVALID_DEVICES_ALL_DEVICEWhen all devices are selected, all selectable devices must be entered.
AD__AD_SET_DEVICE_INVALID_DEVICE_TYPESThe device cannot be set.
AD__AD_SET_NOT_ALLOWED_ALL_PLACEMENTCannot select all placements available for impressions. For the device list [{deviceCodes}] you entered, only the placement list [{placementGroupCodes}] can be selected.
AD__AD_SET_PLACEMENT_GROUP_NOT_EMPTYThe placement must not be empty.
AD__AD_SET_PLACEMENT_GROUP_INVALIDThe placement code ({placementGroupCode}) is invalid.
AD__AD_SET_PLACEMENT_GROUP_NOT_COMPATIBLE_WITH_CAMPAIGN_OBJECTIVE_AND_DEVICE_TYPEThe placement code ({placementGroupCode}) is not compatible with the campaign objective ({objective}) and device ({deviceCode}).
AD__AD_SET_PLACEMENT_GROUP_NOT_AVAILABLE_WITH_EXTERNAL_SHOPPING_MALLThe placement code (NAVER Shopping area) is not compatible with the business channel of an external shopping mall.
AD__AD_SET_PLACEMENT_GROUP_NOT_COMPATIBLE_WITH_TARGETING_TYPEThe placement code ({placementGroupCode}) is not compatible with the targeting type ({targetingType}).
AD__AD_SET_LOCATION_UNKNOWN_LOCATION_INVALIDThe include-unknown option is available only when a location target is set.
AD__AD_SET_LOCATION_TARGET_CANNOT_USE_AT_CONTEXTThe [Context] targeting type does not support location target settings.
AD__AD_SET_MUST_INCLUDE_LOCATION_AT_NEARBYThe location of interest must be included when expanding to nearby areas.
AD__AD_SET_LOCATION_TARGET_EXCEED_MAXUp to 1000 location targets can be set.
AD__AD_SET_LOCATION_TARGET_INVALID_RCODEThe location code ({locationCode}) is invalid.
AD__AD_SET_CONTEXTUAL_TARGETING_CAN_ONLY_CONTEXT_TARGETINGTopic targets are provided only for the [Context] targeting type.
AD__AD_SET_INVALID_CONTEXTUAL_TARGETING_CODEThe topic target code ({contextualTargetingCode}) is invalid.
AD__AD_SET_INVALID_TIME_FORMAT_DAY_OF_WEEKThe dayOfWeek field must be a value between 1 and 7.
AD__AD_SET_INVALID_TIME_FORMAT_HOURThe start time and end time fields must be a value between 0 and 23.
AD__AD_SET_TIME_SLOT_MUST_BE_SET_AT_ADULT_ONLY_AND_SOME_PLACEMENT_GROUPA detailed schedule must be set when adult targeting is used and the Smart Channel, Integrated Services, or Feed area placement is selected.
AD__AD_SET_TIME_SLOT_NOT_ALLOWED_ADULT_ONLYThis detailed schedule cannot be selected when adult targeting is set.
AD__AD_SET_END_TIME_SHOULD_NOT_BE_NULL_WHEN_BUDGET_TYPE_IS_TOTALThe end time must not be empty when the budget type is [total budget].
AD__AD_SET_ACCELERATED_OPTION_NOT_COMPATIBLE_WITH_AUTO_BIDThe 'accelerated delivery' option cannot be set when automatic bidding is set.
AD__AD_SET_QUOTA_AND_FREQUENCY_AD_UNIT_NOT_BE_NULL_WHEN_ACCELERATED_AND_USER_AUTO_FREQUENCY_NOT_SETWhen neither accelerated delivery nor automatic impression frequency is set, the impression frequency and impression unit must not be empty.
AD__AD_SET_QUOTA_AND_FREQUENCY_AD_UNIT_SHOULD_BE_NULL_WHEN_ACCELERATED_SETWhen accelerated delivery is set, the impression frequency and impression unit must be empty.
AD__AD_SET_QUOTA_AND_FREQUENCY_AD_UNIT_SHOULD_BE_NULL_WHEN_USE_AUTO_FREQUENCY_SETWhen automatic impression frequency is set, the impression frequency and impression unit must be empty.
AD__AD_SET_QUOTA_OR_CREATIVE_QUOTA_SHOULD_BE_NULLOnly one of the ad group-level impression frequency and the creative-level impression frequency can be set.
AD__AD_SET_QUOTA_VALUE_SHOULD_BE_BETWEEN_1_TO_5The impression frequency can be set only to a value from 1 to 5.
AD__AD_SET_START_TIME_SHOULD_NOT_BEThe start time must not be empty.
AD__AD_SET_START_TIME_SHOULD_BE_AT_LEAST_AFTER_30_MINUTESThe start time must be at least 30 minutes after the current time.
AD__AD_SET_START_TIME_SHOULD_BE_BEFORE_THAN_END_TIMEThe start time must be earlier than the end time.
AD__AD_SET_END_TIME_SHOULD_BE_NULL_WHEN_ONGOING_IS_SETWhen the delivery period is set to ongoing, the end time must be empty.
AD__AD_SET_END_TIME_SHOULD_NOT_BE_NULL_WHEN_ONGOING_IS_NOT_SETWhen the delivery period is not set to ongoing, the end time must not be empty.
AD__AD_SET_BID_TYPE_NOT_NULLThe billing basis must not be empty.
AD__AD_SET_BID_GOAL_NOT_NULLThe bidding strategy must not be empty.
AD__AD_SET_BID_STRATEGY_NOT_NULLThe cost management must not be empty.
AD__AD_SET_BUDGET_TYPE_NOT_NULLThe budget type must not be empty.
AD__AD_SET_MUST_BE_10_UNITMust be entered in units of 10. Input value: {inputValue}
AD__AD_SET_MUST_BE_0_01_UNITMust be entered in units of 0.01. Input value: {inputValue}
AD__AD_SET_INVALID_CURRENCYThe currency is not defined. Input value: {inputValue}
AD__AD_SET_BID_GOAL_NOT_COMPATIBLE_WITH_CAMPAIGN_OBJECTIVEThe bidding strategy ({bidGoal}) is not compatible with the campaign objective ({objective}).
AD__AD_SET_BID_STRATEGY_NOT_COMPATIBLE_WITH_CAMPAIGN_OBJECTIVE_AND_BID_GOALThe cost management ({bidStrategy}) is not compatible with the campaign objective ({objective}) and bidding strategy ({bidGoal}).
AD__AD_SET_BID_TYPE_NOT_COMPATIBLE_WITH_CAMPAIGN_OBJECTIVE_AND_BID_GOALThe billing basis ({bidType}) is not compatible with the campaign objective ({objective}) and bidding strategy ({bidGoal}).
AD__AD_SET_BID_STRATEGY_VALUE_SHOULD_BE_NULLWhen the cost management is {bidStrategy}, the cost management value must be empty.
AD__AD_SET_BID_STRATEGY_VALUE_SHOULD_NOT_BE_NULLWhen the cost management is {bidStrategy}, the cost management value must not be empty.
AD__AD_SET_BID_PRICE_SHOULD_NOT_BE_NULLWhen the cost management is {bidStrategy}, the bid amount must not be empty.
AD__AD_SET_BID_PRICE_SHOULD_BE_NULLWhen the cost management is {bidStrategy}, the bid amount must be empty.
AD__AD_SET_BID_STRATEGY_UNKNOWN_TYPEThe bidding strategy ({bidGoal}) is an unknown type.
AD__AD_SET_CANNOT_CHANGE_DIFFERENT_BUDGET_TYPEDifferent budget types cannot be modified together.
AD__AD_SET_CANNOT_CHANGE_DIFFERENT_BID_STRATEGYDifferent cost management settings cannot be modified together.
AD__AD_SET_CANNOT_CHANGE_DIFFERENT_BID_TYPEDifferent billing bases cannot be modified together.
AD__AD_SET_BID_GOAL_MUST_SAME_AT_CBOThe bidding strategy of an ad group in a campaign budget optimization campaign must be the same as the campaign optimization option.
AD__AD_SET_BID_STRATEGY_MUST_SAME_AT_CBOThe cost management of an ad group in a campaign budget optimization campaign must be the same as the campaign optimization option.
AD__AD_SET_BUDGET_AMOUNT_CANNOT_BE_SET_AT_CBOThe budget of an ad group in a campaign budget optimization campaign cannot be set.
AD__AD_SET_BUDGET_TYPE_MUST_BE_DAILY_AT_CBOFor an ad group in a campaign budget optimization campaign, only the daily budget type can be selected.
AD__AD_SET_BID_TYPE_MUST_BE_CPC_AT_CBOFor an ad group in a campaign budget optimization campaign, only CPC can be selected as the billing basis.
AD__AD_SET_MAX_AD_SET_AT_CBOThe number of ad groups in a campaign budget optimization campaign is limited to n.
AD__CREATIVE_CANNOT_CREATE_EXCEED_MAXCannot create a new ad because the maximum number of ads has been reached.
AD__TARGETING_CANNOT_SET_AGETargeting cannot be set for this age.
- Adult targeting cannot include minor ages.
AD__BID_STRATEGY_COST_CAP_NEED_AGREEAgreement is required to use the cost limit.
- You only need to agree once per ad account number.
- How to agree: Go to gfa.naver.com, select this option when creating an ad group, check the agreement box, and save.
AD__BID_STRATEGY_NO_CAP_NEED_AGREEAgreement is required to use no bid amount limit.
- You only need to agree once per ad account number.
- How to agree: Go to gfa.naver.com, select this option when creating an ad group, check the agreement box, and save.
AD__START_TIME_CANNOT_CHANGE_IN_OPERATIONThe start date and time cannot be modified when the ad is running or has ended.
COMMON__FILE_NOT_EXISTThe file does not exist.
COMMON__FILE_EXTENSION_NOT_ALLOWEDThe file extension is not allowed.
STATS__INVALID_API_VERSIONThe API version is invalid.
STATS__INVALID_AD_ACCOUNT_NOadAccountNo is invalid.
STATS__INVALID_CAMPAIGN_NOcampaignNo is invalid.
STATS__INVALID_AD_SET_NOadSetNo is invalid.
STATS__INVALID_AGGREGATION_TYPEaggregationType is invalid.
STATS__MISSING_START_DATEstartDate is missing.
STATS__INVALID_START_DATEstartDate is invalid.
STATS__INCONSISTENT_START_DATEstartDate differs from the previous request.
STATS__TOO_EARLY_START_DATEData can be retrieved for up to the past 2 years.
STATS__MISSING_END_DATEendDate is missing.
STATS__INVALID_END_DATEendDate is invalid.
STATS__INCONSISTENT_END_DATEendDate differs from the previous request.
STATS__TOO_EARLY_END_DATEendDate must be after startDate.
STATS__TOO_LATE_END_DATEendDate must be before today.
STATS__ACCESS_BEFORE_AVAILABLEYesterday's data can be retrieved after 02:00.
STATS__TOO_LONG_PERIODThe retrieval period is up to 31 days.
STATS__INVALID_NEXTnext is invalid.
STATS__EXPIRED_PAGING_TOKENThe paging token has expired.
STATS__INCONSISTENT_LIMITlimit differs from the previous request.
STATS__TOO_LARGE_LIMITThe maximum value of limit is 1000.
STATS__INVALID_LIMITlimit is invalid.
STATS__INVALID_TARGET_DATEtargetDate is invalid.
STATS__INCONSISTENT_TIME_UNITtimeUnit differs from the previous request.
STATS__INVALID_TIME_UNITtimeUnit is invalid.
STATS__INVALID_SINCEsince is invalid.
STATS__UNAUTHORIZED_EXCEPTIONAuthentication of the performance retrieval permission failed.
STATS__FORBIDDENYou do not have permission to retrieve this ad account.
STATS__INVALID_REQUESTThe request is invalid.
STATS__UNCAUGHT_EXCEPTIONA server error occurred.