[Ultimate]{class="badge positive"}

Connessione Azure Event Hubs

Panoramica overview

IMPORTANT
Questa destinazione è disponibile solo per clienti Adobe Real-time Customer Data Platform Ultimate.

Azure Event Hubs è una piattaforma di streaming di big data e un servizio di acquisizione 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 all'archivio Azure Event Hubs per eseguire lo streaming dei dati da Adobe Experience Platform.

  • Per ulteriori informazioni su Azure Event Hubs, consulta la documentazione di Microsoft.
  • Per connettersi a Azure Event Hubs a livello di programmazione, vedere l'esercitazione sull'API delle destinazioni di streaming.
  • Per connettersi a Azure Event Hubs tramite l'interfaccia utente di Platform, vedere le sezioni seguenti.

AWS Kinesis nellinterfaccia utente

Casi d’uso use-cases

Utilizzando destinazioni di streaming come Azure Event Hubs, puoi inserire facilmente eventi di segmentazione di alto valore e attributi di profilo associati nei sistemi preferiti.

Ad esempio, un potenziale cliente ha scaricato un white paper che li qualifica come segmenti ad "alta propensione alla conversione". Mappando il pubblico in cui rientra il potenziale cliente alla destinazione Azure Event Hubs, riceverai questo evento in Azure Event Hubs. In questo caso, è possibile utilizzare un approccio fai-da-te e descrivere la logica di business oltre all'evento, in base al principio che si potrebbe utilizzare al meglio con i sistemi IT aziendali.

Tipi di pubblico supportati supported-audiences

Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.

Origine pubblico
Supportato
Descrizione
Segmentation Service
Tipi di pubblico generati tramite il servizio di segmentazione Experience Platform.
Caricamenti personalizzati
Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Basato su profilo
Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), come scelto nella schermata seleziona attributi profilo del flusso di lavoro di attivazione della destinazione.
Frequenza di esportazione
Streaming
Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Indirizzo IP inserisco nell'elenco Consentiti ip-address-allowlist

Per soddisfare i requisiti di sicurezza e conformità dei clienti, Experience Platform inserire nell'elenco Consentiti fornisce un elenco di IP statici che è possibile per la destinazione Azure Event Hubs. Per l'elenco completo degli IP da elenco consentiti, consulta l'elenco Consentiti di indirizzo IP per le destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per 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 authentication-information

Autenticazione standard standard-authentication

Immagine della schermata dellinterfaccia utente che mostra i campi completati per i dettagli di autenticazione standard di Azure Event Hubs

Se si seleziona il tipo Autenticazione standard per connettersi all'endpoint HTTP, immettere i campi seguenti e selezionare Connetti alla 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 sasPolicy a cui corrisponde sasKey devono 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.

Autenticazione con firma di accesso condiviso (SAS) sas-authentication

Immagine della schermata dellinterfaccia utente che mostra i campi completati per i dettagli di autenticazione standard di Azure Event Hubs

Se si seleziona il tipo Autenticazione standard per connettersi all'endpoint HTTP, immettere i campi seguenti e selezionare Connetti alla 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 sasPolicy a cui corrisponde sasKey devono 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 destination-details

Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.

Immagine della schermata dellinterfaccia utente che mostra i campi completati per i dettagli di destinazione degli hub eventi di Azure

  • Nome: immettere un nome per la connessione a Azure Event Hubs.
  • Descrizione: fornire una descrizione della connessione. Esempi: "Clienti di livello Premium", "Clienti interessati al kitesurfing".
  • eventHubName: fornisci un nome per il flusso nella destinazione Azure Event Hubs.
  • Includi nomi segmento: attiva questa opzione se vuoi 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, consulta la sezione Dati esportati più avanti.
  • Includi marche temporali segmento: attiva questa opzione se desideri che l'esportazione dei dati includa la marca temporale UNIX di quando i tipi di pubblico sono stati creati e aggiornati, nonché la marca temporale UNIX di quando i tipi di pubblico sono stati mappati alla destinazione per l'attivazione. Per un esempio di esportazione di dati con questa opzione selezionata, consulta la sezione Dati esportati più avanti.

Abilita avvisi enable-alerts

Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.

Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

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 profile-export-behavior

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 è idoneo per uno dei tipi di pubblico mappati sulla destinazione o è uscito da uno dei tipi di pubblico mappati sulla destinazione.
  • L'aggiornamento del profilo è stato determinato da una modifica nella mappa identità. Ad esempio, a un profilo che si era già qualificato per uno dei tipi di pubblico mappati sulla destinazione è stata aggiunta una nuova identità nell’attributo identity map.
  • 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 sulla destinazione nel passaggio di mappatura viene aggiunto a un profilo.

In tutti i casi descritti sopra, 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 sono idonei per il segmento, l’esportazione nella destinazione è incrementale e include solo i cinque nuovi profili.

Tieni presente che tutti gli attributi mappati vengono esportati per un profilo, indipendentemente da dove si trovano le modifiche. Quindi, nell’esempio precedente, tutti gli attributi mappati per questi cinque nuovi profili verranno esportati anche se gli attributi stessi non sono stati modificati.

Che cosa determina un’esportazione di dati e cosa è incluso nell’esportazione what-determines-export-what-is-included

Per quanto riguarda i dati esportati per un determinato profilo, è importante comprendere i due diversi concetti di ciò che determina un'esportazione di dati nella Azure Event Hubs destinazione e quali dati sono inclusi nell'esportazione.

Cosa determina un’esportazione di destinazione
Cosa è incluso nell’esportazione di destinazione
  • Gli attributi e i tipi di pubblico mappati fungono da spunto per un’esportazione di destinazione. Ciò significa che se uno dei tipi di pubblico mappati cambia stato (da null a realized o da realized a exiting) o se uno qualsiasi degli attributi mappati viene aggiornato, viene 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 segmentMembership include 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 (l'Experience Platform attualmente non supporta il mapping delle identità nella destinazione Azure Event Hubs).
  • Nell’esportazione della destinazione sono inclusi solo gli attributi mappati.

Consideriamo ad esempio questo flusso di dati su una destinazione Azure Event Hubs in cui tre tipi di pubblico sono selezionati nel flusso di dati e quattro attributi sono mappati alla destinazione.

Flusso di dati di destinazione di Amazon Kinesis

Un'esportazione di profilo nella destinazione può essere determinata da un profilo idoneo o in uscita da uno dei tre segmenti mappati. Tuttavia, nell'esportazione dei dati, nell'oggetto segmentMembership (vedi la sezione Dati esportati di seguito), potrebbero essere visualizzati altri tipi di pubblico non mappati, se quel particolare profilo è un membro di essi e se questi condividono lo stesso criterio di unione del pubblico che ha attivato l'esportazione. Se un profilo è idoneo per il pubblico Cliente con auto DeLorean ma è anche membro dei segmenti Guardato "Ritorno al futuro" film e Fantascienza, anche questi altri due tipi di pubblico saranno presenti nell'oggetto segmentMembership dell'esportazione dati, anche se non sono mappati nel flusso di dati, se condividono lo stesso criterio di unione con il segmento Cliente con auto DeLorean.

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 historical-data-backfill

Quando aggiungi un nuovo pubblico a una destinazione esistente o quando 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 exported-data

I dati di Experience Platform esportati arrivano nella destinazione di 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:

L<>esempio di esportazione dei dati seguente include i nomi del pubblico nella sezione segmentMembership
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"
          }
        }
      }
L<>esempio di esportazione dei dati seguente include i timestamp del pubblico nella sezione segmentMembership
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,
          }
        }
      }

Limiti e criteri per nuovi tentativi limits-retry-policy

Nel 95% del tempo, Experience Platform tenta di offrire una latenza di velocità effettiva inferiore a 10 minuti per i messaggi inviati correttamente con una frequenza inferiore a 10.000 richieste al secondo per ogni flusso di dati a una destinazione HTTP.

In caso di richieste non riuscite alla destinazione API HTTP, Experience Platform memorizza le richieste non riuscite e tenta di inviarle all’endpoint due volte.

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