Data Landing Zone-mål
Översikt overview
Data Landing Zone är ett Azure Blob lagringsgränssnitt som tillhandahålls av Adobe Experience Platform, vilket ger dig tillgång till en säker, molnbaserad fillagringsfunktion för att exportera filer från plattformen. Du har åtkomst till en Data Landing Zone-behållare per sandlåda, och den totala datavolymen för alla behållare är begränsad till den totala datamängden som tillhandahålls med plattformsprodukten och tjänstlicensen. Alla kunder med Platform och dess program som Customer Journey Analytics, Journey Orchestration, Intelligent Services och Real-Time Customer Data Platform etableras med en Data Landing Zone-behållare per sandlåda. Du kan läsa och skriva filer till behållaren via Azure Storage Explorer eller kommandoradsgränssnittet.
Data Landing Zone har stöd för SAS-baserad autentisering och dess data skyddas med standardsäkerhetsmekanismer för lagring i Azure Blob vid vila och överföring. SAS står för signatur för delad åtkomst.
Med SAS-baserad autentisering kan du få säker åtkomst till din Data Landing Zone-behållare via en offentlig internetanslutning. Du behöver inte göra några nätverksändringar för att komma åt din Data Landing Zone-behållare, vilket innebär att du inte behöver konfigurera några tillåtelselista- eller korsregionsinställningar för ditt nätverk.
Plattformen tvingar en strikt TTL (time-to-live) på sju dagar för alla filer som överförs till en Data Landing Zone-behållare. Alla filer tas bort efter sju dagar.
Anslut till ditt Data Landing Zone-lagringsutrymme via API eller användargränssnittet connect-api-or-ui
- Läs avsnitten Anslut till målet och Aktivera målgrupper till det här målet nedan om du vill ansluta till lagringsplatsen Data Landing Zone med hjälp av användargränssnittet för plattformen.
- Om du vill ansluta till din Data Landing Zone-lagringsplats programmatiskt läser du Aktivera målgrupper till filbaserade mål med hjälp av API-självstudiekursen för Flow-tjänsten.
Målgrupper supported-audiences
I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.
Exportera typ och frekvens export-type-frequency
Se tabellen nedan för information om exporttyp och frekvens för destinationen.
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.
Förhandskrav prerequisites
Observera följande krav som måste uppfyllas innan du kan använda målet Data Landing Zone.
Anslut Data Landing Zone-behållaren till Azure Storage Explorer
Du kan använda Azure Storage Explorer för att hantera innehållet i Data Landing Zone-behållaren. Om du vill börja använda Data Landing Zone måste du först hämta dina autentiseringsuppgifter, ange dem i Azure Storage Explorer och ansluta Data Landing Zone-behållaren till Azure Storage Explorer.
I användargränssnittet för Azure Storage Explorer väljer du anslutningsikonen i det vänstra navigeringsfältet. Fönstret Välj resurs visas med alternativ att ansluta till. Välj Blob container om du vill ansluta till ditt Data Landing Zone-lagringsutrymme.
Välj sedan URL för delad åtkomstsignatur (SAS) som anslutningsmetod och välj sedan Nästa.
När du har valt anslutningsmetod måste du ange ett visningsnamn och Blobbehållar-SAS-URL:en som motsvarar din Data Landing Zone-behållare.
Hämta autentiseringsuppgifterna för Data Landing Zone retrieve-dlz-credentials
Du måste använda plattforms-API:erna för att hämta dina Data Landing Zone-autentiseringsuppgifter. API-anropet för att hämta dina autentiseringsuppgifter beskrivs nedan. Mer information om hur du hämtar de värden som krävs för rubrikerna finns i guiden Komma igång med Adobe Experience Platform API:er.
API-format
GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
dlz_destinationdlz_destination gör att API:t kan skilja en målbehållare för en landningszon från andra typer av behållare som är tillgängliga för dig.Begäran
I följande exempel på begäran hämtas autentiseringsuppgifter för en befintlig landningszon.
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' \
Svar
Följande svar returnerar inloggningsinformationen för din landningszon, inklusive din nuvarande SASToken och SASUri samt den storageAccountName som motsvarar din landningszonsbehållare.
{
"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"
}
containerNameSASTokenSASUriUppdatera autentiseringsuppgifter för Data Landing Zone update-dlz-credentials
Du kan även uppdatera dina inloggningsuppgifter när du vill. Du kan uppdatera SASToken genom att göra en POST-förfrågan till /credentials-slutpunkten för Connectors API:t.
API-format
POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
dlz_destinationdlz_destination gör att API:t kan skilja en målbehållare för en landningszon från andra typer av behållare som är tillgängliga för dig.refreshrefresh kan du återställa dina autentiseringsuppgifter för landningszonen och automatiskt generera en ny SASToken.Begäran
Följande begäran uppdaterar dina inloggningsuppgifter för landningszonen.
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' \
Svar
Följande svar returnerar uppdaterade värden för SASToken och SASUri.
{
"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"
}
Ange ditt visningsnamn (containerName) och Data Landing Zone SAS-URL, som returneras i det API-anrop som beskrivs ovan, och välj sedan Nästa.
Fönstret Sammanfattning visas med en översikt över dina inställningar, inklusive information om din Blob-slutpunkt och behörigheter. Välj Anslut när du är klar.
En anslutning uppdaterar användargränssnittet för Azure Storage Explorer med behållaren för Data Landing Zone.
Med din Data Landing Zone-behållare ansluten till Azure Storage Explorer kan du nu börja exportera filer från Experience Platform till Data Landing Zone-behållaren. Om du vill exportera filer måste du upprätta en anslutning till Data Landing Zone-målet i användargränssnittet i Experience Platform, vilket beskrivs i avsnittet nedan.
Anslut till målet connect
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
Kontrollera att du har anslutit Data Landing Zone-behållaren till Azure Storage Explorer enligt beskrivningen i avsnittet Krav. Eftersom Data Landing Zone är ett lagringsutrymme som tillhandahålls av Adobe behöver du inte utföra några ytterligare steg i användargränssnittet i Experience Platform för att autentisera mot målet.
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: Fyll i det önskade namnet för det här målet.
-
Description: Valfritt. Du kan till exempel ange vilken kampanj du använder det här målet för.
-
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.
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.
Aktivera målgrupper till det här målet activate
- 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.
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.
Schemaläggning
I steget Scheduling kan du ställa in exportschemat för ditt Data Landing Zone-mål och du kan även konfigurera namnet på dina exporterade filer.
Mappa attribut och identiteter map
I steget Mapping kan du välja vilka attribut- och identitetsfält som ska exporteras för dina profiler. Du kan också välja att ändra rubrikerna i den exporterade filen till ett valfritt användarvänligt namn. Mer information finns i mappningssteget i självstudiekursen om aktivering av gruppmål.
Validera slutförd dataexport exported-data
Kontrollera Data Landing Zone-lagringen och se till att de exporterade filerna innehåller de förväntade profilpopulationerna för att kontrollera om data har exporterats.