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 |