batchnz/hub-spot-ecommerce-bridge

使用 HubSpot Ecommerce Bridge 同步 Craft Commerce 的数据

2.2.3 2023-08-20 23:32 UTC

README

使用 HubSpot Ecommerce Bridge 在 Craft Commerce 和 HubSpot 之间同步数据

要求

此插件需要 Craft CMS 4.0.0 或更高版本以及 Craft Commerce 4.0.0 或更高版本。

还需要一个 Hubspot 账户以及创建其私有应用的能力。

安装

要安装此插件,请按照以下说明操作。

  1. 打开您的终端并转到您的 Craft 项目

     cd /path/to/project
    
  2. 然后让 Composer 加载插件

     composer require batchnz/hub-spot-ecommerce-bridge
    
  3. 在控制面板中,转到设置 → 插件,并点击 HubSpot Commerce 的“安装”按钮。

HubSpot Commerce 概述

Hubspot Commerce 会自动将 Craft 中的所有商业相关数据同步到 Hubspot。同步的模型包括

配置 HubSpot Commerce

私有应用

  1. 在 Hubspot 中创建一个私有应用,并确保为其提供以下作用域
    1. e-commerce
    2. crm.objects.contacts.read
    3. crm.objects.contacts.write
    4. crm.schemas.custom.read
    5. crm.schemas.contacts.read
    6. crm.objects.deals.read
    7. crm.objects.deals.write
    8. crm.schemas.contacts.write
    9. crm.schemas.deals.read
    10. crm.schemas.deals.write
    11. crm.objects.line_items.read
    12. crm.objects.line_items.write
    13. crm.schemas.line_items.read
  2. 导航到 cp 中的 Hubspot Commerce -> 设置,并输入您创建的私有应用的访问令牌,然后点击保存。注意:您需要管理员权限才能访问此设置部分。还建议将其存储为 ENV 变量。

映射

您可以为 Craft Commerce 字段配置将映射到哪个 Hubspot 属性。转到 cp 中的 Hubspot Commerce -> 映射,并配置每个 Craft Commerce 字段将映射到哪个 Hubspot 属性。

重要:您为映射配置的属性必须在 HUBSPOT 中存在给定对象类型(订单、产品等)。

地址

Craft 4 改变了用户地址的工作方式。

如果您想将客户地址信息同步到 Hubspot,请确保您遵循 Commerce 升级指南Craft 设置指南,并在您的网站上配置所有地址相关配置。

使用 HubSpot Commerce

同步将自动进行。

同步项可以在 Craft 的队列中进行监控。

您还可以手动同步特定类型在特定日期范围内的数据。您可以通过转到控制面板中的 Hubspot Commerce -> 手动同步 来执行此操作并运行任何可用的同步。