Yahoo! JAPAN Ads: Most-used fields

The table below gives information about most-used fields that you can import from Yahoo! JAPAN 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
ACCOUNT_ID	Account ID	The unique identifier for the advertiser account.	metric
ACCOUNT_NAME	Account Name	The name of the advertiser account.	dimension
ADGROUP_BID	Ad group bid	The maximum cost-per-click (CPC) or cost-per-thousand impressions (CPM) bid set at the ad group level. Keyword-level bids will override this value if specified.	metric
ADGROUP_ID	Ad group ID	The unique identifier for the ad group.	metric
ADGROUP_NAME	Ad group name	The name of the ad group.	dimension
ADGROUP_TRACKING_ID	Ad group tracking ID	A unique identifier for the ad group used for tracking purposes.	metric
AD_ID	Ad ID	The unique identifier for the ad.	metric
AD_KEYWORD_ID	Keyword ID	The unique identifier for the keyword associated with an ad.	metric
AD_NAME	Ad Name	The name of the ad.	dimension
AD_TYPE	Ad Type	The type of the ad, such as text ad, responsive search ad, etc.	dimension
ALL_CONV	Conversions (all)	The total number of all conversions, including cross-device conversions.	metric
ALL_CONV_VALUE	Conv. value (all)	The total value of all conversions, including cross-device conversions.	metric
AVG_CPC	Avg. CPC	The average cost-per-click (CPC) for your ads.	metric
Ad Group ID	Ad Group ID	The unique identifier for the ad group.	metric
Ad Group Name	Ad Group Name	The name of the ad group.	dimension
All Conv.	All Conv.	The total number of all conversions, including cross-device conversions.	metric
All Conv. Value	All Conv. Value	The total value of all conversions, including cross-device conversions.	metric
BID	Bid (JPY)	The maximum cost-per-click (CPC) or cost-per-thousand impressions (CPM) bid set at the keyword level, expressed in Japanese Yen. This value overrides ad group-level bids.	metric
BUDGET_LOST_IMPRESSION_SHARE	Lost impression share (budget)	The estimated percentage of impressions that your ads didn’t receive due to insufficient budget.	metric
Budget Lost Impression Share	Budget Lost Impression Share	The estimated percentage of impressions that your ads didn’t receive due to insufficient budget.	metric
CAMPAIGN_END_DATE	End Date	The end date of the campaign in YYYYMMDD format.	metric
CAMPAIGN_ID	CampaignID	The unique identifier for the campaign.	metric
CAMPAIGN_NAME	Campaign name	The name of the campaign.	dimension
CAMPAIGN_START_DATE	Start Date	The start date of the campaign in YYYYMMDD format.	metric
CAMPAIGN_TRACKING_ID	Campaign tracking ID	A unique identifier for a specific campaign in Yahoo! JAPAN Ads. This ID is used to track and report on campaign performance.	metric
CAMPAIGN_TYPE	Campaign type	The type of the campaign, such as Standard, Dynamic Ads for Search, etc.	dimension
CLICKS	Clicks	The number of clicks on your ads.	metric
CLICK_RATE	CTR	The click-through rate (CTR), calculated as Clicks / Impressions.	metric
CONVERSIONS	Conversions	The number of conversions recorded for your ads.	metric
CONV_VALUE	Conv. value	The total value of all conversions recorded.	metric
COST	Cost	The total cost of your ad clicks.	metric
CROSS_DEVICE_CONVERSIONS	Cross-device conv.	The number of conversions that originated on one device and were completed on a different device.	metric
Campaign Name	Campaign Name	The name of the campaign.	dimension
DAY	Day	The date for the reported data in YYYYMMDD format.	dimension
DEVICE	Device	The type of device on which the ad was shown (e.g., PC, smartphone, tablet).	dimension
FINAL_URL	Final URL	The landing page URL that users are directed to after clicking an ad.	dimension
FINAL_URL_SMARTPHONE	Smartphone final URL	The final landing page URL for ads displayed on smartphones.	dimension
FIRST_PAGE_BID_ESTIMATE	First page bid estimate		metric
IMPRESSION_SHARE	Impression share	The percentage of impressions that your ads received compared to the total number of impressions your ads were eligible to receive.	metric
IMPS	Impressions	The number of times your ad was shown.	metric
Impression Share	Impression Share	The percentage of impressions that your ads received compared to the total number of impressions your ads were eligible to receive.	metric
KEYWORD	Keyword	The keyword text that triggered your ad.	dimension
KEYWORD_MATCH_TYPE	Match Type	The match type of the keyword (e.g., Broad, Phrase, Exact).	dimension
KEYWORD_TRACKING_ID	Keyword tracking ID	A unique identifier for the keyword used for tracking purposes.	metric
LABELS	Label	Labels are custom tags that users can apply to their advertising campaigns and their components (such as ad groups, ads, and criteria) for organization and filtering. They provide a flexible way to categorize and manage different parts of an advertising account, enabling users to group related items for reporting or bulk operations.	dimension
NETWORK	Show ads on	The network where your ad was shown (e.g., Search Network, Content Network).	dimension
Network	Network	The network where your ad was shown (e.g., Search Network, Content Network).	dimension
QUALITY_INDEX	Quality index	The Quality Index of your keyword, which measures the relevance and quality of your ads, keywords, and landing page.	metric
QUALITY_LOST_IMPRESSION_SHARE	Lost impression share (rank)	The estimated percentage of impressions that your ads didn’t receive due to low Ad Rank (quality score and bid).	metric
Quality Index	Quality Index	The Quality Index of your keyword, which measures the relevance and quality of your ads, keywords, and landing page.	metric
Quality Lost Impression Share	Quality Lost Impression Share	The estimated percentage of impressions that your ads didn’t receive due to low Ad Rank (quality score and bid).	metric
SEARCH_ABSOLUTE_TOP_IMPRESSION_SHARE	Search absolute top impression share	The percentage of times your ad was shown as the very first ad above the organic search results, out of the total eligible impressions for that position.	metric
SEARCH_BUDGET_LOST_ABSOLUTE_TOP_IMPRESSION_SHARE	Search absolute top impression share (budget)	The estimated percentage of times your ad was not shown as the very first ad above organic search results due to an insufficient budget.	metric
SEARCH_BUDGET_LOST_TOP_IMPRESSION_SHARE	Search top impression share (budget)	The estimated percentage of times your ad was not shown in any of the top positions above organic search results due to an insufficient budget.	metric
SEARCH_TOP_IMPRESSION_SHARE	Search top impression share	The percentage of your ad impressions that were shown anywhere above the organic search results.	metric
SYSTEM_SERVING_STATUS	Keyword status	The current serving status of the keyword, indicating whether it is active, paused, or has other system-determined states.	dimension
TOP_IMPRESSION_PERCENTAGE	Search top impression rate	The percentage of times your ad was shown in a top position (anywhere above the organic search results).	metric
TOP_OF_PAGE_BID_ESTIMATE	Top of page bid estimate		metric
TRACKING_URL	Tracking URL	The URL used for tracking clicks and other interactions, often including parameters for analytics and redirects before the final landing page.	dimension