SendGrid 连接

上次更新： 2023-11-02
  • 创建对象：
  • Developer
    User
    Admin
    Leader

概述

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

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

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

先决条件

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

  1. 您需要具有SendGrid帐户。
    • 转到SendGrid 注册 注册和创建SendGrid帐户（如果尚未创建）的页面。
  2. 登录到SendGrid门户后，您还需要生成API令牌。
  3. 导航到SendGrid网站并访问 Settings > API Keys 页面。 或者，请参阅 SendGrid文档 以访问SendGrid应用程序中的相应部分。
  4. 最后，选择 Create API Key 按钮。

在将数据激活到SendGrid目标之前，您必须拥有 架构， a 数据集、和 区段 创建于 Experience Platform. 另请参阅 限制 部分，进一步了解本页内容。

重要

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

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

支持的身份

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

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

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

导出类型和频率

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

项目 类型 注释
导出类型 基于配置文件 您正在导出区段的所有成员，以及所需的架构字段（例如：电子邮件地址、电话号码、姓氏），如 目标激活工作流.
导出频率 流 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 详细了解 流目标.

用例

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

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

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

连接到目标

重要

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

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

验证目标

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

  2. 选择 目录 选项卡和搜索 发送网格. 然后选择 设置. 建立与目标连接后，UI标签将更改为 激活区段.

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

  4. 选择 新建帐户 选项，并填写 持有者令牌 值。 此值是SendGrid API密钥 之前在 “先决条件”部分.

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

填写目标详细信息

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

  • 名称：将来用于识别此目标的名称。
  • 描述：可帮助您将来识别此目标的可选描述。

启用警报

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

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

激活此目标的受众

重要

读取 将用户档案和受众激活到流式受众导出目标 有关将受众激活到此目标的说明。

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

  1. 选择一个或多个要导出到SendGrid的受众。

  2. 在 映射 步骤，选择之后 添加新映射​中，会显示映射页面，以将源XDM字段映射到SendGrid API目标字段。 下图演示了如何在Experience Platform和SendGrid之间映射标识命名空间。 请确保 源字段 电子邮件 应映射到 目标字段 external_id 如下所示。



  3. 同样，映射所需的 Adobe Experience Platform 要导出到SendGrid目标的属性。

  4. 完成映射后，选择 下一个 以进入审阅屏幕。

  5. 选择 完成 以完成设置。

可以为设置的受支持属性映射的完整列表 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中的数据导出

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

  1. 选择 目标 > 浏览 导航到目标列表。

  2. 选择目标并验证状态为 已启用.

  3. 切换到 Activation data 选项卡，然后选择受众名称。

  4. 监测受众摘要，并检查与数据集内创建的计数对应的用户档案计数。

  5. 此 SendGrid营销列表>创建列表API 用于在SendGrid中创建唯一的联系人列表，方法是 list_name 属性和数据导出的时间戳。 导航到SendGrid站点，并检查是否创建了符合名称模式的新联系人列表。

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

  7. 此外，还检查一些电子邮件以验证字段映射是否正确。

数据使用和治理

全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关如何执行操作的详细信息 Adobe Experience Platform 强制执行数据管理，请参见 数据管理概述.

其他资源

此SendGrid目标利用以下API：

限制

上一页
Next page

在此页面上