Skip to main content
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

query

Returns a MarketingActivity resource by ID.

ID!required

The ID of the MarketingActivity to return.


Was this section helpful?

The marketing activity resource represents marketing that a merchant created through an app.

activityListUrl

The URL of the marketing activity listing page in the marketing section.

adminEditUrl
non-null

The admin url used to edit this activity.

adSpend

The amount spent on the marketing activity.

app
non-null

The app which created this marketing activity.

appErrors

The errors generated when an app publishes the marketing activity.

automationStepType

The step type of a marketing automation activity.

budget

The allocated budget for the marketing activity.

createdAt
non-null

The date and time when the marketing activity was created.

errorOccurredAt

The time at which the most recent error occurred, which is set by the app.

flowEditorUrl

The flow editor URL to which the marketing activity is associated.

formData

The completed content in the marketing activity creation form.

hierarchyLevel

The hierarchy level of the marketing activity.

id
non-null

A globally-unique ID.

inMainWorkflowVersion
non-null

Whether the marketing activity is in the main workflow version of the marketing automation.

isExternal
non-null

The marketing activity represents an external marketing activity.

marketingChannelType
non-null

The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.

marketingEvent

Associated marketing event of this marketing activity.

parentActivityId

ID of the parent activity of this marketing activity.

parentRemoteId

ID of the parent activity of this marketing activity.

scheduledToEndAt

The scheduled end time of the marketing activity, which is set by the app.

scheduledToStartAt

The scheduled start time of the marketing activity, which is set by the app.

sourceAndMedium
non-null

A contextual description of the marketing activity based on the platform and tactic used.

status
non-null

The current state of the marketing activity.

statusBadgeTypeV2

The severity of the marketing activity's status.

statusLabel
non-null

The rendered status of the marketing activity.

statusTransitionedAt

The date and time when the activity's status last changed.

tactic
non-null

The method of marketing used for this marketing activity.

targetStatus

The status to which the marketing activity is currently transitioning.

title
non-null

The marketing activity's title, which is rendered on the marketing listing page.

trackingOpens
non-null

Whether the marketing activity is tracking opens.

updatedAt
non-null

The date and time when the marketing activity was updated.

urlParameterValue

The value portion of the URL query parameter used in attributing sessions to this activity.

utmParameters

The set of Urchin Tracking Module used in the URL for tracking this marketing activity.

marketingChannel
non-nullDeprecated

The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation. Use marketingChannelType instead.

statusBadgeType
Deprecated

The severity of the marketing activity's status. Use statusBadgeTypeV2 instead.


Was this section helpful?