batchnz / hub-spot-ecommerce-bridge
使用 HubSpot Ecommerce Bridge 同步 Craft Commerce 的数据
Requires
- ext-json: *
- craftcms/cms: ^4.0.0
- craftcms/commerce: ^4.0.0
- hubspot/api-client: ^9.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-17 03:31:49 UTC
README
使用 HubSpot Ecommerce Bridge 在 Craft Commerce 和 HubSpot 之间同步数据
要求
此插件需要 Craft CMS 4.0.0 或更高版本以及 Craft Commerce 4.0.0 或更高版本。
还需要一个 Hubspot 账户以及创建其私有应用的能力。
安装
要安装此插件,请按照以下说明操作。
-
打开您的终端并转到您的 Craft 项目
cd /path/to/project
-
然后让 Composer 加载插件
composer require batchnz/hub-spot-ecommerce-bridge
-
在控制面板中,转到设置 → 插件,并点击 HubSpot Commerce 的“安装”按钮。
HubSpot Commerce 概述
Hubspot Commerce 会自动将 Craft 中的所有商业相关数据同步到 Hubspot。同步的模型包括
配置 HubSpot Commerce
私有应用
- 在 Hubspot 中创建一个私有应用,并确保为其提供以下作用域
- e-commerce
- crm.objects.contacts.read
- crm.objects.contacts.write
- crm.schemas.custom.read
- crm.schemas.contacts.read
- crm.objects.deals.read
- crm.objects.deals.write
- crm.schemas.contacts.write
- crm.schemas.deals.read
- crm.schemas.deals.write
- crm.objects.line_items.read
- crm.objects.line_items.write
- crm.schemas.line_items.read
- 导航到 cp 中的
Hubspot Commerce -> 设置
,并输入您创建的私有应用的访问令牌,然后点击保存。注意:您需要管理员权限才能访问此设置部分。还建议将其存储为 ENV 变量。
映射
您可以为 Craft Commerce 字段配置将映射到哪个 Hubspot 属性。转到 cp 中的 Hubspot Commerce -> 映射
,并配置每个 Craft Commerce 字段将映射到哪个 Hubspot 属性。
重要:您为映射配置的属性必须在 HUBSPOT 中存在给定对象类型(订单、产品等)。
地址
Craft 4 改变了用户地址的工作方式。
如果您想将客户地址信息同步到 Hubspot,请确保您遵循 Commerce 升级指南 和 Craft 设置指南,并在您的网站上配置所有地址相关配置。
使用 HubSpot Commerce
同步将自动进行。
同步项可以在 Craft 的队列中进行监控。
您还可以手动同步特定类型在特定日期范围内的数据。您可以通过转到控制面板中的 Hubspot Commerce -> 手动同步
来执行此操作并运行任何可用的同步。