Outreach连接
概述 overview
Outreach是一个销售执行平台，拥有世界上最丰富的B2B买方与卖方交互数据，并在专有人工智能技术方面投入了大量资金，以将销售数据转换为智能。 Outreach帮助企业自动执行销售活动并根据收入情报采取行动，以提高其效率、可预测性和增长。
此Adobe Experience Platform 目标利用外联更新资源API，允许您更新与Outreach中潜在客户对应的受众中的身份。
Outreach使用具有授权授权的OAuth 2作为身份验证机制与Outreach Update Resource API通信。 下面在向目标身份验证部分中进一步提供了向您的Outreach实例进行身份验证的说明。
用例 use-cases
作为营销人员，您可以根据潜在客户的Adobe Experience Platform配置文件中的属性，为其提供个性化体验。 您可以从离线数据构建受众并将这些受众发送到Outreach，以便在Adobe Experience Platform中更新受众和配置文件后立即显示在潜在客户的信息源中。
先决条件 prerequisites
Experience Platform先决条件 prerequisites-in-experience-platform
在将数据激活到Outreach目标之前，您必须在Experience Platform中创建一个架构、数据集和区段。
如果您需要有关受众状态的指导，请参阅Adobe关于受众成员资格详细信息架构字段组的文档。
外展先决条件 prerequisites-destination
请注意Outreach中的以下先决条件，以便将数据从Platform导出到您的Outreach帐户：
您需要具有外联帐户 prerequisites-account
转到Outreach 登录页面以注册并创建帐户（如果尚未注册）。 有关详细信息，另请参阅Outreach支持页面。
在对Outreach CRM目标进行身份验证之前，请记下以下各项：
设置自定义字段标签 prerequisites-custom-fields
Outreach支持潜在客户的自定义字段。 有关其他指导，请参阅如何在外联中添加自定义字段。 为了便于识别，建议手动将标签更新为其相应的受众名称，而不是保留默认值。 例如，如下所示：
潜在客户的Outreach设置页面显示自定义字段。
潜在客户的Outreach设置页面显示具有 用户友好 标签且与受众名称匹配的自定义字段。 您可以在潜在客户页面上根据这些标签查看受众状态。
护栏
Outreach API具有每个用户每小时10,000个请求的速率限制。 如果达到此限制，您将收到包含以下消息的429响应： You have exceeded your permitted rate limit of 10,000; please try again at 2017-01-01T00:00:00.。
如果您收到此消息，则必须更新受众导出计划以符合速率阈值。
有关其他详细信息，请参阅Outreach 文档。
支持的身份 supported-identities
Outreach支持更新下表中描述的标识。 了解有关标识的更多信息。
OutreachId- Outreach标识符。 这是对应于目标客户配置文件的数值。
- ID必须与要更新的目标客户在Outreach URL中的ID匹配。
- 有关详细信息，请参阅Outreach 文档。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
- 您正在根据字段映射导出区段的所有成员，以及所需的架构字段 （例如：电子邮件地址、电话号码、姓氏）。
- 根据受众计划步骤期间提供的映射ID值，Outreach中的每个区段状态都将通过平台中的相应受众状态进行更新。
- 流目标为基于API的“始终运行”连接。 一旦根据受众评估在Experience Platform中更新了用户档案，连接器就会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
在 目标 > 目录 中，搜索Outreach。 或者，您可以在CRM类别下找到它。
验证目标 authenticate
要验证到目标，请选择 连接到目标。
您将会看到Outreach登录页面。 提供您的电子邮件。
接下来，提供您的密码。
- 用户名：您的Outreach帐户电子邮件。
- 密码：您的Outreach帐户密码。
如果提供的详细信息有效，则UI会显示 已连接 状态，并带有绿色复选标记。 然后，您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称：将来用于识别此目标的名称。
- 描述：可帮助您将来识别此目标的描述。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。
映射注意事项和示例 mapping-considerations-example
要将受众数据从Adobe Experience Platform正确发送到Outreach目标，您需要完成字段映射步骤。 映射包括在您的Platform帐户中的Experience Data Model (XDM)架构字段与其在目标目标中的相应等效字段之间创建链接。 要将XDM字段正确映射到Outreach目标字段，请执行以下步骤：
-
在映射步骤中，单击 添加新映射。 您将在屏幕上看到一个新映射行。
-
在选择源字段窗口中，选择 选择身份命名空间 类别并添加所需的映射。
-
在选择目标字段窗口中，选择要将源字段映射到的目标字段类型。
-
选择身份命名空间：选择此选项可将源字段映射到列表中的身份命名空间。
-
在XDM配置文件架构和Outreach实例之间添加以下映射：
table 0-row-3 1-row-3 XDM配置文件架构 Outreach实例 必需 OidOutreachId是 -
选择自定义属性：选择此选项可将源字段映射到您在属性名称字段中定义的自定义属性。 有关支持的属性的完整列表，请参阅Outreach 潜在客户文档。
-
例如，根据要更新的值，在XDM配置文件架构和Outreach实例之间添加以下映射：
table 0-row-2 1-row-2 2-row-2 XDM配置文件架构 Outreach实例 person.name.firstNamefirstNameperson.name.lastNamelastName -
下面显示了使用这些映射的示例：
-
计划受众导出和示例 schedule-segment-export-example
-
执行计划受众导出步骤时，必须手动将Platform受众映射到Outreach中的自定义字段属性。
-
为此，请选择每个区段，然后输入与 映射ID 字段中来自Outreach的 自定义字段
N标签 字段对应的数值。note important IMPORTANT - 在映射ID中使用的数值*(
N)*应该与后缀为Outreach中的数字值的自定义属性键匹配。 示例： 自定义字段N标签。 - 您只需指定数值，而无需指定整个自定义字段标签。
- Outreach支持最多150个自定义标签字段。
- 有关详细信息，请参阅Outreach 潜在客户文档。
-
例如：
table 0-row-2 1-row-2 Outreach字段 平台映射ID 自定义字段 4标签4
- 在映射ID中使用的数值*(
验证数据导出 exported-data
要验证您是否正确设置了目标，请执行以下步骤：
-
选择 目标 > 浏览 以导航到目标列表。
-
选择目标并验证状态为 已启用。
-
切换到 Activation data 选项卡，然后选择受众名称。
-
监控受众摘要，并确保用户档案计数对应于在区段内创建的计数。
-
登录到Outreach网站，然后导航到Apps > Contacts页面，并检查是否已添加受众中的配置文件。 您可以看到，根据受众计划步骤中提供的映射ID值，Outreach中的每个受众状态都更新为来自Platform的相应受众状态。
数据使用和治理 data-usage-governance
在处理您的数据时，所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息，请参阅数据治理概述。
错误和故障排除 errors-and-troubleshooting
检查数据流运行时，您可能会看到以下错误消息： Bad request reported while pushing events to the destination. Please contact the administrator and try again.
要修复此错误，请验证您在Platform中为Outreach受众提供的映射ID是否有效以及是否存在于Outreach中。