criteo_stats_report: Get statistics about Criteo Dynamic Remarketing
In sergeymong/CriteoR: Export all data from Criteo, using REST API
Description
Usage
Arguments
Value
References
Examples
View source: R/criteo_stats_report.R
Description
Get statistics about Criteo Dynamic Remarketing
Usage
1
2
3
4
5
6
7
criteo_stats_report(start_date = Sys.Date() - 1, end_date = Sys.Date()
- 1, dimensions = list("Day", "CampaignId"),
metrics = list("Audience", "Displays", "Clicks", "ECpc", "ECpm",
"AdvertiserCost"), tok = criteo_access_token(),
report_type = "CampaignPerformance", ignore_x_device = F,
advertiser_ids = criteo_advertisers(), currency = "RUB",
prettify = T)
Arguments
start_date
Start date of your report. By default, yesterday.
end_date
End date of your report. By default, yesterday.
dimensions
How group by your data? By default by Day and CampaignId.
Number of dimensions between one and three. Possible values:
CampaignId
AdvertiserId
Category
Hour
Day
Week
Year
metrics
Which columns will be displayed.
All possible metrics will below. Default columns:
Audience
Displays
Clicks
ECpc
ECpm
AdvertiserCost
tok
Criteo token. Default is call and refresh token automatically.
report_type
By default, CampaignPerformance. Possible values:
FacebookDPA: stats from Facebook Dynamic Ads.
TransactionID: stats about all transactions
CampaignPerformance: stats about Criteo Dynamic Remarketing
ignore_x_device
Ignore cross-device data. By default, FALSE.
advertiser_ids
By default is call automatically all advertisers. You can set need values.
currency
By default RUB.
prettify
By default TRUE. Work only with default params.
If TRUE returns tibble:
advertiser: <[class: chr]>,
date: <[class: Date]>,
campaign_id: <[class: int]>,
campaign: <[class: chr]>,
audience: <rounded to 0 decimal places [class: int]>,
impressions: <[class: int]>,
clicks: <[class: int]>,
costs: <rounded to 2 decimal places [class: num]>,
cpc: <rrounded to 2 decimal places [class: num]>,
cpm: <rounded to 2 decimal places [class: num]>,
currency: <[class: chr]>
If FALSE return data frame with all columns.
Value
Data frame with all needed columns (watch in "prettify") with advertising stats.
References
- 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<e2><80><99> 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 or ad placements won, out of all impressions or ad placements that were bid on. For example, Criteo bid on 10 ad placements and won 2, so the Overall Competition Win is 20 perc. 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<e2><80><99>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<e2><80><99>s ad, divided by the campaign<e2><80><99>s number of clicks
- ConversionRatePv
Conversion rate post-view is the number of post-view sales generated by users who viewed on your campaign<e2><80><99>s ad, divided by the campaign<e2><80><99>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<e2><80><99>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<e2><80><99>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<e2><80><99>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<e2><80><99>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
Examples
1
2
3
4
5
# If you want get stats for yesterday
criteo_stats_report()
# If you want get stat for exact period
criteo_stats_report(start_date = "2019-01-01", end_date = "2019-05-01")
sergeymong/CriteoR documentation built on May 20, 2019, 1 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Description Usage Arguments Value References Examples
View source: R/criteo_stats_report.R
Description
Get statistics about Criteo Dynamic Remarketing
Usage
1 2 3 4 5 6 7 | criteo_stats_report(start_date = Sys.Date() - 1, end_date = Sys.Date()
- 1, dimensions = list("Day", "CampaignId"),
metrics = list("Audience", "Displays", "Clicks", "ECpc", "ECpm",
"AdvertiserCost"), tok = criteo_access_token(),
report_type = "CampaignPerformance", ignore_x_device = F,
advertiser_ids = criteo_advertisers(), currency = "RUB",
prettify = T)
|
Arguments
start_date |
Start date of your report. By default, yesterday. |
end_date |
End date of your report. By default, yesterday. |
dimensions |
How group by your data? By default by Day and CampaignId. Number of dimensions between one and three. Possible values:
|
metrics |
Which columns will be displayed. All possible metrics will below. Default columns:
|
tok |
Criteo token. Default is call and refresh token automatically. |
report_type |
By default, CampaignPerformance. Possible values:
|
ignore_x_device |
Ignore cross-device data. By default, FALSE. |
advertiser_ids |
By default is call automatically all advertisers. You can set need values. |
currency |
By default RUB. |
prettify |
By default TRUE. Work only with default params. If TRUE returns tibble:
If FALSE return data frame with all columns. |
Value
Data frame with all needed columns (watch in "prettify") with advertising stats.
References
- 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<e2><80><99> 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 or ad placements won, out of all impressions or ad placements that were bid on. For example, Criteo bid on 10 ad placements and won 2, so the Overall Competition Win is 20 perc. 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<e2><80><99>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<e2><80><99>s ad, divided by the campaign<e2><80><99>s number of clicks
- ConversionRatePv
Conversion rate post-view is the number of post-view sales generated by users who viewed on your campaign<e2><80><99>s ad, divided by the campaign<e2><80><99>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<e2><80><99>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<e2><80><99>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<e2><80><99>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<e2><80><99>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
Examples
1 2 3 4 5 | # If you want get stats for yesterday
criteo_stats_report()
# If you want get stat for exact period
criteo_stats_report(start_date = "2019-01-01", end_date = "2019-05-01")
|
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.