[Ultieme]{class="badge positive"}
Azure Event Hubs verbinding
Overzicht overview
Azure Event Hubs is een groot platform voor gegevensstreaming en de 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 real-time uitgaande verbinding maken met uw Azure Event Hubs -opslag om gegevens vanuit Adobe Experience Platform te streamen.
- Voor meer informatie over Azure Event Hubs, zie de documentatie van Microsoft.
- Om met Azure Event Hubs programmatically te verbinden, zie de Streaming bestemmingen API leerprogramma.
- Zie de volgende secties voor een verbinding met Azure Event Hubs via de gebruikersinterface van Platform.
Gebruiksscenario’s use-cases
Door het stromen bestemmingen zoals Azure Event Hubs te gebruiken, kunt u high-value segmenteringsgebeurtenissen en bijbehorende profielattributen in uw systemen van keus gemakkelijk invoeren.
Met een vooruitzicht downloadde u bijvoorbeeld een witboek dat hen kwalificeert tot een segment met een "hoge neiging om te converteren". Als u het publiek in kaart brengt dat het vooruitzicht naar het Azure Event Hubs -doel valt, 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 aan de veiligheid en nalevingsvereisten van klanten te voldoen, verstrekt het Experience Platform een lijst van statische IPs die u voor de Azure Event Hubs bestemming kunt lijsten van gewenste personen. Verwijs naar IP adreslijst van gewenste personen voor het stromen bestemmingenvoor de volledige lijst van IPs aan lijst van gewenste personen.
Verbinden met de bestemming connect
Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. Wanneer u verbinding maakt met dit doel, moet u de volgende informatie opgeven:
Verificatiegegevens authentication-information
Standaardverificatie standard-authentication
Als u het type Standard authentication selecteert om verbinding te maken met het HTTP-eindpunt, voert u de onderstaande velden in en selecteert u 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.
sasPolicy
datsasKey
beantwoordt om te hebben rechten leiden die worden gevormd opdat de lijst van de Hubs van de Gebeurtenis wordt bevolkt. Leer over voor authentiek verklaren aan Azure Event Hubs met de sleutels van SAS in de documentatie van Microsoft. - Namespace: vul de naamruimte Azure Event Hubs in. Leer over Azure Event Hubs namespaces in de documentatie van Microsoft.
Shared Access Signature (SAS)-verificatie sas-authentication
Als u het type Standard authentication selecteert om verbinding te maken met het HTTP-eindpunt, voert u de onderstaande velden in en selecteert u 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.
sasPolicy
datsasKey
beantwoordt om te hebben rechten leiden die worden gevormd opdat de lijst van de Hubs van de Gebeurtenis wordt bevolkt. Leer over voor authentiek verklaren aan Azure Event Hubs met de sleutels van SAS in de documentatie van Microsoft. - Namespace: vul de naamruimte Azure Event Hubs in. Leer over Azure Event Hubs namespaces in de documentatie van Microsoft.
- Event Hub Name: vul de naam Azure Event Hub in. Leer over Azure Event Hubs namen in de documentatie van Microsoft.
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: vul een naam in voor de verbinding met Azure Event Hubs .
- Description: geef een beschrijving van de verbinding. Voorbeelden: "Klanten met de hoogste levensstandaard", "Klanten die geïnteresseerd zijn in keuzen."
- eventHubName: geef een naam voor de stream op naar het Azure Event Hubs -doel.
- Include Segment Names: in-/uitschakelen 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 gegevens die met deze geselecteerde optie uitvoeren, verwijs naar de Uitgevoerde gegevenssectie verder 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 is toegewezen aan het doel. Voor een voorbeeld van een gegevens die met deze geselecteerde optie uitvoeren, verwijs naar de Uitgevoerde gegevenssectie verder 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. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.
Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .
Soorten publiek naar dit doel activeren activate
- Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
- de toestemmings beleidsevaluatiewordt momenteel niet gesteund in de uitvoer naar de Azure bestemming van de Hubs van de Gebeurtenis. Meer informatie.
Zie publieksgegevens aan het stromen van profieluitvoer bestemmingenvoor instructies op het activeren van publiek aan deze bestemming activeren.
Exportgedrag profiel profile-export-behavior
Experience Platform optimaliseert het gedrag voor het exporteren van profielen naar uw Azure Event Hubs -doel, zodat alleen gegevens naar uw doel worden geëxporteerd wanneer relevante updates naar een profiel zijn opgetreden na een 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 werd bepaald door een verandering in de identiteitskaart. 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 het gegeven dat voor een bepaald profiel wordt uitgevoerd, is het belangrijk om de twee verschillende concepten te begrijpen wat een gegevensuitvoer aan uw Azure Event Hubs bestemming en bepaalt welke gegevens in de uitvoer inbegrepen zijn.
- Toegewezen kenmerken en doelgroepen fungeren als actiepunt voor het exporteren van een bestemming. Dit betekent dat als een toegewezen publiek de status wijzigt (van
null
inrealized
of vanrealized
inexiting
) of dat toegewezen kenmerken worden bijgewerkt, een doelexport wordt uitgeschakeld. - Omdat identiteiten momenteel niet aan Azure Event Hubs bestemmingen kunnen worden in kaart gebracht, bepalen de veranderingen in om het even welke identiteit op een bepaald profiel ook bestemmingsuitvoer.
- 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.
- Het
segmentMembership
-object bevat het publiek dat is toegewezen in de activeringsgegevensstroom, waarvoor de status van het profiel is gewijzigd na een afsluitgebeurtenis voor kwalificatie of publiek. Merk op dat andere niet in kaart gebrachte publiek waarvoor het profiel dat voor wordt gekwalificeerd deel van de bestemmingsuitvoer kan uitmaken, als deze doelgroepen tot het zelfde fusiebeleidzoals het publiek behoren dat in activeringsdataflow in kaart wordt gebracht. - Alle identiteiten in het
identityMap
-object worden ook opgenomen (Experience Platform ondersteunt momenteel geen identiteitstoewijzing in het Azure Event Hubs -doel). - Alleen de toegewezen kenmerken worden opgenomen in de doelexport.
Neem bijvoorbeeld deze gegevensstroom naar een Azure Event Hubs -bestemming waar drie soorten publiek in de gegevensstroom zijn geselecteerd en vier kenmerken aan de bestemming worden toegewezen.
Een profieluitvoer naar de bestemming kan door een profiel worden bepaald dat voor of het weggaan van één van drie in kaart gebrachte segmenten in aanmerking komt. Nochtans, in de gegevensuitvoer, in het segmentMembership
voorwerp (zie Uitgevoerde Gegevenssectie hieronder), zouden andere niet in kaart gebrachte toehoorders kunnen verschijnen, als dat bepaalde profiel een lid van hen is en als deze het zelfde fusiebeleid zoals het publiek delen dat de uitvoer teweegbracht. Als een profiel voor de Klant met de Auto's van DeLorean maar ook een lid van het Gecontroleerde "Terug naar de Toekomstige" film en de de fictiefondsen van de Wetenschap segmenten kwalificeert, dan zullen deze andere twee publiek ook in het segmentMembership
voorwerp van de gegevensuitvoer aanwezig zijn, alhoewel deze niet in dataflow, als deze zelfde samenvoegingsbeleid delen met de Klant met het segment van de AutoAuto's van DeLorean.
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 voor het publiek kwalificeerden alvorens het publiek aan de bestemming werd toegevoegd worden uitgevoerd naar de bestemming binnen ongeveer één uur.
Geëxporteerde gegevens exported-data
De geëxporteerde Experience Platform gegevens worden in JSON-indeling in uw Azure Event Hubs -doel geplaatst. 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 verbinden voor de opties Include Segment Names en Include Segment Timestamps :
segmentMembership
code language-json |
---|
|
segmentMembership
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.