Amazon S3-anslutning
- Ämnen:
- Destinationer
Skapat för:
- Administratör
- Användare
Destinationsändringslogg
Med Experience Platform från juli 2023 har målet Amazon S3 nya funktioner enligt nedan:
- Exportstöd för datauppsättningar
- Ytterligare namngivningsalternativ.
- Möjlighet att ange anpassade filhuvuden i de exporterade filerna via det förbättrade mappningssteget.
- Möjlighet att anpassa formateringen för exporterade CSV-datafiler.
Anslut till ditt Amazon S3-lagringsutrymme via API eller användargränssnittet
- Om du vill ansluta till lagringsplatsen Amazon S3 med Experience Platform användargränssnitt läser du avsnitten Anslut till målet och Aktivera målgrupper till det här målet nedan.
- Om du vill ansluta till din Amazon S3-lagringsplats programmatiskt läser du guiden om hur du aktiverar målgrupper till filbaserade mål med hjälp av API-självstudiekursen för Flow-tjänsten.
Målgrupper
I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.
Exportera typ och frekvens
Se tabellen nedan för information om exporttyp och frekvens för destinationen.
Exportera datauppsättningar
Detta mål stöder datauppsättningsexporter. Fullständig information om hur du ställer in datauppsättningsexporter finns i självstudiekurserna:
Filformat för exporterade data
När du exporterar målgruppsdata skapar Experience Platform en .csv -, parquet - eller .json -fil på den angivna lagringsplatsen. Mer information om filerna finns i avsnittet Filformat som stöds för export i självstudiekursen om målgruppsaktivering.
När du exporterar datauppsättningar skapar Experience Platform en .parquet- eller .json-fil på den lagringsplats som du angav. Mer information om filerna finns i avsnittet Verifiera lyckad datauppsättningsexport i självstudiekursen om exportdatamängder.
Anslut till målet
IMPORTANTOm du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för målkonfiguration fyller du i fälten som listas i de två avsnitten nedan.
Autentisera till mål
Fyll i de obligatoriska fälten och välj Connect to destination om du vill autentisera mot målet. Amazon S3-målet har stöd för två autentiseringsmetoder:
- Åtkomstnyckel och autentisering av hemlig nyckel
- Antagen rollautentisering
Åtkomstnyckel och autentisering av hemlig nyckel
Använd den här autentiseringsmetoden när du vill ange din Amazon S3-åtkomstnyckel och hemlig nyckel så att Experience Platform kan exportera data till dina Amazon S3-egenskaper.
-
Amazon S3åtkomstnyckel och Amazon S3hemlig nyckel: Generera ett
access key - secret access key-par i Amazon S3 för att ge Experience Platform åtkomst till ditt Amazon S3-konto. Läs mer i Amazon Web Services-dokumentationen. -
Encryption key: Om du vill kan du bifoga den RSA-formaterade offentliga nyckeln för att lägga till kryptering i de exporterade filerna. Visa ett exempel på en korrekt formaterad krypteringsnyckel i bilden nedan.
Antagen roll
Använd den här autentiseringstypen om du inte vill dela kontonycklar och hemliga nycklar med Adobe. I stället ansluter Experience Platform till din Amazon S3-plats med rollbaserad åtkomst.
För att kunna göra detta måste du skapa en användare för Adobe i AWS-konsolen med de behörigheter som krävs för att skriva till dina Amazon S3-bucket. Skapa en Trusted entity i AWS med Adobe-kontot 670664943635. Mer information finns i AWS-dokumentationen om hur du skapar roller.
- Role: Klistra in ARN för rollen som du skapade i AWS för Adobe-användaren. Mönstret liknar
arn:aws:iam::800873819705:role/destinations-role-customer. - Encryption key: Om du vill kan du bifoga den RSA-formaterade offentliga nyckeln för att lägga till kryptering i de exporterade filerna. Visa ett exempel på en korrekt formaterad krypteringsnyckel i bilden nedan.
Fyll i målinformation
Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.
-
Name: Ange ett namn som hjälper dig att identifiera det här målet.
-
Description: Ange en beskrivning av det här målet.
-
Bucket name: Ange namnet på den Amazon S3-bucket som ska användas för det här målet.
-
Folder path: Ange sökvägen till målmappen som ska vara värd för de exporterade filerna.
-
File type: Välj det format som Experience Platform ska använda för de exporterade filerna. När du väljer alternativet CSV kan du även konfigurera filformateringsalternativen.
-
Compression format: Välj den komprimeringstyp som Experience Platform ska använda för de exporterade filerna.
-
Include manifest file: Aktivera det här alternativet om du vill att exporten ska innehålla en manifestfil för JSON som innehåller information om exportplats, exportstorlek och mycket annat. Manifestet har fått ett namn i formatet
manifest-<<destinationId>>-<<dataflowRunId>>.json. Visa en exempelmanifestfil. Manifestfilen innehåller följande fält:flowRunId: Dataflödet kör som genererade den exporterade filen.scheduledTime: Tiden i UTC när filen exporterades.exportResults.sinkPath: Sökvägen till lagringsplatsen där den exporterade filen placeras.exportResults.name: Namnet på den exporterade filen.size: Den exporterade filens storlek i byte.
TIPAktivera aviseringar
Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.
Välj Next när du är klar med att ange information för målanslutningen.
Amazon S3 behörigheter som krävs
Om du vill ansluta och exportera data till din Amazon S3-lagringsplats skapar du en IAM-användare (Identity and Access Management) för Experience Platform i Amazon S3 och tilldelar behörigheter för följande åtgärder:
s3:DeleteObjects3:GetBucketLocations3:GetObjects3:ListBuckets3:PutObjects3:ListMultipartUploadParts
Minsta nödvändiga behörigheter för IAM-implementerad rollautentisering
När du konfigurerar IAM-rollen som kund ska du kontrollera att behörighetsprincipen som är associerad med rollen innehåller de nödvändiga åtgärderna för målmappen i bucket och åtgärden s3:ListBucket för bucket-roten. Visa ett exempel på lägsta behörighetsprincip för den här autentiseringstypen nedan:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListMultipartUploadParts"
],
"Resource": "arn:aws:s3:::bucket/folder/*"
},
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"s3:ListBucket"
],
"Resource": "arn:aws:s3:::bucket"
}
]
}
Aktivera målgrupper till det här målet
IMPORTANT-
För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
-
Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.
Se Aktivera målgruppsdata för att batchprofilera exportmål för instruktioner om hur du aktiverar målgrupper till det här målet.
Validera slutförd dataexport
Kontrollera Amazon S3-lagringen och se till att de exporterade filerna innehåller de förväntade profilpopulationerna för att kontrollera om data har exporterats.
IP-adress tillåtelselista
Läs artikeln IP-adressen tillåtelselista om du behöver lägga till Adobe IP-adresser i en tillåtelselista.