发送概况数据

开发人员可以为客户设置两种方式将购物者资料属性发送给 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 需要这些用户标识符中的任何一个来识别批量上传中的购物者。

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

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

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

准备好购物者资料批量数据文件后，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 客户文档。