SendGrid连接

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
目标

创建对象：

管理员
用户

概述 overview

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

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

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

先决条件 prerequisites

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

您需要具有SendGrid帐户。
- 转到SendGrid 注册页面以注册并创建SendGrid帐户（如果尚未注册）。
登录到SendGrid门户后，您还需要生成API令牌。
导航到SendGrid网站并访问 Settings > API Keys 页面。或者，请参阅SendGrid文档以访问SendGrid应用程序中的相应部分。
最后，选择 Create API Key 按钮。
- 如果需要有关要执行哪些操作的指导，请参阅SendGrid文档。
- 如果要以编程方式生成API密钥，请参阅SendGrid文档。

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

IMPORTANT

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

支持的身份 supported-identities

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

目标身份

描述

注意事项

电子邮件

电子邮件地址

请注意，Adobe Experience Platform支持纯文本和SHA256哈希电子邮件地址。如果Experience Platform源字段包含未哈希处理的属性，请选中 应用转换 选项，以便在激活时让Platform自动对数据进行哈希处理。

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

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

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

项目

类型

注释

导出类型

基于配置文件

您正在导出区段的所有成员，以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏），如目标激活工作流的选择配置文件属性屏幕中所选。

导出频率

正在流式传输

流目标为基于API的“始终运行”连接。一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。阅读有关流式目标的更多信息。

用例 use-cases

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

为多个营销活动创建营销列表

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

连接到目标 connect

IMPORTANT

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

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

验证目标 authenticate

在Adobe Experience Platform控制台中，导航到目标。
选择目录选项卡并搜索 SendGrid。然后选择设置。建立与目标之间的连接后，UI标签将更改为 激活区段。
此时将显示一个向导，可帮助您配置SendGrid目标。通过选择 配置新目标 来创建新目标。
选择 新帐户 选项并填写 持有者令牌 值。此值是以前在先决条件部分中提到的SendGrid API密钥。
选择 连接到目标。如果您提供的SendGrid API密钥 有效，则UI显示带有绿色复选标记的 已连接 状态，然后您可以继续下一步以填写其他信息字段。

填写目标详细信息 destination-details

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

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

启用警报 enable-alerts

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

完成提供目标连接的详细信息后，选择 下一步。

激活此目标的受众 activate

IMPORTANT

若要激活数据，您需要 查看目标、激活目标、查看配置文件 和 查看区段 访问控制权限。阅读访问控制概述或联系您的产品管理员以获取所需的权限。
要导出标识，您需要 查看标识图形 访问控制权限。

{width="100" modal="regular"}

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

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

选择一个或多个要导出到SendGrid的受众。
在映射步骤中，选择 添加新映射 后，将显示映射页面，以将源XDM字段映射到SendGrid API目标字段。下图演示了如何在Experience Platform和SendGrid之间映射标识命名空间。请确保 Source字段 电子邮件 应映射到 目标字段 external_id，如下所示。
同样，将所需的要导出的Adobe Experience Platform属性映射到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

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

选择目标 > 浏览以导航到目标列表。
选择目标并验证状态为 已启用。
切换到 Activation data 选项卡，然后选择受众名称。
监测受众摘要，并检查与数据集内创建的计数对应的用户档案计数。
SendGrid营销列表>创建列表API用于通过联接 list_name 属性的值和数据导出的时间戳，在SendGrid中创建唯一的联系人列表。导航到SendGrid站点，并检查是否创建了符合名称模式的新联系人列表。
选择新创建的联系人列表，并检查新联系人列表中是否正在填充来自您创建的数据集的新电子邮件记录。
此外，还检查一些电子邮件以验证字段映射是否正确。