发送概况数据

开发人员可以为客户设置两种方式将购物者资料属性发送给 Einstein：批量上传和实时活动跟踪。您可以使用任何一种方法（或同时使用两种方法）将购物者概况数据发送给 Einstein。

向 Einstein 提交数据时，请记住以下几点：

  • Salesforce 强烈建议您不要向 Einstein 发送指定的推荐用户标识符以外的个人身份信息 (PII)。
  • 所有收集的数据都在内部存储长达一年。一年后，数据会过期并从所有 Einstein 数据库中删除。要继续使用此概况数据，您必须将其重新发送给 Einstein。
  • 当 Einstein 收到现有购物者概况属性的新值时，新值将附加到现有值。
  • Einstein 使用提供的所有概况数据。新数据的价值与现有数据没有任何不同。

批量上传 

Salesforce 为客户提供了安全的批量上传端点，以上传他们收集的任何历史购物者概况数据。

批量上传选项适用于：

  • 您跟踪和收集的任何与购物者资料相关的数据。
  • 您希望 Einstein 用于增加购物者个性化的任何可信第三方数据。

授权 

批量上传数据会对 Einstein 数据产生重大影响。因此，我们只允许授权用户上传大量数据。此外，每个上传 API 调用都必须传递从 Account Manager 获取的所需授权标头（承载）访问令牌。

**注意：**要减少 Account Manager 服务器上的负载，请避免在当前令牌过期之前生成任何新令牌。有关批量上传 API 调用的更多信息，请参阅 API 规范。

准备批量上传数据 

要为 Einstein 使用准备批量上传数据，请确保以下内容：

  • 批量文件是一个 gzip 压缩的制表符分隔值 (TSV) 文件。
  • TSV 文件已正确格式化并使用 UTF-8 字符编码保存。
  • 文件的 mimetype 已正确设置以供 gzip 应用程序使用。
  • 标题行必须包含 login_id 标识字段、email_address 标识字段或两者。
  • 您可以为要发送的每个购物者概况属性添加其他列。
  • 值是字符串或字符串列表。对于字符串列表，请确保使用竖线 (|) 分隔符分隔值。例如，orange|yellow。
  • 空列将被忽略。当 Einstein 遇到空列时，它会跳过该列并继续处理剩余的用户属性数据。

批量上传用户标识符 

为了帮助为每个购物者生成相关的产品推荐，Profile Connector API 需要这些用户标识符中的任何一个来识别批量上传中的购物者。

字段描述
login_id购物者登录 ID。在某些情况下，这与 email_address 值相同。
email_address购物者的完整电子邮件地址。例如，shopper1@somewhere.com。

示例批量上传数据 

以下是使用随机列名的购物者概况批量上传 TSV 数据的示例：

login_idemail_address性别颜色brand_list
shopper1shopper1@somewhere.com男士橙色|黄色品牌 A|品牌 B
shopper2shopper2@somewhere.com女士蓝色|黑色品牌 D
shopper3shopper3@somewhere.com女士红色|黑色|蓝紫色品牌 B|品牌 E

购物者批量上传端点限制 

执行购物者资料批量上传时，请记住以下端点限制：

  • 您一次只能上传一个文件。但是，您可以一个接一个地上传多个文件。
  • 允许的最大文件大小为 2 GB。

将购物者资料批量数据上传到 Einstein 

准备好购物者资料批量数据文件后，gzip 压缩每个单独的文件并将其上传到 Einstein 的购物者概况批量上传端点。有关更多信息，请参阅发送批量概况端点。

实时活动跟踪 

使用活动 updateProfile 跟踪端点来调用和发送实时购物者概况数据更新和偏好。实时捕获购物者在您网店中提供的信息，使推荐能够立即反映这些变化。

实时活动跟踪选项适用于：

  • 实时捕捉购物者偏好活动。
  • 实时更新购物者资料。

为了帮助为每个购物者生成相关的产品推荐，Profile Connector API 提供了两个用户标识符，用于在实时跟踪中识别购物者。

  • cookieId（必需）- 匿名购物者的唯一标识符。通常，cookieId 是第一方 cookie 的值。
    • 从传统 Commerce Cloud 网店发出 API 请求时，传递 cqcid cookie 值以匹配传统网店上的自动活动跟踪。有关详细信息，请参阅基于浏览器的本地数据存储。
    • 使用 OCAPI 或 Salesforce Commerce API 时，使用访客登录响应中的 visit_id 值来匹配自动活动。有关详细信息，请参阅 OCAPI 客户文档。
  • userId（鼓励）- 登录购物者的唯一标识符。此参数使 Einstein 能够跨多个设备链接相同的登录用户。
    • 从传统 Commerce Cloud 网店发出 API 请求时，使用 cquid cookie 值以匹配传统网店上的自动活动跟踪。有关详细信息，请参阅基于浏览器的本地数据存储。
    • 使用 OCAPI 或 Salesforce Commerce API 时，使用注册登录响应中的 hashed_login 值来匹配自动活动。有关详细信息，请参阅 OCAPI 客户文档。

为避免潜在的恶意活动，用户标识符参数必须是非连续的。参数不应包括序列、模式、IP 地址、电子邮件地址、姓名或与特定人员相关的任何内容。所有用户标识符参数必须通过散列或其他方法遵守《通用数据保护条例》(GDPR)。

Note

入门指南
设置 Einstein Profile Connector
发送概况数据
配置概况数据
常见问题
设置 Einstein Recommendations