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 da Adobe Experience Platform Edge Network a AWS per 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 di Experience Platform e seleziona Event Forwarding 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, selezionare Extensions nel menu di navigazione a sinistra, quindi selezionare la scheda Catalog. Cerca la scheda AWS, quindi seleziona Install.
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 Save 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 Send Data to 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.
Kinesis Data Stream Details
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.
Data
Con l'opzione Raw, puoi incollare l'oggetto JSON direttamente nel campo di testo fornito, oppure puoi selezionare l'icona dell'elemento dati (
È inoltre possibile utilizzare l'opzione JSON Key-Value Pairs Editor 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, selezionare Keep Changes per aggiungere l'azione alla configurazione della regola. Quando si è soddisfatti della regola, selezionare Save to Library.
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.