[Ultimate]{class="badge positive"}

Azure Event Hubs anslutning

Översikt overview

IMPORTANT
Det här målet är bara tillgängligt för Adobe Real-time Customer Data Platform Ultimate kunder.

Azure Event Hubs är en stor dataströmningsplattform och en tjänst för händelseredigering. Den kan ta emot och bearbeta miljontals händelser per sekund. Data som skickas till ett händelsehubb kan omformas och lagras med hjälp av alla realtidsanalysleverantörer eller batchnings-/lagringsadaptrar.

Du kan skapa en utgående anslutning i realtid till Azure Event Hubs lagring för att strömma data från Adobe Experience Platform.

AWS Kinesis i användargränssnittet

Användningsfall use-cases

Genom att använda direktuppspelningsmål som Azure Event Hubskan du enkelt mata in segmenteringshändelser med högt värde och tillhörande profilattribut i valfria system.

En potentiell kund har till exempel laddat ned ett vitt papper som kvalificerar dem till ett segment med"hög benägenhet att konvertera". Genom att kartlägga målgruppen som den potentiella kunden tillhör Azure Event Hubs mål, du skulle få den här händelsen i Azure Event Hubs. Där kan ni använda en"do-it-self"-strategi och beskriva affärslogiken utöver evenemanget, som ni tror fungerar bäst med företagets IT-system.

Målgrupper supported-audiences

I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.

Målgruppsursprung
Stöds
Beskrivning
Segmentation Service
Målgrupper som skapats genom Experience Platform Segmenteringstjänst.
Anpassade överföringar
Målgrupper importerad till Experience Platform från CSV-filer.

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt
Typ
Anteckningar
Exporttyp
Profile-based
Du exporterar alla medlemmar i ett segment tillsammans med de önskade schemafälten (t.ex. e-postadress, telefonnummer, efternamn), som du har valt på skärmen Välj profilattribut i arbetsflöde för målaktivering.
Exportfrekvens
Streaming
Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om mål för direktuppspelning.

IP-adress tillåtelselista ip-address-allowlist

För att uppfylla kundernas säkerhets- och kompatibilitetskrav tillhandahåller Experience Platform en lista över statiska IP-adresser som du kan tillåtslista för Azure Event Hubs mål. Se IP-adress tillåtelselista för direktuppspelningsmål för den fullständiga listan över IP-adresser som ska tillåtslista.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du View Destinations och Manage Destinations behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekurs om destinationskonfiguration. När du ansluter till det här målet måste du ange följande information:

Autentiseringsinformation authentication-information

Standardautentisering standard-authentication

Bild av gränssnittsskärmen som visar slutförda fält för Azure Event Hubs-standardautentiseringsinformation

Om du väljer Standard authentication typ för att ansluta till HTTP-slutpunkten, ange fälten nedan och markera Connect to destination:

  • SAS Key Name: Namnet på auktoriseringsregeln, som också kallas SAS-nyckelnamn.
  • SAS Key: Den primära nyckeln för Event Hubs-namnutrymmet. The sasPolicy som sasKey motsvarar måste ha hantera rättigheter som konfigurerats för att händelsehubs-listan ska fyllas i. Lär dig mer om autentisering av Azure Event Hubs med SAS-nycklar i Microsoft-dokumentation.
  • Namespace: Fyll i Azure Event Hubs namnutrymme. Läs mer om Azure Event Hubs namnutrymmen i Microsoft-dokumentation.

SAS-autentisering (Shared Access Signature) sas-authentication

Bild av gränssnittsskärmen som visar slutförda fält för Azure Event Hubs-standardautentiseringsinformation

Om du väljer Standard authentication typ för att ansluta till HTTP-slutpunkten, ange fälten nedan och markera Connect to destination:

  • SAS Key Name: Namnet på auktoriseringsregeln, som också kallas SAS-nyckelnamn.
  • SAS Key: Den primära nyckeln för Event Hubs-namnutrymmet. The sasPolicy som sasKey motsvarar måste ha hantera rättigheter som konfigurerats för att händelsehubs-listan ska fyllas i. Lär dig mer om autentisering av Azure Event Hubs med SAS-nycklar i Microsoft-dokumentation.
  • Namespace: Fyll i Azure Event Hubs namnutrymme. Läs mer om Azure Event Hubs namnutrymmen i Microsoft-dokumentation.
  • Event Hub Name: Fyll i Azure Event Hub namn . Läs mer om Azure Event Hubs i Microsoft-dokumentation.

Fyll i målinformation destination-details

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.

Bild av gränssnittsskärmen som visar slutförda fält för Azure Event Hubs-målinformationen

  • Name: Ange ett namn för anslutningen till Azure Event Hubs.
  • Description: Beskriv anslutningen. Exempel:"Premium tier customers","Customers interest of kitResfing".
  • eventHubName: Ange ett namn för strömmen till din Azure Event Hubs mål.
  • Include Segment Names: Växla om du vill att dataexporten ska inkludera namnen på de målgrupper som du exporterar. Ett exempel på en dataexport med det här alternativet markerat finns i Exporterade data vidare nedan.
  • Include Segment Timestamps: Växla om du vill att dataexporten ska inkludera UNIX-tidsstämpeln när målgrupperna skapades och uppdaterades, samt UNIX-tidsstämpeln när målgrupperna mappades till målet för aktiveringen. Ett exempel på en dataexport med det här alternativet markerat finns i Exporterade data vidare nedan.

Aktivera aviseringar enable-alerts

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

Aktivera målgrupper till det här målet activate

IMPORTANT

Se Aktivera målgruppsdata till exportmål för direktuppspelningsprofiler för instruktioner om hur du aktiverar målgrupper till det här målet.

Beteende vid export av profiler profile-export-behavior

Experience Platform optimerar exportbeteendet för profiler för Azure Event Hubs mål, så att endast data exporteras till destinationen när relevanta uppdateringar av en profil har gjorts efter målgruppskvalifikation eller andra viktiga händelser. Profiler exporteras till ditt mål i följande situationer:

  • Profiluppdateringen bestäms av en ändring av målgruppsmedlemskap för minst en av målgrupperna som är mappad till målet. Profilen har till exempel kvalificerats för en av de målgrupper som är mappade till målet eller har avslutat en av de målgrupper som är mappade till målet.
  • Profiluppdateringen bestäms av en ändring i identitetskarta. En profil som redan är kvalificerad för en av de målgrupper som är mappade till målet har till exempel lagts till som en ny identitet i attributet för identitetskarta.
  • Profiluppdateringen bestäms av en attributändring för minst ett av attributen som är mappade till målet. Ett av attributen som är mappade till målet i mappningssteget läggs till i en profil.

I alla de fall som beskrivs ovan exporteras endast de profiler där relevanta uppdateringar har gjorts till ditt mål. Om en målgrupp som mappats till målflödet till exempel har hundra medlemmar och fem nya profiler kvalificerar sig för segmentet, kommer exporten till målplatsen att vara inkrementell och endast innehålla de fem nya profilerna.

Observera att alla mappade attribut exporteras för en profil, oavsett var ändringarna finns. I exemplet ovan exporteras alltså alla mappade attribut för de fem nya profilerna även om attributen inte har ändrats.

Vad avgör en dataexport och vad som ingår i exporten what-determines-export-what-is-included

När det gäller data som exporteras för en viss profil är det viktigt att förstå de två olika begreppen i vad som avgör dataexport till Azure Event Hubs mål och vilka data som inkluderas i exporten.

Vad avgör en målexport
Vad som ingår i målexporten
  • Kopplade attribut och målgrupper fungerar som referens för en målexport. Det innebär att om någon mappad publik ändrar tillstånd (från null till realized eller från realized till exiting) eller om mappade attribut uppdateras, kommer en målexport att startas.
  • Eftersom identiteter inte kan mappas till Azure Event Hubs destinationer, ändringar av en identitet i en viss profil avgör också destinationsexporten.
  • En ändring för ett attribut definieras som en uppdatering för attributet, oavsett om det är samma värde eller inte. Det innebär att en överskrivning av ett attribut betraktas som en ändring även om värdet i sig inte har ändrats.
  • The segmentMembership -objektet innehåller den målgrupp som mappas i aktiveringsdataflödet, för vilket profilens status har ändrats efter en kvalificerings- eller målgruppsavslutningshändelse. Observera att andra omappade målgrupper som profilen är kvalificerad för kan ingå i målexporten om dessa målgrupper tillhör samma sammanfogningsprincip som målgruppen mappas i aktiveringsdataflödet.
  • Alla identiteter i identityMap -objektet ingår också (Experience Platform stöder för närvarande inte identitetsmappning i Azure Event Hubs mål).
  • Endast de mappade attributen inkluderas i målexporten.

Tänk dig till exempel det här dataflödet som en Azure Event Hubs mål där tre målgrupper har valts i dataflödet och fyra attribut har mappats till målet.

Amazon Kinesis måldataflöde

En profilexport till målet kan bestämmas av en profil som kvalificerar för eller avslutar en av tre mappade segment. I dataexporten kan du dock segmentMembership objekt (se Exporterade data nedan) kan andra omappade målgrupper visas om den aktuella profilen är medlem av dem och om dessa delar samma sammanfogningsprincip som den målgrupp som utlöste exporten. Om en profil kvalificerar sig för Kund med DeLorean Cars , men är även medlem i Tittat på "Tillbaka till framtiden" film och Science fiction fans segment, så kommer dessa två andra målgrupper också att vara närvarande i segmentMembership dataexportens objekt, även om dessa inte är mappade i dataflödet, om dessa delar samma sammanfogningsprincip med Kund med DeLorean Cars segment.

När det gäller profilattribut kommer alla ändringar av de fyra attribut som mappas ovan att avgöra målexporten och alla de fyra mappade attributen som finns i profilen kommer att finnas i dataexporten.

Bakgrundsfyllning av historiska data historical-data-backfill

När du lägger till en ny målgrupp till ett befintligt mål, eller när du skapar ett nytt mål och mappar målgrupper till det, exporterar Experience Platform historiska data om målgruppskvalificering till målet. Profiler som är kvalificerade för målgruppen före målgruppen lades till i målet och exporteras till målet inom ungefär en timme.

Exporterade data exported-data

Dina exporterade Experience Platform data får plats i Azure Event Hubs mål i JSON-format. Exporten nedan innehåller till exempel en profil som har kvalificerats för ett visst segment, är medlem i ett annat segment och har avslutat ett annat segment. Exporten innehåller också profilattributets förnamn, efternamn, födelsedatum och personlig e-postadress. Identiteterna för den här profilen är ECID och e-post.

{
  "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"
      }
    ]
  }
}

Nedan visas ytterligare exempel på exporterade data, beroende på vilka användargränssnittsinställningar du har valt i anslutningsmålflödet för Include Segment Names och Include Segment Timestamps alternativ:

Exemplet på dataexport nedan innehåller publiknamnen i segmentMembership section
code language-json
"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"
          }
        }
      }
Exemplet på dataexport nedan innehåller målgruppstidsstämplar i segmentMembership section
code language-json
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Begränsningar och återförsöksprincip limits-retry-policy

På 95 % av tiden försöker Experience Platform att erbjuda en genomströmningslatens på mindre än 10 minuter för meddelanden som skickats utan fel med en hastighet på mindre än 10 000 begäranden per sekund för varje dataflöde till en HTTP-destination.

Om det uppstår misslyckade begäranden till HTTP API-målet, lagrar Experience Platform de misslyckade förfrågningarna och försöker skicka dem till slutpunkten två gånger.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6