[Ultieme]{class="badge positive"}
Azure Event Hubs verbinding
Overzicht overview
Azure Event Hubs is een groot platform voor gegevensstreaming en service voor het opnemen van gebeurtenissen. Het kan miljoenen gebeurtenissen per seconde ontvangen en verwerken. Gegevens die naar een gebeurtenishub worden verzonden, kunnen worden getransformeerd en opgeslagen met behulp van een realtime analyseprovider of batchadapters.
U kunt een uitgaande verbinding in real time aan uw creëren Azure Event Hubs opslag om gegevens uit Adobe Experience Platform te streamen.
- Voor meer informatie over Azure Event Hubs, zie de Microsoft-documentatie.
- Verbinding maken met Azure Event Hubs programmatically, zie Zelfstudie voor Streaming doelen-API.
- Verbinding maken met Azure Event Hubs in de gebruikersinterface van Platform raadpleegt u de onderstaande secties.
Gebruiksscenario’s use-cases
Door streamingdoelen zoals Azure Event Hubskunt u bovendien gemakkelijk hoogwaardige segmentatiegebeurtenissen en de bijbehorende profielkenmerken in uw eigen systemen importeren.
Met een vooruitzicht downloadde u bijvoorbeeld een witboek dat hen kwalificeert tot een segment met een "hoge neiging om te converteren". Door het publiek in kaart te brengen dat het vooruitzicht binnen aan Azure Event Hubs doel, ontvangt u deze gebeurtenis in Azure Event Hubs. Daar, kunt u een doe-het-zelf benadering gebruiken en bedrijfslogica bovenop de gebeurtenis beschrijven, aangezien u denkt het beste met uw systemen van bedrijfsIT zou werken.
Ondersteunde doelgroepen supported-audiences
In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.
Type en frequentie exporteren export-type-frequency
Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.
IP adres lijst van gewenste personen ip-address-allowlist
Om klanten' veiligheid en nalevingsvereisten te ontmoeten, verstrekt het Experience Platform een lijst van statische IPs die u lijst van gewenste personen voor kunt Azure Event Hubs bestemming. Zie IP adres lijst van gewenste personen voor het stromen bestemmingen voor de volledige lijst van IPs aan lijst van gewenste personen.
Verbinden met de bestemming connect
Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. Wanneer u verbinding maakt met dit doel, moet u de volgende informatie opgeven:
Verificatiegegevens authentication-information
Standaardverificatie standard-authentication
Als u Standard authentication type om met uw eindpunt van HTTP te verbinden, ga hieronder de gebieden in en selecteer Connect to destination:
- SAS Key Name: De naam van de machtigingsregel, ook wel de SAS-sleutelnaam genoemd.
- SAS Key: De primaire sleutel van de naamruimte Gebeurtenishubs. De
sasPolicydat desasKeykomt overeen met beheren rechten die worden geconfigureerd om de lijst Gebeurtenishubs te vullen. Meer informatie over verifiëren bij Azure Event Hubs met SAS-toetsen in de Microsoft-documentatie. - Namespace: Vul uw Azure Event Hubs naamruimte. Meer informatie over Azure Event Hubs naamruimten in het dialoogvenster Microsoft-documentatie.
Shared Access Signature (SAS)-verificatie sas-authentication
Als u Standard authentication type om met uw eindpunt van HTTP te verbinden, ga hieronder de gebieden in en selecteer Connect to destination:
- SAS Key Name: De naam van de machtigingsregel, ook wel de SAS-sleutelnaam genoemd.
- SAS Key: De primaire sleutel van de naamruimte Gebeurtenishubs. De
sasPolicydat desasKeykomt overeen met beheren rechten die worden geconfigureerd om de lijst Gebeurtenishubs te vullen. Meer informatie over verifiëren bij Azure Event Hubs met SAS-toetsen in de Microsoft-documentatie. - Namespace: Vul uw Azure Event Hubs naamruimte. Meer informatie over Azure Event Hubs naamruimten in het dialoogvenster Microsoft-documentatie.
- Event Hub Name: Vul uw Azure Event Hub naam . Meer informatie over Azure Event Hubs namen in de Microsoft-documentatie.
Doelgegevens invullen destination-details
Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
- Name: Geef een naam op voor de verbinding met Azure Event Hubs.
- Description: Geef een beschrijving van de verbinding op. Voorbeelden: "Klanten met de hoogste levensstandaard", "Klanten die geïnteresseerd zijn in keuzen."
- eventHubName: Geef een naam voor de stream op aan uw Azure Event Hubs bestemming.
- Include Segment Names: Schakel deze optie in als u wilt dat bij het exporteren van de gegevens de namen worden opgenomen van het publiek dat u exporteert. Voor een voorbeeld van een gegevensexport waarbij deze optie is geselecteerd, raadpleegt u de Geëxporteerde gegevens hieronder.
- Include Segment Timestamps: Schakel deze optie in als u wilt dat bij het exporteren van de gegevens de UNIX-tijdstempel wordt gebruikt wanneer het publiek is gemaakt en bijgewerkt, en ook de UNIX-tijdstempel wanneer het publiek voor activering aan de bestemming is toegewezen. Voor een voorbeeld van een gegevensexport waarbij deze optie is geselecteerd, raadpleegt u de Geëxporteerde gegevens hieronder.
Waarschuwingen inschakelen enable-alerts
U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.
Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next.
Soorten publiek naar dit doel activeren activate
- Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
- Goedkeuring van het beleid wordt momenteel niet gesteund in de uitvoer naar de Azure Event Hubs bestemming. Meer informatie.
Zie De publieksgegevens van de activering aan het stromen profiel de uitvoerbestemmingen voor instructies voor het activeren van het publiek naar deze bestemming.
Exportgedrag profiel profile-export-behavior
Experience Platform optimaliseert het gedrag voor het exporteren van profielen naar uw Azure Event Hubs doel, om alleen gegevens naar uw bestemming te exporteren wanneer relevante updates naar een profiel zijn opgetreden na kwalificatie van het publiek of andere belangrijke gebeurtenissen. In de volgende situaties worden profielen naar uw doel geëxporteerd:
- De profielupdate werd bepaald door een wijziging in het publiekslidmaatschap voor ten minste een van de doelgroepen. Het profiel is bijvoorbeeld gekwalificeerd voor een van de soorten publiek die aan de bestemming zijn toegewezen of heeft een van de soorten publiek afgesloten die aan de bestemming zijn toegewezen.
- De profielupdate is bepaald door een wijziging in het dialoogvenster identiteitsbewijs. Een profiel dat bijvoorbeeld al was gekwalificeerd voor een van de soorten publiek dat aan de bestemming is toegewezen, is toegevoegd aan een nieuwe identiteit in het kenmerk Naamplaatje.
- De profielupdate is bepaald door een wijziging in kenmerken voor ten minste een van de kenmerken die aan de bestemming zijn toegewezen. Een van de kenmerken die in de toewijzingsstap aan het doel is toegewezen, wordt bijvoorbeeld aan een profiel toegevoegd.
In alle hierboven beschreven gevallen worden alleen de profielen waarin relevante updates zijn opgetreden, naar uw bestemming geëxporteerd. Bijvoorbeeld, als een publiek dat aan de bestemmingsstroom in kaart wordt gebracht honderd leden heeft, en vijf nieuwe profielen voor het segment kwalificeren, is de uitvoer naar uw bestemming incrementeel en omvat slechts de vijf nieuwe profielen.
Alle toegewezen kenmerken worden geëxporteerd voor een profiel, ongeacht de locatie van de wijzigingen. In het voorbeeld hierboven worden alle toegewezen kenmerken voor deze vijf nieuwe profielen geëxporteerd, zelfs als de kenmerken zelf niet zijn gewijzigd.
Wat bepaalt een gegevensexport en wat wordt opgenomen in de export? what-determines-export-what-is-included
Met betrekking tot de gegevens die voor een bepaald profiel worden geëxporteerd, is het belangrijk dat u de twee verschillende concepten van wat bepalend is voor het exporteren van gegevens naar uw Azure Event Hubs doel en welke gegevens in de uitvoer worden opgenomen.
- Toegewezen kenmerken en doelgroepen fungeren als actiepunt voor het exporteren van een bestemming. Dit betekent dat als een toegewezen publiek de status wijzigt (van
nulltotrealizedof vanrealizedtotexiting) of toegewezen kenmerken worden bijgewerkt, wordt een doelexport uitgeschakeld. - Omdat identiteiten momenteel niet kunnen worden toegewezen aan Azure Event Hubs doelen, wijzigingen in een identiteit in een bepaald profiel bepalen ook de export van de bestemming.
- Een wijziging voor een kenmerk wordt gedefinieerd als een update voor het kenmerk, ongeacht of het dezelfde waarde heeft of niet. Dit houdt in dat een overschrijven van een kenmerk als een wijziging wordt beschouwd, zelfs als de waarde zelf niet is gewijzigd.
- De
segmentMembershipbevat het publiek dat is toegewezen in de activeringsgegevensstroom, waarvoor de status van het profiel is gewijzigd na een afsluitgebeurtenis voor kwalificatie of het publiek. Andere niet-toegewezen soorten publiek waarvoor het profiel waarvoor is gekwalificeerd, deel kan uitmaken van de doelexport, als deze soorten publiek tot hetzelfde behoren samenvoegingsbeleid als het publiek is toegewezen in de activeringsgegevensstroom. - Alle identiteiten in de
identityMapobject wordt ook opgenomen (Experience Platform ondersteunt momenteel geen identiteitstoewijzing in de Azure Event Hubs bestemming). - Alleen de toegewezen kenmerken worden opgenomen in de doelexport.
Neem bijvoorbeeld deze gegevensstroom naar een Azure Event Hubs doel waar drie publiek in dataflow wordt geselecteerd, en vier attributen worden in kaart gebracht aan de bestemming.
Een profiel dat naar de bestemming wordt geëxporteerd, kan worden bepaald door een profiel dat in aanmerking komt voor of dat een van de drie toegewezen segmenten. Bij de gegevensexport moet u echter in de segmentMembership object (zie Geëxporteerde gegevens in de onderstaande sectie), kunnen andere niet-toegewezen doelgroepen worden weergegeven als dat specifieke profiel lid van die doelgroepen is en als deze hetzelfde samenvoegingsbeleid delen als het publiek dat de exportactie heeft geactiveerd. Als een profiel voor het Klant met DeLorean Auto's publiek maar ook lid van "Terug naar de toekomst" film en Favorieten voor science fiction segmenten, dan zullen deze andere twee soorten publiek ook in de segmentMembership -object van de gegevensexport, ook al worden deze niet toegewezen in de gegevensstroom, als deze hetzelfde samenvoegbeleid delen met de Klant met DeLorean Auto's segment.
Vanuit het oogpunt van profielkenmerken bepalen wijzigingen in de vier bovenstaande kenmerken de doelexport en zijn alle vier toegewezen kenmerken in het profiel aanwezig in de gegevensexport.
Back-up van historische gegevens historical-data-backfill
Wanneer u een nieuw publiek aan een bestaande bestemming toevoegt, of wanneer u een nieuw doel en kaartpubliek aan het creeert, voert het Experience Platform historische gegevens van de publiekskwalificatie naar de bestemming uit. Profielen die in aanmerking komen voor het publiek voor het publiek dat aan de bestemming is toegevoegd, wordt binnen ongeveer een uur naar de bestemming geëxporteerd.
Geëxporteerde gegevens exported-data
Uw geëxporteerde Experience Platform gegevensterreinen in uw Azure Event Hubs doel in JSON-indeling. Bijvoorbeeld, bevat de hieronder uitvoer een profiel dat voor een bepaald segment heeft gekwalificeerd, een lid van andere twee segmenten is, en een ander segment verliet. Het exporteren bevat ook de voornaam, achternaam, geboortedatum en het persoonlijke e-mailadres van het profielkenmerk. De identiteiten voor dit profiel zijn ECID en e-mail.
{
"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"
}
]
}
}
Hieronder vindt u meer voorbeelden van geëxporteerde gegevens, afhankelijk van de UI-instellingen die u hebt geselecteerd in de doelstroom voor het verbinden van Include Segment Names en Include Segment Timestamps opties:
segmentMembership sectie| code language-json |
|---|
|
segmentMembership sectie| code language-json |
|---|
|
Beperkingen en beleid opnieuw proberen limits-retry-policy
In 95 percent van de tijd, probeert het Experience Platform om een productietolerantie van minder dan 10 minuten voor met succes verzonden berichten met een tarief van minder dan 10.000 verzoeken per seconde voor elke dataflow aan een bestemming van HTTP aan te bieden.
In het geval van ontbroken verzoeken aan uw bestemming van HTTP API, slaat het Experience Platform de ontbroken verzoeken op en probeert tweemaal om de verzoeken naar uw eindpunt te verzenden.