MarketingEngagementCreate
Creates a marketing engagement for a marketing activity.
Input
| Name | Type | Required | Description |
| MarketingActivityId | String | False | The marketing activity ID. Set this or RemoteId for activity-level engagements; leave null for channel-level. |
| RemoteId | String | False | A custom unique identifier for the marketing activity. Set this or MarketingActivityId for activity-level engagements; leave null for channel-level. |
| ChannelHandle | String | False | The unique string identifier of the channel. Set only for channel-level engagements; leave null for activity-level. |
| OccurredOn | Datetime | True | The calendar date for which the metrics are being reported. |
| UtcOffset | String | True | The UTC offset for the time zone in which the metrics are reported (format '+HH:MM' or '-HH:MM'). |
| IsCumulative | Bool | True | Whether the provided metrics are cumulative (from first day of reporting) or non-cumulative (single-day). Non-cumulative is strongly preferred. |
| ImpressionsCount | Int | False | The total number of times marketing content was displayed to users. |
| ViewsCount | Int | False | The total number of views on the marketing content. |
| UniqueViewsCount | Int | False | The total number of unique users who saw the marketing content. |
| ClicksCount | Int | False | The total number of interactions on the marketing content. |
| UniqueClicksCount | Int | False | The total number of unique clicks on the marketing content. |
| SharesCount | Int | False | The total number of times marketing content was shared or reposted. |
| FavoritesCount | Int | False | The total number of favorites, likes, saves, or bookmarks on the marketing content. |
| CommentsCount | Int | False | The total number of comments on the marketing content. |
| ComplaintsCount | Int | False | The total number of complaints on the marketing content (e.g. spam marks, dislikes, reports). |
| FailsCount | Int | False | The total number of fails for the marketing content (e.g. bounced emails). |
| SendsCount | Int | False | The total number of marketing emails or messages that were sent. |
| UnsubscribesCount | Int | False | The total number of unsubscribes on the marketing content. |
| SessionsCount | Int | False | The number of online store sessions generated from the marketing content. |
| Orders | Decimal | False | The number of orders generated from the marketing content. |
| FirstTimeCustomers | Decimal | False | The number of customers that placed their first order. |
| ReturningCustomers | Decimal | False | The number of returning customers that placed an order. |
| SalesAmount | Decimal | False | The amount of sales generated from the marketing content. |
| SalesCurrencyCode | String | False | The currency code for the sales amount. |
| AdSpendAmount | Decimal | False | The total ad spend for the marketing content. |
| AdSpendCurrencyCode | String | False | The currency code for the ad spend. |
Result Set Columns
| Name | Type | Description |
| Success | Boolean | Indicates whether or not the operation executed successfully. |
| Details | String | Any extra details on the operation's execution. |
| MarketingActivityId | String | The ID of the associated marketing activity. |