Ultimate
Azure Event Hubs connessione
- Argomenti:
- Destinazioni
Creato per:
- Amministratore
- Utente
Panoramica
IMPORTANTAzure Event Hubs è una piattaforma di streaming big data e un servizio di inserimento di eventi. Può ricevere ed elaborare milioni di eventi al secondo. I dati inviati a un hub eventi possono essere trasformati e memorizzati utilizzando qualsiasi provider di analisi in tempo reale o adattatori di batch/archiviazione.
È possibile creare una connessione in uscita in tempo reale allo spazio di Azure Event Hubs archiviazione per lo streaming di dati da Adobe Experience Platform.
- Per ulteriori informazioni su Azure Event Hubs, vedere la documentazione Microsoft.
- Per connetterti a Azure Event Hubs livello di programmazione, vedi l'API Destinazioni in streaming esercitazione.
- Per connetterti utilizzando Azure Event Hubs l'interfaccia Experience Platform utente, consulta le sezioni seguenti.
Casi d’uso
Utilizzando destinazioni di streaming come Azure Event Hubs, è possibile feed facilmente eventi Segmentazione di alto valore e attributi di profilo associati nei sistemi preferiti.
Ad esempio, un potenziale cliente ha scaricato un white paper che lo qualifica in un segmento "ad alta propensione alla convertire". Mappando il pubblico in cui rientra il potenziale cliente alla Azure Event Hubs destinazione, riceverai questo evento in Azure Event Hubs. Lì, puoi utilizzare un approccio fai-da-te e descrivere logica di business in cima all'evento, poiché ritieni possa funzionare meglio con i tuoi sistemi IT aziendali.
Pubblico supportato
In questa sezione vengono descritti i tipi di pubblico che puoi esportare verso questa destinazione.
Tipo e frequenza di esportazione
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
Elenco indirizzi IP consentiti
Per soddisfare i requisiti di sicurezza e conformità dei clienti, Experience Platform fornisce un elenco di IP statici che è possibile elencare per la Azure Event Hubs destinazione. Per l'elenco completo degli IP da elenco consentiti, consulta l'elenco Consentiti di indirizzo IP per le destinazioni di streaming.
Connettersi alla destinazione
IMPORTANTPer connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Quando ti connetti a questa destinazione, devi fornire le seguenti informazioni:
Informazioni di autenticazione
Autenticazione standard
Se si seleziona il tipo di autenticazione Standard per connettersi all'endpoint HTTP, immettere i campi seguenti e selezionare Connetti a destinazione:
- Nome chiave SAS: il nome del regola di autorizzazione, noto anche come nome della chiave SAS.
- Chiave SAS: la chiave primaria dello spazio dei nomi di Hub eventi. Affinché
sasPolicyl'elenco di Hub eventi possa essere compilato, è necessario che l'elencosasKeydi Hub eventi disponga di diritti gestire . Scopri come eseguire l'autenticazione in Azure Event Hubs con le chiavi SAS nella documentazione di Microsoft. - Spazio dei nomi: compila il tuo spazio dei nomi Azure Event Hubs. Scopri gli spazi dei nomi Azure Event Hubs nella documentazione di Microsoft.
Autenticazione con firma di accesso condiviso (SAS)
Se si seleziona il tipo di autenticazione Standard per connettersi all'endpoint HTTP, immettere i campi seguenti e selezionare Connetti a destinazione:
- Nome chiave SAS: nome della regola di autorizzazione, noto anche come nome della chiave SAS.
- Chiave SAS: chiave primaria dello spazio dei nomi degli hub eventi. I
sasPolicya cui corrispondesasKeydevono avere i diritti manage configurati per compilare l'elenco degli hub eventi. Scopri come eseguire l'autenticazione in Azure Event Hubs con le chiavi SAS nella documentazione di Microsoft. - Spazio dei nomi: compila il tuo spazio dei nomi Azure Event Hubs. Scopri gli spazi dei nomi Azure Event Hubs nella documentazione di Microsoft.
- Nome hub eventi: immettere il nome Azure Event Hub. Scopri i nomi di Azure Event Hubs nella documentazione di Microsoft.
Inserire i dettagli della destinazione
Per configurare i dettagli della destinazione, compila i campi obbligatori e facoltativi riportati di seguito. Un asterisco accanto a un campo nel interfaccia indica che il campo è obbligatorio.
- Nome: inserisci un nome per la connessione a Azure Event Hubs.
- Descrizione: fornisci una descrizione della connessione. Esempi: "Clienti di livello Premium", "Clienti interessati al kitesurf".
- eventHubName: specifica un nome per lo stream fino alla destinazione Azure Event Hubs .
- Includi nomi segmento: attiva questa opzione se desideri che l'esportazione dei dati includa i nomi dei tipi di pubblico che stai esportando. Per un esempio di esportazione di dati con questa opzione selezionata, fare riferimento alla sezione Dati esportati più avanti.
- Includi timestamp segmento: attiva se desideri che l'esportazione dei dati includa il timestamp UNIX quando i tipi di pubblico sono stati creati e aggiornati, nonché il timestamp UNIX quando i tipi di pubblico sono stati mappati alla destinazione per l'attivazione. Per un esempio di esportazione di dati con questa opzione selezionata, fare riferimento alla sezione Dati esportati più avanti.
Abilitare gli avvisi
È possibile abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la destinazione. Seleziona un avviso dall'elenco a cui iscriverti per ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida sulla sottoscrizione agli avvisi relativi alle destinazioni utilizzando il interfaccia.
Dopo aver fornito i dettagli per la connessione di destinazione, selezionare Successivo.
Attivare tipi di pubblico in questa destinazione
IMPORTANT- Per attivare i dati, sono necessarie le autorizzazioni Visualizza Destinazioni], Attiva destinazioni, Profili Visualizza e Segmenti Visualizza accesso controllo. Leggi la panoramica sul [controllo accesso o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- La valutazione dei criteri di consenso non è attualmente supportata nelle esportazioni nella destinazione degli hub eventi di Azure. Ulteriori informazioni.
Per istruzioni sull'attivazione dei tipi di pubblico in questa destinazione, consulta Attiva dati pubblico nelle destinazioni di esportazione del profilo di streaming.
Comportamento di esportazione del profilo
Experience Platform ottimizza il comportamento di esportazione del profilo nella destinazione Azure Event Hubs per esportare i dati nella destinazione solo quando si sono verificati aggiornamenti rilevanti a un profilo in seguito alla qualificazione del pubblico o ad altri eventi significativi. I profili vengono esportati nella destinazione nelle seguenti situazioni:
- L’aggiornamento del profilo è stato determinato da una modifica nell’appartenenza al pubblico per almeno uno dei tipi di pubblico mappati alla destinazione. Ad esempio, il profilo si è qualificato per uno dei tipi di pubblico mappati alla destinazione o è uscito da uno dei tipi di pubblico mappati verso la destinazione.
- L'aggiornamento del profilo è stato determinato da una modifica nella mappa delle identità. Ad esempio, a un profilo che si era già qualificato per uno dei tipi di pubblico mappati alla destinazione è stata aggiunta una nuova identità nell'attributo mappa identità.
- L'aggiornamento del profilo è stato determinato da una modifica degli attributi per almeno uno degli attributi mappati alla destinazione. Ad esempio, uno degli attributi mappati alla destinazione nella fase di mappatura viene aggiunto a un profilo.
In tutti i casi sopra descritti, solo i profili in cui si sono verificati aggiornamenti rilevanti vengono esportati nella destinazione. Ad esempio, se un pubblico mappato al flusso di destinazione ha un centinaio di membri e cinque nuovi profili si qualificano per il segmento, l'esportazione verso la destinazione è incrementale e include solo i cinque nuovi profili.
Tutti gli attributi mappati vengono esportati per un profilo, indipendentemente dalla posizione delle modifiche. Quindi, nell'esempio sopra, tutti gli attributi mappati per questi cinque nuovi profili verranno esportati lineare se gli attributi stessi non sono cambiati.
Cosa determina un'esportazione di dati e cosa è incluso nell'esportazione
Per quanto riguarda i dati esportati per un determinato profilo, è importante comprendere i due diversi concetti di ciò che determina un'esportazione di dati verso la destinazione Azure Event Hubs e quali dati sono inclusi nell'esportazione.
- Gli attributi e i tipi di pubblico mappati fungono da spunto per un’esportazione di destinazione. Ciò significa che se un pubblico mappato cambia stato (da
nullarealizedo darealizedaexiting) o se gli attributi mappati vengono aggiornati, verrà avviata un'esportazione di destinazione. - Poiché al momento non è possibile mappare le identità alle destinazioni Azure Event Hubs, le modifiche in qualsiasi identità su un determinato profilo determinano anche le esportazioni di destinazione.
- Per modifica di un attributo si intende qualsiasi aggiornamento dell'attributo, indipendentemente dal fatto che si tratti o meno dello stesso valore. Ciò significa che una sovrascrittura su un attributo è considerata una modifica anche se il valore stesso non è cambiato.
- L'oggetto
segmentMembershipinclude il pubblico mappato nel flusso di dati di attivazione, per il quale lo stato del profilo è cambiato a seguito di un evento di qualificazione o uscita dal pubblico. Tieni presente che altri tipi di pubblico non mappati per i quali il profilo si è qualificato possono far parte dell'esportazione di destinazione, se tali tipi di pubblico appartengono allo stesso criterio di unione del pubblico mappato nel flusso di dati di attivazione. - Sono incluse anche tutte le identità nell'oggetto
identityMap(Experience Platform attualmente non supporta la mappatura delle Azure Event Hubs identità nella destinazione). - Solo gli attributi mappati sono inclusi nell'esportazione della destinazione.
Ad esempio, considera questo flusso di dati verso una Azure Event Hubs destinazione in cui nel flusso di dati vengono selezionati tre tipi di pubblico e quattro attributi vengono mappati alla destinazione.
Un'esportazione di profilo verso la destinazione può essere determinata da un profilo idoneo o in uscita da uno dei tre segmenti mappati. Tuttavia, nell'esportazione dei dati, nell'oggetto (vedere la segmentMembership sezione Dati esportati di seguito), potrebbero essere visualizzati altri tipi di pubblico non mappati, se quel particolare profilo ne è membro e se condividono lo stesso regola di unione del pubblico che ha attivato l'esportazione. Se un profilo si qualifica per il pubblico del Cliente con DeLorean Cars ma è anche membro dei segmenti Watched "Indietro to the Future"di film e appassionati di fantascienza, allora anche questi altri due pubblici saranno presenti nell'oggetto dell'esportazione segmentMembership dei dati, lineare se questi non sono mappati nel flusso di dati, se condividono lo stesso regola di fusione con il segmento Cliente con DeLorean Cars.
Dal punto di vista degli attributi di profilo, eventuali modifiche ai quattro attributi mappati in precedenza determineranno un’esportazione di destinazione e uno qualsiasi dei quattro attributi mappati presenti nel profilo sarà presente nell’esportazione di dati.
Recupero dati storici
Quando aggiungi un nuovo pubblico a una destinazione esistente o crei una nuova destinazione e mappi i tipi di pubblico a essa, Experience Platform esporta i dati storici di qualificazione del pubblico nella destinazione. I profili qualificati per il pubblico prima che il pubblico sia stato aggiunto alla destinazione vengono esportati nella destinazione entro circa un'ora.
Dati esportati
I dati esportati Experience Platform arrivano nella destinazione Azure Event Hubs in formato JSON. Ad esempio, l’esportazione seguente contiene un profilo idoneo per un determinato segmento, è membro di altri due segmenti ed è uscito da un altro segmento. L’esportazione include anche l’attributo del profilo nome, cognome, data di nascita e indirizzo e-mail personale. Le identità per questo profilo sono ECID e 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"
}
]
}
}
Di seguito sono riportati ulteriori esempi di dati esportati, a seconda delle impostazioni dell'interfaccia utente selezionate nel flusso di destinazione di connessione per le opzioni Includi nomi segmento e Includi marche temporali segmento:
segmentMembership"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"
}
}
}
segmentMembership"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "realized",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
Limiti e criteri per nuovi tentativi
Nel 95% delle volte, Experience Platform tenta di offrire una latenza di throughput inferiore a 10 minuti per i messaggi inviati correttamente con una velocità inferiore a 10 mila richieste al secondo per ogni flusso di dati a una destinazione HTTP.
In caso di richieste non riuscite alla destinazione API HTTP, Experience Platform archivia le richieste non riuscite e riprova due volte a inviare le richieste all'endpoint.