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 ID Dimension
Unique identifier for an ad group.
AD ID Dimension
Unique identifier for an individual advertisement.
AD keyword ID Dimension
Unique identifier for an advertisement keyword.
Ad Group Name Dimension
The unique name identifying an ad group within a campaign. Ad groups organize your ads and keywords.
Ad Name Dimension
The unique name identifying an individual ad creative within an ad group.
Average rank Metric
The average position of the advertisement in search results or placements.
Business Channel ID Dimension
Unique identifier for the business channel.
Campaign ID Dimension
Unique identifier for an advertising campaign.
Campaign Name Dimension
The unique name identifying a campaign for an account. Campaigns are used to organize ad groups and ads around a common advertising goal.
Click Metric
The number of times users clicked on the advertisement.
Click count Metric
The total number of clicks received by the ad, ad group, campaign, or keyword. This is a key performance metric for advertising effectiveness.
Clickthrough rate Metric
The percentage of impressions that resulted in a click, calculated as (Clicks / Impressions) * 100.
Conversion Type Dimension
The specific type of conversion tracked (e.g., purchase, signup, lead).
Conversion amount Metric
The total monetary value of conversions recorded.
Conversion count Metric
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 rate Metric
The percentage of clicks or ad interactions that result in a conversion.
Cost Metric
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 click Metric
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 conversion Metric
The average cost incurred for each conversion.
Customer ID Dimension
Unique identifier for the customer or advertiser account.
Date Dimension
The date for which the performance data is reported.
End Date Dimension
The end date of the campaign or report period.
Hours Dimension
The hour of the day for which the performance data is reported.
Impression Metric
The number of times the advertisement was displayed to users.
Impression count Metric
The total number of times an ad was displayed to users. This metric indicates the visibility of the ad.
Keyword Dimension
Represents the specific search term or keyword associated with an advertising campaign, used for retrieving keyword-level performance data or metadata.
PC Mobile Type Dimension
Specifies the device type (PC or mobile) on which the ad was displayed or targeted.
Region code Metric
A code representing the geographical region for which the data is collected or targeted.
Sales amount Metric
The total revenue generated from sales directly attributed to the advertising campaign, often including VAT.
Sales by conversion Dimension
The total sales revenue generated as a result of conversions.
Start Date Dimension
The start date of the campaign or report period.
View count Metric
The number of times the ad content was viewed.
ad.companyName Dimension
The name of the company associated with the advertisement.
ad.contentIssueDate Dimension
The date when the content or product associated with the advertisement was issued or released.
ad.description Dimension
The main descriptive text for the advertisement.
ad.headline Dimension
The primary headline text for the advertisement.
ad.image Dimension
The main image creative for the advertisement.
ad.imagePath Dimension
The file path or URL to the image used in the advertisement.
ad.landingUrl Dimension
The URL to which users are directed after clicking on the advertisement.
ad.logoImage Dimension
The logo image used in the advertisement.
ad.mobile.display Dimension
The URL displayed to users for the mobile advertisement.
ad.mobile.final Dimension
The final landing page URL for the mobile advertisement.
ad.pc.display Dimension
The URL displayed to users for the PC advertisement.
ad.pc.final Dimension
The final landing page URL for the PC advertisement.
ad.productReleaseDate Dimension
The date when the product associated with the advertisement was released.
ad.thumbnail Dimension
The thumbnail image for the advertisement.
adAttr.bidAmt Metric
The bid amount set for an entity (e.g., keyword, ad group).
adAttr.useGroupBidAmt Dimension
Indicates whether the ad uses the bid amount set at the ad group level.
adRelevanceScore Dimension
A score indicating how relevant the advertisement is to the target audience or search query.
adgroupAttrJson.campaignTp Metric
The campaign type associated with the ad group.
adgroupAttrJson.contentsType Dimension
The type of content associated with the ad group.
adgroupAttrJson.media Dimension
Information about the media used within the ad group.
adgroupAttrJson.nccProductGroupId Dimension
The Naver Common Commerce (NCC) product group ID associated with the ad group.
adgroupAttrJson.templateId Dimension
The unique identifier for a creative template applied to an ad group, particularly used for Brand Search ad creatives.
adgroupAttrJson.templateName Dimension
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.
adgroupType Dimension
The type of the ad group.
autobidStrategy.autobidBidGoal Dimension
The specific objective or goal set for the automatic bidding strategy (e.g., maximize conversions, target ROAS).
autobidStrategy.autobidBidStrategy Dimension
The specific automatic bidding strategy employed (e.g., maximize clicks, target CPA).
autobidStrategy.autobidBidStrategyValue Dimension
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.autobidBidType Dimension
The type of bid mechanism used within the automatic bidding strategy.
autobidStrategy.autobidTargetId Dimension
The unique identifier of the target associated with the automatic bidding strategy.
autobidStrategy.autobidTargetType Dimension
The type of target associated with the automatic bidding strategy (e.g., conversion, impression share).
autobidStrategy.customerId Dimension
The unique identifier for the customer associated with the autobidding strategy.
autobidStrategy.delFlag Dimension
A flag indicating whether the autobidding strategy has been marked for deletion.
autobidStrategy.delTm Dimension
The timestamp when the automatic bidding strategy was marked for deletion.
autobidStrategy.editTm Dimension
The timestamp when the automatic bidding strategy was last edited or updated.
autobidStrategy.isAutobidActive Dimension
Indicates whether the automatic bidding strategy is currently active and in use for the associated ad.
autobidStrategy.regTm Dimension
The timestamp when the automatic bidding strategy was registered or created.
bidAmt Metric
The bid amount set for an entity (e.g., keyword, ad group).
budgetLock Dimension
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.
campaignTp Dimension
Identifies the type of the advertising campaign, categorizing campaigns based on their objectives or characteristics.
contentsNetworkBidAmt Metric
The bid amount specifically set for ads displayed on the content network.
customerId Dimension
A unique identifier for the customer account managing the ad campaigns.
dailyBudget Metric
The maximum amount of money allocated for spending on an ad campaign or ad group per day.
delFlag Dimension
A flag indicating whether an entity (e.g., campaign, ad group, ad) has been marked for deletion.
deliveryMethod Dimension
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.
editTm Dimension
The timestamp when the entity was last edited or updated.
enable Dimension
A boolean flag indicating whether the entity is enabled or active.
expectedClickScore Dimension
A predicted score representing the likelihood of an advertisement being clicked by users.
id Metric
A unique identifier for the specific entity (e.g., campaign ID, ad group ID, ad ID, keyword ID).
inspectStatus Dimension
The current inspection or review status of an ad creative or campaign.
keyword Dimension
The keyword used for targeting the advertisement.
links.mobile.final Dimension
The final landing page URL for the mobile advertisement.
links.pc.final Dimension
The final landing page URL for the PC advertisement.
mobileChannelId Dimension
The unique identifier for the mobile advertising channel.
name Dimension
The name of the entity, such as the campaign name, ad group name, or ad title.
nccAdId Dimension
The Naver Common Commerce (NCC) platform's unique identifier for the advertisement.
nccAdgroupId Dimension
A unique identifier for the Naver Search Ad ad group.
nccCampaignId Dimension
A unique identifier for the Naver Search Ad campaign.
pcChannelId Dimension
The unique identifier for the PC advertising channel.
periodEndDt Dimension
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.
periodStartDt Dimension
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.brandName Dimension
The brand name associated with the product group.
productGroup.customerId Dimension
The unique identifier for the customer who owns or manages the product group.
productGroup.editTm Dimension
The timestamp when the product group was last edited or updated.
productGroup.mallId Dimension
The unique identifier for the shopping mall or platform associated with the product group.
productGroup.mallName Dimension
The name of the shopping mall or platform associated with the product group.
productGroup.name Dimension
The name of the product group.
productGroup.nccBusinessChannelId Dimension
The unique identifier for the business channel associated with the product group within Naver Common Commerce.
productGroup.nccProductGroupId Dimension
The unique identifier for the product group within Naver Common Commerce (NCC).
productGroup.numberOfAdgroups Dimension
The total count of ad groups associated with this specific product group.
productGroup.regTm Dimension
The timestamp when the product group was registered or created.
productGroup.registeredProductType Dimension
The type of product registered within the product group.
productGroup.registrationMethod Dimension
The method used to register the product group (e.g., manual, API).
referenceData.APPLY_TM Metric
The timestamp when the reference data was applied.
referenceData.DEL_FLAG Metric
A flag indicating whether the reference data has been marked for deletion.
referenceData.DEL_TM Metric
The timestamp when the reference data was marked for deletion.
referenceData.adCustomerId Metric
The unique identifier for the customer associated with the ad reference data.
referenceData.brand Dimension
The brand name associated with the product in the reference data.
referenceData.catId Metric
The category ID for the product in the reference data.
referenceData.category1Id Metric
The ID of the first-level category for the product in the reference data.
referenceData.category1Name Dimension
The name of the first-level category for the product in the reference data.
referenceData.category2Id Metric
The ID of the second-level category for the product in the reference data.
referenceData.category2Name Dimension
The name of the second-level category for the product in the reference data.
referenceData.category3Id Metric
The ID of the third-level category for the product in the reference data.
referenceData.category3Name Dimension
The name of the third-level category for the product in the reference data.
referenceData.category4Id Metric
The ID of the fourth-level category for the product in the reference data.
referenceData.category4Name Dimension
The name of the fourth-level category for the product in the reference data.
referenceData.id Metric
A unique identifier for the specific entity in the reference data.
referenceData.imageUrl Dimension
The URL of the product image in the reference data.
referenceData.imgStatusCd Dimension
The status code of the image associated with the product in the reference data.
referenceData.lowPrice Metric
The lowest price of the product in the reference data.
referenceData.maker Dimension
The manufacturer or maker of the product in the reference data.
referenceData.mallName Dimension
The name of the shopping mall associated with the product group in the reference data.
referenceData.mallProductId Metric
The product ID within the shopping mall for the product in the reference data.
referenceData.mallProductUrl Dimension
The URL of the product on the shopping mall.
referenceData.mobilePrice Metric
The price of the product specifically for mobile viewing or purchase in the reference data.
referenceData.openDate Metric
The date when the product was made available or 'opened' in the reference data.
referenceData.parentId Metric
The parent ID for the product in the reference data, often used for variations or grouped products.
referenceData.priceUnit Dimension
The unit of price for the product (e.g., KRW, USD) in the reference data.
referenceData.prodStatusCd Dimension
The status code for the product in the reference data.
referenceData.prodTypeCd Dimension
The type code for the product in the reference data.
referenceData.productName Dimension
The name of the product in the reference data.
referenceData.productTitle Dimension
The title of the product in the reference data.
referenceData.purchaseCnt Metric
The total count of purchases for the product in the reference data.
referenceData.registrable Dimension
Indicates whether the product in the reference data is registrable.
referenceData.reviewCountSum Metric
The total sum of review counts for the product in the reference data.
referenceData.scoreInfo Metric
Information related to the product's score or rating in the reference data.
referenceKey Dimension
A unique identifier or key that references a specific ad creative or material, used during the creation or modification of shopping search ads.
regTm Dimension
The timestamp when the entity was registered or created.
sharedBudgetId Dimension
The unique identifier for a budget that is shared across multiple campaigns or ad groups.
sharedBudgetLock Dimension
Indicates if the shared budget is locked, preventing further changes.
sharedBudgetName Dimension
The name assigned to the shared budget.
sharedDailyBudget Dimension
The daily budget amount allocated for the shared budget.
status Dimension
The current operational status of the entity (e.g., campaign, ad group, ad, keyword), such as 'active', 'paused', or 'deleted'.
statusReason Dimension
The reason for the current status of an ad, ad group, or campaign (e.g., disapproved, paused).
systemBiddingType Dimension
The type of bidding managed by the system (e.g., automated, manual).
targetSummary.media Dimension
A summary of the media types targeted by the campaign or ad group.
targetSummary.pcMobile Dimension
A summary of whether PC, mobile, or both device types are targeted.
targetSummary.period Dimension
A summary of the period during which the campaign or ad group is targeted.
targetSummary.time Dimension
A summary of the time of day when the campaign or ad group is targeted.
targetSummary.week Dimension
A summary of the days of the week when the campaign or ad group is targeted.
targets Dimension
A collection of targeting settings that define the audience or placement for ad delivery.
targets.delFlag Dimension
A flag indicating whether this specific targeting setting has been marked for deletion.
targets.editTm Dimension
The timestamp when the targeting setting was last edited or updated.
targets.ownerId Dimension
The unique identifier of the owner of the targeting setting.
targets.regTm Dimension
The timestamp when the targeting setting was registered or created.
targets.target.contents Dimension
Specifies targeting related to content, including categories, topics, or types of placements where ads are displayed.
targets.target.mobile Dimension
A targeting option that focuses ad delivery specifically on mobile devices.
targets.target.pc Dimension
A targeting option that focuses ad delivery specifically on personal computer (PC) devices.
targets.target.search Dimension
Specifies targeting for advertisements displayed on search results pages.
targets.target.type Dimension
Specifies the type of targeting being applied, such as demographic, regional, hourly, or device-based targets.
targets.targetTp Dimension
Specifies the type of targeting configured for ad delivery.
totalChargeCost Metric
The aggregate financial expenditure incurred for the advertising activities during a specified period.
trackingMode Dimension
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.
type Dimension
The type or category of the entity.
useCntsNetworkBidAmt Dimension
The bid amount applied for ads displayed on the content network.
useDailyBudget Dimension
Indicates whether a daily budget is actively being used for the campaign or ad group.
usePeriod Dimension
Specifies the time period or duration for which advertising data is being reported or analyzed.