Amazon S3-anslutning s3-connection

Destinationsändringslogg changelog

Visa ändringslogg
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasamånad Uppdateringstyp Beskrivning
Januari 2024 Funktioner och dokumentation Amazon S3-målkopplingen har nu stöd för en ny, antagen rollautentiseringstyp. Läs mer om det i avsnittet autentisering.
Juli 2023 Funktioner och dokumentation

I Experience Platform från juli 2023 har målet Amazon S3 nya funktioner enligt nedan:

Anslut till ditt Amazon S3-lagringsutrymme via API eller användargränssnittet connect-api-or-ui

Målgrupper supported-audiences

I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.

Målgruppsursprung
Stöds
Beskrivning
Segmentation Service
Publiker som genererats via Experience Platform segmenteringstjänsten.
Anpassade överföringar
Publikerna importerade till Experience Platform från CSV-filer.

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt
Typ
Anteckningar
Exporttyp
Profile-based
Du exporterar alla medlemmar i ett segment tillsammans med de önskade schemafälten (t.ex. e-postadress, telefonnummer, efternamn), som du har valt på skärmen Välj profilattribut i arbetsflödet för målaktivering.
Exportfrekvens
Batch
Batchdestinationer exporterar filer till efterföljande plattformar i steg om tre, sex, åtta, tolv eller tjugofyra timmar. Läs mer om gruppfilsbaserade mål.

Profilbaserad exporttyp för Amazon S3 är markerad i USA.

Exportera datauppsättningar export-datasets

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 file-format

När du exporterar målgruppsdata skapar 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 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 connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Om 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 authenticate

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 för att tillåta Experience Platform att exportera data till dina Amazon S3-egenskaper.

Bild av obligatoriska fält när åtkomstnyckel och autentisering av hemliga nycklar väljs.

  • Amazon S3åtkomstnyckel och Amazon S3hemlig nyckel: Generera ett access key - secret access key-par i Amazon S3 för att ge plattformså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.

    Bild som visar ett exempel på en korrekt formaterad PGP-nyckel i gränssnittet.

Antagen roll assumed-role-authentication

Bild av de obligatoriska fälten när du väljer autentisering av 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 göra detta måste du skapa en användare som antas ha 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 destination-details

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.
TIP
I arbetsflödet för anslutningsmål kan du skapa en anpassad mapp i din Amazon S3-lagring per exporterad målgruppsfil. Läs Använd makron för att skapa en mapp på din lagringsplats för instruktioner.

Aktivera aviseringar enable-alerts

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 required-s3-permission

Om du vill ansluta och exportera data till din Amazon S3-lagringsplats skapar du en IAM-användare (Identity and Access Management) för Platform i Amazon S3 och tilldelar behörigheter för följande åtgärder:

  • s3:DeleteObject
  • s3:GetBucketLocation
  • s3:GetObject
  • s3:ListBucket
  • s3:PutObject
  • s3:ListMultipartUploadParts

Minsta nödvändiga behörigheter för IAM-implementerad rollautentisering minimum-permissions-iam-user

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 activate

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.

    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål. {width="100" modal="regular"}

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 exported-data

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 ip-address-allow-list

Läs artikeln IP-adressen tillåtelselistaom du behöver lägga till IP-adresser i Adobe i en tillåtelselista.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6