Amazon Kinesis connection

Panoramica

IMPORTANTE

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

La Kinesis Data Streams servizio Amazon Web Services consente di raccogliere ed elaborare grandi flussi di record di dati in tempo reale.

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

Amazon Kinesis nell’interfaccia utente

Casi d’uso

Utilizzando destinazioni di streaming come Amazon Kinesis, puoi facilmente inserire nei tuoi sistemi di scelta gli eventi di segmentazione di alto valore e gli attributi di profilo associati.

Ad esempio, un prospect ha scaricato un white paper che li qualifica in un segmento "alta propensione alla conversione". Mappando il segmento in cui rientra il potenziale di crescita Amazon Kinesis destinazione, riceverai questo evento in Amazon Kinesis. In questo caso, è possibile utilizzare un approccio fai-da-te e descrivere la logica di business al di sopra dell'evento, in quanto si ritiene che funzionerebbe meglio con i sistemi IT aziendali.

Tipo e frequenza di esportazione

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, fare riferimento alla 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 delle esportazioni Streaming Le destinazioni di streaming sono connessioni basate su API "sempre attive". Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del segmento, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni destinazioni di streaming.

inserire nell'elenco Consentiti indirizzo IP

Per soddisfare i requisiti di sicurezza e conformità dei clienti, Experience Platform fornisce un elenco di IP statici che puoi inserire nell'elenco Consentiti per Amazon Kinesis destinazione. Fai riferimento a ELENCO CONSENTITI di indirizzi IP per le destinazioni di streaming per l’elenco completo degli IP da inserire nell'elenco Consentiti.

Obbligatorio Amazon Kinesis permissions

Per connettere ed esportare correttamente i dati al tuo Amazon Kinesis flussi, Experience Platform richiede autorizzazioni per le seguenti azioni:

  • kinesis:ListStreams
  • kinesis:PutRecord
  • kinesis:PutRecords

Queste autorizzazioni sono organizzate tramite Kinesis e vengono controllati da Platform una volta configurata la destinazione Kinesis nell’interfaccia utente di Platform.

L’esempio seguente visualizza i diritti di accesso minimi necessari per esportare correttamente i dati in un Kinesis destinazione.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams",
                "kinesis:PutRecord",
                "kinesis:PutRecords"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}
Proprietà Descrizione
kinesis:ListStreams Un’azione che elenca i flussi di dati Kinesis di Amazon.
kinesis:PutRecord Azione che scrive un singolo record di dati in un flusso di dati Kinesis.
kinesis:PutRecords Azione che scrive più record di dati in un flusso di dati Kinesis in una singola chiamata.

Per ulteriori informazioni sul controllo dell'accesso per Kinesis flussi di dati, leggi quanto segue Kinesis documento.

Collegati alla destinazione

IMPORTANTE

Per connettersi alla destinazione, è necessario Gestire le destinazioni autorizzazione controllo accessi. Leggi la sezione panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni richieste.

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

Informazioni di autenticazione

Inserisci i campi seguenti e seleziona Connetti alla destinazione:

Immagine della schermata dell’interfaccia utente che mostra i campi completati per i dettagli di autenticazione di Amazon Kinesis

  • Amazon Web Serviceschiave di accesso e chiave segreta: In Amazon Web Services, genera un access key - secret access key per concedere a Platform l’accesso al tuo Amazon Kinesis conto. Ulteriori informazioni nel Documentazione di Amazon Web Services.
  • Regione: Indicare quale Amazon Web Services da regione a flusso di dati.

Compila 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 nell’interfaccia utente indica che il campo è obbligatorio.

Immagine della schermata dell’interfaccia utente che mostra i campi completati per i dettagli di destinazione di Amazon Kinesis

  • Nome: Specifica un nome per la connessione a Amazon Kinesis
  • Descrizione: Fornire una descrizione della connessione a Amazon Kinesis.
  • flusso: Immetti il nome di un flusso di dati esistente nel tuo Amazon Kinesis conto. Platform esporta i dati in questo flusso.
  • Includi nomi dei segmenti: Attiva/disattiva se desideri che l’esportazione dei dati includa i nomi dei segmenti che stai esportando. Per un esempio di esportazione di dati con questa opzione selezionata, consulta Dati esportati più avanti.
  • Includi marche temporali del segmento: Attiva/disattiva se desideri che l’esportazione dei dati includa la marca temporale UNIX al momento della creazione e dell’aggiornamento dei segmenti, nonché la marca temporale UNIX al momento della mappatura dei segmenti alla destinazione per l’attivazione. Per un esempio di esportazione di dati con questa opzione selezionata, consulta Dati esportati più avanti.

Abilitare gli avvisi

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

Una volta completati i dettagli della connessione di destinazione, seleziona Successivo.

Attiva i segmenti in questa destinazione

IMPORTANTE

Per attivare i dati, è necessario Gestire le destinazioni, Attivare le destinazioni, Visualizza profili e Visualizzare i segmenti autorizzazioni di controllo accessi. Leggi la sezione panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni richieste.

Vedi Attivare i dati del pubblico nelle destinazioni di esportazione del profilo in streaming per istruzioni su come attivare i segmenti di pubblico a questa destinazione.

Comportamento dell’esportazione del profilo

Experience Platform ottimizza il comportamento di esportazione del profilo nel tuo Amazon Kinesis per esportare i dati nella destinazione solo quando si sono verificati aggiornamenti rilevanti a un profilo in seguito alla qualifica del segmento o ad altri eventi significativi. I profili vengono esportati nella destinazione nelle situazioni seguenti:

  • L’aggiornamento del profilo è stato determinato da una modifica dell’appartenenza al segmento per almeno uno dei segmenti mappati alla destinazione. Ad esempio, il profilo si è qualificato per uno dei segmenti mappati alla destinazione o è uscito da uno dei segmenti mappati alla destinazione.
  • L'aggiornamento del profilo è stato determinato da una modifica nel mappa identità. Ad esempio, a un profilo già qualificato per uno dei segmenti mappati alla destinazione è stata aggiunta una nuova identità nell’attributo di 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 nel passaggio di mappatura viene aggiunto a un profilo.

In tutti i casi descritti in precedenza, vengono esportati nella destinazione solo i profili in cui si sono verificati aggiornamenti rilevanti. Ad esempio, se un segmento mappato al flusso di destinazione ha un centinaio di membri e cinque nuovi profili sono qualificati 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 trovino le modifiche. Nell’esempio precedente, quindi, tutti gli attributi mappati per questi cinque nuovi profili verranno esportati anche 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 determina un’esportazione di dati nel tuo Amazon Kinesis destinazione e quali dati sono inclusi nell'esportazione.

Cosa determina un’esportazione di destinazione Contenuto dell’esportazione di destinazione
  • Gli attributi e i segmenti mappati fungono da spunto per un’esportazione di destinazione. Ciò significa che, se uno dei segmenti mappati cambia stato (da null a Realizzato o da Realizzato/Esistente a Uscire) o qualsiasi attributo mappato viene aggiornato, verrà avviata un’esportazione di destinazione.
  • Poiché le identità non possono attualmente essere mappate su Amazon Kinesis le destinazioni, le modifiche apportate a qualsiasi identità in un determinato profilo determinano anche le esportazioni di destinazione.
  • Una modifica per un attributo è definita come qualsiasi aggiornamento sull'attributo, che sia o meno lo stesso valore. Ciò significa che una sovrascrittura su un attributo viene considerata una modifica anche se il valore stesso non è stato modificato.
  • Tutti i segmenti (con lo stato di appartenenza più recente), indipendentemente dal fatto che siano mappati nel flusso di dati o meno, sono inclusi nel segmentMembership oggetto.
  • Tutte le identità nel identityMap sono inclusi anche gli oggetti (l'Experience Platform attualmente non supporta la mappatura dell'identità nel Amazon Kinesis destinazione).
  • Solo gli attributi mappati sono inclusi nell’esportazione di destinazione.

Ad esempio, considera questo flusso di dati come un Amazon Kinesis destinazione in cui tre segmenti sono selezionati nel flusso di dati e quattro attributi sono mappati sulla destinazione.

Flusso di dati di destinazione di Amazon Kinesis

Un’esportazione di profilo verso la destinazione può essere determinata da un profilo che qualifica o esce da uno dei tre segmenti mappati. Tuttavia, nell’esportazione dei dati, nella segmentMembership oggetto (vedere Dati esportati di seguito), potrebbero essere visualizzati altri segmenti non mappati, se quel particolare profilo è membro di essi. Se un profilo è idoneo per il segmento Cliente con DeLorean Cars ma è anche membro dei segmenti Orologio "Torna al futuro" film e appassionati di fantascienza, allora questi altri due segmenti saranno anche presenti nel segmentMembership oggetto dell’esportazione dei dati, anche se non sono mappati nel flusso di dati.

Dal punto di vista degli attributi del profilo, eventuali modifiche ai quattro attributi mappati sopra determineranno un’esportazione di destinazione e uno qualsiasi dei quattro attributi mappati presenti sul profilo sarà presente nell’esportazione dei dati.

Recupero dati storici

Quando aggiungi un nuovo segmento a una destinazione esistente o quando crei una nuova destinazione e mappi segmenti su di essa, Experience Platform esporta i dati storici di qualificazione dei segmenti alla destinazione. Profili qualificati per il segmento prima il segmento aggiunto alla destinazione viene esportato nella destinazione entro circa un’ora.

Dati esportati

Esportazione Experience Platform i dati arrivano nel tuo Amazon Kinesis destinazione in formato JSON. Ad esempio, l’esportazione seguente contiene un profilo qualificato per un determinato segmento, è membro di altri due segmenti ed è uscita da un altro segmento. L’esportazione include anche il nome dell’attributo del profilo, il cognome, la data di nascita e l’indirizzo e-mail personale. Le identità di questo profilo sono ECID ed 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":"existing"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"existing"
      },
      "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 il Includi nomi dei segmenti e Includi marche temporali del segmento opzioni:

 L’esempio di esportazione dei dati riportato di seguito include i nomi dei segmenti nel segmentMembership sezione
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }
 L’esempio di esportazione dei dati riportato di seguito include le marche temporali del segmento nel segmentMembership sezione
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Limiti e nuovo criterio

Nel 95% del tempo, Experience Platform tenta di offrire una latenza di throughput inferiore a 10 minuti per i messaggi inviati con successo con una velocità 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 due volte di inviare le richieste all’endpoint.

In questa pagina