Partnerize: Most-used fields

Partnerize: Most-used fields#

The table below gives information about most-used fields that you can import from Partnerize. 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
Advertiser Reference advertiser_reference Metric

A unique reference or identifier for the advertiser.

Average Order Size average_order_size Metric

The average number of items per order across all conversions.

Average Order Value average_order_value Metric

The average monetary value of an order.

Click Conversion Rate click_conversion_rate Metric

The percentage of clicks that resulted in a conversion. This metric is available in the API's aggregated overview reports.

Conversion Rejection Rate conversion_rejection_rate Metric

The rate at which conversions are rejected, usually expressed as a percentage of total conversions.

Country country Metric

The country associated with the transaction or user.

Date Dimension

The date of the event or record.

Date Time date_time Dimension

The date and time of the event or record.

Date end Dimension

The end date of the reporting period.

Date start Dimension

The start date of the reporting period.

Total Clicks Converted total_clicks_converted Metric

The total number of clicks that resulted in a conversion.

Total Partner Commission total_partner_commission Metric

The total commission earned by a partner for generated conversions. This is mentioned in the Analytics API documentation for reporting.

Type type Dimension

A classification or category type for an entity, such as a conversion or report.

advertiser_reference Dimension

An internal identifier used by the advertiser to reference a creative or deal.

campaign_id Dimension

A unique identifier for a marketing campaign.

campaign_name Dimension

The name or title of the marketing campaign.

category Dimension

The category associated with a campaign deal.

click_date Dimension

This field indicates the date when a click event occurred. It is used for tracking and reporting on traffic generation.

commission Metric

The amount of commission earned for a generated conversion, often by a partner or publisher.

conversion_date Dimension

The date when the conversion occurred. The API uses ISO-8601 date format for various date-related fields.

conversion_id Dimension

A unique identifier or reference for a specific conversion event within the platform.

conversion_item_id Dimension

A unique identifier for a specific item within a conversion event. The API supports exporting conversion items reports.

conversion_reference Dimension

A unique identifier or reference for a specific conversion event.

conversion_status Dimension

The current status of a conversion, such as approved, pending, or rejected.

country Dimension

The ISO-2 country code relevant to the advertiser, publisher, or campaign.

country_name Dimension

The name of the country associated with the transaction or user.

creative_type Dimension

The type of creative or promotional material used for a marketing campaign, such as text links, banners, or HTML assets.

currency Dimension

The currency in which monetary values (conversions, commissions, order values) are reported. It can also be used as a filter for reporting.

customer_reference Metric

A unique identifier for a campaign within the Partnerize platform. This reference is used for tracking and reporting purposes, allowing users to differentiate between various campaigns.

customer_type Dimension

Represents the category or type of the customer associated with a conversion or other tracked event within the Partnerize platform. This field helps in classifying customers for reporting and analysis.

device_id Dimension

A unique identifier for the device used by the customer during a click or conversion.

device_name Dimension

The name or type of the device used by the customer.

e_cpa Metric

The effective cost per action.

item_commission Metric

The commission attributed to a specific item within a conversion. This is inferred from the existence of conversion item IDs and item-level reporting.

partner_id Dimension

A unique identifier for the partner.

partner_name Dimension

The name of the partner.

partnership_model_id Dimension

A unique identifier for the partnership model associated with a campaign or publisher.

partnership_model_name Dimension

The name of the partnership model (e.g., CPA, CPL, RevShare).

publisher_commission Metric

The commission specifically earned by a publisher (partner) for their generated conversions. The API includes endpoints to retrieve partner commissions.

publisher_id Dimension

The unique identifier for a publisher (partner) on the platform. This is used across various partner and campaign management APIs.

publisher_name Dimension

The name of the publisher (partner) account. This is often referred to as 'account_name' for partners.

ref_device Dimension

A unique identifier or name/type for the device used by the customer during a click or conversion event.

ref_partnership_model Dimension

A reference to the type of partnership model, e.g., affiliate, influencer. The API provides an endpoint to list available partnership models.

reject_reason Dimension

The reason provided for why a conversion or other tracked event was rejected.

source_referer Dimension
total_clicks Metric

The total number of clicks recorded.

total_commission Metric

The total aggregate commission earned.

total_conversion_items Metric

The total number of items included in conversions.

total_conversions Metric

The total number of conversions recorded.

total_impressions Metric

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

total_order_value Metric

The total monetary value of all confirmed orders or conversions.

total_unique_clicks Metric

The total number of distinct clicks recorded.

traffic_source_id Dimension

A unique identifier for the traffic source.

traffic_source_name Dimension

The name of the traffic source.

voucher_codes Dimension

A unique code, such as a coupon or promotional code, offered by a brand to customers to apply discounts or promotions to transactions.