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 onderwerp in de verificatiesectie.
Juli 2023 Bijwerken van functionaliteit en documentatie

Met de release van het Experience Platform van juli 2023 Amazon S3 doel biedt 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
Door het Experience Platform gegenereerde soorten publiek Segmenteringsservice.
Aangepaste uploads
Soorten publiek geïmporteerd in Experience Platform van CSV-bestanden.

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 u hebt gekozen in het scherm met de kenmerken voor het geselecteerde profiel van het dialoogvenster doelactiveringsworkflow.
Exportfrequentie
Batch
De bestemmingen van de partij voeren dossiers naar stroomafwaartse platforms in toename van drie, zes, acht, twaalf, of 24 uren uit. Meer informatie over batchbestandsgebaseerde doelen.

Op Amazon S3-profielen gebaseerd exporttype gemarkeerd in de UU.

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

Bij exporteren publieksgegevens, Platform maakt een .csv, parquet, of .json in de opslaglocatie die u hebt opgegeven. Zie voor meer informatie over de bestanden de ondersteunde bestandsindelingen voor export in de zelfstudie voor publieksactivering.

Bij exporteren gegevenssets, Platform maakt een .parquet of .json in de opslaglocatie die u hebt opgegeven. Zie voor meer informatie over de bestanden de succesvolle uitvoer van gegevenssets controleren in de zelfstudie over exportgegevensbestanden.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u nodig View Destinations en Manage Destinations toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.

Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. Vul in de workflow voor doelconfiguratie de velden in die in de twee onderstaande secties worden vermeld.

Verifiëren voor bestemming authenticate

Als u zich wilt verifiëren bij de bestemming, 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.

Afbeelding van de vereiste velden bij het selecteren van de toegangstoets en de verificatie met de geheime sleutel.

  • Amazon S3toegangstoets en Amazon S3geheime sleutel: In Amazon S3, een access key - secret access key paar om Platform toegang tot uw te verlenen Amazon S3 account. Meer informatie in het dialoogvenster Amazon Web Services-documentatie.

  • 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.

    Afbeelding met een voorbeeld van een PGP-sleutel met de juiste notatie in de gebruikersinterface.

Veronderstelde rol assumed-role-authentication

Afbeelding van de vereiste velden bij het selecteren van aangenomen rolverificatie.

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 rechten vereist om naar uw Amazon S3 emmers te schrijven. Een Trusted entity in AWS met de Adobe account 670664943635. Raadpleeg voor meer informatie de AWS-documentatie over het maken 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 deze bestemming te identificeren.

  • Description: Voer een beschrijving van dit doel in.

  • Bucket name: Voer de naam in van de Amazon S3 emmer die door deze bestemming 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 u de CSV kunt u configureren, opties voor bestandsindeling.

  • 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. Een voorbeeldmanifestbestand. Het manifestbestand bevat de volgende velden:

    • flowRunId: De dataflow run waarmee het geëxporteerde bestand is gegenereerd.
    • scheduledTime: De tijd in UTC toen het bestand werd geëxporteerd.
    • exportResults.sinkPath: Het pad in de 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. Lezen Macro's gebruiken om een map te maken op uw opslaglocatie voor instructies.

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. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.

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

Vereist Amazon S3 machtigingen required-s3-permission

Om gegevens met succes te verbinden en uit te voeren aan uw Amazon S3 opslaglocatie, een gebruiker voor Identiteit en Toegangsbeheer (IAM) maken Platform in Amazon S3 en wijs toestemmingen voor de volgende acties toe:

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

Soorten publiek naar dit doel activeren activate

IMPORTANT
  • Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
  • Om te exporteren identiteiten, hebt u de View Identity Graph toegangsbeheermachtiging.
    Selecteer naamruimte voor identiteit die in de workflow wordt gemarkeerd om het publiek naar bestemmingen te activeren. {width="100" modal="regular"}

Zie Gebruikersgegevens activeren om exportdoelen voor batchprofielen te maken voor instructies voor het activeren van het publiek naar deze bestemming.

Geëxporteerde gegevens valideren exported-data

Controleer uw Amazon S3 opslaan en ervoor zorgen dat de geëxporteerde bestanden de verwachte profielpopulaties bevatten.

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

Zie de IP adres lijst van gewenste personen artikel als u Adobe IPs aan een lijst van gewenste personen moet toevoegen.

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