> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# [Analytics] Statistics v1
export const EndpointBadge = ({method = "GET", children}) => {
const METHOD_STYLES = {
GET: {
bg: "mint-bg-[#2AB673]"
},
POST: {
bg: "mint-bg-[#3064E3]"
},
PUT: {
bg: "mint-bg-[#C28C30]"
},
PATCH: {
bg: "mint-bg-[#DA622B]"
},
DELETE: {
bg: "mint-bg-[#CB3A32]"
},
API: {
bg: "mint-bg-black"
}
};
const key = method.toUpperCase();
const styles = METHOD_STYLES[key] ?? METHOD_STYLES.API;
return
{key}
{children}
;
};
## **Retrieving Statistics for a Specific Advertiser**
The Statistics API allows measurement and reporting on campaigns using the metrics and dimensions you specify.
```http theme={null}
https://api.criteo.com/legacy/marketing/v1/statistics
```
```bash cURL theme={null}
curl --request POST \
--url https://api.criteo.com/legacy/marketing/v1/statistics \
--header 'Accept: application/json' \
--header 'Content-Type: text/json' \
--data '{"dimensions":["CampaignId","Day"],"metrics":["Display","Clicks"],"advertiserIds":"12345","startDate":"09-10-2020","endDate":"09-14-2020","timezone":"PST","currency":"USD","format":"Csv"}'
```
A report is generated via a POST call and the results are returned directly in the response.
```csv theme={null}
Advertiser Name;Campaign ID;Campaign Name;Category ID;Category Name;Day;Currency;Clicks
My Advertiser;54321;Lower Funnel;0;MyCategory;Thu 2020/9/10;USD;293
My Advertiser;54321;Lower Funnel;0;MyCategory;Fri 2020/9/11;USD;254
My Advertiser;54321;Lower Funnel;0;MyCategory;Sat 2020/9/12;USD;280
My Advertiser;54321;Lower Funnel;0;MyCategory;Sun 2020/9/13;USD;327
My Advertiser;54321;Lower Funnel;0;MyCategory;Mon 2020/9/14;USD;306
My Advertiser;54321;Lower Funnel;0;MyCategory;Tue 2020/9/15;USD;219
```
All metrics from Management Center UI are available through the API, available up to a daily granularity. A maximum of 3 dimensions can be used.
Remaining budget and statistics are not real-time and can be delayed up to a few hours.
Formats allowed for export are XML, JSON, CSV, EXCEL and HTML. Currency value must respect ISO currency code format.
## **Available Dimensions**
A maximum of 3 dimensions can be used. Some combinations of dimensions are not allowed and we recommend keeping the following order when building your report:
* AdvertiserId
* CampaignId
* Category
* Year
* Week
* Day
* Hour
## **Available Metrics**
| Metrics | Details |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Clicks | Number of times that your Criteo ads have been clicked |
| Displays | Number of times your Criteo ad is displayed to a user on publishers’ websites |
| AdvertiserCost | Total cost of your campaigns |
| SalesPc | The total number of purchases completed via the same device your Criteo ads were clicked. Sales are attributed within 30 days after a user clicks on your Criteo ad. |
| SameSalesPc | The total number of purchases completed via the same device your Criteo ads were clicked. Sales are attributed within 30 days after a user clicks on your Criteo ad. |
| SalesPcNd | Post-click sales that are non-deduplicated |
| SalesPv | All sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign. Post-view sales do not include sales from users who clicked an ad, which are counted as sales |
| SalesPvNd | All non-deduplicated post-view sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign. Post-view sales do not include sales from users who clicked an ad, which are counted as sales |
| SalesPcPv | The total amount of sales generated both post-click and post-view |
| SalesAllPc | The total number of purchases completed via the same device your Criteo ads were clicked, or a different one. Sales are attributed within 30 days after a user clicks on your Criteo ad. |
| RevenueGeneratedPc | Total revenue of your campaigns generated from post-click sales |
| RevenueGeneratedPv | Total revenue of your campaigns generated from post-view sales |
| RevenueGeneratedPcPv | Post-click + post-view revenue is the total revenue of your campaigns generated from post-click and post-view sales. This number is computed based on the prices provided by your conversion trackers |
| RevenueGeneratedPcNd | Total revenue of your campaigns generated from post-click sales non-deduplicated |
| RevenueGeneratedPvNd | Total revenue of your campaigns generated from post-view sales non-deduplicated |
| ExposedUsers | Number of distinct cookies that have seen at least one Criteo display |
| OverallCompetitionWin | Percentage of impressions/ad placements won, out of all impressions/ad placements that were bid on. For example, Criteo bid on 10 ad placements and won 2, so the Overall Competition Win is 20%. Higher CPC bids result in increased competition win. |
| Audience | Number of distinct cookies to which Criteo had the opportunity to make a display |
| Reach | Share of the audience exposed to at least one Criteo display ad (percentage) |
| AverageCart | Average revenue generated by a campaign’s sales. This number is calculated by dividing the total revenue by the total sales |
| ClickThroughRate | The number of times your Criteo ads are clicked, divided by the number of times your ad is displayed (impressions). Each campaign has its own CTR |
| ConversionRate | Number of sales generated by users who clicked on your campaign’s ad, divided by the campaign’s number of clicks |
| ConversionRatePv | Conversion rate post-view is the number of post-view sales generated by users who viewed on your campaign’s ad, divided by the campaign’s number of impressions |
| ECos | The ratio between the total cost of the campaign and the sales amount that the campaign generated. COS provides a good indication of your campaign’s ROI |
| ECosPv | The ratio between the total cost of the campaign and the post-view sales amount that the campaign generated. This number provides a good indication of your campaign’s ROI. |
| ECosPcPv | Cost of sale post-click + post-view is the ratio between the total cost of the campaign and the post-click and post-view sales amount that the campaign generated. This number provides a good indication of your campaign’s ROI |
| CostPerOrder | Cost per order is the amount of money (cost) spent to generate post-click sales |
| CostPerOrderPv | The amount of money (cost) spent to generate post-view sales |
| CostPerOrderPcPv | Cost per order post-click + post-view is the amount of money (cost) spent to generate post-click and post-view sales |
| ECpc | The price you pay each time a user clicks your Criteo ad. Depending on your campaign’s business model, you can change the CPC on the Campaigns tab for each campaign |
| ECpm | Cost per mille is the cost of your campaign for 1,000 impressions |
| ReturnOnAdvertisingSpending | Corresponds to the ratio between the sales amount the campaign generated and the total cost of the campaign (ROAS = 1/COS) |
| AdvertiserValue | The total value generated by the campaign. It is equal to the sum of revenues generated by each product multiplied by their corresponding Value coefficient as defined in the advertiser's feed. |
| CostOfAdvertiserValue | The ratio between the total cost of the campaign and the Advertiser Value of the campaign |