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.

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