如何在电子邮件中设置产品推荐

将产品块的源设置为推荐，可以按畅销商品、补货、降价、新品上架、组合购买或根据浏览记录对产品进行排名，而无需您挑选产品或编写产品目录规则。请参阅获取推荐产品了解此源添加的每个字段。其中三种策略需要来自您产品目录之外的数据才能生效：畅销商品读取您的订单历史，而组合购买和根据浏览记录则读取购物者浏览和购买过的内容。本指南将介绍需要发送哪些数据，以便每种策略都有内容可供排名。

提示

已经为废弃购物车恢复发送 PW_AbandonedCart 和 PW_OrderCreated 事件了吗？请继续阅读。畅销商品策略需要在 PW_OrderCreated 事件上增加一个废弃购物车指南中未涵盖的字段。

开始之前

请确保您账户的产品目录中有产品。前往内容 → 产品目录，连接一个数据源、导入一个 CSV 文件或手动添加产品。了解如何填充您的产品目录。

需要开发人员协助

发送以下事件需要您的开发团队协助，除非您的商店集成已为您发送这些事件。请与他们分享本指南。

新账户会首先看到常规产品目录

以下每种策略都需要积累历史数据才能进行排名。在此之前，该块将显示常规产品目录。请参阅获取推荐产品下的说明。

哪些策略需要事件

六种策略中有三种是根据您发送的事件对产品进行排名；另外三种则直接根据您的产品目录进行排名，无需您提供任何额外信息。

策略	需要事件？	数据源
补货	否	产品目录库存变化
降价	否	产品目录价格变化
新品上架	否	产品目录“添加”日期
畅销商品 (7/30 天)	是	带有 items 的 PW_OrderCreated / PW_OrderUpdated
根据浏览记录	是	任何携带产品 ID 的事件。订单 items 也会为其排名所依据的产品对提供数据
组合购买	是	任何携带产品 ID 或订单 items 的事件，外加一个设备标签

您的数据源中的库存或价格变化，或下一次计划的同步，都会自动更新补货、降价和新品上架。这三种策略无需发送任何事件。

畅销商品：将商品添加到您的订单事件中

畅销商品 (7 天) 和 畅销商品 (30 天) 根据在相应时间窗口内售出的单位数量对产品进行排名。它们会读取 PW_OrderCreated 和 PW_OrderUpdated 事件上的 items 数组，特别是每个商品的 productId 和 quantity。

如果您已经发送 PW_OrderCreated 来清除废弃购物车标签，那个最小化的调用（仅含 orderId）仍然可以清除购物车，但它无法为“畅销商品”策略提供任何计数依据。请将订单的行项目添加到同一次调用中：

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293",
      "items": [
        {
          "productId": "SKU-4821",
          "quantity": 1
        },
        {
          "productId": "SKU-5190",
          "quantity": 2
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

productId 必须与您的产品目录中该商品使用的 ID 相匹配，这样“畅销商品”策略才能查找并显示该产品。此策略会忽略额外的商品字段（如价格、名称等）。只有 productId 和 quantity 会计入排名。该事件还需要包含 orderId，因为不含该字段的订单不会被计入。

订单发生变化时，请发送带有相同 orderId 和 items 的 PW_OrderUpdated。对于事件中的每个产品，新的 quantity 会替换之前的值，而不是与之累加。通过这种方式，产品的数量最低可以降到 1 件，但不能降到零：

• quantity 为 0 或以下： 该产品按售出 1 件计算。
• 产品未包含在 items 中： 该产品保留上一次包含它的事件中的数量。

例如，一位客户订购了某产品 2 件，随后全部退货。如果您发送 PW_OrderUpdated 并将该产品的 quantity 设为 0，“畅销商品”策略会为其计 1 件，而不是 2 件。如果您从 items 中移除该产品，它仍计为 2 件。没有任何事件可以将已退货或已取消的产品从“畅销商品”策略中移除。只有当订单超出 7 天或 30 天的时间窗口后，它才会停止计数。

已付款的 Shopify 订单已自动计入

如果您使用 Shopify 集成：

• 每笔已付款订单都会以 PW_OrderCreated 的形式到达，其中 orderId 为 Shopify 订单 ID，items 携带 productId 和 quantity。已付款订单会计入“畅销商品”策略，您无需进行任何额外操作。
• productId 是 Shopify 产品 ID，与从 Shopify 导入目录时目录使用的 ID 相同。
• 该集成不会发送 PW_OrderUpdated，因此“畅销商品”策略会按原始订单中的数量计数，不会反映后续的编辑、退款或取消。

将数量作为数字发送

请为 quantity 使用真实的 JSON 数字，而不是带引号的字符串。Pushwoosh 仅以首次声明或推断的类型存储每个属性值；类型不匹配的值将被静默丢弃，而 postEvent 仍会返回成功。关于 PW_AbandonedCart 的相同警告，请参阅使用正确的属性类型。

畅销商品策略专门根据订单历史进行排名，浏览和购物车活动不计入在内。如果需要一个包含浏览和购物车活动的排名，请改用根据浏览记录或组合购买。

根据浏览记录和组合购买：跟踪产品活动

这两种策略都基于相同的信号构建：携带产品 ID 的事件。您不需要专门的“产品已浏览”事件名称——任何通过 postEvent 发送的自定义事件都会被计入，只要其 attributes 包含以下键之一：

• 单个产品，作为顶级属性：product_id、productId、productid、item_id 或 sku。
• 多个产品，作为一个 products 数组，其中每个项目都有 product_id、productId、id 或 sku。

例如，触发您现有的产品浏览事件，并附带一个产品 ID 属性：

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "ProductViewed",
    "attributes": {
      "product_id": "SKU-4821",
      "category": "Audio"
    },
    "userId": "shopper@example.com"
  }
}

根据浏览记录策略会推荐与每个购物者最近浏览过的产品相搭配的产品。其工作方式如下：

• Pushwoosh 会保留每个购物者最近发送过事件的 10 个产品，按从新到旧排列。只有带有上述产品 ID 键的事件才会将产品添加到此列表中，订单 items 不会。
• 该块会显示与这些最近产品配对的产品，所用的配对与组合购买相同（见下文）。订单会计入这些配对，因此发送带有 items 的 PW_OrderCreated 也能改善此策略，但这不是必需的。
• 购物者最近列表中已有的产品不会显示。
• 在购物者最后一次产品事件的 30 天后，该列表会被清空。如果购物者没有最近产品，或者其中任何产品都还没有配对，该块会向其显示常规目录。

无需产品标签或其他设置。

提示

如果您使用 Shopify 集成，店面主题嵌入代码已在每次产品页面浏览时发送带有 productId 的 PW_ProductViewed 事件——您无需进行任何额外操作，只要 Push Init Embed 开关是打开的（默认为关闭）。请参阅店面浏览事件。

组合购买会显示购物者经常与某个给定产品一起选购的产品。例如，对于一部手机，该块可以显示其他手机购买者也浏览过或购买过的手机壳和充电器。与这两个产品都有互动的购物者越多，被推荐产品的排名就越高。

尽管名称如此，但并不要求必须购买。浏览、购物车事件和订单都会被计入。该策略会读取：

• 每个携带产品 ID 的事件，使用上面列出的键。
• PW_OrderCreated 和 PW_OrderUpdated 的 items 数组。其他事件的 items（包括 PW_AbandonedCart）不会被读取。

Pushwoosh 按以下方式对产品进行配对：

• 当同一用户在过去 30 天内针对两个产品都发送过事件时，这两个产品就构成一对。这些事件可以是分开的：产品不需要在同一个订单中。
• 配对在单个应用程序内计算。您账户中其他应用程序的活动不会被计入。
• 排名每天重新计算一次，因此新事件从第二天开始生效。

组合购买还需要一个额外的东西：一个产品标签，这是一个设备标签，用于保存要为其生成推荐的产品的 ID。 在产品块中配置策略时设置该字段的名称（例如 PW_LastViewedProductID），然后在每个设备上保持该标签的更新。例如，每当购物者查看产品时，将其设置为该产品的 ID。如果收件人设备上未设置该标签，该块将为他们回退到显示常规产品目录。

标签名称规则

标签名称只接受字母、数字、下划线和空格，因为它必须能在 Liquid 中被寻址。请参阅“组合购买”需要一个产品标签。

确认您的事件已送达

在添加该块之前，请检查 Pushwoosh 是否确实收到了上述事件：前往受众 → 事件，打开您发送的事件（PW_OrderCreated 或携带产品 ID 的自定义事件），并确认最近的命中记录已显示。请参阅事件统计。

注意

一个空的产品块可能意味着“事件从未到达”或“尚未积累足够的历史数据”（见上文说明）。事件统计可以帮助您在追查第二个原因之前排除第一个原因。

将该块添加到您的电子邮件中

将一个产品块添加到您的电子邮件内容中，将源设置为推荐，并选择一个策略。有关设置面板中每个字段的说明，请参阅获取推荐产品。在发送前，点击刷新预览以检查画布是否已填充真实产品。