Connessione Azure Event Hubs

Panoramica

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.

Puoi creare una connessione in uscita in tempo reale al tuo Azure Event Hubs archiviazione per lo streaming dei dati da Adobe Experience Platform.

• Per ulteriori informazioni su Azure Event Hubs, vedere Documentazione di Microsoft.
• Per connettersi a Azure Event Hubs a livello di programmazione, vedere Tutorial sull’API per Streaming Destinations.
• Per connettersi a Azure Event Hubs utilizzando l’interfaccia utente di Platform, consulta le sezioni seguenti.

Casi di utilizzo

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". Mediante la mappatura del pubblico in cui rientra il potenziale cliente su Azure Event Hubs destinazione, 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

Questa sezione descrive il tipo di pubblico che puoi esportare in questa destinazione.

Tipo e frequenza di esportazione

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

Indirizzo IP inserito nell'elenco Consentiti

Per soddisfare i requisiti di sicurezza e conformità dei clienti, Experienci Platform fornisce un elenco di IP statici che è possibile inserire nell'elenco Consentiti per l interfaccia Azure Event Hubs destinazione. Fai riferimento a ELENCO CONSENTITI di indirizzo IP per destinazioni di streaming inserire nell'elenco Consentiti per l’elenco completo degli IP da.

Connetti alla destinazione

Per connettersi a questa destinazione, seguire i passaggi descritti in esercitazione sulla configurazione della destinazione. Quando ti connetti a questa destinazione, devi fornire le seguenti informazioni:

Informazioni di autenticazione

Autenticazione standard

Se si seleziona la Autenticazione standard digita per connetterti all’endpoint HTTP, inserisci i campi seguenti e seleziona 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. Il sasPolicy che il sasKey corrisponde a deve avere gestire diritti configurati per il popolamento dell’elenco Hub eventi. Scopri come eseguire l’autenticazione in Azure Event Hubs con le chiavi SAS nel Documentazione di Microsoft.
• Namespace: compila il Azure Event Hubs spazio dei nomi. Informazioni su Azure Event Hubs spazi dei nomi in Documentazione di Microsoft.

Autenticazione con firma di accesso condiviso (SAS)

Se si seleziona la Autenticazione standard digita per connetterti all’endpoint HTTP, inserisci i campi seguenti e seleziona 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. Il sasPolicy che il sasKey corrisponde a deve avere gestire diritti configurati per il popolamento dell’elenco Hub eventi. Scopri come eseguire l’autenticazione in Azure Event Hubs con le chiavi SAS nel Documentazione di Microsoft.
• Namespace: compila il Azure Event Hubs spazio dei nomi. Informazioni su Azure Event Hubs spazi dei nomi in Documentazione di Microsoft.
• Nome hub eventi: compila il Azure Event Hub nome . Informazioni su Azure Event Hubs nomi in Documentazione di Microsoft.

Inserisci i dettagli della destinazione

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.

• Nome: specifica un nome per la connessione a Azure Event Hubs.
• Descrizione: fornisci una descrizione della connessione. Esempi: "Clienti di livello Premium", "Clienti interessati al kitesurfing".
• eventHubName: specifica un nome per il flusso nel Azure Event Hubs destinazione.
• 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, fai riferimento al 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 sulla destinazione per l’attivazione. Per un esempio di esportazione di dati con questa opzione selezionata, fai riferimento al Dati esportati più avanti.

Abilita avvisi

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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attiva il pubblico in questa destinazione

Consulta Attivare i dati del pubblico nelle destinazioni di esportazione del profilo di streaming per istruzioni sull’attivazione dei tipi di pubblico in questa destinazione.

Comportamento di esportazione del profilo

Experience Platform ottimizza il comportamento di esportazione del profilo in Azure Event Hubs destinazione, per esportare i dati nella destinazione solo quando si sono verificati aggiornamenti rilevanti di un profilo in seguito alla qualifica di un pubblico o 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

Per quanto riguarda i dati esportati per un determinato profilo, è importante comprendere i due diversi concetti di cosa determina un’esportazione di dati nel Azure Event Hubs destinazione e quali dati sono inclusi nell’esportazione.

Ad esempio, considera questo flusso di dati come un Azure Event Hubs destinazione in cui tre tipi di pubblico sono selezionati nel flusso di dati e quattro attributi sono 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, nella segmentMembership oggetto (vedere Dati esportati sezione seguente), 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 Cliente con auto DeLorean ma è anche membro del gruppo Guarda "Ritorno al futuro" film e Fantascienza segmenti, quindi anche questi altri due tipi di pubblico saranno presenti nel segmentMembership oggetto dell’esportazione di dati, anche se non sono mappati nel flusso di dati, se condividono lo stesso criterio di unione con Cliente con auto DeLorean segmento.

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 quando crei una nuova destinazione e mappi i tipi di pubblico a essa, Experienci Platform esporta i dati storici di qualificazione del pubblico nella destinazione. Profili qualificati per il pubblico prima di il pubblico aggiunto alla destinazione viene esportato nella destinazione entro circa un'ora.

Dati esportati

Il tuo esportato Experience Platform i dati vengono inseriti nel Azure Event Hubs destinazione 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 Includi nomi segmento e Includi marche temporali segmento opzioni:

"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

Nel 95% del tempo, Experienci 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, Experienci Platform memorizza le richieste non riuscite e tenta di inviarle all’endpoint due volte.

Risorse Business.Adobe.com