impact.com: Most-used fields

impact.com: Most-used fields#

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

AOV

AOV

Average Order Value, representing the average amount of money spent per customer order.

dimension

ATId

ATId

An identifier for an Advertiser Tracking event or similar entity.

metric

AT_Id

AT_Id

An identifier for an Advertiser Tracking event or similar entity.

dimension

AVGImpressionDuration

AVGImpressionDuration

dimension

ActionCost

ActionCost

The cost associated with a specific action, such as a click, lead, or conversion event recorded within the impact.com platform.

dimension

ActionDate

ActionDate

The date when a specific action (e.g., sale, lead, registration) occurred.

dimension

ActionId

ActionId

A unique identifier for a recorded action.

dimension

ActionTracker

ActionTracker

A mechanism or system within the impact.com platform responsible for tracking and attributing user actions, such as conversions.

dimension

Action_Date

Action_Date

The date and time when a specific action or conversion event occurred.

dimension

Action_Id

Action_Id

A unique identifier assigned to a specific action or conversion event recorded by the platform.

dimension

Action_Tracker

Action_Tracker

A mechanism or system within the impact.com platform responsible for tracking and attributing user actions, such as conversions.

dimension

Actions

Actions

The total number of tracked actions or conversions initiated by partners.

metric

ActionsConfirmed

ActionsConfirmed

The total number of actions that have been confirmed or approved.

dimension

ActionsCost

ActionsCost

The total cost associated with all recorded actions.

metric

ActionsOpen

ActionsOpen

The total number of actions that are pending confirmation or review.

dimension

Activity

Activity

A general term for user interactions or events, potentially encompassing actions like clicks, engagements, or conversions.

dimension

Ad

Ad

The name or identifier of the specific advertisement that led to an action.

dimension

AdId

AdId

A unique identifier for an advertisement.

dimension

AdType

AdType

The type or format of the advertisement (e.g., banner, text, video).

dimension

Amount

Amount

A monetary value associated with a transaction or event.

metric

BatchDate

BatchDate

The date on which a batch process, such as a batch modification or reversal of conversion events, was initiated or completed.

dimension

Business

Business

Refers to the business or brand associated with the report data.

dimension

CPA

CPA

Cost Per Action, representing the cost incurred for each completed action.

dimension

CPC

CPC

Cost Per Click, the average cost for each click received.

metric

CPCCost

CPCCost

The total cost incurred from clicks.

metric

CR

CR

Conversion Rate, the percentage of users who complete a desired action.

dimension

CTR

CTR

Click-Through Rate, the ratio of users who click on a specific link to the total number of users who view a page, email, or advertisement.

dimension

CallCost

CallCost

The cost associated with calls generated through marketing efforts.

dimension

CallRevenue

CallRevenue

The revenue generated from calls attributed to marketing activities.

dimension

Calls

Calls

The total number of tracked calls. Impact.com can track call events.

metric

CatalogCategory

CatalogCategory

The category of a product within a product catalog, used for organizing and describing items.

dimension

CatalogSubcategory

CatalogSubcategory

A more granular subcategory of a product within a product catalog, providing further classification.

dimension

Category

Category

The primary classification or category of a product, service, or campaign.

dimension

CategoryList

CategoryList

A compilation or list of categories associated with products, campaigns, or other entities.

dimension

Category_List

Category_List

A compilation or list of categories associated with products, campaigns, or other entities.

dimension

Channel

Channel

The marketing channel through which an action or referral occurred (e.g., search, social, email, display).

dimension

City

City

The city associated with an event or user.

dimension

ClickCost

ClickCost

The total cost incurred from clicks on advertisements or links.

metric

Clicks

Clicks

The total number of clicks tracked.

metric

ClientCost

ClientCost

The cost incurred by the client (advertiser) for various marketing activities or campaigns.

metric

Client_Cost

Client_Cost

The cost incurred by the client (advertiser) for various marketing activities or campaigns.

dimension

Company_URL

Company_URL

The web address of the company or business.

dimension

Conversion_Country

Conversion_Country

The country where a conversion event took place.

dimension

ConvertedCalls

ConvertedCalls

The number of calls that resulted in a desired conversion.

dimension

Cost

Cost

The total monetary cost associated with a particular item or action.

metric

Country

Country

The country associated with an event or user.

dimension

CurrentAccountBalance

CurrentAccountBalance

The current monetary balance of an account within the impact.com platform.

metric

Customer_Id

Customer_Id

A unique identifier for a customer.

dimension

Customer_Status

Customer_Status

The status of a customer, such as new or returning, often used in reports like ‘New vs. Return Customer Report’.

dimension

Date

Date

The generic date of an event or record.

dimension

Description

Description

A textual description for an entity such as a campaign, offer, or partner account.

dimension

Device

Device

The type of device used by a customer during an interaction (e.g., desktop, mobile, tablet).

dimension

Discount

Discount

The total discount amount applied to transactions.

dimension

DiscountRate

DiscountRate

The percentage or rate of discount applied to an order or product.

dimension

Discount_Rate

Discount_Rate

The percentage or rate of discount applied to an order or product.

dimension

DownloadCost

DownloadCost

The cost associated with each download.

dimension

Downloads

Downloads

The total number of times content, applications, or other digital assets have been downloaded.

metric

Forwardbalance

Forwardbalance

The anticipated account balance considering future transactions or scheduled payouts.

metric

GeoLocation

GeoLocation

Geographical location data associated with an event or user.

dimension

Geo_Location

Geo_Location

Geographical location data associated with an event or user.

dimension

GoodsCost

GoodsCost

The total cost of products in the basket captured at conversion.

dimension

Grossactioncost

Grossactioncost

The total cost of actions before any deductions or adjustments.

dimension

Grossactions

Grossactions

The total number of actions recorded before any reversals or cancellations.

dimension

Grossrevenue

Grossrevenue

The total revenue generated before any deductions for costs or returns.

dimension

IO

IO

Refers to an Insertion Order, a formal agreement for advertising placements.

dimension

IO_ID

IO_ID

The unique identifier for an Insertion Order, a document that outlines the details of an advertising campaign.

dimension

ImportedCost

ImportedCost

The Cost of Actions imported from third-party tracking systems.

dimension

Importedclicks

Importedclicks

The total number of clicks tracked that were imported from third-party systems.

dimension

Importedimpressions

Importedimpressions

The total number of times an ad was displayed that were imported from third-party systems.

dimension

Impressions

Impressions

The total number of times an advertisement or content was displayed.

metric

InstallCost

InstallCost

The cost associated with each application installation.

dimension

Installs

Installs

The total number of application installations.

metric

Ipaddr

Ipaddr

The IP address of the user involved in an event.

dimension

LeadCPA

LeadCPA

Cost Per Action for leads, representing the cost incurred for each generated lead.

dimension

LeadCR

LeadCR

Conversion Rate for leads, the percentage of users who become leads.

dimension

LeadCost

LeadCost

The total cost associated with generating leads.

dimension

LeadRR

LeadRR

The return rate associated with leads, indicating the percentage of leads that convert or result in a desired outcome.

dimension

Leads

Leads

The total number of generated leads.

metric

MPId

MPId

Media Partner ID, a unique identifier for a media partner.

metric

Manufacturer

Manufacturer

The manufacturer of a product listed in a product catalog.

dimension

Margin

Margin

The financial margin, calculated as Revenue minus Goods Cost.

dimension

Media

Media

Refers to the type of media or content used in a campaign, such as social media posts or advertisements.

dimension

MediaPartner

MediaPartner

The name of the media partner.

dimension

Media_Partner

Media_Partner

The name of the media partner or affiliate responsible for driving traffic or conversions.

dimension

Mediatype

Mediatype

The type of partner, if identified, indicating their primary method of promotion or content creation.

dimension

MobileInstallRevenue

MobileInstallRevenue

The revenue generated from mobile application installations.

dimension

Month

Month

The month in which a particular event or data point occurred.

dimension

Mp

Mp

Identifier or abbreviation for a Media Partner, a key entity in the impact.com platform.

dimension

Mps

Mps

Refers to Media Partners, which are publishers, influencers, or other entities promoting advertiser offers.

dimension

Network

Network

The advertising or partnership network involved.

metric

Notes

Notes

A free-form text field for additional information or comments.

dimension

OID

OID

A unique identifier for an order, used in reports such as the ‘OrderId Lookup Report’.

dimension

OS

OS

The operating system of the device used by a customer (e.g., iOS, Android, Windows).

dimension

Opens

Opens

The number of times an application or email has been opened.

dimension

Orders

Orders

The number of orders placed by customers, often tracked for conversion and revenue attribution.

metric

OriginalRevenue

OriginalRevenue

The revenue amount before any adjustments or currency conversions.

dimension

Original_Currency

Original_Currency

The currency in which the original transaction or payout amount was recorded.

dimension

Original_Payout

Original_Payout

The initial amount that was designated for payment to a partner before any modifications or reversals.

dimension

OtherCost

OtherCost

Any additional costs associated with an action, conversion, or transaction that are not categorized as the primary action cost.

metric

OtherMobileActions

OtherMobileActions

A count or record of mobile-specific actions, other than primary conversion events, tracked by the platform.

dimension

OtherMobileCost

OtherMobileCost

Additional costs associated with mobile-specific activities, such as performance bonuses, make-good payments, and placement fees on mobile platforms.

dimension

OtherMobileRevenue

OtherMobileRevenue

Revenue generated from mobile activities not categorized elsewhere.

dimension

Partner

Partner

The name or identifier of the partner (e.g., affiliate, influencer).

dimension

PastDuePayout

PastDuePayout

The amount of payout that is overdue to a media partner or affiliate.

dimension

Payout

Payout

The amount paid out to a partner for a conversion or action.

metric

PerfAOV

PerfAOV

The Average Order Value (AOV) for performance-based marketing activities, indicating the average monetary value of orders generated.

dimension

PerfCPA

PerfCPA

Performance Cost Per Action, representing the cost incurred for each completed action (e.g., sale, lead, click) attributable to a partnership.

dimension

PerfROAS

PerfROAS

Performance Return On Ad Spend, indicating the revenue generated for every dollar spent on advertising or partnership activities.

metric

PerfRevenue

PerfRevenue

The total revenue generated as a result of performance-based marketing or partnership efforts.

metric

Perfactions

Perfactions

The total number of performance-based actions.

metric

Perfcr

Perfcr

Performance Conversion Rate, the percentage of users who complete a desired performance-based action.

dimension

Perfroi

Perfroi

Performance Return On Investment, a metric to evaluate the efficiency of performance-based marketing investments.

dimension

Platform

Platform

The platform on which an event occurred (e.g., web, mobile, desktop).

dimension

Postcode

Postcode

The postal code of a location.

dimension

Product

Product

The name or identifier of a product involved in a transaction.

dimension

ProductCategory

ProductCategory

The category of a product.

dimension

PromoCode

PromoCode

A promotional code used during a transaction.

dimension

Promo_Code

Promo_Code

A unique code offered to customers to receive a discount or special offer on an order.

dimension

Propertyid

Propertyid

A unique identifier for a media property.

dimension

Quantity

Quantity

The number of units of a product or item.

metric

ROAS

ROAS

Return On Ad Spend, indicating the revenue generated for every dollar spent on advertising.

dimension

ROI

ROI

Return On Investment, a metric to evaluate the efficiency of an investment.

dimension

RR

RR

A general return rate or response rate metric.

dimension

Rate

Rate

The commission rate or payout rate applied to an action or conversion.

dimension

RawImpressions

RawImpressions

The total number of times an ad or content was displayed, without filtering.

dimension

Rawclicks

Rawclicks

The total number of clicks on an ad or link, without filtering for fraud or duplicates.

dimension

Rebate

Rebate

A partial refund or discount offered.

dimension

RefUrl

RefUrl

The referring URL that directed the user.

dimension

Referral_Date

Referral_Date

The date when a referral event occurred.

dimension

Referral_Traffic_Source

Referral_Traffic_Source

The origin of the traffic that led to a referral, such as a specific website, social media platform, or advertising campaign.

dimension

Referral_Traffic_Type

Referral_Traffic_Type

The category or method by which referral traffic was generated, e.g., organic, paid, direct, social, or email.

dimension

Referral_Type

Referral_Type

The classification of the referral, e.g., affiliate, influencer, business development.

dimension

Referring_URL

Referring_URL

The URL of the page that directed the user to the advertiser’s site.

dimension

Region

Region

The geographical region or state associated with an event or user.

dimension

Revenue

Revenue

The total revenue generated from partnership activities.

metric

ReversedActionCost

ReversedActionCost

The cost associated with actions that have been reversed.

dimension

ReversedActions

ReversedActions

The number of actions that have been reversed or cancelled.

dimension

ReversedLeadCost

ReversedLeadCost

The cost associated with leads that have been reversed.

dimension

ReversedLeads

ReversedLeads

The number of leads that have been reversed or deemed invalid.

dimension

ReversedRevenue

ReversedRevenue

The revenue amount that has been reversed or cancelled.

dimension

ReversedSaleCost

ReversedSaleCost

The cost associated with sales that have been reversed.

dimension

ReversedSales

ReversedSales

The number of sales that have been reversed or cancelled.

dimension

SKU

SKU

Stock Keeping Unit, a unique identifier for a product.

dimension

SaleCPA

SaleCPA

Cost Per Action for sales, representing the cost incurred for each completed sale.

dimension

SaleCR

SaleCR

Conversion Rate for sales, the percentage of users who make a purchase.

dimension

SaleCost

SaleCost

The total cost associated with generating sales.

dimension

SaleRR

SaleRR

The return rate specifically for sales actions.

dimension

SaleRevenue

SaleRevenue

The total revenue generated from sales.

dimension

Sale_Amount

Sale_Amount

The total monetary value of a sale or transaction.

metric

Sales

Sales

The total number of completed sales.

metric

Sends

Sends

dimension

SharedId

SharedId

A unique identifier shared across different entities, often used in reports like ‘Performance by Partner Shared Id Report’.

dimension

Shared_Id

Shared_Id

A unique identifier shared across different entities, often used in reports like ‘Performance by Partner Shared Id Report’.

dimension

State

State

The state or province associated with an event or user.

dimension

Status

Status

The current status of an action, campaign, or entity (e.g., pending, approved, reversed).

dimension

StatusDetail

StatusDetail

Detailed information regarding the status of an entity, such as a campaign, offer, or partner.

dimension

Status_Detail

Status_Detail

Detailed information regarding the status of an entity, such as a campaign, offer, or partner.

dimension

SubId1

SubId1

The first sub-identifier used for granular tracking of marketing activities or conversions, common in affiliate marketing.

dimension

SubId2

SubId2

The second sub-identifier used for granular tracking of marketing activities or conversions.

dimension

SubId3

SubId3

The third sub-identifier used for granular tracking of marketing activities or conversions.

dimension

Subcategory

Subcategory

A more specific classification within a broader category for products, services, or campaigns.

dimension

Tax

Tax

The amount of tax applied to a transaction.

metric

Time

Time

A timestamp or duration related to an event or activity.

dimension

TimesImpressionsViewed

TimesImpressionsViewed

The number of times an impression was viewed, a metric related to ad performance.

dimension

TotalBusinessCost

TotalBusinessCost

The total Cost of Goods plus Total Cost.

dimension

TotalClicks

TotalClicks

The total number of clicks recorded.

dimension

TotalCost

TotalCost

The overall aggregated cost.

metric

TotalPendingPayout

TotalPendingPayout

The sum of all payouts that have been approved but not yet cleared or paid to partners.

metric

Txn_Id

Txn_Id

A unique identifier for a transaction.

dimension

Txn_Type

Txn_Type

The classification of a transaction (e.g., sale, return, adjustment).

dimension

Type

Type

A categorization of an entity or activity.

dimension

User_Agent

User_Agent

The string sent by a user’s browser or application, containing information about the operating system and browser.

dimension

VAT

VAT

Value Added Tax, a consumption tax applied to goods and services.

metric

Version

Version

The version identifier of an API, report, or other system component. The implementation specifies IrVersion=11.

dimension

ViewableImpressions

ViewableImpressions

The number of ad impressions that were actually visible to users.

metric

action_batch_date

action_batch_date

The date when a batch of actions was processed or recorded.

dimension

actual_clearing_date

actual_clearing_date

The actual date when a payment or transaction was cleared.

dimension

ad_campaign

ad_campaign

The name or identifier of the advertising campaign.

dimension

ad_campaign_group

ad_campaign_group

The group to which an advertisement campaign belongs.

dimension

ad_end_date

ad_end_date

The date when an advertisement campaign concluded.

dimension

ad_group

ad_group

The name or identifier of the ad group within an advertising campaign.

dimension

ad_id

ad_id

A unique identifier for an advertisement.

dimension

ad_name

ad_name

The descriptive name of the advertisement.

dimension

ad_start_date

ad_start_date

The date when an advertisement campaign began.

dimension

ad_type

ad_type

The type or format of the advertisement (e.g., banner, text, video).

dimension

adv_business_region

adv_business_region

The geographical business region of the advertiser.

dimension

adv_cust_city

adv_cust_city

The city of the advertiser’s customer.

dimension

adv_cust_country

adv_cust_country

The country of the advertiser’s customer.

dimension

adv_cust_region

adv_cust_region

The geographical region of the advertiser’s customer.

dimension

adv_cust_status

adv_cust_status

The current status of the advertiser’s customer.

dimension

adv_line_of_business

adv_line_of_business

The specific line of business for the advertiser.

dimension

batch_id

batch_id

A unique identifier for a batch of records or actions.

dimension

bonus_cost

bonus_cost

The cost associated with bonuses or additional incentives paid out to partners, contributing to the overall program expense.

dimension

campaign_status

campaign_status

The current operational status of a marketing campaign (e.g., active, paused, ended).

dimension

click_cost

click_cost

The cost associated with a single click on an advertisement.

metric

click_date

click_date

The date when a click event occurred.

dimension

click_id

click_id

A unique identifier for a click event.

dimension

click_to_action

click_to_action

Data indicating that a user’s click directly led to a specific action or conversion event.

dimension

currency_exch_rate

currency_exch_rate

The exchange rate used to convert a transaction amount from one currency to another.

dimension

date_

date_

The generic date associated with a record or event.

dimension

date_display

date_display

A formatted date for display purposes.

dimension

date_joined

date_joined

The date when an entity joined, such as a partner or customer.

dimension

date_sort

date_sort

The date of a specific event or action, formatted for sorting and programmatic filtering. This field allows for chronological ordering of data within reports, such as by click date or action date, and supports date range filtering.

dimension

delivery_type

delivery_type

The method or type of delivery for a product or service.

dimension

device_type

device_type

The type of device used (e.g., mobile, desktop, tablet).

dimension

goods_cost

goods_cost

The total cost of products in the basket captured at conversion.

dimension

gross_action_cost

gross_action_cost

The total cost of Locked and Open-Ended Actions plus Reversed Action Cost.

metric

gross_revenue

gross_revenue

The total revenue generated before any expenses or deductions.

metric

group_id

group_id

A unique identifier for a partner group.

dimension

group_name

group_name

The name of a partner group.

dimension

invoice_date

invoice_date

The date when an invoice was issued.

dimension

join_date

join_date

The date when an entity, such as a partner or customer, joined the platform or program.

dimension

landing_page

landing_page

The URL of the page where a user lands after clicking on an advertisement or link.

dimension

landing_page_url

landing_page_url

The URL of the landing page where a user arrived.

dimension

location_id

location_id

A unique identifier for a geographical location.

dimension

location_name

location_name

The name of a geographical location associated with an action or partner, such as a country or state.

dimension

location_type

location_type

The classification or type of a geographical location, such as country or state.

dimension

locking_date

locking_date

The date when a conversion event or other data becomes finalized and can no longer be modified.

dimension

media_count

media_count

The total number of media assets or instances associated with a record.

metric

media_id

media_id

A unique identifier for a piece of media or creative.

dimension

media_partner_id

media_partner_id

A unique identifier for a media partner.

dimension

media_property_id

media_property_id

A unique identifier for a media property (e.g., a website, app, or publisher).

dimension

media_property_name_current

media_property_name_current

The current name of the media property.

dimension

media_property_name_historic

media_property_name_historic

The historical name of the media property where an event occurred.

dimension

media_property_type_current

media_property_type_current

The current type of the media property (e.g., website, blog, social media channel).

dimension

media_property_type_historic

media_property_type_historic

The historical type of the media property where an event occurred.

dimension

mp_id

mp_id

A unique identifier for a media partner.

dimension

original_currency_sale_amount

original_currency_sale_amount

The sale amount recorded in its original currency before any currency conversion.

dimension

original_sale_amount

original_sale_amount

The total sale amount before any discounts, taxes, or currency conversions.

metric

partner_group

partner_group

A categorization or grouping of partners within the impact.com platform for organizational and reporting purposes.

dimension

partner_id

partner_id

A unique identifier for a partner.

dimension

payment_type

payment_type

How the customer paid for their order.

dimension

property_name

property_name

The name of a media property.

dimension

property_type

property_type

The classification or type of a media property.

dimension

publisher_id

publisher_id

A unique identifier for a publisher.

dimension

publisher_name

publisher_name

The name of the publisher.

dimension

ref_ad_placement

ref_ad_placement

The specific location or context where an advertisement was displayed.

dimension

ref_ad_position

ref_ad_position

The positional ranking of an advertisement within its placement.

dimension

ref_ad_rank

ref_ad_rank

The ranking of an advertisement based on performance or other metrics.

dimension

ref_landingpage_url

ref_landingpage_url

The URL of the landing page that was linked to by the referring source.

dimension

ref_media_business_region

ref_media_business_region

The business region associated with media activities.

dimension

ref_media_line_of_business

ref_media_line_of_business

Reference to the line of business associated with a media entity.

dimension

ref_media_property

ref_media_property

The name or identifier of the referring media property.

dimension

ref_redirect_rule_id

ref_redirect_rule_id

An identifier for a specific redirect rule applied to tracking links, governing where users are directed.

dimension

ref_unique_id

ref_unique_id

A unique identifier for a referral event.

dimension

ref_url

ref_url

The referring URL.

dimension

scheduled_clearing_date

scheduled_clearing_date

The planned date when a payment or transaction is expected to be cleared.

dimension

site_category

site_category

The category of the website where an event occurred.

dimension

site_version

site_version

dimension

social_platform

social_platform

The social media platform from which a referral or action originated.

dimension

total_business_cost

total_business_cost

The total Cost of Goods plus Total Cost.

dimension

traffic_cat

traffic_cat

The category of web traffic (e.g., organic, paid, referral).

dimension