Azure Event Hubs 连接

概述

重要

此目标仅适用于 Adobe Real-time Customer Data Platform Ultimate 客户。

Azure Event Hubs 是一个大数据流式传输平台和事件摄取服务。 它每秒可以接收和处理数百万个事件。 发送到事件中心的数据可以使用任何实时分析提供程序或批处理/存储适配器进行转换和存储。

您可以创建到 Azure Event Hubs 用于从Adobe Experience Platform流式传输数据的存储。

  • 有关详情,请参阅 Azure Event Hubs,请参见 Microsoft文档.
  • 要连接到 Azure Event Hubs 以编程方式查看 流目标API教程.
  • 要连接到 Azure Event Hubs 使用Platform用户界面,请参阅以下部分。

UI中的AWS Kinesis

用例

通过使用流式目标,例如 Azure Event Hubs,您可以轻松地将高价值分段事件和关联的配置文件属性馈送到您选择的系统。

例如,潜在客户下载了一份白皮书,将其归类为“高转化倾向”区段。 通过将潜在客户所属的区段映射到 Azure Event Hubs 目标,您将在以下位置收到此事件: Azure Event Hubs. 在这里,您可以采用DIY(自己动手)方法并在事件之上描述业务逻辑,因为您认为这种方法最适合您的企业IT系统。

导出类型和频率

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

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

允许列表 IP地址

为了满足客户的安全性和法规遵从性要求, Experience Platform提供了一个您可以为其允许列表的静态IP列表, Azure Event Hubs 目标。 请参阅 流目标的IP地址允许列表 要允许列表的IP的完整列表。

连接到目标

重要

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

要连接到此目标,请按照 目标配置教程. 连接到此目标时,必须提供以下信息:

身份验证信息

标准身份验证

显示Azure事件中心标准身份验证详细信息的已完成字段的UI屏幕图像

如果您选择 标准身份验证 键入以连接到您的HTTP端点,输入以下字段并选择 连接到目标

  • SAS密钥名称:授权规则的名称,也称为SAS密钥名称。
  • SAS密钥:事件中心命名空间的主键。 此 sasPolicysasKey 对应的必须具有 管理 为填充事件中心列表而配置的权限。 了解如何向进行身份验证 Azure Event Hubs 使用SAS密钥 Microsoft文档.
  • 命名空间:填写您的 Azure Event Hubs 命名空间。 了解 Azure Event Hubs 中的命名空间 Microsoft文档.

共享访问签名(SAS)身份验证

显示Azure事件中心标准身份验证详细信息的已完成字段的UI屏幕图像

如果您选择 标准身份验证 键入以连接到您的HTTP端点,输入以下字段并选择 连接到目标

  • SAS密钥名称:授权规则的名称,也称为SAS密钥名称。
  • SAS密钥:事件中心命名空间的主键。 此 sasPolicysasKey 对应的必须具有 管理 为填充事件中心列表而配置的权限。 了解如何向进行身份验证 Azure Event Hubs 使用SAS密钥 Microsoft文档.
  • 命名空间:填写您的 Azure Event Hubs 命名空间。 了解 Azure Event Hubs 中的命名空间 Microsoft文档.
  • 事件中心名称:填写您的 Azure Event Hub 名称。 了解 Azure Event Hubs 中的名称 Microsoft文档.

填写目标详细信息

要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

显示Azure事件中心目标详细信息的已完成字段的用户界面屏幕图像

  • 名称:填写与的连接名称 Azure Event Hubs.
  • 描述:提供连接的描述。 示例:“高级层客户”、“对风筝冲浪感兴趣的客户”。
  • eventHubName:为您的流提供名称 Azure Event Hubs 目标。
  • 包括区段名称:如果希望数据导出包含要导出的区段名称,请进行切换。 有关选中此选项后数据导出的示例,请参阅 导出的数据 章节。
  • 包括区段时间戳:如果希望数据导出包括创建和更新区段时的UNIX时间戳,以及将区段映射到目标以供激活时的UNIX时间戳,请进行切换。 有关选中此选项后数据导出的示例,请参阅 导出的数据 章节。

启用警报

您可以启用警报,以接收有关流向目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的更多信息,请参阅以下指南中的 使用UI订阅目标警报.

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

将区段激活到此目标

重要

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

参见 将受众数据激活到流配置文件导出目标 有关将受众区段激活到此目标的说明。

配置文件导出行为

Experience Platform会优化将配置文件导出到 Azure Event Hubs 目标,用于在区段鉴别或其他重要事件后对配置文件进行相关更新时,仅将数据导出到您的目标。 在以下情况下,会将配置文件导出到您的目标:

  • 配置文件更新由映射到目标的至少一个区段的区段成员资格更改确定。 例如,配置文件已符合映射到目标的其中一个区段的条件,或已退出映射到目标的其中一个区段。
  • 配置文件更新由 身份映射. 例如,已经符合映射到目标的其中一个区段资格的配置文件,已在标识映射属性中添加了一个新标识。
  • 配置文件更新由映射到目标的至少一个属性的更改确定。 例如,会将映射步骤中映射到目标的某个属性添加到配置文件中。

在上述所有情况下,只会将已发生相关更新的用户档案导出到您的目标。 例如,如果映射到目标流的区段具有一百个成员,并且有五个新用户档案符合该区段的条件,则导出到目标的操作将以增量方式进行,并且只包含五个新用户档案。

请注意,无论更改发生在何处,都将为配置文件导出所有映射的属性。 因此,在上面的示例中,将导出这五个新配置文件的所有映射属性,即使属性本身未发生更改也是如此。

决定数据导出的因素以及导出中包含的内容

对于为给定用户档案导出的数据,了解以下两个不同的概念很重要: 决定数据导出到您的 Azure Event Hubs 目标哪些数据包含在导出中.

决定目标导出的因素 目标导出中包含的内容
  • 映射的属性和区段会作为目标导出的提示。 这意味着,如果任何映射的区段更改了状态(从 nullrealized 或从 realizedexiting)或者更新任何映射的属性,则启动目标导出。
  • 由于身份当前无法映射到 Azure Event Hubs 目标,给定配置文件上任何标识的更改也会决定目标导出。
  • 属性的更改被定义为属性上的任何更新,无论它是不是同一个值。 这意味着即使值本身未发生更改,对属性的覆盖也会被视为更改。
  • segmentMembership 对象包括激活数据流中映射的区段,在发生资格或区段退出事件后,用户档案的状态已发生更改。 请注意,配置文件符合条件的其他未映射区段也可以作为目标导出的一部分(如果这些区段属于同一个) 合并策略 区段在激活数据流中映射时相同。
  • 中的所有标识 identityMap 对象也包含在内(Experience Platform当前不支持中的标识映射) Azure Event Hubs 目标)。
  • 目标导出中仅包含映射的属性。

例如,将此数据流视为 Azure Event Hubs 目标,其中在数据流中选择三个区段,并且四个属性映射到目标。

Amazon Kinesis目标数据流

导出到目标的配置文件可由符合或退出其中一个配置文件的配置文件来确定 三个映射区段. 但是,在数据导出中,在 segmentMembership 对象(请参阅 导出的数据 如果特定配置文件是其他未映射区段的成员,并且这些区段与触发导出的区段共享相同的合并策略,则可能会显示其他未映射区段。 如果配置文件符合 使用德洛雷亚汽车的客户 区段,但同时也是 观看了《回到未来》 电影和 科幻迷们 区段,则其他这两个区段也将显示在 segmentMembership 数据导出对象,即使这些对象未在数据流中映射,只要它们与共享相同的合并策略 使用德洛雷亚汽车的客户 区段。

从配置文件属性的角度来看,对上述四个映射属性所做的任何更改都将决定目标导出,并且配置文件上存在的四个映射属性中的任何一个都将出现在数据导出中。

历史数据回填

向现有目标添加新区段时,或者创建新目标并将区段映射到该目标时,Experience Platform会将历史区段资格数据导出到该目标。 符合区段资格的用户档案 早于 添加到目标的区段会在大约1小时内导出到目标。

导出的数据

已导出 Experience Platform 数据登陆您的 Azure Event Hubs JSON格式的目标。 例如,以下导出包含一个符合某个区段资格条件的配置文件,该配置文件是另一个区段的成员,并且退出另一个区段。 导出还包括配置文件属性的名字、姓氏、出生日期和个人电子邮件地址。 此配置文件的身份是ECID和电子邮件。

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
   "ups":{
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
         "lastQualificationTime":"2022-01-11T21:24:39Z",
         "status":"exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
         "lastQualificationTime":"2022-01-02T23:37:33Z",
         "status":"realized"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"realized"
      },
      "5114d758-ce71-43ba-b53e-e2a91d67b67f":{
         "lastQualificationTime":"2022-01-11T23:37:33Z",
         "status":"realized"
      }
   }
},
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

下面是导出数据的更多示例,具体取决于您在连接目标流中为选择的UI设置 包括区段名称包括区段时间戳 选项:

 以下数据导出示例包括 segmentMembership 部分
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }
 以下数据导出示例包括 segmentMembership 部分
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

限制和重试策略

在95%的时间中,Experience Platform会尝试为成功发送的消息提供少于10分钟的吞吐量延迟,每个数据流向HTTP目标的请求速率低于每秒10,000个请求。

如果对HTTP API目标的请求失败,Experience Platform会存储失败的请求,并重试两次以将请求发送到您的端点。

在此页面上