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.

metric

ATId

ATId

Action Tracker ID, a unique identifier for a specific action tracking setup.

metric

ActionCost

ActionCost

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

metric

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

The system or method used to track specific user actions.

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

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 when a batch of data or transactions was processed.

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.

dimension

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 catalog.

dimension

CatalogSubcategory

CatalogSubcategory

The subcategory of a product within a catalog.

dimension

Category

Category

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

dimension

CategoryList

CategoryList

A list of categories associated with a product or campaign.

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.

metric

Company_URL

Company_URL

The website URL of the company involved in the partnership.

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 outstanding balance in an advertiser’s or media partner’s account.

metric

Customer_Id

Customer_Id

A unique identifier for a customer.

dimension

Customer_Status

Customer_Status

The current status of a customer within the platform or sales funnel (e.g., new, returning, active).

dimension

Date

Date

The generic date of an event or record.

dimension

Description

Description

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 factor of a discount applied to a product or service.

dimension

Discount_Rate

Discount_Rate

The percentage or factor of a discount applied to a product or service.

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 cost of goods sold for a product or service.

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

Insertion Order, a document outlining the details of an advertising campaign or partnership agreement.

dimension

IO_ID

IO_ID

A unique identifier for an Insertion Order.

dimension

ImportedCost

ImportedCost

The cost of imported data or transactions.

dimension

Importedclicks

Importedclicks

The number of clicks imported from an external source.

dimension

Importedimpressions

Importedimpressions

The number of impressions imported from an external source.

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

Lead Reversal Rate, the percentage of leads that are later reversed or deemed invalid.

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

dimension

Margin

Margin

The profit margin on a product or service.

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 media used (e.g., social, display, search).

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

Network

Network

The advertising or affiliate network associated with a campaign or partner.

metric

Notes

Notes

dimension

OS

OS

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

dimension

Oid

Oid

Order Identifier, a unique reference number assigned to a specific customer order or transaction.

dimension

Opens

Opens

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

dimension

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

OtherCost

OtherCost

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

metric

OtherMobileActions

OtherMobileActions

The number of other mobile-specific actions recorded, excluding installs or opens.

dimension

OtherMobileCost

OtherMobileCost

The cost associated with other mobile-specific actions.

dimension

OtherMobileRevenue

OtherMobileRevenue

The revenue generated from other mobile-specific actions.

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

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 associated with a customer or conversion 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

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.

metric

ROI

ROI

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

metric

RR

RR

Reversal Rate, the percentage of transactions or actions that are reversed or cancelled.

dimension

Rate

Rate

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

metric

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

An amount returned or credited to a customer or partner.

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

Sale Reversal Rate, the percentage of sales that are later reversed or cancelled.

dimension

SaleRevenue

SaleRevenue

The total revenue generated from sales.

dimension

Sales

Sales

The total number of completed sales.

metric

SharedId

SharedId

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

dimension

Subcategory

Subcategory

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

dimension

Subid1

Subid1

Sub-identifier 1, a custom tracking parameter used by partners to pass additional granular information about the traffic or conversion source.

dimension

Subid2

Subid2

Sub-identifier 2, a custom tracking parameter used by partners to pass additional granular information about the traffic or conversion source.

dimension

Subid3

Subid3

Sub-identifier 3, a custom tracking parameter used by partners to pass additional granular information about the traffic or conversion source.

dimension

Tax

Tax

The amount of tax applied to a transaction.

metric

TimesImpressionsViewed

TimesImpressionsViewed

The number of times impressions were viewed.

dimension

TotalBusinessCost

TotalBusinessCost

The aggregate cost of doing business related to partnerships.

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

The general classification of an item or event.

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

The Value Added Tax (VAT) applied to an action, conversion, or transaction.

metric

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

action_date

action_date

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

dimension

action_id

action_id

A unique identifier for a specific action or event recorded within the partnership automation platform.

dimension

action_tracker

action_tracker

A mechanism used to link an action or conversion to a specific account and campaign.

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 advertising campaign belongs.

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_type

ad_type

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

dimension

adv_cust_city

adv_cust_city

The city of the advertiser’s customer associated with a specific action or conversion.

dimension

adv_cust_country

adv_cust_country

The country of the advertiser’s customer associated with a specific action or conversion.

dimension

adv_cust_region

adv_cust_region

The region or state of the advertiser’s customer associated with a specific action or conversion.

dimension

at_id

at_id

The unique identifier for an action tracker.

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

client_cost

client_cost

The cost incurred by the client (advertiser) for a specific marketing activity or campaign.

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_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

dimension

device_type

device_type

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

dimension

goods_cost

goods_cost

The cost of goods associated with a sale.

dimension

invoice_date

invoice_date

The date when an invoice was issued.

dimension

join_date

join_date

The date when 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 relevant to a conversion or customer data.

dimension

location_type

location_type

The classification of a geographical location (e.g., city, region, country).

dimension

locking_date

locking_date

The date after which a transaction or record cannot be modified.

dimension

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, if it has changed.

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, if it has changed.

dimension

mp_id

mp_id

A unique identifier for a media partner.

metric

original_currency_sale_amount

original_currency_sale_amount

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

dimension

original_payout

original_payout

The payout amount in its original currency or before any adjustments.

dimension

original_sale_amount

original_sale_amount

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

metric

partner_group

partner_group

The group or segment to which a media partner belongs.

dimension

partner_id

partner_id

A unique identifier for a partner.

dimension

payment_type

payment_type

How the customer paid for their order.

dimension

promo_code

promo_code

A specific code used to apply discounts or promotions to an order, often tracked for partner attribution.

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 a referring advertisement was displayed.

dimension

ref_ad_position

ref_ad_position

The position of a referring advertisement on a page or within a content block.

dimension

ref_ad_rank

ref_ad_rank

The ranking or order of a referring advertisement in a list of results.

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 the referring media.

dimension

ref_media_line_of_business

ref_media_line_of_business

The line of business associated with the referring media.

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

A unique identifier for the redirect rule applied to a referring link.

dimension

ref_unique_id

ref_unique_id

A unique identifier for a referral event.

dimension

ref_url

ref_url

The referring URL.

dimension

sale_amount

sale_amount

The total monetary value of a sale or transaction, used for calculating partner commissions and overall revenue.

metric

scheduled_clearing_date

scheduled_clearing_date

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

dimension

shared_id

shared_id

A common identifier used across different systems or partners to link related data points or user activities.

dimension

site_category

site_category

The category of the website or media property where an ad was displayed.

dimension

social_platform

social_platform

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

dimension

status_detail

status_detail

Additional details regarding the status of a record or action.

dimension

total_business_cost

total_business_cost

The aggregate cost of doing business.

dimension

traffic_cat

traffic_cat

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

dimension