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		metric
Business Channel ID	Business Channel ID	Unique identifier for the business channel.	dimension
Campaign	Campaign	The name of the advertising campaign.	dimension
Campaign ID	Campaign ID	Unique identifier for an advertising campaign.	dimension
Campaign Type	Campaign Type	The type of advertising campaign (e.g., search, display).	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.	dimension
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		dimension
ad.contentIssueDate	ad.contentIssueDate		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		dimension
ad.imagePath	ad.imagePath		dimension
ad.landingUrl	ad.landingUrl		dimension
ad.logoImage	ad.logoImage		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		dimension
adAttr.bidAmt	adAttr.bidAmt		metric
adAttr.useGroupBidAmt	adAttr.useGroupBidAmt		dimension
adRelevanceScore	adRelevanceScore		dimension
adgroupAttrJson.campaignTp	adgroupAttrJson.campaignTp	The campaign type associated with the ad group.	metric
adgroupAttrJson.contentsType	adgroupAttrJson.contentsType		dimension
adgroupAttrJson.media	adgroupAttrJson.media		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
customerId	customerId	A unique identifier for the customer account managing the ad campaigns.	dimension
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		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		dimension
links.pc.final	links.pc.final		dimension
mobileChannelId	mobileChannelId	The unique identifier for the mobile advertising channel.	dimension
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
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		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		metric
referenceData.adCustomerId	referenceData.adCustomerId	The unique identifier for the customer associated with the ad reference data.	metric
referenceData.brand	referenceData.brand		dimension
referenceData.catId	referenceData.catId		metric
referenceData.category1Id	referenceData.category1Id		metric
referenceData.category1Name	referenceData.category1Name		dimension
referenceData.category2Id	referenceData.category2Id		metric
referenceData.category2Name	referenceData.category2Name		dimension
referenceData.category3Id	referenceData.category3Id		metric
referenceData.category3Name	referenceData.category3Name		dimension
referenceData.category4Id	referenceData.category4Id		metric
referenceData.category4Name	referenceData.category4Name		dimension
referenceData.id	referenceData.id		metric
referenceData.imageUrl	referenceData.imageUrl		dimension
referenceData.imgStatusCd	referenceData.imgStatusCd		dimension
referenceData.lowPrice	referenceData.lowPrice		metric
referenceData.maker	referenceData.maker		dimension
referenceData.mallName	referenceData.mallName		dimension
referenceData.mallProductId	referenceData.mallProductId		metric
referenceData.mallProductUrl	referenceData.mallProductUrl		dimension
referenceData.mobilePrice	referenceData.mobilePrice		metric
referenceData.openDate	referenceData.openDate	The date when the product was made available or ‘opened’ in the reference data.	metric
referenceData.parentId	referenceData.parentId		metric
referenceData.priceUnit	referenceData.priceUnit		dimension
referenceData.prodStatusCd	referenceData.prodStatusCd		dimension
referenceData.prodTypeCd	referenceData.prodTypeCd		dimension
referenceData.productName	referenceData.productName		dimension
referenceData.productTitle	referenceData.productTitle		dimension
referenceData.purchaseCnt	referenceData.purchaseCnt		metric
referenceData.registrable	referenceData.registrable		dimension
referenceData.reviewCountSum	referenceData.reviewCountSum		metric
referenceData.scoreInfo	referenceData.scoreInfo		metric
regTm	regTm	The timestamp when the entity was registered or created.	dimension
sharedBudgetId	sharedBudgetId		dimension
sharedBudgetLock	sharedBudgetLock		dimension
sharedBudgetName	sharedBudgetName		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		dimension
targetSummary.time	targetSummary.time		dimension
targetSummary.week	targetSummary.week		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		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
usePeriod	usePeriod	Indicates if a specific operating period is defined for the campaign or ad group.	dimension