安装 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 Admin 仪表盘 →Plugins → Add New → 搜索Omnisend for WooCommerce → 点击立即安装
如果您是 WordPress 新手，请阅读Managing Plugins。
⚠️ 选择 Email Marketing for WooCommerce by Omnisend。通用 WordPress 插件缺少 WooCommerce 特有的功能。
第 2 步。插件将在几秒钟内安装完成，并出现 'Activate' 按钮。点击该按钮即可激活。Omnisend WooCommerce 电子邮件（Email）营销插件。
第 3 步。 激活后，页面顶部会出现一个横幅。点击将您的店铺连接到 Omnisend。
第 4 步。 您将进入连接页面。
有 Omnisend 账户吗？ 点击连接您的账户。
是 Omnisend 新用户？ 点击创建新账户。
第 5 步。 如果您选择了“连接您的账户”并且已准备好一个空的店铺，您将看到一个批准弹窗。点击批准。
如果您选择了 "Create new account"，请先完成注册，然后再批准。
⚠️ 如果您看到错误而不是“批准”弹窗，请前往店铺连接问题排查。
步骤 6. 插件向 Omnisend 发送验证请求，您的店铺便会连接。您将跳转至Brand Assets 页面。
wordpress.com 的安装过程
第 1 步。 前往您的 WordPress Admin 仪表盘 →Plugins → Add New → 搜索Omnisend for WooCommerce → 选择它。
第 2 步。 点击在插件市场 (Plugin Marketplace) 的 Omnisend 插件页面上安装并激活。
步骤 3. 安装后，点击管理插件
第 4 步。您将进入连接页面。
您有 Omnisend 账户吗？ 点击连接您的账户。
刚接触 Omnisend？ 点击创建新账户。
第 5 步。 如果您选择了“连接您的账户”并且准备好了一个空店铺，您将看到一个批准弹窗。点击批准
如果您选择了 “Create new account”，请先完成注册，然后再批准。
⚠️ 如果您看到的是错误而不是“批准”弹窗，请前往店铺连接故障排除。
步骤 6. 插件向 Omnisend 发送验证请求，您的店铺即可连接。您将跳转至Brand Assets页面。
⚠️ 如果您的店铺连接出现任何问题， 请跳转至故障排除部分。
WooCommerce 插件优势
将 WooCommerce 连接到 Omnisend 后，您即可使用：
渠道：电子邮件（Email）、短信（SMS）、Facebook Custom Audience、Google Customer Match。
注册表单：Wheel of Fortune、Popups、落地页等。
自动化：欢迎邮件、废弃购物车（Abandoned Cart）、订单确认等。
利用丰富的数据扩展细分受众（Segmentation）。
营销活动、表单、自动化和送达率（Deliverability）的完整报告。
💡 Omnisend WooCommerce 插件包含所有 标准 Omnisend 功能。需要自定义工作流（Workflow）吗？使用 Omnisend API 传递额外数据。
多站点支持
Omnisend 完全兼容 WordPress Multisite 安装（插件版本 1.16.0 及以上）。
您可以在单个多站点设置下连接和管理多个 WooCommerce 店铺 - 无需在每个站点上手动单独安装 Omnisend。
无论您的多站点是通过 子域名（例如 store1.example.com） 还是 子目录（例如 example.com/store1） 进行配置，此功能都适用。非常适合寻求集中式管理和简化集成的代理机构或多品牌卖家。
添加插件权限
允许 WooCommerce 插件权限，以便集成顺利运行。
步骤 1. 前往您的 WordPress 管理面板并打开 Omnisend 插件页面。
第 2 步。 如果需要，请将 Omnisend 插件更新至最新版本。
第 3 步。 点击添加权限。
第 4 步。 点击在 WooCommerce 同意许可窗口中批准。
更新插件后：
如果您更新了 Omnisend 插件但仍然看到连接横幅或红色警告：
请等待 5–10 分钟，以便更改生效。
清除您的浏览器缓存并刷新页面。
如果横幅持续显示，请查看店铺连接问题排查。
如果您没有看到“Add permissions”按钮，请前往 WooCommerce → Settings → Advanced → REST API → select Omnisend key → Revoke。然后请按照上述步骤操作；按钮应该就会出现。
数据同步
连接 WooCommerce 后，Omnisend 会同步您店铺的所有历史数据：联系人、商品和订单。初始同步最多可能需要 24 小时。之后，素材会即时填充。
数据类型 | 联系人 | 购物车/结账 | 订单 | 产品 | 产品分类 |
时间线 | 立即 | 立即 | 立即 | 立即 | 立即 |
💡 默认情况下，结账邮件会同步为未订阅状态。若要收集订阅者，请启用下方的选择加入复选框。
结账时电子邮件（Email）订阅
前往 Omnisend 插件并勾选在结账页面添加订阅复选框。您可以自定义同意许可文本，并根据需要预先选中复选框。
启用后，在结账时勾选复选框的客户将同步到 Omnisend，成为 电子邮件（Email）订阅者。
结账时订阅短信（SMS）
前往 Omnisend 插件并勾选在结账页面添加短信（SMS）订阅复选框。根据需要自定义同意许可文本。
在结账时勾选复选框的客户将作为 短信（SMS）订阅者 同步到 Omnisend。
WooCommerce 8.3+ (新结账区块):
对于 WooCommerce 8.3 及更高版本，Omnisend 会自动检测新的结账区块，并将复选框置于电子邮件（Email）字段下方。经典结账和区块结账均受支持。
不同 WooCommerce 版本的结账体验 | 结账预览 |
WooCommerce 8.2 及更低版本
(经典结账 体验) | 
|
WooCommerce 8.3 及更高版本
（对于新结账 (8.3+)，复选框将显示在电子邮件（Email）字段的正下方） | 
|
同步状态与重新同步选项
在插件页面上，您会看到一个同步状态表，其中显示了联系人、产品和订单的成功、错误、待处理或已跳过状态。
自助操作：
重新同步 – 重试失败的同步。
重新同步所有联系人 – 在账户发生重大变更（例如，永久删除联系人）后使用。
💡 请确保启用 Omnisend 注册表单，并考虑其他选择加入方式，从而让客户触发条件（Trigger）您的自动化邮件（自动化流程（Automation））。
联系人属性优先级：
请注意，在同步联系人信息时，Omnisend 会遵循基于优先级的方法来映射 first_name 和 last_name 属性：
优先级 1：首先检查 WordPress User first_name 字段。
优先级 2：如果 first_name 缺失，则会考虑 shipping_first_name。
优先级 3：如果仍然无法获取，Omnisend 将查看 billing_first_name 以获取 first_name。
属性 | 优先级 1 | 优先级 2 | 优先级 3 |
名字 | WordPress 用户 | WordPress 用户 | WordPress 用户 |
姓 | WordPress 用户 | WordPress 用户 | WordPress 用户 |
自动化流程（Automation）的订单状态映射
Omnisend 不会替换您 WooCommerce 店铺中的任何自动回复。
Omnisend 不会取代 WooCommerce 的自动回复。如果您想替换它们，禁用 WooCommerce 订单确认电子邮件并在 Omnisend 中启用相应的自动化。
WooCommerce 和 Omnisend 使用不同的订单状态逻辑。映射关系请见下表：
使用 WordPress Filter Hooks 自定义 Omnisend
在 WordPress 中，filter hooks 是一种钩子，允许开发者在数据显示或处理之前修改数据。它们提供了一种无需直接修改核心文件即可更改 WordPress 功能的方法，从而使自定义更轻松，更新更安全。
筛选器挂钩是如何工作的？
过滤器钩子使用 apply_filters() 函数，该函数允许开发者在数据返回前对其进行修改或扩展。开发者使用 add_filter() 将自定义函数附加到特定的过滤器钩子上，从而动态地更改内容。
Omnisend 提供的筛选器挂钩
omnisend_联系人_数据
允许在将联系人数据发送到 Omnisend 之前进行自定义（可在 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
允许向购物车商品添加额外属性，这些属性会编码到用于废弃购物车挽回的 added product to cart 和 started checkout 事件中的 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 → 店铺 → 添加新店铺。
我看到 “店铺已连接”，但我之前从未连接过。为什么？
这通常意味着另一个店铺（或具有相同域名的测试网站）已被关联。在 Omnisend 中创建新店铺 ，切换到该店铺，然后重试连接。
如果我已经连接了 Shopify，还需要创建新的店铺吗？
是每个平台（Shopify、WooCommerce 等）都必须连接到您 Omnisend 账户中的一个单独店铺，以防止数据混合。前往账户设置 → 店铺 → 添加新店铺，然后将 WooCommerce 连接到这个新店铺。
“Approve” 按钮不显示。我该怎么办？
A：前往 WooCommerce → Settings → Advanced → REST API → 找到 Omnisend 密钥 → 撤销它。然后重新安装插件，再试一次。
为什么点击 "Approve" 后，我会被重定向回 "连接您的账户"？
这种重定向循环通常发生在缓存插件、安全插件（例如 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.).另外，请核实最近的插件更新没有中断连接。请尝试重新同步插件。
我如何连接一个 staging 网站，而不会破坏我的线上店铺？
确保您的测试网站有WP_ENVIRONMENT_TYPE 在...中设置为 "staging"wp-config.php然后将暂存插件连接到 Omnisend 中一个单独的测试品牌。
"wp-json/omnisend-api/v1/connected returns false" 是什么意思？
A: 这意味着 Omnisend 无法访问您网站的 API。检查您的防火墙，禁用缓存插件，并验证您的SSL证书是否有效。
插件已激活，但无法同步数据。为什么？
初始同步最多需要24小时。在插件页面查看同步状态。如果显示错误，请点击 "Resync" 或禁用冲突的插件。
准备好更快地增长了吗？ 填写表格，即可匹配一位经过审查的 Omnisend 合作伙伴，帮助您增加收入 – 无需猜测。
如果您有任何疑问或需要帮助，请联系我们的支持团队，邮箱为 [email protected] 或通过应用内聊天。