推荐与商品目录

OneTrace.ru 会为每位客户挑选商品：热门商品、“一起购买”、相似商品、最近浏览以及个性化推荐。推荐可以展示在网站、邮件、旅程和群发中。使用推荐需要商品目录，以及浏览、加购和购买事件。

在菜单中打开用户互动 → 推荐。所有项目成员都可以查看此板块，“所有者”“管理员”和“经理”可以接入商品源、修改设置和启动重新计算。

商品目录

页面顶部显示目录中的商品数量、有货商品数量和类目数量。目录为空时无法进行推荐：请接入商品源或通过 API 上传商品。

如何接入商品源

1. 在商品源模块中点击添加商品源。
2. 填写名称和商品源网址（文件链接）。
3. 选择格式：YML（Yandex）、Google Merchant、CSV、JSON 或 JSON Lines。
4. 在更新字段中选择重新读取商品源的频率：每 1、3、6 或 12 小时，或每天一次。
5. 如果商品源受密码或令牌保护，请填写 Authorization 请求头，例如 Bearer …。它会加密存储。
6. 点击保存。首次导入会立即开始。

在 CSV 和 JSON 中，系统按列名识别：id、name 或 title、url、image、price、old_price、currency、available、category、brand（也支持对应的俄语列名）。其他列视为商品特征。商品 id 必须与网站在事件中传递的 id 一致，否则客户的行为将无法与目录关联。

每个商品源都会显示状态（正常或失败）、上次导入时间和结果：读取了多少商品和类目、有多少商品被下架。立即更新按钮会在计划之外启动导入。暂停会停止按计划导入（状态为“已暂停”），立即更新会解除暂停。出错的商品源会按计划重试，错误信息显示在其下方。

注意事项：

• 商品源中不再存在的商品会被下架，而不是删除：其事件历史会被保留，商品重新出现在商品源中后会再次可用。
• 删除商品源后，商品仍保留在目录中。

图片副本

在商品源设置中，可以开启将商品图片复制到我们的存储。这样，邮件和小组件中的图片将从 OneTrace.ru 的 CDN 加载，不受您网站可用性的影响。

• 最多下载 … 张图片，每秒、分钟或小时：用于限制速度，避免给您的网站带来负载。默认每秒 5 张。
• 商品源下方会显示已复制、排队中和下载失败的图片数量。在副本生成之前（或商品源中的图片地址发生变化时），会显示原始图片。
• 副本计入套餐的图片存储限额。如果开关不可用，说明您的部署中尚未配置图片存储。

库存

并非每家商店都管理库存，因此库存需要单独开启：每个商品源的设置中有 使用库存 开关；对于来自 API 和商店插件的商品，开关位于本板块的设置卡片中（使用来自 API 和插件的库存）。默认关闭。

• 开启——保存库存，库存为零的商品下架。基于库存的功能可用，例如“库存不多”旅程。商品源中的库存取自 <count>（YML）、g:quantity（Google）或 stock、quantity 列（CSV 和 JSON）；API 中取自 stock 字段。
• 关闭——不使用库存：即使商店发送零库存，商品也按商品源中的有货标记或 available 字段显示。

通过 API 上传

开发人员可以通过请求 https://cdp.onetrace.ru/api/v1/products 上传和删除商品，每次请求最多 1000 个商品和类目。需要具有“上传和删除商品”权限的私密密钥，参见API 密钥和服务器端集成。

目录语言

如果您的网站支持多种语言，请上传商品翻译，这样小组件、搜索和邮件就会以客户的语言显示商品名称和链接。

• 其他语言的商品源。 添加第二个商品源（即同一份导出文件的其他语言版本），并为其选择商品源语言。这类商品源不会创建商品，也不会下架商品：它会为主商品源中 id 相同的商品补充名称、链接和特征的翻译。项目中有多种语言时才会显示该字段，参见项目设置、套餐与审计。
• 通过 API。 在商品和类目的 translations 字段中传递翻译，例如 "translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}。

语言会自动选择：在网站上使用追踪器传递的访客语言，在邮件中使用该邮件版本的语言，参见语言版本。如果没有该语言的翻译，则显示主名称和主链接。商品搜索可以按任意语言的名称找到商品。在商品表格中，名称旁边会显示该商品已翻译成的语言。

模型使用的事件

在模型使用的事件模块中，指定表示商品操作的事件：

默认情况下，事件取自预测设置，其余取值来自店铺行业。点击保存后，模型会重新计算。

模型与夜间计算

模型卡片显示状态（等待中、计算中、就绪、无目录、失败）、计算时间以及商品之间的关联数量。

模型每晚重新计算，保存设置后以及点击重新计算按钮时也会立即计算。在计算期间或出错时，推荐结果按上一版本提供。

除商品关联外，计算还会向档案写入 favorite_category、favorite_brand 和 top_products 属性；对于有尺寸的行业，还会写入 pref_…（客户的尺码，参见店铺行业）和 replenish_at（“该补货了”的日期）。可以在分群中使用它们，例如“最喜爱的类目为鞋类”。

推荐类型

没有历史记录的新访客会看到热门商品。推荐结果中只包含有货的商品。

检查推荐结果

在检查结果模块中选择类型，并根据类型填写商品 ID、类目 ID 或档案 ID。点击显示，即可看到客户将会收到的商品卡片。

效果报告

30 天内对网站的效果表格按类型显示展示、点击、CTR、购买和收入。如果客户在点击推荐后 7 天内购买了该商品，即计为一次购买，收入按目录价格计算。邮件中推荐的效果可以在群发和旅程的报告中查看。

在哪里展示推荐

• 网站上：使用“网站”板块中的现成小组件或调用追踪器，参见网站推荐小组件。
• 邮件中：使用邮件编辑器中的商品区块。在其中可以选择哪些商品、数量、列数、显示价格和商品下方的按钮。对于“一起浏览”“一起购买”和“相似”类型，商品取自触发该邮件的事件（包含商品 id 的事件属性），弃购邮件就是这样构建的。如果没有匹配的商品，邮件中不会显示该区块。
• 任意渠道的模板中：使用 recommendations() 函数：

{% for product in recommendations('personal', 4) %}
  <a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}