[Ultimate]{class="badge positive"}
Azure Event Hubs 連線
概觀 overview
Azure Event Hubs 是巨量資料串流平台和事件擷取服務。 其每秒可接收及處理數百萬個事件。 傳送到事件中樞的資料可以使用任何即時分析提供者或批次/儲存配接卡進行轉換和儲存。
您可以建立與您的的即時輸出連線 Azure Event Hubs 從Adobe Experience Platform串流資料的儲存空間。
- 有關詳細資訊 Azure Event Hubs,請參閱 Microsoft檔案.
- 若要連線到 Azure Event Hubs 以程式設計方式參閱 串流目的地API教學課程.
- 若要連線到 Azure Event Hubs 使用Platform使用者介面,請參閱下列章節。
使用案例 use-cases
使用串流目的地,例如 Azure Event Hubs,您就能輕鬆將高價值分段事件和相關設定檔屬性饋送至您選擇的系統。
例如,潛在客戶下載了白皮書,將其歸類為「高轉換傾向」區段。 將潛在客戶所屬的受眾對應至 Azure Event Hubs 目的地,您會在以下位置收到此事件: Azure Event Hubs. 在這裡,您可以採用DIY(自己動手)方式,並在事件上方描述商業邏輯,因為您認為這種方式最適合企業IT系統。
支援的對象 supported-audiences
本節說明您可以將哪些型別的對象匯出至此目的地。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
IP位址允許清單 ip-address-allowlist
為了滿足客戶的安全性和合規性要求,Experience Platform提供您可以允許清單中的靜態IP Azure Event Hubs 目的地。 請參閱 串流目的地的IP位址允許清單 以取得加入允許清單的IP完整清單。
連線到目標 connect
若要連線至此目的地,請遵循以下說明的步驟: 目的地設定教學課程. 連線到這個目的地時,您必須提供下列資訊:
驗證資訊 authentication-information
標準驗證 standard-authentication
如果您選取 標準驗證 輸入以連線至您的HTTP端點,輸入以下欄位並選取 連線到目的地:
- SAS金鑰名稱:授權規則的名稱,也稱為SAS金鑰名稱。
- SAS金鑰:事件中樞名稱空間的主要索引鍵。 此
sasPolicy
該sasKey
對應到必須具有 管理 已設定許可權,以便填入事件中樞清單。 瞭解如何驗證 Azure Event Hubs 使用SAS金鑰 Microsoft檔案. - 名稱空間:填入 Azure Event Hubs 名稱空間。 瞭解 Azure Event Hubs 中的名稱空間 Microsoft檔案.
共用存取簽章(SAS)驗證 sas-authentication
如果您選取 標準驗證 輸入以連線至您的HTTP端點,輸入以下欄位並選取 連線到目的地:
- SAS金鑰名稱:授權規則的名稱,也稱為SAS金鑰名稱。
- SAS金鑰:事件中樞名稱空間的主要索引鍵。 此
sasPolicy
該sasKey
對應到必須具有 管理 已設定許可權,以便填入事件中樞清單。 瞭解如何驗證 Azure Event Hubs 使用SAS金鑰 Microsoft檔案. - 名稱空間:填入 Azure Event Hubs 名稱空間。 瞭解 Azure Event Hubs 中的名稱空間 Microsoft檔案.
- 事件中心名稱:填入 Azure Event Hub 名稱。 瞭解 Azure Event Hubs 中的名稱 Microsoft檔案.
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱以下指南: 使用UI訂閱目的地警報.
當您完成提供目的地連線的詳細資訊時,請選取「 」 下一個.
啟動此目標的對象 activate
另請參閱 啟用受眾資料至串流設定檔匯出目的地 以取得啟用此目的地對象的指示。
設定檔匯出行為 profile-export-behavior
Experience Platform會將設定檔匯出行為最佳化至 Azure Event Hubs 目的地,目的是在對象資格或其他重大事件後發生設定檔的相關更新時,僅將資料匯出至您的目的地。 在下列情況下,設定檔會匯出至您的目的地:
- 設定檔更新是由對應至目的地的至少一個對象的對象成員資格變更所決定。 例如,設定檔已符合對應至目的地的其中一個對象的資格,或已退出對應至目的地的其中一個對象。
- 設定檔更新是由 身分對應. 例如,已符合對應至目的地之其中一個對象資格的設定檔,已在身分對應屬性中新增身分。
- 設定檔更新是由對應到目的地的至少一個屬性的變更所決定。 例如,會將對應步驟中對應至目的地的其中一個屬性新增至設定檔。
在上述所有情況下,只有已發生相關更新的設定檔才會匯出至您的目的地。 例如,如果對應至目的地流程的受眾有一百個成員,且有五個新設定檔符合區段的資格,則匯出至您的目的地的作業將以漸進方式進行,且僅包含五個新設定檔。
請注意,無論變更位於何處,所有對映屬性都會匯出為設定檔。 因此,在上述範例中,將會匯出這五個新設定檔的所有對應屬性,即使屬性本身並未變更亦然。
決定資料匯出的因素及匯出中包含的因素 what-determines-export-what-is-included
針對針對指定設定檔匯出的資料,瞭解以下兩個不同的概念是很重要的 決定匯出至您的資料的 Azure Event Hubs 目的地 和 哪些資料包含在匯出中.
- 對應的屬性和受眾可作為目的地匯出的提示。 這表示如果任何對應的對象變更狀態(從
null
至realized
或從realized
至exiting
)或更新任何對應的屬性,就會開始匯出目的地。 - 由於身分目前無法對應至 Azure Event Hubs 目的地,指定設定檔上任何身分的變更也會決定目的地匯出。
- 屬性的變更定義為屬性上的任何更新,無論其是否為相同的值。 這表示即使值本身並未變更,屬性上的覆寫也會視為變更。
- 此
segmentMembership
物件包含啟動資料流中對應的對象,其設定檔的狀態已隨著資格或對象退出事件而變更。 請注意,如果其他未對應對象屬於相同對象,則設定檔符合資格的對象可以屬於目的地匯出的一部分 合併原則 對象在啟動資料流中的對應方式。 - 中的所有身分
identityMap
也包括物件(Experience Platform目前不支援中的身分對應) Azure Event Hubs 目的地)。 - 目的地匯出僅包含對應的屬性。
例如,將此資料流視為 Azure Event Hubs 在資料流中選取三個對象,且四個屬性對應至目的地的目的地。
要判斷匯出至目的地的設定檔是否符合「 」或「 」其中之一, 三個對應的區段. 不過,在資料匯出中,在 segmentMembership
物件(請參閱 匯出的資料 區段底下),其他未對應的對象可能會出現,如果該特定設定檔為其成員,且這些對象與觸發匯出的對象共用相同的合併原則。 如果設定檔符合 擁有DeLorean Cars的客戶 對象,但也是 觀看「回到未來」 影片和 科幻迷 區段,則其他這兩個對象也會出現在 segmentMembership
匯出的物件,即使這些物件未在資料流中對映,只要它們與共用相同的合併原則 擁有DeLorean Cars的客戶 區段。
從設定檔屬性的角度來看,對上述四個對應屬性所做的任何變更將決定目的地匯出,而且設定檔上存在的四個對應屬性中的任何一個都會出現在資料匯出中。
歷史資料回填 historical-data-backfill
當您新增對象至現有目的地,或當您建立新目的地並將對象對應至該目的地時,Experience Platform會將歷史對象資格資料匯出至該目的地。 符合對象資格的設定檔 早於 新增至目的地的對象會在約一小時內匯出至目的地。
匯出的資料 exported-data
您的匯出 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
區段code language-json |
---|
|
segmentMembership
區段code language-json |
---|
|
限制和重試原則 limits-retry-policy
在95%的時間中,Experience Platform會嘗試針對每個資料流向HTTP目的地的成功傳送訊息,以每秒少於10,000個要求的速率,提供少於10分鐘的輸送量延遲。
如果對您的HTTP API目的地的請求失敗,Experience Platform會儲存失敗的請求並重試兩次,以將請求傳送至您的端點。