Version 2019-10

Marketing events represent actions taken by your app, on behalf of the merchant, to market products, collections, discounts, pages, blog posts, and other features. Marketing events represent actions that target multiple potential customers, rather than specific individuals. For example, you should model your marketing event at the email campaign level, rather than on a per-email basis.

Marketing events include the event_type and marketing_channel properties that help Shopify to rank your app and surface it in the Shopify admin in ways that are useful to merchants. Traffic and order attribution for your app is handled by providing UTM parameters with your marketing events. The same UTM parameters are also used in the links provided in the marketing event. Engagements can also be added to marketing events to give merchants more insight into how potential customers interact with your marketing events. For example, engagements for ad campaigns can include clicks, shares, and comments.

What you can do with MarketingEvent

The Shopify API lets you do the following with the MarketingEvent resource. More detailed versions of these general actions may be available:

MarketingEvent properties

"remote_id": "123abc"

An optional remote identifier for a marketing event. The remote identifier lets Shopify validate engagement data.

"event_type": "ad"

The type of marketing event. Valid values: ad, post, message, retargeting, transactional, affiliate, loyalty, newsletter, abandoned_cart.


If there are values that you’d like to use for event_type that are not in the list above, then please post your request here. Our approach is to be more structured than using freeform text, but to still allow for categorization of most types of marketing actions.

"marketing_channel": "social"

The channel that your marketing event will use. Valid values: search, display, social, email, referral.