安装 Omnisend for WooCommerce 插件，以同步您的店铺和 Omnisend 之间的联系人、产品和订单。您将自动处理废弃购物车（Abandoned Cart）挽回、订单确认和细分受众（Segmentation）– 无需手动设置。

本指南涵盖了 wordpress.org 和 wordpress.com 的安装。

如果您想在不使用 WooCommerce 的情况下使用 Omnisend for WordPress，请参阅 Omnisend for WordPress Plugin。

没有找到您需要的内容？在 WordPress 论坛 上发布帖子，并通过获取您需要的答案来支持社区。

在您开始之前

在连接 WooCommerce 之前，您必须创建一个新的空店铺。每个平台在 Omnisend 中都需要一个独立的品牌，以防止数据混合。

要创建新店铺：前往 Account Settings → Stores → Add New Store。创建后，返回 WordPress 并点击“Connect your account”以将 WooCommerce 连接到此新店铺。了解更多关于管理多个店铺的信息。

如果您在连接 WooCommerce 店铺之前没有使用过 Omnisend，并且您现在正在连接，请按照以下步骤操作。

WordPress 有两个版本：

wordpress.org – 自托管；您需要手动安装插件。
wordpress.com – 由 Automattic 托管；通过应用商店安装插件。

两者都与 Omnisend 兼容。请按照下方您版本对应的说明操作：wordpress.org 和 wordpress.com。

将 Omnisend 与 WooCommerce 集成

wordpress.org 的安装过程

步骤 1. 前往您的 WordPress 管理仪表盘 →插件 →Add New → 搜索Omnisend for WooCommerce → 点击立即安装

如果您是 WordPress 新用户，请阅读 管理插件。

⚠️ 选择 Omnisend 的 WooCommerce 电子邮件营销。通用 WordPress 插件缺少 WooCommerce 特定功能。

第 2 步。插件将在几秒钟内安装完成，并出现“Activate”按钮。点击该按钮以激活。Omnisend 的 WooCommerce 电子邮件营销插件。

第 3 步。激活后，页面顶部会出现一个横幅。点击连接您的店铺到 Omnisend

步骤 4. 您将进入连接页面。

有 Omnisend 账户？ 点击"Connect your account"。
首次使用 Omnisend？ 点击"Create new account"。

步骤 5. 如果您选择了“连接您的账户”并且有一个空的店铺已准备就绪，您将看到一个批准弹窗。点击批准

如果您选择了 "Create new account"，请先完成注册，然后批准。

⚠️ 如果您看到错误而不是“批准”弹窗，请前往疑难解答店铺连接。

第六步。 该插件向 Omnisend 发送验证请求，您的店铺已连接。您将进入Brand Assets 页面。

wordpress.com 的安装过程

步骤 1. 前往您的 WordPress 管理仪表盘 →插件 →Add New → 搜索Omnisend for WooCommerce → 选择它。

步骤 2. 点击安装并激活在插件市场中的 Omnisend 插件页面上。

步骤 3. 安装完成后，点击管理插件

第 4 步。您将进入连接页面。

有 Omnisend 账户？ 点击"Connect your account"。
刚接触 Omnisend？ 点击"Create new account"。

步骤 5. 如果您选择了“连接您的账户”并且有一个空的店铺已准备就绪，您将看到一个批准弹窗。点击批准。

如果您选择了 "Create new account"，请先完成注册，然后批准。

⚠️ 如果您看到错误而不是批准弹窗，请前往排查店铺连接问题。

第六步。插件向 Omnisend 发送验证请求，您的店铺已连接。您将进入品牌资产 page.

⚠️如果您的店铺连接遇到任何问题，请前往故障排除部分。

WooCommerce 插件优势

将 WooCommerce 连接到 Omnisend 后，您将获得以下功能：

渠道：电子邮件（Email）、短信（SMS）、Facebook Custom Audience、Google Customer Match。
注册表单：幸运大转盘、弹窗、落地页等
Automations: 欢迎邮件, 废弃购物车（Abandoned Cart）, 订单确认, 等。
扩展的细分受众（Segmentation）结合丰富数据。
完整的营销活动、表单、自动化和送达率（Deliverability）报告。
Live View – 网站追踪

💡 Omnisend WooCommerce 插件包含所有标准 Omnisend 功能。需要自定义工作流程吗？使用 Omnisend API 来传递额外数据。

多站点支持

Omnisend 与 WordPress Multisite 安装完全兼容（插件版本 1.16.0 及更高版本）。

您可以在单个多站点设置下连接和管理多个 WooCommerce 店铺，无需在每个站点上单独手动安装 Omnisend。

这适用于您的多站点配置方式为子域名（例如，store1.example.com）或子目录（例如，example.com/store1）。适用于寻求集中管理和简化集成的代理机构或多品牌卖家。

添加插件权限

允许 WooCommerce 插件权限，以便集成顺利运行。

步骤 1. 前往您的 WordPress 管理面板并打开 Omnisend 插件页面。

步骤 2. 如有需要，请将 Omnisend 插件更新到最新版本。

步骤 3. 点击添加权限

第四步。点击在 WooCommerce 同意许可窗口中同意。

更新插件后：

如果您更新了 Omnisend 插件，但仍然看到连接横幅或红色警告：

等待 5–10 分钟让更改生效。
清除您的浏览器缓存并刷新页面。
如果横幅持续显示，请查看店铺连接故障排除。

如果您没有看到“Add permissions”按钮，请前往 WooCommerce → Settings → Advanced → REST API → 选择 Omnisend 密钥 → 撤销。然后按照上述步骤操作；按钮就会出现。

数据同步

连接 WooCommerce 后，Omnisend 会同步您店铺中的所有历史数据：联系人、产品和订单。初始同步最多可能需要 24 小时。之后，新数据立即同步。

同步如何工作：

联系人与订单：通过 Omnisend API 同步（截至 2026 年 3 月 16 日）。
产品：通过 WooCommerce 插件同步。

数据类型	联系人	购物车/结账	订单	产品	产品类别
时间线	即时	即时	即时	即时	即时

⚠️ 保持您的插件更新：最新插件版本通过 Omnisend API 同步联系人。如果您正在使用旧版 plugin，plugin 和 API 将同时同步联系人（双重同步负载），这可能会减慢您的店铺速度。更新到最新插件版本以确保最佳性能

💡 默认情况下，结账邮件同步为未订阅状态。要收集订阅者，请启用下方的选择加入复选框。

结账时的电子邮件选择加入

前往 Omnisend Plugin 并勾选 添加一个选择加入复选框到结账页面。您可以自定义同意许可文本，并根据需要预选复选框。

启用后，在结账时勾选复选框的客户将作为电子邮件订阅者同步到 Omnisend。

结账时短信（SMS）选择加入

前往 Omnisend 插件，并勾选添加一个短信（SMS）选择加入复选框到结账页面。根据需要自定义同意许可文本。

在结账时勾选该复选框的客户将同步到 Omnisend，成为短信（SMS）订阅者。

WooCommerce 8.3+ (新结账 Blocks):
对于 WooCommerce 8.3 及更高版本，Omnisend 会自动检测新的结账区块，并将复选框放置在电子邮件字段下方。经典结账和区块结账均受支持。

适用于不同 WooCommerce 版本的结账体验	结账预览
WooCommerce 8.2 及更低版本 (经典结账体验)
WooCommerce 8.3 及更高版本（对于新结账 (8.3+)，复选框将显示在电子邮件字段正下方）

同步状态与重新同步选项

在插件页面上，您会看到一个同步状态表，其中显示联系人、产品和订单的成功、错误、待处理或已跳过状态。

自助操作：

重新同步 – 重试失败的同步。
Resync all contacts – 在账户发生重大更改后使用（例如，永久删除联系人）。

💡 请确保启用 Omnisend 注册表单，并考虑 其他选择加入方式，以便您的客户触发条件（Trigger）您的自动化邮件（自动化流程（Automation））。

联系人属性优先级：

请注意，在同步联系人信息时，Omnisend 遵循基于优先级的方法来映射 first_name 和 last_name 属性：

优先级 1: 我们首先检查 WordPress User first_name 字段。

优先级 2：如果缺少 first_name，我们考虑 shipping_first_name。

优先级 3：如果仍然不可用，我们查看 billing_first_name 作为 first_name。

属性	优先级 1	优先级 2	优先级 3
first_name	WordPress 用户 `first_name`	WordPress 用户 `shipping_first_name`	WordPress 用户 `billing_first_name`
last_name	WordPress 用户 `last_name`	WordPress 用户 `shipping_last_name`	WordPress 用户 `billing_last_name`

自动化流程（Automation）工作流程的订单状态映射

Omnisend 不会取代您在 WooCommerce 店铺中设置的任何自动回复。

Omnisend 不会取代 WooCommerce 的自动回复。如果您想替换它们，禁用 WooCommerce 订单确认邮件 并启用 Omnisend 中相应的自动化。

WooCommerce 和 Omnisend 使用不同的订单状态逻辑。请参阅下表了解映射关系：

使用 WordPress 筛选器挂钩自定义 Omnisend

在 WordPress 中，筛选器挂钩是一种挂钩，允许开发者在数据显示或处理之前修改数据。它们提供了一种更改 WordPress 功能的方式，无需直接修改核心文件，使自定义更简单，更新更安全。

筛选器挂钩如何工作？

Filter hooks 使用 apply_filters() 函数，该函数允许开发者在数据返回之前修改或扩展数据。开发者使用 add_filter() 将自定义函数附加到特定的筛选器挂钩，这使他们能够动态更改内容。

由 Omnisend 提供的筛选器挂钩

omnisend_contact_data

允许在将联系人数据发送到 Omnisend 之前进行自定义（可在我们的 API 文档中找到可用属性）。

add_filter( 'omnisend_contact_data', 'example_modify_omnisend_contact_data', 10, 2 );
function example_modify_omnisend_contact_data( $omnisend_contact, $wordpress_user ) {
    if ( str_ends_with( $wordpress_user->user_email, '@gmail.com' ) ) {
        array_push( $omnisend_contact['tags'], 'gmail_users' );
    }

    return $omnisend_contact;
}

omnisend_cart_line_item

允许自定义作为添加产品到购物车和开始结账事件一部分发送到 Omnisend 的每个购物车商品行项目

add_filter( 'omnisend_cart_line_item', 'example_modify_omnisend_cart_line_item', 10, 2 );
function example_modify_omnisend_cart_line_item( $omnisend_cart_line_item, $woocommerce_cart_item ) {
    $omnisend_cart_line_item['special_product_category'] = $woocommerce_cart_item['special_product_category'];

    return $omnisend_cart_line_item;
}

omnisend_cart_checkout_url_item

允许向购物车商品添加额外属性，这些属性被编码到 `checkout_url` 属性中，用于添加产品到购物车和开始结账事件中的购物车找回。这些附加属性在购物车恢复期间自动传递给 WooCommerce。


add_filter( 'omnisend_cart_checkout_url_item', 'example_modify_omnisend_cart_checkout_url_item', 10, 2 );
function example_modify_omnisend_cart_checkout_url_item( $omnisend_cart_checkout_url_item, $woocommerce_cart_item ) {
    $omnisend_cart_checkout_url_item['special_product_category'] = $woocommerce_cart_item['special_product_category'];

    return $omnisend_cart_checkout_url_item;
}

omnisend_recover_cart_item_data

允许对在购物车恢复期间传递给 WooCommerce 的购物车商品数据进行额外自定义。

add_filter( 'omnisend_recover_cart_item_data', 'example_modify_omnisend_recover_cart_item_data', 10, 2 );
function example_modify_omnisend_recover_cart_item_data( $woocommerce_cart_item_data, $omnisend_cart_item ) {
    $woocommerce_cart_item_data['source'] = 'recovered_during_cart_recovery';

    return $woocommerce_cart_item_data;
}

常见问题

如需更多故障排除案例，请参阅排查 WooCommerce (WordPress) 连接问题。

什么是“空店铺”以及我为什么需要它？

一个空的店铺是您的 Omnisend 账户中的一个新店铺。如果您已连接一个店铺（如 Shopify），则必须为 WooCommerce 添加第二个店铺。前往 Profile → 店铺 → 添加新店铺。

我看到 "Store Already Connected"，但我从未连接过。为什么？
这通常意味着另一个店铺（或一个具有相同域名的测试站点）已连接。在 Omnisend 中创建一个新店铺，切换到该店铺，然后再次尝试连接。

如果我已连接 Shopify，我需要创建新的店铺吗？
是的。每个平台 (Shopify、WooCommerce 等) 必须连接到您的 Omnisend 账户中的一个单独的店铺，以防止数据混淆。前往 Account Settings → Stores → Add New Store，然后将 WooCommerce 连接到此新店铺。

“Approve”按钮没有出现。我该怎么办？
A: 前往 WooCommerce → Settings → Advanced → REST API → 找到 Omnisend 密钥 → 撤销它。然后重新安装插件，再试一次。

为什么我会在点击 "Approve" 后被重定向回 "Connect your account"？
此重定向循环通常发生在缓存插件、安全插件（如 Wordfence）或 WP Crontrol 干扰时。暂时禁用这些插件，清除您的浏览器缓存，并在无痕窗口中重试。

我已禁用所有插件但仍然无法连接。出了什么问题？
请检查以下内容：

验证您的域名是否具有有效的 SSL 证书 (HTTPS)。
WordPress 必须安装在域名根目录（而不是 example.com/store）。
您的服务器可能正在剥离授权标头。请联系您的主机服务商，将此添加到 .htaccess：SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

哪些插件通常会阻止 Omnisend？
WP Crontrol, LiteSpeed Cache, Really Simple Security, Perfmatters, 和一些 Cloudflare 设置。在故障排除时，请首先禁用这些插件。

如何在 Wordfence 中将 Omnisend 列入白名单？
前往 Wordfence → Firewall → “Allowlisted IP addresses” → 添加下面列出的 IP → Save。

34.170.162.11;

34.56.62.59;

34.56.108.215;

34.133.59.36;

34.58.66.146;

35.184.130.5;

35.232.14.89。

连接之前正常，但突然停止了。发生了什么？
检查您的店铺 URL 是否更改（即使是细微的更改，例如添加www.)。另请验证最近的插件更新没有中断连接。尝试重新同步插件。

我如何连接暂存站点而不破坏我的实时店铺？
请确保您的暂存站点已将WP_ENVIRONMENT_TYPE 设置为“staging”wp-config.php。然后将暂存插件连接到 Omnisend 中一个单独的测试品牌。

“wp-json/omnisend-api/v1/connected returns false”是什么意思？
A: 这意味着 Omnisend 无法访问您的网站 API。检查您的防火墙，禁用缓存插件，并验证您的SSL证书是否有效。

插件已激活，但不同步数据。为什么？
首次同步最长需要 24 小时。请检查插件页面以获取同步状态。如果显示错误，点击“Resync”或禁用冲突插件。

您需要更新您的 WooCommerce 插件吗？
最新插件版本移除了插件中的联系人同步功能 – 联系人现在转而通过 Omnisend API 进行同步。如果您不更新，插件和 API 都会同步联系人，这会造成双重同步负载，可能会影响您的店铺性能。前往Plugins →WordPress 中的Updates进行更新。