Bestemming landingszone gegevens

Overzicht overview

Data Landing Zone is een interface voor cloudopslag die door Adobe Experience Platform is ingericht en waarmee u toegang hebt tot een veilige opslagvoorziening voor bestanden in de cloud waarmee u bestanden vanuit Experience Platform kunt exporteren. U hebt toegang tot één Data Landing Zone container per sandbox en het totale gegevensvolume voor alle containers is beperkt tot de totale gegevens die worden geleverd bij uw Experience Platform-licentie voor producten en services. Alle klanten van Experience Platform en de bijbehorende toepassingen, zoals Customer Journey Analytics , Journey Orchestration , Intelligent Services en Real-Time Customer Data Platform , beschikken over één Data Landing Zone container per sandbox.

Experience Platform past een strikte, 7-dagen durende (TTL) toe op alle bestanden die naar een Data Landing Zone -container zijn geüpload. Alle bestanden worden na zeven dagen verwijderd.

De Data Landing Zone doelconnector is beschikbaar voor klanten die de Azure- of Amazon Web Service-cloudondersteuning gebruiken. Het authentificatiemechanisme is verschillend gebaseerd op de wolk waarin de bestemming provisioned is, zijn al het andere over de bestemming en zijn gebruiksgevallen het zelfde. Lees meer over de twee verschillende authentificatiemechanismen in de secties voor authentiek verklaren aan de Gegevens Landing Zone die in Azure Blobwordt voorzien en voor authentiek verklaart aan de AWS-provisioned Gegeven Landing Zone.

{modal="regular"}

Verbinding maken met uw Data Landing Zone -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.

Type en frequentie exporteren export-type-frequency

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

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

Verifieer aan de Gebied van Gegevens die in Azure Blob wordt verstrekt authenticate-dlz-azure

U kunt bestanden lezen en schrijven naar uw container via Azure Storage Explorer of de opdrachtregelinterface.

Data Landing Zone biedt ondersteuning voor verificatie op basis van SAS en de bijbehorende gegevens zijn in rust en onderweg beveiligd met standaard Azure Blob -opslagbeveiligingsmechanismen. SAS staat voor gedeelde toegangshandtekening.

Als u uw gegevens via een openbare internetverbinding wilt beveiligen, gebruikt u SAS-verificatie voor een veilige toegang tot uw Data Landing Zone -container. Er zijn geen netwerkwijzigingen vereist voor toegang tot uw Data Landing Zone -container. Dit betekent dat u geen lijsten van gewenste personen of instellingen voor meerdere regio's voor uw netwerk hoeft te configureren.

Sluit de Data Landing Zone -container aan op Azure Storage Explorer

U kunt Azure Storage Explorer gebruikenom de inhoud van uw Data Landing Zone container te beheren. Als u Data Landing Zone wilt gaan gebruiken, moet u eerst uw referenties ophalen, deze invoeren in Azure Storage Explorer en de Data Landing Zone -container verbinden met Azure Storage Explorer .

Selecteer in de gebruikersinterface van Azure Storage Explorer het verbindingspictogram op de linkernavigatiebalk. Het Uitgezochte venster van het Middel verschijnt, die u van opties voorzien om met te verbinden. Selecteer Blob container om verbinding te maken met uw Data Landing Zone -opslag.

Daarna, selecteer Gedeelde toegangshandtekening URL (SAS) als uw verbindingsmethode, en selecteer dan daarna.

Na het selecteren van uw verbindingsmethode, moet u a vertoningsnaam en Blobcontainer SAS URL verstrekken die met uw Data Landing Zone container beantwoordt.

De referenties voor uw Data Landing Zone ophalen retrieve-dlz-credentials

U moet de Experience Platform API's gebruiken om uw Data Landing Zone -gegevens op te halen. De API-aanroep om uw referenties op te halen wordt hieronder beschreven. Voor informatie over het krijgen van de vereiste waarden voor uw kopballen, verwijs Begonnen het worden met Adobe Experience Platform APIsgids.

API formaat

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Verzoek

In het volgende aanvraagvoorbeeld worden de gegevens voor een bestaande landingszone opgehaald.

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Reactie

De volgende reactie retourneert de referentie-informatie voor de landingszone, inclusief de huidige SASToken en SASUri , en de storageAccountName die overeenkomen met de container van de landingszone.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Data Landing Zone gebruikersgegevens bijwerken update-dlz-credentials

U kunt uw gegevens desgewenst ook vernieuwen. U kunt uw SASToken bijwerken door een POST-aanvraag in te dienen bij het /credentials eindpunt van de Connectors API.

API formaat

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

Verzoek

Met het volgende verzoek worden de gegevens van uw landingszone bijgewerkt.

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Reactie

In het volgende antwoord worden bijgewerkte waarden voor de SASToken en SASUri geretourneerd.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

Verstrek uw vertoningsnaam (containerName) en Data Landing Zone SAS URL, zoals die in de hierboven beschreven API vraag is teruggekeerd, en selecteer dan Volgende.

Het Summiere venster verschijnt, die u van een overzicht van uw montages, met inbegrip van informatie over uw Blob eindpunt en toestemmingen voorzien. Wanneer klaar, uitgezochte verbindt.

Een geslaagde verbinding werkt de gebruikersinterface van Azure Storage Explorer bij met uw Data Landing Zone -container.

Als de Data Landing Zone -container is aangesloten op Azure Storage Explorer , kunt u nu bestanden van Experience Platform naar uw Data Landing Zone -container exporteren. Als u bestanden wilt exporteren, moet u een verbinding tot stand brengen met de Data Landing Zone -bestemming in de gebruikersinterface van Experience Platform, zoals hieronder wordt beschreven.

Verifiëren voor de AWS-provisioned Data Landing Zone authenticate-dlz-aws

Voer de onderstaande bewerkingen uit om referenties naar uw Data Landing Zone -instantie te verkrijgen die is ingericht op AWS. Gebruik vervolgens een keuzerondje om verbinding te maken met de instantie Data Landing Zone .

De referenties voor uw Data Landing Zone ophalen retrieve-dlz-credentials-aws

U moet de Experience Platform API's gebruiken om uw Data Landing Zone -gegevens op te halen. De API-aanroep om uw referenties op te halen wordt hieronder beschreven. Voor informatie over het krijgen van de vereiste waarden voor uw kopballen, verwijs Begonnen het worden met Adobe Experience Platform APIsgids.

API formaat

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination'

Verzoek

In het volgende aanvraagvoorbeeld worden de gegevens voor een bestaande landingszone opgehaald.

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

Reactie

De volgende reactie retourneert de referentie-informatie voor de landingszone, inclusief de huidige awsAccessKeyId , awsSecretAccessKey en andere informatie.

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

Verbinden met de bestemming connect

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

Zorg ervoor dat u uw Data Landing Zone container aan Azure Storage Explorer zoals die in de wordt beschreven eerste vereistensectie hebt verbonden. Omdat Data Landing Zone is een opslagruimte met Adobe-provisioning, hoeft u geen verdere stappen in de Experience Platform-interface uit te voeren om verificatie naar de bestemming uit te voeren.

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.

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 .

Soorten publiek naar dit doel activeren activate

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

Planning

In de Scheduling stap, kunt u opstelling het uitvoerprogrammavoor uw Data Landing Zone bestemming en u kunt ook de naam van uw uitgevoerde dossiersvormen.

Kenmerken en identiteiten toewijzen map

In de stap Mapping kunt u selecteren welke kenmerk- en identiteitsvelden u wilt exporteren voor uw profielen. U kunt ook selecteren om de kopteksten in het geëxporteerde bestand te wijzigen in een gewenste vriendelijke naam. Voor meer informatie, bekijk de toewijzingsstapin de activerende partijbestemmingen UI leerprogramma.

Geëxporteerde gegevens valideren exported-data

Om te controleren of gegevens zijn geëxporteerd, controleert u de Data Landing Zone -opslag en controleert u of de geëxporteerde bestanden de verwachte profielpopulaties bevatten.