Naver Search Ads: Most-used fields
The table below gives information about most-used fields that you can import from Naver Search Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
AD Group IDDimension
Unique identifier for an ad group.
AD IDDimension
Unique identifier for an individual advertisement.
AD keyword IDDimension
Unique identifier for an advertisement keyword.
Ad Group NameDimension
The unique name identifying an ad group within a campaign. Ad groups organize your ads and keywords.
Ad NameDimension
The unique name identifying an individual ad creative within an ad group.
Average rankMetric
The average position of the advertisement in search results or placements.
Business Channel IDDimension
Unique identifier for the business channel.
Campaign IDDimension
Unique identifier for an advertising campaign.
Campaign NameDimension
The unique name identifying a campaign for an account. Campaigns are used to organize ad groups and ads around a common advertising goal.
ClickMetric
The number of times users clicked on the advertisement.
Click countMetric
The total number of clicks received by the ad, ad group, campaign, or keyword. This is a key performance metric for advertising effectiveness.
Clickthrough rateMetric
The percentage of impressions that resulted in a click, calculated as (Clicks / Impressions) * 100.
Conversion TypeDimension
The specific type of conversion tracked (e.g., purchase, signup, lead).
Conversion amountMetric
The total monetary value of conversions recorded.
Conversion countMetric
The total number of conversions attributed to the ad, ad group, campaign, or keyword. Conversions represent desired actions taken by users, such as purchases or sign-ups.
Conversion rateMetric
The percentage of clicks or ad interactions that result in a conversion.
CostMetric
The total monetary cost incurred for advertising activities within the Naver Search Ads platform. This can include costs for clicks, impressions, or conversions.
Cost per clickMetric
The average cost incurred for each click on an ad. This is a common metric to evaluate the efficiency of an advertising campaign.
Cost per conversionMetric
The average cost incurred for each conversion.
Customer IDDimension
Unique identifier for the customer or advertiser account.
DateDimension
The date for which the performance data is reported.
End DateDimension
The end date of the campaign or report period.
HoursDimension
The hour of the day for which the performance data is reported.
ImpressionMetric
The number of times the advertisement was displayed to users.
Impression countMetric
The total number of times an ad was displayed to users. This metric indicates the visibility of the ad.
KeywordDimension
Represents the specific search term or keyword associated with an advertising campaign, used for retrieving keyword-level performance data or metadata.
PC Mobile TypeDimension
Specifies the device type (PC or mobile) on which the ad was displayed or targeted.
Region codeMetric
A code representing the geographical region for which the data is collected or targeted.
Sales amountMetric
The total revenue generated from sales directly attributed to the advertising campaign, often including VAT.
Sales by conversionDimension
The total sales revenue generated as a result of conversions.
Start DateDimension
The start date of the campaign or report period.
View countMetric
The number of times the ad content was viewed.
ad.companyNameDimension
The name of the company associated with the advertisement.
ad.contentIssueDateDimension
The date when the content or product associated with the advertisement was issued or released.
ad.descriptionDimension
The main descriptive text for the advertisement.
ad.headlineDimension
The primary headline text for the advertisement.
ad.imageDimension
The main image creative for the advertisement.
ad.imagePathDimension
The file path or URL to the image used in the advertisement.
ad.landingUrlDimension
The URL to which users are directed after clicking on the advertisement.
ad.logoImageDimension
The logo image used in the advertisement.
ad.mobile.displayDimension
The URL displayed to users for the mobile advertisement.
ad.mobile.finalDimension
The final landing page URL for the mobile advertisement.
ad.pc.displayDimension
The URL displayed to users for the PC advertisement.
ad.pc.finalDimension
The final landing page URL for the PC advertisement.
ad.productReleaseDateDimension
The date when the product associated with the advertisement was released.
ad.thumbnailDimension
The thumbnail image for the advertisement.
adAttr.bidAmtMetric
The bid amount set for an entity (e.g., keyword, ad group).
adAttr.useGroupBidAmtDimension
Indicates whether the ad uses the bid amount set at the ad group level.
adRelevanceScoreDimension
A score indicating how relevant the advertisement is to the target audience or search query.
adgroupAttrJson.campaignTpMetric
The campaign type associated with the ad group.
adgroupAttrJson.contentsTypeDimension
The type of content associated with the ad group.
adgroupAttrJson.mediaDimension
Information about the media used within the ad group.
adgroupAttrJson.nccProductGroupIdDimension
The Naver Common Commerce (NCC) product group ID associated with the ad group.
adgroupAttrJson.templateIdDimension
The unique identifier for a creative template applied to an ad group, particularly used for Brand Search ad creatives.
adgroupAttrJson.templateNameDimension
The name of the template applied to the ad group. These templates define the visual layout and interactive features of the ads within that group, especially for formats like Naver Brand Search Ads which offer various template types to customize presentation and functionality.
adgroupTypeDimension
The type of the ad group.
autobidStrategy.autobidBidGoalDimension
The specific objective or goal set for the automatic bidding strategy (e.g., maximize conversions, target ROAS).
autobidStrategy.autobidBidStrategyDimension
The specific automatic bidding strategy employed (e.g., maximize clicks, target CPA).
autobidStrategy.autobidBidStrategyValueDimension
The specific value or setting configured for the automatic bidding strategy applied to an ad, defining how the system automatically manages bids to achieve campaign goals.
autobidStrategy.autobidBidTypeDimension
The type of bid mechanism used within the automatic bidding strategy.
autobidStrategy.autobidTargetIdDimension
The unique identifier of the target associated with the automatic bidding strategy.
autobidStrategy.autobidTargetTypeDimension
The type of target associated with the automatic bidding strategy (e.g., conversion, impression share).
autobidStrategy.customerIdDimension
The unique identifier for the customer associated with the autobidding strategy.
autobidStrategy.delFlagDimension
A flag indicating whether the autobidding strategy has been marked for deletion.
autobidStrategy.delTmDimension
The timestamp when the automatic bidding strategy was marked for deletion.
autobidStrategy.editTmDimension
The timestamp when the automatic bidding strategy was last edited or updated.
autobidStrategy.isAutobidActiveDimension
Indicates whether the automatic bidding strategy is currently active and in use for the associated ad.
autobidStrategy.regTmDimension
The timestamp when the automatic bidding strategy was registered or created.
bidAmtMetric
The bid amount set for an entity (e.g., keyword, ad group).
budgetLockDimension
Indicates whether the budget for a shared budget or ad group is locked (true) and cannot be modified, or if it is unlocked (false) and can be adjusted.
campaignTpDimension
Identifies the type of the advertising campaign, categorizing campaigns based on their objectives or characteristics.
contentsNetworkBidAmtMetric
The bid amount specifically set for ads displayed on the content network.
customerIdDimension
A unique identifier for the customer account managing the ad campaigns.
dailyBudgetMetric
The maximum amount of money allocated for spending on an ad campaign or ad group per day.
delFlagDimension
A flag indicating whether an entity (e.g., campaign, ad group, ad) has been marked for deletion.
deliveryMethodDimension
Indicates the method used to retrieve data from the Naver Search Ads API. This can include asynchronously generated Performance Reports, directly fetched Summary Reports, or Metadata Reports from list endpoints.
editTmDimension
The timestamp when the entity was last edited or updated.
enableDimension
A boolean flag indicating whether the entity is enabled or active.
expectedClickScoreDimension
A predicted score representing the likelihood of an advertisement being clicked by users.
idMetric
A unique identifier for the specific entity (e.g., campaign ID, ad group ID, ad ID, keyword ID).
inspectStatusDimension
The current inspection or review status of an ad creative or campaign.
keywordDimension
The keyword used for targeting the advertisement.
links.mobile.finalDimension
The final landing page URL for the mobile advertisement.
links.pc.finalDimension
The final landing page URL for the PC advertisement.
mobileChannelIdDimension
The unique identifier for the mobile advertising channel.
nameDimension
The name of the entity, such as the campaign name, ad group name, or ad title.
nccAdIdDimension
The Naver Common Commerce (NCC) platform's unique identifier for the advertisement.
nccAdgroupIdDimension
A unique identifier for the Naver Search Ad ad group.
nccCampaignIdDimension
A unique identifier for the Naver Search Ad campaign.
pcChannelIdDimension
The unique identifier for the PC advertising channel.
periodEndDtDimension
The end date for the reporting period. This field corresponds to the 'until' parameter in Naver Search Ads API requests for summary and performance reports, defining the final date for which data is collected.
periodStartDtDimension
The start date for the reporting period. This field corresponds to the 'since' parameter in Naver Search Ads API requests for summary and performance reports, defining the initial date from which data is collected.
productGroup.brandNameDimension
The brand name associated with the product group.
productGroup.customerIdDimension
The unique identifier for the customer who owns or manages the product group.
productGroup.editTmDimension
The timestamp when the product group was last edited or updated.
productGroup.mallIdDimension
The unique identifier for the shopping mall or platform associated with the product group.
productGroup.mallNameDimension
The name of the shopping mall or platform associated with the product group.
productGroup.nameDimension
The name of the product group.
productGroup.nccBusinessChannelIdDimension
The unique identifier for the business channel associated with the product group within Naver Common Commerce.
productGroup.nccProductGroupIdDimension
The unique identifier for the product group within Naver Common Commerce (NCC).
productGroup.numberOfAdgroupsDimension
The total count of ad groups associated with this specific product group.
productGroup.regTmDimension
The timestamp when the product group was registered or created.
productGroup.registeredProductTypeDimension
The type of product registered within the product group.
productGroup.registrationMethodDimension
The method used to register the product group (e.g., manual, API).
referenceData.APPLY_TMMetric
The timestamp when the reference data was applied.
referenceData.DEL_FLAGMetric
A flag indicating whether the reference data has been marked for deletion.
referenceData.DEL_TMMetric
The timestamp when the reference data was marked for deletion.
referenceData.adCustomerIdMetric
The unique identifier for the customer associated with the ad reference data.
referenceData.brandDimension
The brand name associated with the product in the reference data.
referenceData.catIdMetric
The category ID for the product in the reference data.
referenceData.category1IdMetric
The ID of the first-level category for the product in the reference data.
referenceData.category1NameDimension
The name of the first-level category for the product in the reference data.
referenceData.category2IdMetric
The ID of the second-level category for the product in the reference data.
referenceData.category2NameDimension
The name of the second-level category for the product in the reference data.
referenceData.category3IdMetric
The ID of the third-level category for the product in the reference data.
referenceData.category3NameDimension
The name of the third-level category for the product in the reference data.
referenceData.category4IdMetric
The ID of the fourth-level category for the product in the reference data.
referenceData.category4NameDimension
The name of the fourth-level category for the product in the reference data.
referenceData.idMetric
A unique identifier for the specific entity in the reference data.
referenceData.imageUrlDimension
The URL of the product image in the reference data.
referenceData.imgStatusCdDimension
The status code of the image associated with the product in the reference data.
referenceData.lowPriceMetric
The lowest price of the product in the reference data.
referenceData.makerDimension
The manufacturer or maker of the product in the reference data.
referenceData.mallNameDimension
The name of the shopping mall associated with the product group in the reference data.
referenceData.mallProductIdMetric
The product ID within the shopping mall for the product in the reference data.
referenceData.mallProductUrlDimension
The URL of the product on the shopping mall.
referenceData.mobilePriceMetric
The price of the product specifically for mobile viewing or purchase in the reference data.
referenceData.openDateMetric
The date when the product was made available or 'opened' in the reference data.
referenceData.parentIdMetric
The parent ID for the product in the reference data, often used for variations or grouped products.
referenceData.priceUnitDimension
The unit of price for the product (e.g., KRW, USD) in the reference data.
referenceData.prodStatusCdDimension
The status code for the product in the reference data.
referenceData.prodTypeCdDimension
The type code for the product in the reference data.
referenceData.productNameDimension
The name of the product in the reference data.
referenceData.productTitleDimension
The title of the product in the reference data.
referenceData.purchaseCntMetric
The total count of purchases for the product in the reference data.
referenceData.registrableDimension
Indicates whether the product in the reference data is registrable.
referenceData.reviewCountSumMetric
The total sum of review counts for the product in the reference data.
referenceData.scoreInfoMetric
Information related to the product's score or rating in the reference data.
referenceKeyDimension
A unique identifier or key that references a specific ad creative or material, used during the creation or modification of shopping search ads.
regTmDimension
The timestamp when the entity was registered or created.
sharedBudgetDeliveryMethodDimension
This field specifies how the campaign's budget is delivered or spent over time. For example, 'STANDARD' delivery aims to spend the budget evenly throughout the day.
sharedBudgetIdDimension
The unique identifier for a budget that is shared across multiple campaigns or ad groups.
sharedBudgetLockDimension
Indicates if the shared budget is locked, preventing further changes.
sharedBudgetNameDimension
The name assigned to the shared budget.
sharedDailyBudgetDimension
The daily budget amount allocated for the shared budget.
statusDimension
The current operational status of the entity (e.g., campaign, ad group, ad, keyword), such as 'active', 'paused', or 'deleted'.
statusReasonDimension
The reason for the current status of an ad, ad group, or campaign (e.g., disapproved, paused).
systemBiddingTypeDimension
The type of bidding managed by the system (e.g., automated, manual).
targetSummary.mediaDimension
A summary of the media types targeted by the campaign or ad group.
targetSummary.pcMobileDimension
A summary of whether PC, mobile, or both device types are targeted.
targetSummary.periodDimension
A summary of the period during which the campaign or ad group is targeted.
targetSummary.timeDimension
A summary of the time of day when the campaign or ad group is targeted.
targetSummary.weekDimension
A summary of the days of the week when the campaign or ad group is targeted.
targetsDimension
A collection of targeting settings that define the audience or placement for ad delivery.
targets.delFlagDimension
A flag indicating whether this specific targeting setting has been marked for deletion.
targets.editTmDimension
The timestamp when the targeting setting was last edited or updated.
targets.ownerIdDimension
The unique identifier of the owner of the targeting setting.
targets.regTmDimension
The timestamp when the targeting setting was registered or created.
targets.target.contentsDimension
Specifies targeting related to content, including categories, topics, or types of placements where ads are displayed.
targets.target.mobileDimension
A targeting option that focuses ad delivery specifically on mobile devices.
targets.target.pcDimension
A targeting option that focuses ad delivery specifically on personal computer (PC) devices.
targets.target.searchDimension
Specifies targeting for advertisements displayed on search results pages.
targets.target.typeDimension
Specifies the type of targeting being applied, such as demographic, regional, hourly, or device-based targets.
targets.targetTpDimension
Specifies the type of targeting configured for ad delivery.
totalChargeCostMetric
The aggregate financial expenditure incurred for the advertising activities during a specified period.
trackingModeDimension
The method or protocol used to track user interactions and conversions, such as clicks and post-click actions, for advertisements on the Naver Search Ads platform.
typeDimension
The type or category of the entity.
useCntsNetworkBidAmtDimension
The bid amount applied for ads displayed on the content network.
useDailyBudgetDimension
Indicates whether a daily budget is actively being used for the campaign or ad group.
usePeriodDimension
Specifies the time period or duration for which advertising data is being reported or analyzed.