Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Line Ads: Most-used fields

The table below gives information about most-used fields that you can import from Line 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.

FieldAdverity UI nameType
ad.adaccountIdDimension

The ID of the ad account to which the ad belongs.

ad.adgroupIdMetric

The ID of the ad group to which the ad belongs.

ad.configuredStatusDimension

The configured status of the ad.

ad.createdDateDimension

The date when the ad was created in ISO 8601 format and in the ad account's timezone.

ad.deliveryStatusDimension

The delivery status of the ad, indicating its current serving state.

ad.idMetric

The unique ID of the ad.

ad.modifiedDateDimension

The last modified date of the ad in ISO 8601 format and in the ad account's timezone.

ad.nameDimension

The name of the ad.

adaccount.configuredStatusDimension

The configured status of the ad account.

adaccount.createdDateDimension

The date when the ad account was created in ISO 8601 format.

adaccount.currencyDimension

The currency used for the ad account, e.g., JPY.

adaccount.deliveryStatusDimension

The delivery status of the ad account.

adaccount.idDimension

The unique ID of the ad account.

adaccount.modifiedDateDimension

The last modified date of the ad account in ISO 8601 format and in the ad account's timezone.

adaccount.nameDimension

The name of the ad account.

adaccount.timezoneDimension

The timezone configured for the ad account.

adgroup.bidAmountMicroMetric

The bid amount for the ad group in micros and in the ad account's currency. This field is used as bid amount, max CPC, max CPA, etc. depending on the bid type.

adgroup.bidStrategyDimension

Bidding strategy for the ad group. For example, AUTO_BID, MANUAL_CPC, MAX_IMPRESSIONS.

adgroup.bidTypeDimension

The type of bidding strategy used for the ad group.

adgroup.campaignIdMetric

The ID of the campaign to which the ad group belongs.

adgroup.configuredStatusDimension

The configured status of the ad group, e.g., ACTIVE.

adgroup.createdDateDimension

The date when the ad group was created in ISO 8601 format and in the ad account's timezone.

adgroup.dailyBudgetMicroMetric

The daily budget for the ad group, specified in micros of the ad account's currency.

adgroup.deliveryStatusDimension

The delivery status of the ad group, indicating its current serving state, e.g., PAUSED.

adgroup.idMetric

The unique ID of the ad group.

adgroup.modifiedDateDimension

The last modified date of the ad group in ISO 8601 format and in the ad account's timezone.

adgroup.nameDimension

The name of the ad group.

adgroup.rnfFrequencyMetric

Frequency capping for the ad group. Specifies how many times a user sees an ad within a certain period.

campaign.activeCboDimension

Indicates whether Campaign Budget Optimization (CBO) is active for the campaign.

campaign.campaignObjectiveDimension

The objective of the campaign, such as WEBSITE_CONVERSION or VISIT_MY_WEBSITE.

campaign.configuredStatusDimension

The configured status of the campaign, e.g., PAUSED.

campaign.createdDateDimension

The date when the campaign was created in ISO 8601 format and in the ad account's timezone.

campaign.dailyBudgetMicroMetric

The daily budget allocated for the campaign, typically expressed in micro-units of the currency.

campaign.deliveryStatusDimension

The delivery status of the campaign, indicating its current serving state, e.g., PAUSED.

campaign.endDateDimension

The date when the campaign is scheduled to stop delivering ads in ISO 8601 format and in the ad account's timezone. A value of '1970-01-01T00:00:00Z' indicates the campaign runs indefinitely.

campaign.idDimension

The unique ID of the campaign.

campaign.modifiedDateDimension

The last modified date of the campaign in ISO 8601 format and in the ad account's timezone.

campaign.nameDimension

The name of the campaign.

campaign.spendingLimitMicroMetric

The spending limit of the campaign in micros and in the ad account's currency. Campaigns that reach their spending limit are paused automatically.

campaign.spendingLimitTypeDimension

The type of spending limit applied to the campaign, e.g., MONTHLY.

campaign.startDateDimension

The date when the campaign is scheduled to start delivering ads in ISO 8601 format and in the ad account's timezone.

statistics.addToCartMetric

The number of add-to-cart events.

statistics.addToCartCpaMetric

The Cost Per Action (CPA) for add-to-cart events.

statistics.addToCartCpaWithEvMetric

The Cost Per Action (CPA) for all add-to-cart conversions, including engagement view conversions.

statistics.addToCartCvrMetric

The Conversion Rate (CVR) for add-to-cart events.

statistics.addToCartCvrWithEvMetric

The Conversion Rate (CVR) for all add-to-cart conversions, including engagement view conversions.

statistics.addToCartWithEvMetric

The number of all add-to-cart events, including engagement view conversions.

statistics.clickMetric

The number of clicks on the ad.

statistics.costMetric

The total cost incurred by the ad.

statistics.costPerVideoCompletionMetric

The cost per complete video view (100% watched).

statistics.costPerVideoView3sMetric

The cost per 3-second video view.

statistics.cpaMetric

The Cost Per Acquisition (CPA).

statistics.cpaAddToCartMetric

The Cost Per Action (CPA) for add-to-cart conversions.

statistics.cpaAddToCartWithEvMetric

The Cost Per Action (CPA) for add-to-cart conversions including engagement view.

statistics.cpaCompleteRegistrationMetric

The Cost Per Action (CPA) for complete registration conversions.

statistics.cpaCompleteRegistrationWithEvMetric

The Cost Per Action (CPA) for complete registration conversions including engagement view.

statistics.cpaCompleteReservationMetric

The Cost Per Action (CPA) for complete reservation conversions.

statistics.cpaCompleteReservationWithEvMetric

The Cost Per Action (CPA) for complete reservation conversions including engagement view.

statistics.cpaGenerateLeadMetric

The Cost Per Action (CPA) for generate lead conversions.

statistics.cpaGenerateLeadWithEvMetric

The Cost Per Action (CPA) for generate lead conversions including engagement view.

statistics.cpaInitiateCheckOutMetric

The Cost Per Action (CPA) for initiate checkout conversions.

statistics.cpaInitiateCheckOutWithEvMetric

The Cost Per Action (CPA) for initiate checkout conversions including engagement view.

statistics.cpaPurchaseMetric

The Cost Per Action (CPA) for purchase conversions.

statistics.cpaPurchaseWithEvMetric

The Cost Per Action (CPA) for purchase conversions including engagement view.

statistics.cpaViewItemDetailMetric

The Cost Per Action (CPA) for view item detail conversions.

statistics.cpaViewItemDetailWithEvMetric

The Cost Per Action (CPA) for view item detail conversions including engagement view.

statistics.cpcMetric

The Cost Per Click (CPC).

statistics.cpmMetric

The Cost Per Mille (CPM), or cost per thousand impressions.

statistics.ctrMetric

The Click-Through Rate (CTR).

statistics.currencyDimension

The currency of the reported statistics, e.g., JPY.

statistics.cvMetric

The total number of conversions.

statistics.cvAddToCartMetric

The number of add-to-cart conversions.

statistics.cvAddToCartWithEvMetric

The number of all add-to-cart events, including engagement view conversions.

statistics.cvApiMetric

The number of API conversions.

statistics.cvCompleteRegistrationMetric

The number of complete registration conversions.

statistics.cvCompleteRegistrationWithEvMetric

The number of all complete registration events, including engagement view conversions.

statistics.cvCompleteReservationMetric

The number of complete reservation conversions.

statistics.cvCompleteReservationWithEvMetric

The number of all complete reservation events, including engagement view conversions.

statistics.cvGenerateLeadMetric

The number of generate lead conversions.

statistics.cvGenerateLeadWithEvMetric

The number of all generate lead events, including engagement view conversions.

statistics.cvInitiateCheckOutMetric

The number of initiate checkout conversions.

statistics.cvInitiateCheckOutWithEvMetric

The number of all initiate checkout events, including engagement view conversions.

statistics.cvPurchaseMetric

The number of purchase conversions.

statistics.cvPurchaseValueMetric

The value of purchase conversions (clicks).

statistics.cvPurchaseValueWithEvMetric

The total purchase value attributed to conversions, including estimated value or event data.

statistics.cvPurchaseWithEvMetric

The number of all purchase events, including engagement view conversions.

statistics.cvViewItemDetailMetric

The number of view item detail conversions.

statistics.cvViewItemDetailWithEvMetric

The number of all view item detail events, including engagement view conversions.

statistics.cvWithCvApiMetric

The total number of conversions including those tracked via Conversion API.

statistics.cvWithCvApiCpaMetric

The Cost Per Action (CPA) for conversions including those tracked via Conversion API.

statistics.cvWithCvApiCpaWithEvMetric

The Cost Per Action (CPA) for all conversions, including engagement view and Conversion API.

statistics.cvWithCvApiCvrMetric

The Conversion Rate (CVR) for conversions including those tracked via Conversion API.

statistics.cvWithCvApiCvrWithEvMetric

The Conversion Rate (CVR) for all conversions, including engagement view and Conversion API.

statistics.cvWithCvApiWithEvMetric

The total number of conversions, including engagement view and Conversion API.

statistics.cvrMetric

The Conversion Rate (CVR).

statistics.cvrAddToCartMetric

The Conversion Rate (CVR) for add-to-cart events.

statistics.cvrAddToCartWithEvMetric

The Conversion Rate (CVR) for add-to-cart conversions including engagement view.

statistics.cvrCompleteRegistrationMetric

The Conversion Rate (CVR) for complete registration events.

statistics.cvrCompleteRegistrationWithEvMetric

The Conversion Rate (CVR) for complete registration conversions including engagement view.

statistics.cvrCompleteReservationMetric

The Conversion Rate (CVR) for complete reservation events.

statistics.cvrCompleteReservationWithEvMetric

The Conversion Rate (CVR) for complete reservation conversions including engagement view.

statistics.cvrGenerateLeadMetric

The Conversion Rate (CVR) for generate lead events.

statistics.cvrGenerateLeadWithEvMetric

The Conversion Rate (CVR) for generate lead conversions including engagement view.

statistics.cvrInitiateCheckOutMetric

The Conversion Rate (CVR) for initiate checkout events.

statistics.cvrInitiateCheckOutWithEvMetric

The Conversion Rate (CVR) for initiate checkout conversions including engagement view.

statistics.cvrPurchaseMetric

The Conversion Rate (CVR) for purchase events.

statistics.cvrPurchaseWithEvMetric

The Conversion Rate (CVR) for purchase conversions including engagement view.

statistics.cvrViewItemDetailMetric

The Conversion Rate (CVR) for view item detail events.

statistics.cvrViewItemDetailWithEvMetric

The Conversion Rate (CVR) for view item detail conversions including engagement view.

statistics.impMetric

The total number of impressions.

statistics.impShareRateMetric

The percentage of impressions your ads received compared to the total number of impressions your ads were eligible to receive.

statistics.installMetric

The number of app install events (click-through conversion).

statistics.installCpaMetric

The Cost Per Action (CPA) for app install (click) conversions.

statistics.installCpaWithEvMetric

The Cost Per Action (CPA) for all app installs (clicks + views + engagement view conversions) (JP only).

statistics.installCvrMetric

The Conversion Rate (CVR) for app install (click) conversions.

statistics.installCvrWithEvMetric

The Conversion Rate (CVR) for all app installs (clicks + views + engagement view conversions) (JP only).

statistics.levelAchievedMetric

The number of level achieved events.

statistics.levelAchievedCpaMetric

The Cost Per Action (CPA) for level achieved conversions.

statistics.levelAchievedCpaWithEvMetric

The Cost Per Action (CPA) for all level achieved conversions, including engagement view.

statistics.levelAchievedCvrMetric

The Conversion Rate (CVR) for level achieved events.

statistics.levelAchievedCvrWithEvMetric

The Conversion Rate (CVR) for all level achieved conversions, including engagement view.

statistics.levelAchievedWithEvMetric

The number of all level achieved events, including engagement view conversions.

statistics.lostImpShareByBudgetRateMetric

The percentage of times your ad didn't show due to an insufficient budget.

statistics.lostImpShareByRankRateMetric

The percentage of times your ad didn't show due to a low Ad Rank.

statistics.openMetric

The number of app open events.

statistics.openCpaMetric

The Cost Per Action (CPA) for app open conversions.

statistics.openCpaWithEvMetric

The Cost Per Action (CPA) for all app open conversions, including engagement view.

statistics.openCvrMetric

The Conversion Rate (CVR) for app open events.

statistics.openCvrWithEvMetric

The Conversion Rate (CVR) for all app open conversions, including engagement view.

statistics.openWithEvMetric

The number of all app open events, including engagement view conversions.

statistics.purchaseMetric

The number of purchase conversions.

statistics.purchaseCpaMetric

The Cost Per Action (CPA) for purchase conversions.

statistics.purchaseCpaWithEvMetric

The Cost Per Action (CPA) for all purchase conversions, including engagement view.

statistics.purchaseCvrMetric

The Conversion Rate (CVR) for purchase events.

statistics.purchaseCvrWithEvMetric

The Conversion Rate (CVR) for all purchase conversions, including engagement view.

statistics.purchaseWithEvMetric

The number of all purchase events, including engagement view conversions.

statistics.reachMetric

The estimated number of unique people who have seen ads. This field is present only when report delivery type is null.

statistics.roasMetric

Return On Ad Spend (ROAS) for purchase events.

statistics.roasWithEvMetric

The Return on Ad Spend (ROAS), which indicates the revenue generated for every unit of currency spent on advertising, including estimated value or event data.

statistics.searchMetric

The number of search events.

statistics.searchCpaMetric

The Cost Per Action (CPA) for search conversions.

statistics.searchCpaWithEvMetric

The Cost Per Action (CPA) for all search conversions, including engagement view.

statistics.searchCvrMetric

The Conversion Rate (CVR) for search events.

statistics.searchCvrWithEvMetric

The Conversion Rate (CVR) for all search conversions, including engagement view.

statistics.searchWithEvMetric

The number of all search events, including engagement view conversions.

statistics.skadnInstallMetric

The number of installs measured by SKAdNetwork.

statistics.skadnInstallCpaMetric

The Cost Per Action (CPA) for installs measured by SKAdNetwork.

statistics.skadnInstallCvrMetric

The Conversion Rate (CVR) for installs measured by SKAdNetwork.

statistics.totalInstallMetric

The total number of app installs (clicks + views) (JP only).

statistics.totalInstallCpaMetric

The Cost Per Action (CPA) for total app installs (clicks + views) (JP only).

statistics.totalInstallCpaWithEvMetric

The Cost Per Action (CPA) for total app installs (clicks + views + engagement view conversions) (JP only).

statistics.totalInstallCvrWithEvMetric

The Conversion Rate (CVR) for total app installs (clicks + views + engagement view conversions) (JP only).

statistics.totalInstallWithEvMetric

The total number of app installs (clicks + views + engagement view conversions) (JP only).

statistics.tutorialCompleteMetric

The number of tutorial completion events.

statistics.tutorialCompleteCpaMetric

The Cost Per Action (CPA) for tutorial completion conversions.

statistics.tutorialCompleteCpaWithEvMetric

The Cost Per Action (CPA) for all tutorial completion conversions, including engagement view.

statistics.tutorialCompleteCvrMetric

The Conversion Rate (CVR) for tutorial completion events.

statistics.tutorialCompleteCvrWithEvMetric

The Conversion Rate (CVR) for all tutorial completion conversions, including engagement view.

statistics.tutorialCompleteWithEvMetric

The number of all tutorial completion events, including engagement view conversions.

statistics.videoCompletionsMetric

The number of times a video was watched to 100% completion.

statistics.videoStartMetric

The number of video play start events.

statistics.videoView25rMetric

The number of times a video was watched to 25% completion (JP only).

statistics.videoView3sMetric

The number of times a video was watched for at least 3 seconds (JP only).

statistics.videoView50rMetric

The number of times a video was watched to 50% completion (JP only).

statistics.videoView75rMetric

The number of times a video was watched to 75% completion (JP only).

statistics.videoView95rMetric

The number of times a video was watched to 95% completion (JP only).

statistics.viewCategoryMetric

The number of view category events.

statistics.viewCategoryCpaMetric

The Cost Per Action (CPA) for view category conversions.

statistics.viewCategoryCpaWithEvMetric

The Cost Per Action (CPA) for all view category conversions, including engagement view.

statistics.viewCategoryCvrMetric

The Conversion Rate (CVR) for view category events.

statistics.viewCategoryCvrWithEvMetric

The Conversion Rate (CVR) for all view category conversions, including engagement view.

statistics.viewCategoryWithEvMetric

The number of all view category events, including engagement view conversions.

statistics.viewHomeMetric

The number of view home events.

statistics.viewHomeCpaMetric

The Cost Per Action (CPA) for view home conversions.

statistics.viewHomeCpaWithEvMetric

The Cost Per Action (CPA) for all view home conversions, including engagement view.

statistics.viewHomeCvrMetric

The Conversion Rate (CVR) for view home events.

statistics.viewHomeCvrWithEvMetric

The Conversion Rate (CVR) for all view home conversions, including engagement view.

statistics.viewHomeWithEvMetric

The number of all view home events, including engagement view conversions.

statistics.viewItemMetric

The number of view item events.

statistics.viewItemCpaMetric

The Cost Per Action (CPA) for view item conversions.

statistics.viewItemCpaWithEvMetric

The Cost Per Action (CPA) for all view item conversions, including engagement view.

statistics.viewItemCvrMetric

The Conversion Rate (CVR) for view item events.

statistics.viewItemCvrWithEvMetric

The conversion rate for users who viewed a specific item, including estimated value or event data.

statistics.viewItemWithEvMetric

The total number of times an item was viewed, including estimated value or event data associated with the view.

statistics.viewableImpMetric

The number of viewable impressions.

statistics.vtInstallMetric

The number of install events (view-through conversion) (JP only).

untilDimension

The end date for the report data collection. Data will be collected up to and including this date. The format for specifying the date is YYYY-MM-DD.