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	The unique identifier for an ad group. This corresponds to nccAdgroupId in the API.	dimension
AD ID	AD ID	The unique identifier for an individual advertisement. This corresponds to nccAdId in the API.	dimension
AD keyword ID	AD keyword ID	Unique identifier for an advertisement keyword.	dimension
Average rank	Average rank	The average position of an ad in search results. Available in performance and summary reports as avgRnk.	metric
Business Channel ID	Business Channel ID	The Business Channel ID field corresponds to the Business Channel Type in the Naver Search Ads API. It represents the type of business channel associated with the advertisement, such as a website, phone number, physical address, NAVER Booking Service, NAVER TALK service, NAVER Shopping, or NAVER BLOG. This field helps categorize the nature of the advertiser’s presence or offering.	dimension
Campaign	Campaign	Represents an advertising campaign in Naver Search Ads, used to organize and manage ad groups and ads.	dimension
Campaign ID	Campaign ID	The unique identifier for an ad campaign. This corresponds to nccCampaignId in the API.	dimension
Campaign Type	Campaign Type	This field specifies the category or type of the advertising campaign, such as Keyword, Brand Search, Blog, or Shopping. Different campaign types have distinct characteristics and objectives within the Naver Search Ads platform.	dimension
Click	Click	The total number of clicks on an ad. Corresponds to clkCnt in the API.	metric
Click count	Click count	The total number of clicks on an ad. Available in performance and summary reports as clkCnt.	metric
Clickthrough rate	Clickthrough rate	The ratio of clicks to impressions, indicating ad effectiveness. Available in performance and summary reports as ctr.	metric
Conversion Type	Conversion Type	The specific type of conversion recorded (e.g., purchase, sign-up).	dimension
Conversion amount	Conversion amount	The total value generated from conversions. Available in performance and summary reports as convAmt.	metric
Conversion count	Conversion count	The total number of conversions recorded. Related to convAmt metric in reports.	metric
Conversion rate	Conversion rate	The percentage of clicks or impressions that resulted in a conversion.	metric
Cost	Cost	The total cost incurred for the advertising activity.	metric
Cost per click	Cost per click	The average cost incurred for each click on an ad. Available in performance and summary reports as cpc.	metric
Cost per conversion	Cost per conversion	The average cost incurred for each conversion.	metric
Criterion ID	Criterion ID	The unique identifier for a specific criterion, such as a keyword or target.	dimension
Customer ID	Customer ID	The unique identifier for the customer or advertiser account.	metric
Date	Date	The specific date for which the data is reported or relevant.	dimension
End Date	End Date	The end date of the data collection or reporting period. This corresponds to periodEndDt in the API.	dimension
Hours	Hours	A time-based dimension representing the hour of the day for data reporting.	metric
Impression	Impression	The total number of times an ad was displayed. Corresponds to impCnt in the API.	metric
Impression count	Impression count	The total number of times an ad was displayed. Available in performance and summary reports as impCnt.	metric
PC Mobile Type	PC Mobile Type	The device type on which the ad was displayed, such as PC or mobile.	dimension
Region code	Region code	The Region code field is used for geo-targeting, allowing advertisers to specify particular geographic areas where their search advertising campaigns should be displayed. This ensures that ads are shown to users located within the selected regions, enhancing the precision and effectiveness of the advertising efforts.	metric
Sales amount	Sales amount	The total sales revenue generated from ads. Available in performance and summary reports as salesAmt.	metric
Sales by conversion	Sales by conversion	The total sales revenue directly attributed to conversions from ads.	dimension
Search Keyword	Search Keyword	The specific keyword used in a search query.	dimension
Start Date	Start Date	The start date of the data collection or reporting period. This corresponds to periodStartDt in the API.	dimension
View count	View count	The total number of times an ad or 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 of the advertisement was issued or created.	dimension
ad.description	ad.description	The descriptive text content of the advertisement.	dimension
ad.headline	ad.headline	The main headline text of the advertisement.	dimension
ad.image	ad.image	The primary image asset used in the advertisement.	dimension
ad.landingUrl	ad.landingUrl	The URL of the landing page where users are directed after clicking the ad.	dimension
ad.logoImage	ad.logoImage	The logo image displayed as part of the advertisement.	dimension
ad.mobile.display	ad.mobile.display	The display URL of the advertisement when shown on mobile devices.	dimension
ad.mobile.final	ad.mobile.final	The final landing page URL of the advertisement for mobile devices.	dimension
ad.pc.display	ad.pc.display	The display URL of the advertisement when shown on PC devices.	dimension
ad.pc.final	ad.pc.final	The final landing page URL of the advertisement for PC devices.	dimension
ad.productReleaseDate	ad.productReleaseDate	The release date of the product being promoted in the advertisement.	dimension
ad.thumbnail	ad.thumbnail	The thumbnail image used for the advertisement.	dimension
adAttr.bidAmt	adAttr.bidAmt	An attribute indicating the bid amount set for the advertisement.	metric
adRelevanceScore	adRelevanceScore	A score indicating the relevance of the ad to potential customers or search queries.	metric
adgroupAttrJson.campaignTp	adgroupAttrJson.campaignTp	The campaign type associated with the ad group, provided as a JSON attribute.	metric
adgroupAttrJson.contentsType	adgroupAttrJson.contentsType	The type of content associated with the ad group, provided as a JSON attribute.	dimension
adgroupAttrJson.media	adgroupAttrJson.media	The media type associated with the ad group, provided as a JSON attribute.	dimension
adgroupAttrJson.nccProductGroupId	adgroupAttrJson.nccProductGroupId	The unique identifier for a product group associated with an ad group, particularly relevant for shopping brand or product catalog ad types.	dimension
adgroupType	adgroupType	The type or category of the ad group.	dimension
autobidStrategy.autobidBidGoal	autobidStrategy.autobidBidGoal	The specific goal set for the automated bidding strategy (e.g., maximize conversions).	dimension
autobidStrategy.autobidBidStrategy	autobidStrategy.autobidBidStrategy	The type of automated bidding strategy being used.	dimension
autobidStrategy.autobidBidStrategyValue	autobidStrategy.autobidBidStrategyValue	The value associated with the automated bidding strategy (e.g., target CPA amount).	metric
autobidStrategy.autobidBidType	autobidStrategy.autobidBidType	The type of bid utilized by the automated bidding strategy.	dimension
autobidStrategy.autobidTargetId	autobidStrategy.autobidTargetId	The unique identifier of the target for the automated bidding strategy.	dimension
autobidStrategy.autobidTargetType	autobidStrategy.autobidTargetType	The type of target specified for the automated bidding strategy.	dimension
autobidStrategy.customerId	autobidStrategy.customerId	The customer ID associated with the automated bidding strategy.	metric
autobidStrategy.delFlag	autobidStrategy.delFlag	A flag indicating whether the automated bidding strategy has been marked for deletion.	dimension
autobidStrategy.delTm	autobidStrategy.delTm	The timestamp indicating when the automated bidding strategy was deleted.	dimension
autobidStrategy.editTm	autobidStrategy.editTm	The timestamp indicating when the automated bidding strategy was last edited.	dimension
autobidStrategy.isAutobidActive	autobidStrategy.isAutobidActive	A boolean flag indicating if the automated bidding strategy is currently active.	dimension
autobidStrategy.regTm	autobidStrategy.regTm	The timestamp indicating when the automated bidding strategy was registered.	dimension
bidAmt	bidAmt	The bid amount set for a keyword or ad.	metric
campaignTp	campaignTp	The type or category of the campaign.	dimension
contentsNetworkBidAmt	contentsNetworkBidAmt	The bid amount specifically for content networks.	metric
customerId	customerId	The unique identifier for the customer or advertiser account.	metric
dailyBudget	dailyBudget	The maximum amount allocated to be spent daily for a campaign or ad group.	metric
delFlag	delFlag	A flag indicating whether an entity has been marked for deletion.	dimension
editTm	editTm	The timestamp indicating when the entity was last edited or modified.	dimension
enable	enable	A boolean flag indicating if an entity (e.g., campaign, ad group) is enabled or active.	dimension
expectedClickScore	expectedClickScore	A predictive score indicating the likelihood of clicks on an ad.	metric
id	id	A generic unique identifier for various entities within the API.	dimension
inspectStatus	inspectStatus	The current inspection status of an ad or creative (e.g., pending, approved, disapproved).	dimension
keyword	keyword	The specific keyword text targeted by an ad.	dimension
links.mobile.final	links.mobile.final	The final landing page URL for mobile devices, part of the ad’s link settings.	dimension
links.pc.final	links.pc.final	The final landing page URL for PC devices, part of the ad’s link settings.	dimension
mobileChannelId	mobileChannelId	The unique identifier for the mobile advertising channel.	dimension
name	name	The name of the entity (e.g., campaign name, ad group name, product group name).	dimension
nccAdId	nccAdId	The unique identifier for an individual advertisement, fetched from the /ncc/ads endpoint.	dimension
nccAdgroupId	nccAdgroupId	The unique identifier for an ad group, fetched from the /ncc/adgroups endpoint.	dimension
nccCampaignId	nccCampaignId	The unique identifier for an ad campaign, fetched from the /ncc/campaigns endpoint.	dimension
pcChannelId	pcChannelId	The unique identifier for the PC advertising channel.	dimension
periodEndDt	periodEndDt	The end date of the specified reporting or campaign period.	dimension
periodStartDt	periodStartDt	The start date of the specified reporting or campaign period.	dimension
productGroup.brandName	productGroup.brandName	The brand name of the products within the product group.	dimension
productGroup.customerId	productGroup.customerId	The customer ID associated with the product group.	metric
productGroup.editTm	productGroup.editTm	The timestamp indicating when the product group was last edited.	dimension
productGroup.mallId	productGroup.mallId	The unique identifier of the online mall associated with the product group.	dimension
productGroup.mallName	productGroup.mallName	The name of the online mall associated with the product group.	dimension
productGroup.name	productGroup.name	The name of the product group.	dimension
productGroup.nccBusinessChannelId	productGroup.nccBusinessChannelId	The unique identifier of the Naver Commerce Center (NCC) business channel for the product group.	dimension
productGroup.nccProductGroupId	productGroup.nccProductGroupId	The unique identifier for the product group within Naver Commerce Center.	dimension
productGroup.numberOfAdgroups	productGroup.numberOfAdgroups	The total number of ad groups linked to this product group.	metric
productGroup.regTm	productGroup.regTm	The timestamp indicating when the product group was registered.	dimension
productGroup.registeredProductType	productGroup.registeredProductType	The type of product registered within the product group.	dimension
productGroup.registrationMethod	productGroup.registrationMethod	The method used to register products in the product group.	dimension
referenceData.APPLY_TM	referenceData.APPLY_TM	Reference data field for the timestamp when data was applied.	metric
referenceData.DEL_FLAG	referenceData.DEL_FLAG	Reference data field indicating a deletion flag.	metric
referenceData.DEL_TM	referenceData.DEL_TM	Reference data field for the timestamp when data was deleted.	metric
referenceData.adCustomerId	referenceData.adCustomerId	Reference data field for the customer ID associated with an ad.	metric
referenceData.brand	referenceData.brand	Reference data field for the brand name of a product.	dimension
referenceData.catId	referenceData.catId	Reference data field for the category identifier of a product.	metric
referenceData.category1Id	referenceData.category1Id	Reference data field for the ID of the first-level category.	metric
referenceData.category1Name	referenceData.category1Name	Reference data field for the name of the first-level category.	dimension
referenceData.category2Id	referenceData.category2Id	Reference data field for the ID of the second-level category.	metric
referenceData.category2Name	referenceData.category2Name	Reference data field for the name of the second-level category.	dimension
referenceData.category3Id	referenceData.category3Id	Reference data field for the ID of the third-level category.	metric
referenceData.category3Name	referenceData.category3Name	Reference data field for the name of the third-level category.	dimension
referenceData.category4Id	referenceData.category4Id	Reference data field for the ID of the fourth-level category.	metric
referenceData.category4Name	referenceData.category4Name	Reference data field for the name of the fourth-level category.	dimension
referenceData.id	referenceData.id	Reference data field for a generic unique identifier.	metric
referenceData.imageUrl	referenceData.imageUrl	Reference data field for the URL of an image.	dimension
referenceData.imgStatusCd	referenceData.imgStatusCd	Reference data field for the status code of an image.	dimension
referenceData.lowPrice	referenceData.lowPrice	Reference data field for the lowest price of a product.	metric
referenceData.maker	referenceData.maker	Reference data field for the manufacturer of a product.	dimension
referenceData.mallName	referenceData.mallName	Reference data field for the name of the online mall.	dimension
referenceData.mallProductId	referenceData.mallProductId	The unique identifier for a product listed in a shopping mall, often used for linking product-specific advertisements.	metric
referenceData.mallProductUrl	referenceData.mallProductUrl	The URL for a product page in a shopping mall, providing a direct link to the advertised product’s listing.	dimension
referenceData.mobilePrice	referenceData.mobilePrice	Reference data field for the price of a product on mobile platforms.	metric
referenceData.openDate	referenceData.openDate	Reference data field for the date when a product or service became available.	metric
referenceData.parentId	referenceData.parentId	Reference data field for the identifier of a parent entity.	metric
referenceData.priceUnit	referenceData.priceUnit	Reference data field for the unit of currency or quantity for pricing.	dimension
referenceData.prodStatusCd	referenceData.prodStatusCd	Reference data field for the status code of a product.	dimension
referenceData.prodTypeCd	referenceData.prodTypeCd	Reference data field for the type code of a product.	dimension
referenceData.productName	referenceData.productName	Reference data field for the name of the product.	dimension
referenceData.productTitle	referenceData.productTitle	Reference data field for the title of the product.	dimension
referenceData.purchaseCnt	referenceData.purchaseCnt	Reference data field for the total count of purchases.	metric
referenceData.registrable	referenceData.registrable	Reference data field indicating if a product or item is registrable.	dimension
referenceData.reviewCountSum	referenceData.reviewCountSum	Reference data field for the sum of review counts for a product.	metric
referenceData.scoreInfo	referenceData.scoreInfo	Reference data field for information related to scores or ratings.	metric
regTm	regTm	The timestamp indicating when the entity was registered or created.	dimension
sharedBudgetId	sharedBudgetId	The unique identifier for a shared budget.	dimension
sharedBudgetName	sharedBudgetName	The name assigned to the shared budget.	dimension
sharedDailyBudget	sharedDailyBudget	The daily budget amount allocated for the shared budget.	metric
status	status	The current operational status of an entity (e.g., active, paused).	dimension
statusReason	statusReason	A textual description or code indicating the reason for the current status.	dimension
systemBiddingType	systemBiddingType	The type of automated bidding strategy employed by the system.	dimension
targetSummary.media	targetSummary.media	A summary of the media channels targeted by the campaign.	dimension
targetSummary.pcMobile	targetSummary.pcMobile	A summary of the PC and mobile device targeting settings.	dimension
targetSummary.period	targetSummary.period	A summary of the time period targeting settings.	dimension
targetSummary.time	targetSummary.time	A summary of the time-of-day targeting settings.	dimension
targetSummary.week	targetSummary.week	A summary of the day-of-week targeting settings.	dimension
targets	targets	A collection of targeting settings for a campaign or ad group.	dimension
targets.delFlag	targets.delFlag	A flag indicating whether specific targeting settings have been marked for deletion.	dimension
targets.editTm	targets.editTm	The timestamp indicating when the targeting settings were last edited.	dimension
targets.ownerId	targets.ownerId	The unique identifier of the owner of the targeting settings.	dimension
targets.regTm	targets.regTm	The timestamp indicating when the targeting settings were registered.	dimension
targets.target.contents	targets.target.contents	Specific content-related targeting criteria.	dimension
targets.target.mobile	targets.target.mobile	Specific mobile device targeting criteria.	dimension
targets.target.pc	targets.target.pc	Specific PC device targeting criteria.	dimension
targets.target.search	targets.target.search	Specific search-related targeting criteria.	dimension
targets.target.type	targets.target.type	The type of target specified in the targeting settings.	metric
targets.targetTp	targets.targetTp	The type of targeting criteria applied to the advertising entity (e.g., ad or ad group).	dimension
totalChargeCost	totalChargeCost	The total cost incurred or charged for advertising activities.	metric
trackingUrl	trackingUrl	The URL used to track clicks and other interactions with the ad.	dimension
type	type	The general type or category of an entity.	dimension
useCntsNetworkBidAmt	useCntsNetworkBidAmt	Indicates whether the bid amount specific to the Content Network should be utilized.	dimension
useDailyBudget	useDailyBudget	A flag indicating if a daily budget limit is actively being used.	dimension