Bestemming landingszone gegevens

Overzicht overview

Data Landing Zone is een Azure Blob -opslaginterface die door Adobe Experience Platform is ingericht en u toegang biedt tot een veilige, op de cloud gebaseerde opslagfaciliteit voor het opslaan van bestanden om bestanden van het platform te 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 Platform Products and Services-licentie. Alle klanten van 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. 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.

Met verificatie op basis van SAS hebt u via een openbare internetverbinding veilig 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.

Het platform dwingt een strikte tijd-aan-levende (TTL) zeven dagen op alle dossiers af die aan een Data Landing Zone container worden geupload. Alle bestanden worden na zeven dagen verwijderd.

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

Vereisten prerequisites

Aan de volgende voorwaarden moet worden voldaan voordat u het doel van Data Landing Zone kunt gebruiken.

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 platform-API's gebruiken om uw Data Landing Zone -referenties 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-user-container",
    "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-user-container?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 aanvraag voor een POST 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-user-container",
    "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-user-container?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 het Experience Platform naar de 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 het Experience Platform, zoals beschreven in de onderstaande sectie.

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 een Adobe-provisioned opslag is, te hoeven u geen verdere stappen in het Experience Platform UI uit te voeren om aan de bestemming voor authentiek te verklaren.

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.