发送概况数据

开发人员可以为客户设置两种方式将购物者资料属性发送给 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。

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