input_object
The input fields for a marketing engagement.
The total ad spend for the marketing content. Recurring weekly, monthly, or yearly spend needs to be divided into daily amounts.
The total number of interactions, such as a button press or a screen touch, that occurred on the marketing content.
The total number of comments on the marketing content.
The total number of complaints on the marketing content. For message-based platforms such as email or SMS, this represents the number of marketing emails or messages that were marked as spam. For social media platforms, this represents the number of dislikes or the number of times marketing content was reported.
The total number of fails for the marketing content. For message-based platforms such as email or SMS, this represents the number of bounced marketing emails or messages.
The total number of favorites, likes, saves, or bookmarks on the marketing content.
The number of customers that have placed their first order. Doesn't include adjustments such as edits, exchanges, or returns.
The total number of times marketing content was displayed to users, whether or not an interaction occurred. For message-based platforms such as email or SMS, this represents the number of marketing emails or messages that were delivered.
Specifies how the provided metrics have been aggregated. Cumulative metrics are aggregated from the first day of reporting up to and including
. Non-cumulative metrics are aggregated over the single day indicated in. Cumulative metrics will monotonically increase in time as each record includes the previous day's values, and so on. Non-cumulative is strongly preferred, and support for cumulative metrics may be deprecated in the future.The date for which the metrics are being reported, from 0:00:00 to 23:59:59 in the time zone specified by
.The number of orders generated from the marketing content.
The number of returning customers that have placed an order. Doesn't include adjustments such as edits, exchanges, or returns.
The amount of sales generated from the marketing content.
The total number of marketing emails or messages that were sent.
The number of online store sessions generated from the marketing content.
The total number of times marketing content was distributed or reposted to either one's own network of followers through a social media platform or other digital channels. For message-based platforms such as email or SMS, this represents the number of times marketing emails or messages were forwarded.
The total number of unique clicks on the marketing content.
The total number of all users who saw marketing content since it was published. For message-based platforms such as email or SMS, this represents the number of unique users that opened a marketing email or message. For video-based content, this represents the number of unique users that played video content.
The total number of unsubscribes on the marketing content. For social media platforms, this represents the number of unfollows.
The time difference, in hours, between UTC and the time zone used to aggregate these metrics.
The total number of views on the marketing content. For message-based platforms such as email or SMS, this represents the number of times marketing emails or messages were opened. For video-based content, this represents the number of times videos were played.