创建新营销活动-marketingEngagementCreate mutation

为营销活动创建新的营销活动参与。

所需的访问

write_marketing_events 访问范围。

在本页面

• 互动范例
• 参数
• MarketingEngagementInput字段
• 返回字段

互动范例

这是一个示例变异查询。

<font style="color:#1F61A0;">marketingEngagement </font><font style="color:#555555;">{</font> 
  <font style="color:#1F61A0;">clicksCount</font>
  <font style="color:#1F61A0;">commentsCount</font>
  <font style="color:#1F61A0;">投诉数</font>
  <font style="color:#1F61A0;">failCount</font>
  <font style="color:#1F61A0;">favoriteCount</font>
  <font style="color:#1F61A0;">fetchedAt</font>
  <font style="color:#1F61A0;">impressionsCount</font>
  <font style="color:#1F61A0;">is累积</font>
  <font style="color:#1F61A0;">发生</font>
  <font style="color:#1F61A0;">sendCount</font>
  <font style="color:#1F61A0;">股份数</font>
  <font style="color:#1F61A0;">uniqueClicksCount</font>
  <font style="color:#1F61A0;">uniqueViewsCount</font>
  <font style="color:#1F61A0;">取消订阅数</font>
  <font style="color:#1F61A0;">utcOffset</font>
  <font style="color:#1F61A0;">viewsCount</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">userErrors </font><font style="color:#555555;">{</font> 
  <font style="color:#1F61A0;">场地</font>
  <font style="color:#1F61A0;">信息</font>
<font style="color:#555555;">}</font>

<font style="color:#8B2BB9;">“ occurredOn” </font><font style="color:#555555;">：</font><font style="color:#D64292;">“占位符”</font> 

参数

MarketingEngagementInput字段

• adSpend（[MoneyInput](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/moneyinput)）
  如果行销活动是每日支出的付费广告，则当天的总广告支出。
• clicksCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天营销活动的总点击次数。
• commentsCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的评论总数。
• 投诉数（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的投诉总数。
• failCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  一天的失败总数。
• favoriteCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天收藏夹的总数。
• fetchedAt（[DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
  数据获取的日期时间。
• impressionsCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的总展示次数。
• isCumulative（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
  参与度是否报告为生命周期值而不是每日总计。
• 发生在（[Date!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#date-2021-01)） 必需的
  这些参与发生的日期。
• sendCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的发送总数。
• shareCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的股份总数。
• uniqueClicksCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的唯一点击总数。
• uniqueViewsCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的唯一身份观看总数。
• unsubscribesCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  当天的取消订阅总数。
• utcOffset（[UtcOffset](https://shopify.dev/docs/admin-api/graphql/reference/scalar#utcoffset-2021-01)）
  应用程序用来确定将支出分配到哪个日期的UTC偏移量。
• viewsCount（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
  一天的总观看次数。

返回字段

• marketingEngagement（[MarketingEngagement](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/marketingengagement)）
  创建的市场参与。
• userErrors（[[UserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/usererror)）
  执行突变时发生的错误列表。