[Ultimate]{class="badge positive"}

Connessione Azure Event Hubs

Panoramica overview

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 inviare dati da Adobe Experience Platform.

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.

Tipi di pubblico supportati per tipo di dati sul pubblico:

Tipo e frequenza di esportazione export-type-frequency

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

Indirizzo IP inserito nell’elenco Consentiti ip-address-allowlist

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

Connettersi tramite Azure Private Link private-link

Se la tua organizzazione ha dei requisiti di sicurezza di rete rigidi, puoi configurare questa destinazione per instradare le esportazioni di dati sulla backbone privata Microsoft Azure invece che su Internet pubblica. Per i prerequisiti, i guardrail e i passaggi di configurazione, consulta Azure Private Link for destinations.

Connettersi alla destinazione connect

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

Se si seleziona il tipo Autenticazione standard per connettersi all’endpoint HTTP, immettere i campi seguenti e selezionare Connetti alla destinazione:

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

Se si seleziona il tipo Autenticazione standard per connettersi all’endpoint HTTP, immettere i campi seguenti e selezionare Connetti alla destinazione:

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.

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

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:

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.

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.

Un’esportazione di profilo nella destinazione può essere determinata da un profilo idoneo o in uscita da uno dei tre tipi di pubblico mappati. Quando l’opzione Includi solo tipi di pubblico mappati è attivata, l’oggetto segmentMembership (vedi la sezione Dati esportati di seguito) include solo i tre tipi di pubblico mappati. Se questa opzione è disattivata, è possibile che nell’oggetto segmentMembership vengano visualizzati anche altri tipi di pubblico non mappati, se quel particolare profilo è un membro di tali tipi di pubblico e se questi condividono lo stesso criterio di unione del pubblico che ha attivato l’esportazione. Ad esempio, se un profilo è idoneo per il pubblico Customer with DeLorean Cars ed è anche membro del pubblico Basic Site Active and City - Dallas, anche questi altri due tipi di pubblico vengono visualizzati nell’oggetto segmentMembership quando Include mapped audiences only è disattivato, a condizione che condividano lo stesso criterio di unione con il pubblico Customer with 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 historical-data-backfill

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 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 della connessione per le opzioni Includi nomi di pubblico e Includi marche temporali pubblico:

"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": {
        "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% dei casi, Experience Platform tenta di offrire una latenza di velocità effettiva inferiore a 10 minuti per i messaggi inviati con successo, con una frequenza inferiore a 10.000 richieste al secondo per ogni flusso di dati verso 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.