文档Experience Platform目标指南

SendGrid连接

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 用户

概述 overview

SendGrid是用于交易和营销电子邮件的常用客户通信平台。

此Adobe Experience Platform 目标利用SendGrid Marketing Contacts API导出您的第一方电子邮件配置文件，并在新的SendGrid受众中激活它们，以满足您的业务需求。

SendGrid使用API持有者令牌作为与SendGrid API通信的身份验证机制。

先决条件 prerequisites

在开始配置目标之前，需要以下项目。

  1. 您需要具有SendGrid帐户。

    • 转到SendGrid 注册页面以注册并创建SendGrid帐户（如果尚未注册）。

  2. 登录到SendGrid门户后，您还需要生成API令牌。

  3. 导航到SendGrid网站并访问​Settings > API Keys​页面。 或者，请参阅SendGrid文档以访问SendGrid应用程序中的相应部分。

  4. 最后，选择​ Create API Key ​按钮。

    • 如果需要有关要执行哪些操作的指导，请参阅SendGrid文档。
    • 如果要以编程方式生成API密钥，请参阅SendGrid文档。

SendGrid API密钥设置页面显示“创建API密钥”按钮。

在将数据激活到SendGrid目标之前，您必须在中创建架构、数据集和区段Experience Platform。 另请参阅此页面下面的限制部分。

IMPORTANT

  • 用于从电子邮件配置文件创建邮件列表的SendGrid API要求在每个配置文件中提供唯一的电子邮件地址。 这与其是否用作​ 电子邮件 ​或​ 备用电子邮件 ​的值无关。 由于SendGrid连接支持电子邮件和备用电子邮件值的映射，因此请确保在​ 数据集 ​的每个配置文件中使用的所有电子邮件地址都应是唯一的。 否则，在将电子邮件配置文件发送到SendGrid时，这将导致错误，并且数据导出中不会出现该电子邮件配置文件。

  • 目前，从Experience Platform中的受众删除配置文件时，没有相应的功能可从SendGrid中删除这些配置文件。

支持的身份 supported-identities

SendGrid支持激活下表中描述的标识。 了解有关标识的更多信息。

目标身份
描述
注意事项
电子邮件
电子邮件地址
请注意，Adobe Experience Platform支持纯文本和SHA256哈希电子邮件地址。 如果Experience Platform源字段包含未哈希处理的属性，请选中​ Apply transformation ​选项，以便在激活时让Experience Platform自动对数据进行哈希处理。

请注意，SendGrid​不支持经过哈希处理的电子邮件地址，因此只会将未经转换的纯文本数据发送到目标。

支持的受众 supported-audiences

此部分介绍哪些类型的受众可以导出到此目标。

受众来源
受支持
描述
Segmentation Service
是
通过Experience Platform 分段服务生成的受众。
所有其他受众来源
否

此类别包括通过Segmentation Service生成的受众之外的所有受众来源。 了解各种受众源。 一些示例包括：

  • 自定义上传受众从CSV文件导入到Experience Platform，
  • 相似的受众，
  • 联合受众，
  • 其他Experience Platform应用程序（如Adobe Journey Optimizer）中生成的受众，
  • 等等。

按受众数据类型划分的受众支持：

受众数据类型
受支持
描述
用例
人员受众
是
根据客户个人资料，允许您针对特定的营销活动人群组进行定位。
频繁购买者，购物车放弃者
帐户受众
否
针对特定组织内的个人，制定基于帐户的营销策略。
B2B营销
潜在客户受众
否
定位尚未成为客户但与目标受众具有共同特征的个人。
利用第三方数据发现潜在客户
数据集导出
否
存储在Adobe Experience Platform数据湖中的结构化数据的集合。
报告、数据科学工作流

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息，请参阅下表。

项目
类型
注释
导出类型
Profile-based
您正在导出区段的所有成员，以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏），如目标激活工作流的选择配置文件属性屏幕中所选。
导出频率
Streaming
流目标为基于API的“始终运行”连接。 根据受众评估在Experience Platform中更新用户档案后，连接器会立即将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

用例 use-cases

为了帮助您更好地了解应如何以及何时使用SendGrid目标，以下是Experience Platform客户可以通过使用此目标解决的示例用例。

为多个营销活动创建营销列表 create-marketing-list

使用SendGrid的营销团队可以在SendGrid中创建邮件列表，并使用电子邮件地址填充该列表。 现在，在SendGrid内创建的邮件列表随后可用于多个营销活动。

连接到目标 connect

IMPORTANT
若要连接到目标，您需要​ View Destinations ​和​Manage Destinations 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。

要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。

验证目标 authenticate

  1. 在Adobe Experience Platform控制台中，导航到​目标。

  2. 选择​ 目录 ​选项卡并搜索​SendGrid。 然后选择​设置。 建立与目标之间的连接后，UI标签将更改为​激活区段。
    在Experience Platform目标目录中的 SendGrid目标卡片，其中的“设置”按钮突出显示。

  3. 此时将显示一个向导，可帮助您配置SendGrid目标。 通过选择​ 配置新目标 ​来创建新目标。
    SendGrid目标安装向导，显示“配置新目标”选项。

  4. 选择​ 新帐户 ​选项并填写​ 持有者令牌 ​值。 此值是以前在​ 先决条件部分 ​中提到的SendGrid API密钥。
    SendGrid身份验证屏幕，显示“新建帐户”选项和“持有者令牌”字段。

  5. 选择​连接到目标。 如果您提供的SendGrid API密钥​有效，则UI显示带有绿色复选标记的​ 已连接 ​状态，然后您可以继续下一步以填写其他信息字段。

SendGrid目标在成功验证后显示“已连接”状态并带有绿色复选标记。

填写目标详细信息 destination-details

在设置此目标时，必须提供以下信息：

  • Name：将来用于识别此目标的名称。
  • Description：一个可选描述，可帮助您以后识别此目标。

显示“名称”和“说明”字段的SendGrid目标详细信息表单。

启用警报 enable-alerts

您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。

完成提供目标连接的详细信息后，选择​Next。

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据，您需要​View Destinations、Activate Destinations、View Profiles​和​View Segments 访问控制权限。 阅读访问控制概述或联系您的产品管理员以获取所需的权限。
  • 要导出​标识，您需要​View Identity Graph 访问控制权限。
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。

有关特定于该目标的详细信息，请参阅以下图像。

  1. 选择一个或多个要导出到SendGrid的受众。
    受众选择屏幕，显示已选择导出到SendGrid的一个或多个受众。

  2. 在​ Mapping ​步骤中，选择​ Add new mapping ​后，将显示映射页面，以将源XDM字段映射到SendGrid API目标字段。 下图演示了如何在Experience Platform和SendGrid之间映射身份命名空间。 确保​Source field 电子邮件​应映射到​Target field external_id，如下所示。
    映射步骤显示在SendGrid激活工作流中选择的“添加新映射”选项。
    映射屏幕显示映射到SendGrid中external_id目标字段的电子邮件源字段。
    映射屏幕，显示选定用于映射到SendGrid目标字段的XDM源属性。
    显示在Experience Platform和SendGrid之间配置的其他身份命名空间映射的映射屏幕。

  3. 同样，将所需的要导出的Adobe Experience Platform属性映射到SendGrid目标。
    映射屏幕，显示选定作为SendGrid导出的源字段的Experience Platform配置文件属性。
    映射屏幕显示Experience Platform XDM字段与SendGrid目标字段之间已完成的属性映射。

  4. 完成映射后，选择​ Next ​进入审阅屏幕。
    SendGrid激活查看屏幕，显示完成安装之前配置的映射摘要。

  5. 选择​ Finish ​以完成设置。
    显示“完成”按钮的SendGrid激活工作流完成屏幕。

可以为SendGrid营销联系人>添加或更新联系人API设置的受支持属性映射的完整列表如下。

源字段
目标字段
类型
描述
限制
xdm：
homeAddress.street1
xdm：
address_line_1
字符串
地址的第一行。
最大长度：
100个字符
xdm：
homeAddress.street2
xdm：
address_line_2
字符串
地址的可选第二行。
最大长度：
100个字符
xdm：
_extconndev.alternate_emails
xdm：
备用电子邮件
字符串数组
与联系人关联的其他电子邮件。
  • 最大：5项
  • 最小值： 0个项目
xdm：
homeAddress.city
xdm：
城市
字符串
联系人的城市。
最大长度：
60个字符
xdm：
homeAddress.country
xdm：
国家/地区
字符串
联系人所在的国家/地区。 可以是全名或缩写。
最大长度：
50个字符
identityMap：
电子邮件
标识：
external_id
字符串
联系人的主电子邮件。 这必须是有效的电子邮件。
最大长度：
254个字符
xdm：
人员。姓名。名字
xdm：
名字
字符串
联系人的姓名
最大长度：
50个字符
xdm：
person.name.lastName
xdm：
last_name
字符串
联系人的姓氏
最大长度：
50个字符
xdm：
homeAddress.postalCode
xdm：
postal_code
字符串
联系人的邮政编码。
xdm：
homeAddress.stateProvidle
xdm：
state_providle_region
字符串
联系人的省/市/自治区或地区。
最大长度：
50个字符

验证SendGrid中的数据导出 validate

要验证您是否正确设置了目标，请执行以下步骤：

  1. 选择​Destinations > Browse​以导航到目标列表。
    Experience Platform中的“目标浏览”选项卡显示已配置目标的列表。

  2. 选择目标并验证状态为​enabled。
    “浏览”选项卡中的 SendGrid目标显示已启用状态。

  3. 切换到​ Activation data ​选项卡，然后选择受众名称。
    SendGrid目标的“激活数据”选项卡，其中显示了选定的受众名称。

  4. 监测受众摘要，并检查与数据集内创建的计数对应的用户档案计数。
    显示所选SendGrid受众配置文件计数的“受众摘要”面板。

  5. SendGrid营销列表>创建列表API通过联接​ list_name 属性的值和数据导出的时间戳，在SendGrid中创建唯一的联系人列表。 导航到SendGrid站点，并检查是否创建了符合名称模式的新联系人列表。
    SendGrid营销列表页面，该页面显示符合预期名称模式的新创建联系人列表。
    SendGrid联系人列表详细信息视图，用于确认使用正确的名称创建了新列表。

  6. 选择新创建的联系人列表，并检查新联系人列表中是否正在填充来自您创建的数据集的新电子邮件记录。

  7. 此外，还检查一些电子邮件以验证字段映射是否正确。
    SendGrid联系人详细信息视图，显示从导出的数据集填充的电子邮件记录字段。
    SendGrid联系人记录显示确认来自Experience Platform的正确字段映射的映射字段值。

数据使用和治理 data-usage-governance

在处理您的数据时，所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息，请参阅数据治理概述。

其他资源 additional-resources

此SendGrid目标利用以下API：

限制 limits

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6