Yahoo! Japan Display Ads: Most-used fields#
The table below gives information about most-used fields that you can import from Yahoo! Japan Display 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 |
|---|---|---|---|
10 sec video views |
10 sec video views |
The number of times a video ad was viewed for at least 10 seconds. |
metric |
100% video views |
100% video views |
The number of times a video ad was watched to 100% completion. |
metric |
25% video views |
25% video views |
The number of times a video ad was watched to at least 25% completion. |
metric |
3 sec video views |
3 sec video views |
The number of times a video ad was viewed for at least 3 seconds. |
metric |
50% video views |
50% video views |
The number of times a video ad was watched to at least 50% completion. |
metric |
75% video views |
75% video views |
The number of times a video ad was watched to at least 75% completion. |
metric |
95% video views |
95% video views |
The number of times a video ad was watched to at least 95% completion. |
metric |
Account ID |
Account ID |
A unique identifier for the advertising account. |
metric |
Account Name |
Account Name |
The name of the advertising account. |
dimension |
Ad Group ID |
Ad Group ID |
A unique identifier for the ad group within a campaign. |
metric |
Ad Group Name |
Ad Group Name |
The name of the ad group. |
dimension |
Ad ID |
Ad ID |
A unique identifier for the specific ad creative. |
metric |
Ad Name |
Ad Name |
The name assigned to the ad creative. |
dimension |
Ad type |
Ad type |
The format or style of the ad, such as text, image, or video. |
dimension |
App Name |
App Name |
The name of the application associated with the ad campaign, often available in app-related reports, such as those related to SKAdNetwork items. |
dimension |
App OS |
App OS |
The operating system (e.g., iOS, Android) of the app targeted by the advertisement. This field provides a dimension for reporting and targeting app-based campaigns. |
dimension |
Avg. CPC |
Avg. CPC |
The average cost incurred for each click on an ad. |
metric |
Avg. CPM |
Avg. CPM |
The average cost per mille (thousand impressions) for an ad. |
metric |
Base Account ID |
Base Account ID |
A unique identifier for the base advertising account, often representing the top-level account in a hierarchy. |
metric |
CTR |
CTR |
The Click-Through Rate, calculated as the number of clicks divided by the number of impressions, expressed as a percentage. |
metric |
Campaign ID |
Campaign ID |
A unique identifier for the advertising campaign. |
metric |
Campaign Name |
Campaign Name |
The name of the advertising campaign. |
dimension |
Campaign Type |
Campaign Type |
The type of campaign, such as ‘PRIVATE_MARKET_PLACE’ for specific delivery types, which influences how ads are served and reported. |
dimension |
Campaign delivery settings |
Campaign delivery settings |
Settings that control how a campaign’s ads are delivered, including specific delivery types and associated configurations. |
dimension |
Clicks |
Clicks |
The total number of clicks on an ad. |
metric |
Content keyword |
Content keyword |
A keyword used for targeting ads to specific content on webpages. |
dimension |
Conv. rate |
Conv. rate |
The conversion rate, calculated as the number of conversions divided by the number of clicks or impressions, expressed as a percentage. |
metric |
Conv. rate (all) |
Conv. rate (all) |
The total conversion rate, including all conversions (view-through, cross-device, etc.) divided by clicks or impressions. |
metric |
Conv. value |
Conv. value |
The monetary value associated with conversions. |
metric |
Conv. value (all) |
Conv. value (all) |
The total monetary value associated with all conversions, including view-through and cross-device conversions. |
metric |
Conversions |
Conversions |
The number of times a desired action, such as a purchase or signup, occurred after an ad interaction. |
metric |
Conversions (all) |
Conversions (all) |
The total number of conversions, including view-through and cross-device conversions. |
metric |
Cost |
Cost |
The total cost incurred for advertising activity. |
metric |
Cost/conv. |
Cost/conv. |
The average cost incurred for each conversion. |
metric |
Cost/conv. (all) |
Cost/conv. (all) |
The average cost incurred for each conversion, including all conversions (view-through, cross-device, etc.). |
metric |
Daily |
Daily |
Indicates that data is reported or broken down on a daily basis. |
dimension |
Description 1 |
Description 1 |
The first line of descriptive text for an ad creative. |
dimension |
Description 2 |
Description 2 |
The second line of descriptive text for an ad creative. |
dimension |
Destination URL (campaign banner) |
Destination URL (campaign banner) |
This field is no longer available in the API. It previously represented the landing page URL that users are directed to after clicking on a campaign banner ad. As of November 2022, ads with destination URLs are no longer supported by the API. |
dimension |
Device |
Device |
The type of device on which the ad was displayed (e.g., mobile, desktop, tablet). |
dimension |
Display URL |
Display URL |
The URL displayed in the advertisement, which may differ from the actual landing page URL. |
dimension |
Final URL |
Final URL |
The ultimate landing page URL that users are directed to after clicking an ad. |
dimension |
Impressions |
Impressions |
The total number of times an ad was displayed. |
metric |
Lifetime budget |
Lifetime budget |
The total budget allocated for a campaign or an ad group that runs over its entire duration. |
dimension |
Measured impressions |
Measured impressions |
The number of times an ad was displayed and measured to meet specific impression criteria. |
metric |
Media ID |
Media ID |
A unique identifier for the creative media asset (e.g., image, video) used in an ad. This is managed by services like AdGroupAdService or AssetService. |
metric |
Media Name |
Media Name |
The descriptive name of the creative media asset used in an ad campaign, associated with its Media ID. |
dimension |
Month |
Month |
A reporting dimension indicating the month in which ad performance data occurred. ReportDefinitionService allows specifying date ranges for reports. |
dimension |
OS |
OS |
The operating system of the device on which an ad was displayed. The API includes ‘DEVICE’ as a reportable field, which can specify OS, such as ‘Connected TV’. |
dimension |
Paid video views (CPV) |
Paid video views (CPV) |
The number of times a paid video ad has been viewed, and the associated cost per view (CPV) as a metric for video ad performance. |
metric |
Search Keyword |
Search Keyword |
A keyword that triggered an ad to be displayed in search results. |
dimension |
Search Keyword ID |
Search Keyword ID |
A unique identifier for the search keyword. |
metric |
Title |
Title |
The main headline or title text for an ad creative. |
dimension |
Tracking URL |
Tracking URL |
A URL used to track clicks and other user interactions with an ad, often including parameters for analytics. |
dimension |
Video views |
Video views |
The total number of times a video ad was viewed. |
metric |
Viewable clicks |
Viewable clicks |
The number of clicks recorded on ads that were deemed viewable. |
metric |
Viewable impressions |
Viewable impressions |
The number of times an ad was displayed and met the industry standard for viewability (e.g., 50% of pixels in view for at least 1 second for display ads, 2 seconds for video ads). |
metric |