Azure Event Hubs 連接

總覽

Azure Event Hubs 是大資料流平台和事件接收服務。 它每秒可以接收和處理數百萬個事件。 通過使用任何即時分析提供程式或批處理/儲存適配器，可以轉換和儲存發送到事件中心的資料。

您可以建立到您的 Azure Event Hubs 儲存以從Adobe Experience Platform傳輸資料。

• 有關 Azure Event Hubs，請參見 Microsoft文檔。
• 連接到 Azure Event Hubs 以寫程式方式，請參見 流目標API教程。
• 連接到 Azure Event Hubs 使用平台用戶介面，請參閱以下各節。

使用案例

使用流目標，如 Azure Event Hubs，您可以輕鬆地將高價值分段事件和關聯的配置檔案屬性輸入到您選擇的系統中。

例如，潛在客戶下載了一份白皮書，確認他們屬於「高傾向轉換」段。 通過映射目標客戶所在的段 Azure Event Hubs 目標，您將在 Azure Event Hubs。 在這裡，您可以採用自行動手的方法，並在活動之前描述業務邏輯，因為您認為最適合您的企業IT系統。

導出類型和頻率

有關目標導出類型和頻率的資訊，請參閱下表。

IP地址允許清單

為滿足客戶的安全性和法規遵從性要求，Experience Platform提供了一個靜態IP清單，您可以為 Azure Event Hubs 目標。 請參閱 流目標的IP地址允許清單 清單。

連接到目標

要連接到此目標，請按照 目標配置教程。 連接到此目標時，必須提供以下資訊：

驗證資訊

標準驗證

如果選擇 標準驗證 鍵入以連接到HTTP終結點，輸入下面的欄位並選擇 連接到目標:

• SAS密鑰名稱:授權規則的名稱，也稱為SAS密鑰名稱。
• SAS密鑰:事件集線器命名空間的主鍵。 的 sasPolicy 那個 sasKey 必須對應 管理 為填充事件中心清單而配置的權限。 瞭解身份驗證 Azure Event Hubs 在 Microsoft文檔。
• 命名空間:填寫 Azure Event Hubs 命名空間。 瞭解 Azure Event Hubs 命名空間 Microsoft文檔。

共用訪問簽名(SAS)驗證

如果選擇 標準驗證 鍵入以連接到HTTP終結點，輸入下面的欄位並選擇 連接到目標:

• SAS密鑰名稱:授權規則的名稱，也稱為SAS密鑰名稱。
• SAS密鑰:事件集線器命名空間的主鍵。 的 sasPolicy 那個 sasKey 必須對應 管理 為填充事件中心清單而配置的權限。 瞭解身份驗證 Azure Event Hubs 在 Microsoft文檔。
• 命名空間:填寫 Azure Event Hubs 命名空間。 瞭解 Azure Event Hubs 命名空間 Microsoft文檔。
• 命名空間:填寫 Azure Event Hubs 命名空間。 瞭解 Azure Event Hubs 命名空間 Microsoft文檔。

目標詳細資訊

在建立到Azure事件中心目標的身份驗證連接後，請提供目標的以下資訊：

• 名稱:填寫到的連接的名稱 Azure Event Hubs。
• 說明:提供連接的說明。 示例：「高級客戶」、「對風箏衝浪感興趣的客戶」。
• 事件集線器名稱:為流提供名稱 Azure Event Hubs 目標。
• 包括段名稱:如果希望資料導出包含要導出的段的名稱，則切換。 有關選擇此選項的資料導出示例，請參閱 導出的資料 的下一頁。
• 包括段時間戳:如果希望資料導出包括建立和更新段時的UNIX時間戳，以及將段映射到要激活的目標時的UNIX時間戳，則切換。 有關選擇此選項的資料導出示例，請參閱 導出的資料 的下一頁。

將段激活到此目標

請參閱 激活受眾資料以流式處理配置檔案導出目標 有關激活此目標受眾段的說明。

配置檔案導出行為

Experience Platform優化配置檔案導出行為 Azure Event Hubs 目標：僅當在段鑑定或其他重要事件之後對配置檔案進行了相關更新時，才將資料導出到目標。 配置式在以下情況下導出到目標：

• 配置檔案更新由映射到目的地的至少一個段的段成員資格的改變確定。 例如，配置檔案已限定映射到目標的段之一或已退出映射到目標的段之一。
• 配置檔案更新由 身份映射。 例如，已為映射到目標的段之一限定的配置檔案已在標識映射屬性中添加了新標識。
• 配置檔案更新由映射到目的地的至少一個屬性的屬性的改變確定。 例如，映射步驟中映射到目標的屬性之一被添加到配置檔案。

在上述所有情況下，只將發生相關更新的配置檔案導出到目標。 例如，如果映射到目標流的段有100個成員，並且有5個新配置檔案符合該段的條件，則向目標的導出是增量的，並且只包括5個新配置檔案。

請注意，無論更改位於何處，都會為配置檔案導出所有映射的屬性。 因此，在上面的示例中，即使屬性本身沒有更改，也會導出這五個新配置檔案的所有映射屬性。

什麼決定資料導出以及導出中包含的內容

對於為給定配置檔案導出的資料，瞭解以下兩個不同概念非常重要 決定將資料導出到 Azure Event Hubs 目標 和 資料包含在導出中。

例如，將此資料流視為 Azure Event Hubs 目標，其中在資料流中選擇了三個段，並將四個屬性映射到目標。

導出到目標的配置檔案可由符合或退出其中一個配置檔案來確定 三個映射段。 但是，在資料導出中，在 segmentMembership 對象（請參見） 導出的資料 )中，如果特定配置檔案是其成員，則可能會顯示其他未映射的段。 如果配置檔案符合DeLorean Cars分部客戶的資格，但也是受觀看的「回到未來」電影和科幻片迷分部的成員，則另外兩個分部也將出現在 segmentMembership 資料導出的對象，即使這些對象未映射到資料流中。

從配置檔案屬性的視點來看，對上述四個屬性的任何更改都將確定目標導出，並且配置檔案上存在的四個映射屬性中的任何一個都將出現在資料導出中。

歷史資料回填

當您將新段添加到現有目標或建立新目標並將段映射到該目標時，Experience Platform會將歷史段限定資料導出到目標。 限定段的配置檔案 先 已添加到目標的段在大約一小時內導出到目標。

導出的資料

已導出 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":"existing"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"existing"
      },
      "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"
      }
    ]
  }
}

下面是導出資料的進一步示例，具體取決於您在連接目標流中為 包括段名稱 和 包括段時間戳 選項：

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

限制和重試策略

在95%的時間內，Experience Platform嘗試為成功發送的消息提供小於10分鐘的吞吐量延遲，每個資料流每秒的請求數小於10.000。

如果向HTTP API目標發出失敗請求，Experience Platform將儲存失敗的請求並重試兩次，以將請求發送到終結點。