Panoramica dell'estensione AWS
Amazon Web Services (AWS) è una piattaforma di cloud computing che offre un'ampia gamma di servizi quali elaborazione distribuita, archiviazione del database, distribuzione di contenuti e servizi di integrazione SaaS (Software-as-a-Service) per la gestione delle relazioni con i clienti (CRM) e la pianificazione delle risorse aziendali (ERP).
L'estensione AWS event forwarding sfrutta Amazon Kinesis Data Streams per inviare eventi dall'Edge Network di Adobe Experience Platform a AWS per l'ulteriore elaborazione. Questa guida illustra come installare l’estensione e utilizzarne le funzionalità in una regola di inoltro degli eventi.
Prerequisiti
Per utilizzare questa estensione, è necessario disporre di un account AWS con un flusso di dati Kinesis esistente. Se non disponi di un flusso di dati preesistente, consulta la documentazione di AWS su creazione di un nuovo flusso di dati tramite AWS Management Console.
Installare l’estensione install
Per installare l'estensione AWS, passa all'interfaccia utente di Data Collection o all'interfaccia utente Experience Platform e seleziona Inoltro eventi dal menu di navigazione a sinistra. Da qui, seleziona una proprietà a cui aggiungere l’estensione o creane una nuova.
Dopo aver selezionato o creato la proprietà desiderata, seleziona Estensioni nel menu di navigazione a sinistra, quindi seleziona la scheda Catalogo. Cerca la scheda AWS, quindi seleziona Installa.
Nella schermata successiva è necessario fornire le credenziali di connessione per l'account AWS. In particolare, devi fornire l'ID della chiave di accesso AWS e la chiave di accesso segreta. Se non conosci questi valori, consulta la documentazione di AWS su come ottenere l'ID della chiave di accesso e la chiave di accesso segreta.
Al termine, selezionare Salva e l'estensione verrà installata.
Configurare una regola di inoltro degli eventi rule
Dopo aver installato l'estensione, crea una nuova regola di inoltro eventi e configurane le condizioni come desiderato. Durante la configurazione delle azioni per la regola, seleziona l'estensione AWS, quindi seleziona Invia dati a Kinesis Data Stream per il tipo di azione.
Il pannello a destra si aggiorna per mostrare le opzioni di configurazione per la modalità di invio dei dati. In particolare, devi assegnare elementi dati alle varie proprietà che rappresentano la tua configurazione di Event Hub.
Dettagli flusso dati Kinesis
Kinesis Data Streams separa i record di dati appartenenti a un flusso in più parti. Utilizza la chiave di partizione inviata con ciascun record di dati per determinare a quale partizione appartiene un determinato record di dati.
Una buona chiave di partizione per la distribuzione dei clienti potrebbe essere il numero del cliente, poiché è diverso per ciascun cliente. Una chiave di partizione scadente potrebbe avere il loro codice postale perché tutti possono vivere nella stessa area nelle vicinanze. In generale, è consigliabile scegliere una chiave di partizione con l'intervallo più alto di valori potenziali diversi. Consulta l'articolo AWS su ridimensionamento dei Kinesis flussi di dati per le best practice sulla gestione delle chiavi di partizione.
Dati
Con l'opzione Raw, puoi incollare l'oggetto JSON direttamente nel campo di testo fornito, oppure puoi selezionare l'icona dell'elemento dati ( ) per effettuare una selezione da un elenco di elementi dati esistenti per rappresentare il payload.
È inoltre possibile utilizzare l'opzione Editor coppie chiave-valore JSON per aggiungere manualmente ogni coppia chiave-valore tramite un editor di interfaccia utente. Ogni valore può essere rappresentato da un input non elaborato, oppure è possibile selezionare un elemento dati.
Al termine, seleziona Mantieni modifiche per aggiungere l'azione alla configurazione della regola. Una volta soddisfatta la regola, selezionare Salva nella libreria.
Infine, pubblica un nuovo evento con inoltro di build per abilitare le modifiche alla libreria.
Passaggi successivi
Questa guida illustra come inviare dati a Kinesis Data Streams utilizzando l'estensione di inoltro eventi AWS. Per ulteriori informazioni sulle funzionalità di inoltro degli eventi in Experience Platform, consulta la panoramica sull'inoltro degli eventi.