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 bid amount set for the ad group. |
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 |
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_RATE |
Conv. rate (all) |
The ratio of clicks and 10-second video views that resulted in one or more valuable actions by users, such as a purchase or membership registration. It is calculated by dividing ‘all conversions’ by the sum of clicks and 10-second video views. |
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 |
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_RATE |
Conv. rate |
The ratio of clicks and 10-second video views that resulted in a conversion. It is calculated by dividing ‘conversions’ by the sum of clicks and 10-second video views. This metric does not include view-through conversions. |
metric |
CONV_VALUE |
Conv. value |
The total value of all conversions recorded. |
metric |
COST |
Cost |
The total cost of your ad clicks. |
metric |
COST_PER_ALL_CONV |
Cost/conv. (all) |
The cost per all conversions. This metric is calculated by dividing the total cost by the total number of all conversions. |
metric |
Campaign Name |
Campaign Name |
The name of the campaign. |
dimension |
DAILY_SPENDING_LIMIT |
Daily Spending Limit |
The maximum amount an ad campaign is allowed to spend per day. Ad delivery is controlled to stay within this limit. |
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 |
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 |
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 |
MONTH |
Month |
A dimension for reporting that allows grouping or filtering data by month. |
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_BUDGET_LOST_ABSOLUTE_TOP_IMPRESSION_SHARE |
Search absolute top impression share (budget) |
metric |
|
SEARCH_BUDGET_LOST_TOP_IMPRESSION_SHARE |
Search top impression share (budget) |
The estimated percentage of impression share lost due to a limited budget, specifically for ads that could have appeared in the top position of search results. |
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 |
TRACKING_URL |
Tracking URL |
The URL used to track ad performance. This URL is optional and can be used to redirect users to a tracking service before reaching the final landing page. |
dimension |
YEAR |
Year |
A dimension for reporting that allows grouping or filtering data by year. |
dimension |