Översikt över tillägget AWS

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. I följande dokument finns en konsoliderad referens till de ändrade terminologin.

Amazon Web Services (AWS) är en molnbaserad datorplattform som erbjuder en mängd olika tjänster, till exempel distribuerad databehandling, databaslagring, innehållsleverans och SaaS-integrationstjänster (Software-as-a-service) för kundrelationshantering (CRM) och resursplanering (ERP).

Tillägget AWS Vidarebefordraanvänder Amazon Kinesis Data Streams för att skicka händelser från Adobe Experience Platform Edge Network till AWS för vidare bearbetning. Den här guiden beskriver hur du installerar tillägget och använder dess funktioner i en regel för vidarebefordran av händelser.

Förhandskrav

Du måste ha ett AWS-konto med en befintlig Kinesis-dataström för att kunna använda det här tillägget. Om du inte har någon befintlig dataström läser du AWS-dokumentationen om hur du skapar en ny dataström med AWS hanteringskonsolen.

Installera tillägget install

Om du vill installera tillägget AWS går du till användargränssnittet för datainsamling eller användargränssnittet för Experience Platform och väljer Event Forwarding i den vänstra navigeringen. Här väljer du en egenskap som tillägget ska läggas till i eller skapar en ny egenskap i stället.

När du har markerat eller skapat den önskade egenskapen väljer du Extensions i den vänstra navigeringen och väljer sedan fliken Catalog. Sök efter kortet AWS och välj sedan Install.

Knappen Install som väljs för tillägget AWS i användargränssnittet för datainsamling.

På nästa skärm måste du ange anslutningsautentiseringsuppgifterna för ditt AWS-konto. Du måste ange ditt AWS-ID för åtkomstnyckel och en hemlig åtkomstnyckel. Om du inte känner till dessa värden läser du AWS-dokumentationen om hur du får ditt åtkomstnyckel-ID och din hemliga åtkomstnyckel.

Åtkomstnyckel-ID och hemlig åtkomstnyckel har lagts till i tilläggskonfigurationsvyn.

IMPORTANT
En åtkomstprincip måste bifogas till kontot AWS som används för att generera åtkomstautentiseringsuppgifterna. Den här principen måste konfigureras för att ge åtkomstbehörighet att skicka data till dataströmmen Kinesis. Se Exempel 2 i dokumentet AWS om exempelprofiler för Kinesis Data Streams för att se hur principen ska definieras.

När du är klar väljer du Save så installeras tillägget.

Konfigurera en regel för vidarebefordran av händelser rule

När du har installerat tillägget skapar du en ny händelsevidarebefordring av regeln och konfigurerar villkoren efter behov. När du konfigurerar åtgärderna för regeln väljer du tillägget AWS och väljer sedan Send Data to Kinesis Data Stream som åtgärdstyp.

Åtgärdstypen Send Data to Kinesis Data Stream som väljs för en regel i användargränssnittet för datainsamling.

Den högra panelen uppdateras och visar konfigurationsalternativ för hur data ska skickas. Du måste tilldela dataelement till de olika egenskaper som representerar din Event Hub-konfiguration.

Konfigurationsalternativen för åtgärdstypen Send Data to Kinesis Data Stream som visas i gränssnittet.

Kinesis Data Stream Details

Indata
Beskrivning
Stream Name
Namnet på dataströmmen som den här regeln för vidarebefordran av händelser skickar dataposter till.
AWS Region
Regionen AWS där dataströmmen Kinesis skapas.
Partition Key
partitionsnyckeln som tillägget använder när data skickas till dataströmmen.

Kinesis Data Streams delar upp de dataposter som tillhör en ström i flera delningar. Den använder den partitionsnyckel som skickas med varje datapost för att avgöra vilken del en viss datapost tillhör.

En bra partitionsnyckel för att distribuera kunder kan vara kundnumret eftersom det är olika för varje kund. En dålig partitionsnyckel kan ha sitt postnummer eftersom de alla kan finnas i samma område som närliggande. I allmänhet bör du välja en partitionsnyckel som har det högsta intervallet av olika möjliga värden. Mer information om hur du hanterar partitionsnycklar finns i artikeln AWS om skalning av Kinesis dataströmmar.

Data

Indata
Beskrivning
Payload
Det här fältet innehåller de data som kommer att vidarebefordras till dataströmmen Kinesis i JSON-format.

Under alternativet Raw kan du klistra in JSON-objektet direkt i det angivna textfältet, eller så kan du välja dataelementsikonen ( Datauppsättningsikonen ) och välja från en lista över befintliga dataelement som ska representera nyttolasten.

Du kan också använda alternativet JSON Key-Value Pairs Editor för att manuellt lägga till nyckelvärdepar via en gränssnittsredigerare. Varje värde kan representeras av en rådatainmatning, eller ett dataelement kan markeras i stället.

När du är klar väljer du Keep Changes för att lägga till åtgärden i regelkonfigurationen. När du är nöjd med regeln väljer du Save to Library.

Publicera slutligen en ny händelse som vidarebefordrar build för att aktivera ändringarna i biblioteket.

Nästa steg

I den här guiden beskrivs hur du skickar data till Kinesis Data Streams med hjälp av tillägget AWS för vidarebefordran av händelser. Mer information om funktioner för att vidarebefordra händelser i Experience Platform finns i översikten över vidarebefordran av händelser.

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