Panoramica dell'estensione AWS

NOTE
Adobe Experience Platform Launch è stato ridefinito come suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

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.

Pulsante Installa selezionato per lestensione AWS nellinterfaccia utente di Data Collection.

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.

LID della chiave di accesso e la chiave di accesso segreta sono stati aggiunti nella vista di configurazione dellestensione.

IMPORTANT
È necessario allegare un criterio di accesso all'account AWS utilizzato per generare le credenziali di accesso. Questo criterio deve essere configurato per concedere i diritti di accesso per l'invio di dati al flusso di dati Kinesis. Per informazioni su come definire i criteri, consultare l'Esempio 2 nel documento AWS in Criteri di esempio per Kinesis Data Streams.

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.

Tipo di azione Invia dati a Kinesis Data Stream selezionato per una regola nellinterfaccia utente di Data Collection.

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.

Opzioni di configurazione per il tipo di azione Invia dati a flusso di dati Kinesis visualizzato nellinterfaccia utente.

Dettagli flusso dati Kinesis

Input
Descrizione
Nome flusso
Il nome del flusso a cui questa regola di inoltro eventi invierà i record di dati.
Area geografica AWS
Area AWS in cui viene creato il flusso di dati Kinesis.
Chiave partizione
La chiave di partizione che verrà utilizzata dall'estensione per inviare dati al flusso di dati.

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

Input
Descrizione
Payload
Questo campo contiene i dati che verranno inoltrati al flusso di dati Kinesis, in formato JSON.

Con l'opzione Raw, puoi incollare l'oggetto JSON direttamente nel campo di testo fornito, oppure puoi selezionare l'icona dell'elemento dati ( icona del set di 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.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743