README

Shopware个性化
1. 入门指南
  1. 工作原理
安装
1. 社区
2. ZIP存档
配置
卸载
Nosto 插件作业调度
依赖项
开发
1. 本地设置
2. 测试设置

Shopware个性化

通过在整个购物旅程中为您的客户提供个性化的产品推荐，提高您的转化率和平均订单价值。

Nosto 允许您通过基于用户独特行为的推荐来为每位客户提供个性化的购物体验 - 从而提高转化率、平均订单价值和客户保留率。

入门指南

工作原理

此插件在购物体验中添加了一个新的区块类别，称为 Nosto 组件，以及一个名为 Nosto 的区块。此元素需要一个在 Nosto 管理员活动区域放置部分中找到的元素 ID。该元素可以放在您商店的任何 CMS 页面上，当配置并激活销售渠道时，插件会自动将产品推荐元素添加到相应位置。基本上，cms-element 是一个空的 "div" 占位符元素，这个 "div" 将自动填充来自您商店的产品推荐。

这是通过在用户访问页面时挖掘商店数据来实现的。例如，当用户浏览产品页面时，产品信息会异步发送到 Nosto，Nosto 依次根据该产品向商店提供产品推荐并显示给用户。

访问网站的用户越多，他们创建的页面浏览量越多，推荐就越准确。

除了推荐元素和实时数据收集之外，该插件还包括一些幕后功能，用于保持产品信息最新并跟踪商店中的订单。

每当商店中的产品更新时，例如价格发生变化，信息都会通过 API 发送到 Nosto。这将同步所有访问商店并查看最新推荐的用户的跨用户数据。

商店中所有下订单也都发送到 Nosto。这是为了跟踪由产品推荐直接产生的订单，即当用户在推荐中点击产品，将其添加到购物车并下订单时。

Nosto 还跟踪订单状态，即当订单状态更改为“已支付”或“已取消”时，通过 API 和新闻通讯订阅者更新订单。

您只需要为您的商店创建一个 Nosto 账户，并在您的商店中安装和配置插件即可使用 Nosto。这就像点击一个按钮那么简单，所以请继续阅读。

安装

插件可以按以下方式安装

社区商店（推荐）
ZIP存档

此外，该插件具有内置的 Nosto 作业调度程序依赖项。它包含在插件源中。

社区（推荐）

如果您已将Shopware账户连接到安装，则可以从Shopware管理员“我的扩展”部分自动下载和安装插件。该插件位于“我的扩展”中的“客户账户 + 个性化”部分，或者通过搜索“nosto”找到。如果您找不到，也可以从社区商店手动下载。找到插件后，只需单击插件页面上的“立即下载”按钮，然后按照说明激活插件。

ZIP存档

您还可以通过在Shopware管理员“我的扩展”部分上传zip存档来安装插件。插件存档可以从社区商店下载。
如果插件已设置为本地开发，可以使用shopware-cli extension zip . --disable-git生成存档。

之后，您可以在Shopware管理员“我的扩展”部分激活插件。

配置

Nosto插件有一个独立的设置页面。您可以配置每个销售渠道及其配置语言的价值。

设置 → 扩展 → Nosto

账户设置概览

基本配置字段和控制按钮位于标记有数字的插件配置页面

注意

账户设置仅适用于特定销售渠道和语言。没有全局账户设置。

指示已配置账户是否启用商品/产品同步的字段。
API验证按钮，将验证以下提到的令牌，并将结果显示在通知窗口中。
带有账户ID的必填字段。它可以在Nosto账户（账户设置）中获取，更多指南可以在这里找到：此处。
带有账户名称的必填字段。它可以在Nosto账户（账户设置）中获取，更多指南可以在这里找到：此处。
带有产品令牌API密钥的必填字段（API_PRODUCTS）。用于在Shopware和Nosto之间同步产品。此密钥必须从Nosto技术支持请求，之后它将出现在管理员中的身份验证令牌部分，更多指南可以在这里找到：此处。
带有电子邮件令牌API密钥的必填字段（API_EMAIL）。用于在Shopware和Nosto之间同步电子邮件。此密钥必须从Nosto技术支持请求，之后它将出现在管理员中的身份验证令牌部分，更多指南可以在这里找到：此处。
带有GraphQL令牌API密钥的必填字段（API_APPS）。用于在Shopware和Nosto之间同步订单、推荐、细分、分类商品。此密钥必须从Nosto技术支持请求，之后它将出现在管理员中的身份验证令牌部分，更多指南可以在这里找到：此处。
带有搜索令牌API密钥的必填字段（API_SEARCH）。用于所有使用即插即用解决方案时的搜索请求。此密钥必须从Nosto技术支持请求，之后它将出现在管理员中的身份验证令牌部分，更多指南可以在这里找到：此处。
分类更新按钮，用于同步分类商品的所有分类。

常规设置概览

某些配置仅适用于全局或特定渠道。

启用此设置后，Nosto跟踪JS脚本将在访客与店铺页面第一次互动后直接初始化和加载。这可以用于防止页面加载时店铺性能问题。
特定渠道 在产品同步期间，所选域名将用于产品URL。

标签分配概览

在“标签分配”卡片中显示的所有字段都用于将产品的自定义字段值传输到相关的Nosto产品实体。

功能标志概述

此配置卡片包含多个功能开关，用于启用/禁用将产品数据发送给Nosto的信息。还有启用/禁用评分和评论的可能性。Nosto支持对评分和评论元数据进行标记。评分值和评论计数元数据可以用于创建高级推荐规则，以推广好评产品。

卸载

您可以从Shopware管理员的“我的扩展”部分卸载此插件，使用标准的Shopware流程。更多信息请参阅这里

Nosto 插件作业调度

一旦安装并激活了插件，在Shopware 6管理中，您应该能在营销选项卡下看到菜单项，这将带我们到Nosto插件仪表板。营销 → Nosto工作列表

作业调度仪表板功能

一旦您进入Nosto工作列表页面，您应该能看到计划中的工作列表。

在作业列表页面，我们可以查看完整的作业信息。在插件安装后，所有产品都可以通过点击控制按钮“计划完整产品同步”来安排相关作业与Nosto同步。

这里有7列，包含了当前作业的相关信息。

作业调度仪表板视图

Nosto插件中有3种不同的仪表板视图。可以在作业列表页面的顶部操作栏切换视图模式。

列表视图

列表视图是仪表板的默认视图，具有过滤支持。

分组视图

分组视图有2种分组方式。

按状态分组
按作业类型分组。

可以在顶部操作栏切换分组类型。

图表视图

图表视图允许我们根据类型或根据状态对作业进行分组，并按日期显示。在图表栏的顶部，我们有一个下拉选择，可以在这里选择日期范围： 30天。
14天。
7天。
最后24小时。
昨天。

通过点击彩色圆点徽章，我们可以隐藏/显示与徽章颜色和前面的类型/状态对应的图表线和信息。

在图表底部有彩色圆点徽章，带有图表线名称（对应于图表分组模式状态/类型）。

自动加载

在Nosto仪表板顶部的操作中有一个名为自动加载的切换字段。

作业列表页面有自动重新加载功能，所以您甚至不需要重新加载整个页面来检查作业的执行状态。列表数据每分钟自动刷新。

列表页面包含所有Nosto插件作业

变更日志实体同步操作 - 父待办事项事件处理操作在子项上 - 营销权限同步操作（通讯录），订单同步操作（新订单、更新订单事件），以及 产品同步操作。
完整目录同步操作 - 同步产品 - 产品同步操作的父级。

依赖项

Nosto Job Scheduler，该调度器包含在插件源中

开发

本地设置

此设置需要安装 Shopware CLI。

使用 shopware-cli project create <folder> <version> 命令安装商店
- 按照终端中的说明设置商店
将插件仓库克隆或挂载到 custom/plugins 中。（不支持符号链接）
安装所有插件依赖项
1. composer install
2. npm install
在商店根目录下，运行以下命令
1. bin/console plugin:refresh
2. bin/console plugin:install NostoIntegration --activate --clearCache

测试设置

按照上述本地设置进行操作
商店文件夹： composer require symfony/test-pack --dev
插件文件夹： composer test
- 第一次运行时，测试将失败
- 这将创建测试数据库并运行迁移
- 数据库名称将为配置的DB名称后缀为 _test
商店文件夹：将环境文件中的数据库名称更改为 <databaseName>_test
商店文件夹：运行以下命令
1. bin/console plugin:refresh
2. bin/console plugin:install NostoIntegration --activate --clearCache

现在您可以回到第3点，它将成功运行

nosto / nosto-integration

维护者

详细信息