SendGrid 连接

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Destinations

创建对象：

Admin
User

概述 overview

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

此 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目标之前，您必须拥有架构， a 数据集、和区段创建于 Experience Platform. 另请参阅限制部分，进一步了解本页内容。

IMPORTANT

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

支持的身份 supported-identities

SendGrid支持激活下表中描述的标识。了解有关身份.

目标身份

描述

注意事项

电子邮件

电子邮件地址

请注意，支持纯文本和SHA256哈希电子邮件地址 Adobe Experience Platform. 如果Experience Platform源字段包含未哈希处理的属性，请检查 应用转换 选项，拥有 Platform 在激活时自动散列数据。

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

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

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

项目

类型

注释

导出类型

基于配置文件

您正在导出区段的所有成员，以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏），如目标激活工作流.

导出频率

流

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

用例 use-cases

为了帮助您更好地了解应该如何以及何时使用SendGrid目标，以下提供了一些示例用例， Experience Platform 客户可以通过使用此目标进行解析。

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

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

连接到目标 connect

IMPORTANT

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

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

验证目标 authenticate

在 Adobe Experience Platform 控制台，导航到目标.
选择目录选项卡和搜索 发送网格. 然后选择设置. 建立与目标连接后，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之间映射标识命名空间。请确保 源字段 电子邮件 应映射到 目标字段 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：
alternate_email

字符串数组

与联系人关联的其他电子邮件。

最大：5项
最小值： 0个项目

xdm：
homeAddress.city

xdm：
城市

字符串

联系人的城市。

最大长度：
60个字符

xdm：
homeAddress.country

xdm：
国家/地区

字符串

联系人所在的国家/地区。可以是全名或缩写。

最大长度：
50个字符

identitymap：
电子邮件

标识：
external_id

字符串

联系人的主电子邮件。这必须是有效的电子邮件。

最大长度：
254个字符

xdm：
person.name.firstname

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 用于在SendGrid中创建唯一的联系人列表，方法是 list_name 属性和数据导出的时间戳。导航到SendGrid站点，并检查是否创建了符合名称模式的新联系人列表。
选择新创建的联系人列表，并检查新联系人列表中是否正在填充来自您创建的数据集的新电子邮件记录。
此外，还检查一些电子邮件以验证字段映射是否正确。