(Beta) Amazon Kinesis connection

Panoramica

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.

• Per ulteriori informazioni Amazon Kinesis, vedi Documentazione di Amazon.
• Per connettersi a Amazon Kinesis a livello di programmazione, consulta Esercitazione API per lo streaming delle destinazioni.
• Per connettersi a Amazon Kinesis utilizzando l’interfaccia utente di Platform, consulta le sezioni seguenti.

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 di esportazione

Basato su profilo - si esportano tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), come scelto dalla schermata Seleziona attributi del flusso di lavoro di attivazione del pubblico.

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/*"
            ]
        }
    ]
}

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

Collegati alla destinazione

Per connettersi a questa destinazione, segui i passaggi descritti in esercitazione sulla configurazione della destinazione.

Parametri di connessione

Quando configurazione questa destinazione, devi fornire le seguenti informazioni:

• 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.
• 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.

Attiva i segmenti in questa destinazione

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 nella destinazione Amazon Kinesis, in modo da esportare i dati nella destinazione solo quando si sono verificati aggiornamenti rilevanti a un profilo in seguito alla qualifica del segmento o altri eventi significativi. I profili vengono esportati nella destinazione nelle situazioni seguenti:

• L’aggiornamento del profilo è stato attivato 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 attivato da una modifica nella 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 attivato 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.

Dati esportati

Esportazione Experience Platform i dati si aprono in Amazon Kinesis in formato JSON. Ad esempio, l’esportazione seguente contiene un profilo qualificato per un determinato segmento ed uscito da un altro segmento e include 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": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}