Placed: Most-used fields

Placed: Most-used fields#

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

advertiser

advertiser

The name of the advertiser.

dimension

baselineCvr

baselineCvr

Percentage of visitors per impressions served. This is the baseline conversion rate.

metric

behavioralLift

behavioralLift

Percent difference between exposed users’ actual visits during a campaign and their expected visit rates.

metric

behavioralLiftConfidence

behavioralLiftConfidence

Likelihood the campaign drove lift, calculated as 1 minus the p-value. The p-value indicates the likelihood of observing non-0 lift even if the campaign didn’t drive lift.

metric

behavioralLiftIndex

behavioralLiftIndex

Measure of how more or less likely exposed users are to have driven incremental visits versus a synthetic control group. A value of 100 represents the baseline. It is calculated as (Store Visits / Expected Store Visits) * 100.

metric

behavioralLiftIndexConfidence

behavioralLiftIndexConfidence

Likelihood the campaign drove lift, calculated as 1 minus the p-value. The p-value indicates the likelihood of observing non-0 lift even if the campaign didn’t drive lift.

metric

behavioralLiftVisits

behavioralLiftVisits

Total store visits directly attributable to media exposure.

metric

campaign

campaign

The name of the advertising campaign.

dimension

category

category

A classification or grouping for data, such as a product category or audience segment.

dimension

cpv

cpv

Cost associated with driving total visits. A low value indicates efficient media spend. Calculated as Ad Spend / Store Visits.

metric

cvr

cvr

Percentage of exposed visitors per impressions served, representing the conversion rate.

metric

dayOfWeek

dayOfWeek

Represents the day of the week (e.g., Monday, Tuesday) for data breakdown.

dimension

daypart

daypart

Represents a segment of the day (e.g., morning, afternoon, evening) for data breakdown.

dimension

endDate

endDate

The end date for the report, formatted as YYYY-MM-DD.

dimension

frequency

frequency

Average number of impressions served per exposed user, calculated as Impressions / Reach.

metric

impressionIndex

impressionIndex

The index of impressions, indicating relative impression performance.

metric

impressions

impressions

Total number of campaign impressions to date. Note that total impressions per partner may not exactly align with total ad network impressions.

metric

income

income

Represents an income demographic segment for audience targeting or reporting.

dimension

liftSales

liftSales

Standard lift in revenue attributed to media exposure.

metric

liftVisits

liftVisits

Standard store visits driven by media exposure.

metric

lineItem

lineItem

A specific item within an advertising campaign, often representing a particular ad or targeting setting.

dimension

market

market

The geographical market or region targeted by the campaign.

dimension

name

name

The name of the report.

dimension

network

network

The advertising network or platform where the campaign is running.

dimension

partner

partner

The partner (e.g., ad network) associated with the campaign or report.

dimension

percentVisitors

percentVisitors

The percentage of total store visits.

metric

reach

reach

Total number of unique users who were exposed to the campaign.

metric

reportId

reportId

The unique identifier for the report.

dimension

returningCvr

returningCvr

Percentage of returning visitors per impressions served.

metric

sales

sales

Store sales generated by exposed users.

metric

spend

spend

Total estimated campaign cost to an advertiser to date, based on spend data provided by the advertiser or partner. A CPM is calculated based on partner-level spend and impressions and used to derive ad spend.

metric

standardLift

standardLift

Percent difference between exposed users’ actual visits during a campaign and their expected visit rates. Standard lift does not account for prior business visitation. It is calculated as (Conversion Rate - Expected Conversion Rate) / Expected Conversion Rate.

metric

standardLiftConfidence

standardLiftConfidence

The confidence level associated with the standard lift metric.

metric

startDate

startDate

The start date for the report, formatted as YYYY-MM-DD.

dimension

status

status

The current status of the report, such as COMPLETED, PENDING, or PROCESSING.

dimension

type

type

The classification of the report, such as OVERALL, PARTNER, or CUSTOM.

dimension

visits

visits

Total number of store visits attributed to exposed users during the campaign.

metric

yearMonthDay

yearMonthDay

Represents the date in YYYY-MM-DD format, typically used for daily data breakdowns.

dimension