Marketing Activity
Requires access scope.
The marketing activity resource represents marketing that a merchant created through an app.
Anchor to FieldsFields
- Anchor to activityListUrlactivity•URL
List Url The URL of the marketing activity listing page in the marketing section.
- Anchor to adSpendad•Money
Spend V2 The amount spent on the marketing activity.
- •App!non-null
The app which created this marketing activity.
- Anchor to appErrorsapp•Marketing
Errors Activity Extension App Errors The errors generated when an app publishes the marketing activity.
- Anchor to budgetbudget•Marketing
Budget The allocated budget for the marketing activity.
- Anchor to createdAtcreated•Date
At Time!non-null The date and time when the marketing activity was created.
- Anchor to formDataform•String
Data The completed content in the marketing activity creation form.
- Anchor to hierarchyLevelhierarchy•Marketing
Level Activity Hierarchy Level The hierarchy level of the marketing activity.
- •ID!non-null
A globally-unique ID.
- Anchor to inMainWorkflowVersionin•Boolean!non-null
Main Workflow Version Whether the marketing activity is in the main workflow version of the marketing automation.
- Anchor to isExternalis•Boolean!non-null
External The marketing activity represents an external marketing activity.
- Anchor to marketingChannelTypemarketing•Marketing
Channel Type Channel!non-null The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.
- Anchor to marketingEventmarketing•Marketing
Event Event Associated marketing event of this marketing activity.
- Anchor to parentActivityIdparent•ID
Activity Id ID of the parent activity of this marketing activity.
- Anchor to parentRemoteIdparent•String
Remote Id ID of the parent activity of this marketing activity.
- Anchor to sourceAndMediumsource•String!non-null
And Medium A contextual description of the marketing activity based on the platform and tactic used.
- Anchor to statusstatus•Marketing
Activity Status!non-null The current state of the marketing activity.
- Anchor to statusBadgeTypeV2status•Badge
Badge Type V2 Type The severity of the marketing activity's status.
- Anchor to statusLabelstatus•String!non-null
Label The rendered status of the marketing activity.
- Anchor to statusTransitionedAtstatus•Date
Transitioned At Time The date and time when the activity's status last changed.
- Anchor to tactictactic•Marketing
Tactic!non-null The method of marketing used for this marketing activity.
- Anchor to targetStatustarget•Marketing
Status Activity Status The status to which the marketing activity is currently transitioning.
- Anchor to titletitle•String!non-null
The marketing activity's title, which is rendered on the marketing listing page.
- Anchor to updatedAtupdated•Date
At Time!non-null The date and time when the marketing activity was updated.
- Anchor to urlParameterValueurl•String
Parameter Value The value portion of the URL query parameter used in attributing sessions to this activity.
- Anchor to utmParametersutm•UTMParameters
Parameters The set of Urchin Tracking Module used in the URL for tracking this marketing activity.
Deprecated fields
- Anchor to marketingChannelmarketing•Marketing
Channel Channel!non-nullDeprecated - Anchor to statusBadgeTypestatus•Marketing
Badge Type Activity Status Badge TypeDeprecated
Anchor to QueriesQueries
- •query
A list of marketing activities associated with the marketing app.
- •query
Returns a MarketingActivity resource by ID.
Anchor to MutationsMutations
- •mutation
Create new marketing activity.
- Anchor to inputinput•Marketing
Activity Create Input!required The Input of marketing activity create.
Arguments
- Anchor to marketingActivitymarketing•Marketing
Activity Activity The created marketing activity.
- Anchor to redirectPathredirect•String
Path The path to return back to shopify admin from embedded editor.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates a new external marketing activity.
- Anchor to inputinput•Marketing
Activity Create External Input!required The input field for creating an external marketing activity.
Arguments
- Anchor to marketingActivitymarketing•Marketing
Activity Activity The external marketing activity that was created.
- Anchor to userErrorsuser•[Marketing
Errors Activity User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates a marketing activity with the latest information.
- Anchor to inputinput•Marketing
Activity Update Input!required The Input of the marketing activity.
Arguments
- Anchor to marketingActivitymarketing•Marketing
Activity Activity The updated marketing activity.
- Anchor to redirectPathredirect•String
Path The redirect path from the embedded editor to the Shopify admin.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Update an external marketing activity.
- Anchor to inputinput•Marketing
Activity Update External Input!required The input field for updating an external marketing activity.
- Anchor to marketingActivityIdmarketing•ID
Activity Id The ID of the marketing activity. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.
- Anchor to remoteIdremote•String
Id A custom unique identifier for the marketing activity, which can be used to manage the activity and send engagement metrics without having to store our marketing activity ID in your systems. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.
- •UTMInput
Specifies the Urchin Traffic Module (UTM) parameters that are associated with a related marketing campaign. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.
Arguments
- Anchor to marketingActivitymarketing•Marketing
Activity Activity The updated marketing activity.
- Anchor to userErrorsuser•[Marketing
Errors Activity User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates a new external marketing activity or updates an existing one. When optional fields are absent or null, associated information will be removed from an existing marketing activity.
- Anchor to inputinput•Marketing
Activity Upsert External Input!required The input field for creating or updating an external marketing activity.
Arguments
- Anchor to marketingActivitymarketing•Marketing
Activity Activity The external marketing activity that was created or updated.
- Anchor to userErrorsuser•[Marketing
Errors Activity User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields