Amazon S3 verbinding s3-connection

Doelwijziging changelog

Wijzigingen weergeven
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
Januari 2024 Bijwerken van functionaliteit en documentatie De Amazon S3 bestemmingsschakelaar steunt nu een nieuw verondersteld rolauthentificatietype. Lees meer over het in de authentificatiesectie.
Juli 2023 Bijwerken van functionaliteit en documentatie

Met de release van het Experience Platform van juli 2023 biedt de Amazon S3 -bestemming nieuwe functionaliteit, zoals hieronder wordt weergegeven:

Verbinding maken met uw Amazon S3 -opslag via API of UI connect-api-or-ui

Ondersteunde doelgroepen supported-audiences

In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.

Oorsprong publiek
Ondersteund
Beschrijving
Segmentation Service
āœ“
Het publiek produceerde door de Dienst van de Segmentatie van het Experience Platform šŸ”—.
Aangepaste uploads
āœ“
Het publiek ingevoerdein Experience Platform van Csv- dossiers.

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
U exporteert alle leden van een segment, samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam), zoals gekozen in het scherm van de uitgezochte profielkenmerken van het werkschema van de bestemmingsactivering.
Exportfrequentie
Batch
De bestemmingen van de partij voeren dossiers naar stroomafwaartse platforms in toename van drie, zes, acht, twaalf, of 24 uren uit. Lees meer over partij op dossier-gebaseerde bestemmingen.

Amazon S3 op profiel-gebaseerd die uitvoertype in UU wordt benadrukt.

Gegevensbestanden exporteren export-datasets

Deze bestemming steunt dataset de uitvoer. Voor volledige informatie over hoe te de uitvoer van de opstellingsdataset, lees de leerprogramma's:

Bestandsindeling van de geƫxporteerde gegevens file-format

Wanneer het uitvoeren van publieksgegevens, leidt het Platform tot een .csv, parquet, of .json dossier in de opslagplaats die u verstrekte. Voor meer informatie over de dossiers, zie gesteunde dossierformaten voor de uitvoersectie in het leerprogramma van de publiekactivering.

Wanneer het uitvoeren van datasets, leidt het Platform tot een .parquet of .json dossier in de opslagplaats die u verstrekte. Voor meer informatie over de dossiers, zie succesvolle datasetuitvoersectie in het de uitvoerdatasetleerprogramma verifiƫren.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. Vul in de workflow voor doelconfiguratie de velden in die in de twee onderstaande secties worden vermeld.

Verifiƫren voor bestemming authenticate

Als u voor verificatie bij het doel wilt zorgen, vult u de vereiste velden in en selecteert u Connect to destination . De Amazon S3-bestemming ondersteunt twee verificatiemethoden:

  • Toegangstoets en geheime sleutelverificatie
  • Veronderstelde rolauthentificatie

Toegangstoets en geheime sleutelverificatie

Gebruik deze verificatiemethode als u de Amazon S3-toegangstoets en de geheime sleutel wilt invoeren, zodat Experience Platform gegevens kan exporteren naar uw Amazon S3-eigenschappen.

Beeld van de vereiste gebieden wanneer het selecteren van toegangstoets en geheime zeer belangrijke authentificatie.

  • Amazon S3access key en Amazon S3geheime sleutel: In Amazon S3, produceer een access key - secret access key paar om Platform toegang tot uw Amazon S3 rekening te verlenen. Leer meer in de documentatie van Amazon Web Services.

  • Encryption key: U kunt desgewenst een openbare sleutel met RSA-indeling toevoegen om versleuteling toe te voegen aan uw geĆ«xporteerde bestanden. Bekijk een voorbeeld van een correct opgemaakte coderingssleutel in de onderstaande afbeelding.

    Beeld dat een voorbeeld van een correct geformatteerde sleutel PGP in UI toont.

Veronderstelde rol assumed-role-authentication

Beeld van de vereiste gebieden wanneer het selecteren van veronderstelde rolauthentificatie.

Gebruik dit verificatietype als u accountsleutels en geheime sleutels niet met Adobe wilt delen. In plaats daarvan maakt Experience Platform verbinding met uw Amazon S3-locatie via op rollen gebaseerde toegang.

Om dit te doen, moet u in de console van AWS een veronderstelde gebruiker voor Adobe met het recht vereiste toestemmingentot stand brengen om aan uw emmers van Amazon S3 te schrijven. Maak een Trusted entity in AWS met het Adobe account 670664943635 . Voor meer informatie, verwijs naar de documentatie van AWS bij het creƫren van rollen.

  • Role: plak de ARN van de rol die u in AWS voor de Adobe gebruiker hebt gemaakt. Het patroon is vergelijkbaar met arn:aws:iam::800873819705:role/destinations-role-customer .
  • Encryption key: U kunt desgewenst een openbare sleutel met RSA-indeling toevoegen om versleuteling toe te voegen aan uw geĆ«xporteerde bestanden. Bekijk een voorbeeld van een correct opgemaakte coderingssleutel in de onderstaande afbeelding.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.

  • Name: Voer een naam in die u helpt bij het identificeren van dit doel.

  • Description: voer een beschrijving van dit doel in.

  • Bucket name: voer de naam in van het Amazon S3 emmertje dat door dit doel moet worden gebruikt.

  • Folder path: voer het pad in naar de doelmap waarin de geĆ«xporteerde bestanden worden opgeslagen.

  • File type: selecteer het Experience Platform voor de indeling die u voor de geĆ«xporteerde bestanden wilt gebruiken. Wanneer het selecteren van de CSV optie, kunt u ook de dossier het formatteren optiesvormen.

  • Compression format: Selecteer het compressietype dat Experience Platform moet gebruiken voor de geĆ«xporteerde bestanden.

  • Include manifest file: Schakel deze optie in als u wilt dat bij het exporteren een manifest-JSON-bestand wordt opgenomen dat informatie bevat over de exportlocatie, de exportgrootte en meer. Het manifest wordt genoemd gebruikend het formaat manifest-<<destinationId>>-<<dataflowRunId>>.json. Bekijk a steekproef manifestdossier. Het manifestbestand bevat de volgende velden:

    • flowRunId: De dataflow looppasdie het uitgevoerde dossier produceerde.
    • scheduledTime: De tijd in UTC toen het bestand werd geĆ«xporteerd.
    • exportResults.sinkPath: Het pad in uw opslaglocatie waar het geĆ«xporteerde bestand is opgeslagen.
    • exportResults.name: De naam van het geĆ«xporteerde bestand.
    • size: De grootte van het geĆ«xporteerde bestand, in bytes.
TIP
In de Connect-doelworkflow kunt u per geƫxporteerd publieksbestand een aangepaste map in uw Amazon S3-opslag maken. Lees de macro's van het Gebruik om een omslag in uw opslagplaatsvoor instructies tot stand te brengen.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Vereiste Amazon S3 machtigingen required-s3-permission

Als u gegevens wilt verbinden en exporteren naar uw Amazon S3 -opslaglocatie, maakt u een gebruiker voor Identiteit en Toegangsbeheer (IAM) voor Platform in Amazon S3 en wijst u machtigingen toe voor de volgende handelingen:

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

Minimale vereiste toestemmingen voor IAM veronderstelde rolauthentificatie minimum-permissions-iam-user

Wanneer het vormen van de rol IAM als klant, zorg ervoor dat het toestemmingsbeleid verbonden aan de rol de vereiste acties aan de doelomslag in het emmertje en de s3:ListBucket actie voor de wortel van het emmertje omvat. De mening onder een voorbeeld van het minimumtoestemmingenbeleid voor dit authentificatietype:

{
    "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"
        }
    ]
}

Soorten publiek naar dit doel activeren activate

IMPORTANT

Zie publieksgegevens aan de uitvoerbestemmingen van het partijprofielvoor instructies op het activeren van publiek aan deze bestemming activeren.

Geƫxporteerde gegevens valideren exported-data

Om te controleren of gegevens zijn geƫxporteerd, controleert u de Amazon S3 -opslag en controleert u of de geƫxporteerde bestanden de verwachte profielpopulaties bevatten.

IP adres lijst van gewenste personen ip-address-allow-list

Verwijs naar het šŸ”— artikel van de lijst van gewenste personen van het 0} IP adres als u Adobe IPs aan een lijst van gewenste personen moet toevoegen.

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