营销活动 目的

营销活动代表由应用程序代表商家创建的营销。

所需的访问

read_marketing_events 访问范围。

在本页面

属性

  • activityListUrl（[URL](https://shopify.dev/docs/admin-api/graphql/reference/scalar#url-2021-01)）
    营销部分中此营销活动的活动列表页面的URL。
  • adSpend（[MoneyV2](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/moneyv2)）
    在此营销活动上花费的金额。
  • app（[App!](https://shopify.dev/docs/admin-api/graphql/reference/apps/app)）
    创建此营销活动的应用程序。
  • appErrors（[MarketingActivityExtensionAppErrors](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivityextensionapperrors)）
    应用尝试完成此活动时生成的错误。
  • budget（[MarketingBudget](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingbudget)）
    此营销活动的预算。
  • createdAt（[DateTime!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    创建营销活动的日期和时间。
  • formData（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    营销活动的表单数据。
  • id（[ID!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01)）
    全局唯一标识符。
  • marketingChannel（[MarketingChannel!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingchannel)）
    市场营销的广泛类别，用于报告汇总。
  • marketingEvent（[MarketingEvent](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingevent)）
    此营销活动的关联营销事件。
  • sourceAndMedium（[String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    基于所使用的平台和策略的营销活动的上下文描述。
  • status（[MarketingActivityStatus!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivitystatus)）
    状态有助于识别此营销活动是否已完成，排队，失败等。
  • statusBadgeType（[MarketingActivityStatusBadgeType](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivitystatusbadgetype)）
    StatusBadgeType有助于识别状态标记的颜色。
  • statusLabel（[String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    状态标签，用于描述营销活动的状态。
  • statusTransitionedAt（[DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    活动状态上次更改的日期和时间。
  • tactic（[MarketingTactic!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingtactic)）
    用于此营销活动的营销方法。
  • targetStatus（[MarketingActivityStatus](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivitystatus)）
    应用在异步操作之前设置的预期状态。
  • title（[String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    此营销活动的标题。
  • UpdatedAt（[DateTime!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    营销活动的更新日期和时间。
  • utmParameters（[UTMParameters](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/utmparameters)）
    为该营销活动跟踪的UTM参数集。

返回MarketingActivity的类型

  • [MarketingEngagement.marketingActivity](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingengagement#marketingactivity-2021-01)
  • [QueryRoot.marketingActivities](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/queryroot#marketingactivities-2021-01)
  • [QueryRoot.marketingActivity](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/queryroot#marketingactivity-2021-01)

MarketingActivity的mutation

实现

  • [Node](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/node)

自动生成的类型，用于通过多个MarketingActivities分页。

在本页面

属性

  • edges（[[MarketingActivityEdge!]!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivity)）
    边列表。
  • pageInfo（[PageInfo!](https://shopify.dev/docs/admin-api/graphql/reference/pageinfo)）
    有助于分页的信息。

一种自动生成的类型，在分页期间包含一个MarketingActivity和一个光标。

在本页面

属性

  • cursor（[String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    用于分页的光标。
  • node（[MarketingActivity!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivity)）
    MarketingActivityEdge末尾的项目。

返回MarketingActivityEdge的类型

  • [MarketingActivityConnection.edges](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingactivity#edges-2021-01)