将 ShopifyQL 查询迁移到新版 Shopify 分析

ShopifyQL Notebooks 应用即将关闭，关闭日期待定。目前，您无法再通过 Shopify App Store 安装该应用；如果您卸载该应用，之后将无法再重新安装。

您可以手动将 ShopifyQL 查询迁移到新的 Shopify 分析。请注意，新的 Shopify 分析使用新版本的 ShopifyQL，所以在迁移过程中可能需要修改部分数据集和维度组合，以便在新的 Shopify 分析中返回与 ShopifyQL Notebooks 应用中相同的数据。

为了确保不丢失任何数据，您也可以在关闭日期之前的任何时间从 ShopifyQL Notebooks 应用导出数据集。

本页相关主题

将您现有的 ShopifyQL 查询迁移到新版 Shopify 分析

新版 Shopify 分析在所有默认和自定义报告中使用更新版本的 ShopifyQL，这与 ShopifyQL Notebooks 应用中使用的版本不同。

您可以使用查询创建自定义数据探索，将现有的 ShopifyQL 查询手动迁移到新版 Shopify 分析中更新的 ShopifyQL 版本。然后，您可以将其保存为自定义报告，并将自定义报告作为卡添加到 Shopify 后台中的分析数据概览。

您无法自动批量迁移现有查询。

详细了解如何使用新版 Shopify 分析创建自定义数据探索。

步骤：

在 Shopify 后台中，转到设置 > 应用和销售渠道。
点击 ShopifyQL Notebooks。
点击打开应用。
在笔记本部分，点击您要迁移其数据集的笔记本。
复制您要迁移的 ShopifyQL 查询。
在 Shopify 后台中，转至分析 > 报告。
点击新探索。
在 ShopifyQL 查询编辑器中，粘贴您现有的查询。
可选：自定义查询以确保查询有效并使用更新后的值。
点击 ▹ 运行。
点击保存。
在保存报告对话框中，为自定义报告命名，然后点击保存。

Notebooks 和新版 Shopify 分析中 ShopifyQL 的差异

新版 Shopify 分析在所有默认和自定义报告中使用更新版本的 ShopifyQL，这与 ShopifyQL Notebooks 应用中使用的版本不同。

在 ShopifyQL 的更新版本中，表数据集（用作查询中的 FROM 值）和维度（用作 SHOW、GROUP BY、ORDER BY 或 WHERE 值）的某些组合已经发生改变，这会影响您编写查询的方式。

例如，您可以在 Notebooks 应用中编写此 ShopifyQL 查询，按账单寄送国家和地区对总运费进行分组：

FROM orders
  SHOW shipping
  GROUP BY billing_country, billing_region

但是，在新的 Shopify 分析中，orders 和 shipping 数据集以及维度组合已更新为 sales 和 shipping_charges。因此，要将查询迁移到使用新版 Shopify 分析的更新版 ShopifyQL，您必须按照以下示例修改查询：

FROM sales
  SHOW shipping_charges
  GROUP BY billing_country, billing_region

更新数据集

如果您选择使用新版 Shopify 分析手动重新创建数据集，或者选择从 Notebooks 应用迁移现有 ShopifyQL 查询，请查看下表，其中列出了从 Notebooks 版本的 ShopifyQL 到更新版分析的部分数据集和维度组合的变化。

如果某个数据集和维度组合未在下面列出，则表示两个版本的 ShopifyQL 中的值保持不变，并且不需要在查询中进行修改即可返回相同的数据。

表格列出了新版 Shopify 分析中已更新的 ShopifyQL Notebooks 数据集和维度组合。
Notebooks 中的 ShopifyQL（数据集 > 维度）	新版 Shopify 分析中的 ShopifyQL（数据集 > 维度）
`订单` > `discounts_adjustments`	无等效项。新版 Shopify 分析中不存在。
`订单` > `gross_sales_adjustments`	无等效项。新版 Shopify 分析中不存在。
`订单` > `net_product_quantity`	`销售` > `net_items_sold`
`订单` > `ordered_product_quantity`	`销售` > `quantity_ordered`
`订单` > `returned_product_quantity`	`销售` > `quantity_returned`
`orders` > `shipping`	`sales` > `shipping_charges`
`products` > `cart_sessions`	`sessions` > `sessions_with_cart_additions`
`products` > `checkout_purchase_sessions`	`sales` > `sessions_that_reached_and_completed_checkout`
`产品` > `checkout_sessions`	`访问` > `sessions_that_reached_checkout`
`产品` > `checkout_to_purchase_rate`	`访问` > `checkout_conversion_rate`
`产品` > `purchase_sessions`	`sessions` > `sessions_that_completed_checkout`
`products` > `quantity_purchased`	`销售` > `quantity_ordered`
`产品` > `view_cart_checkout_purchase_sessions`	`sessions` > `sessions_that_completed_checkout_closed_funnel`
`产品` > `view_cart_checkout_sessions`	`sessions` > `sessions_that_reached_checkout_closed_funnel`
`products` > `view_cart_checkout_to_purchase_rate`	`访问` > `completed_checkout_rate`
`产品` > `view_cart_sessions`	`sessions` > `sessions_with_cart_additions`
`产品` > `view_purchase_sessions`	`sessions` > `sessions_that_completed_checkout`
`产品` > `view_sessions`	`sessions` > `sessions`
`产品` > `view_to_cart_rate`	`sessions` > `added_to_cart_rate`
`产品` > `view_to_checkout_rate`	`sessions` > `reached_checkout_rate`
`products` > `view_to_purchase_rate`	`sessions` > `conversion_rate`

## 导出 ShopifyQL Notebooks 数据集 {#export-datasets}

ShopifyQL Notebooks 关闭后，您将无法访问该应用或引用其中的数据集。如果您想保存现有的 ShopifyQL Notebooks 数据集以供日后参考，请将其导出为 CSV 文件。

步骤：

在 Shopify 后台中，转到设置 > 应用和销售渠道。
点击 ShopifyQL Notebooks。
点击打开应用。
在笔记本部分，点击您要导出其数据集的笔记本。
在包含要导出数据集的代码块中，点击 ...，然后点击 ↥将结果导出为 CSV 文件。
点击导出。