Documentatie Experience Platform Handleiding voor bestemmingen

Bestemming landingszone gegevens

Laatst bijgewerkt: 10 januari 2025

Onderwerpen:
Destinations

Gemaakt voor:

Beheerder
Gebruiker

IMPORTANT

Deze documentatiepagina verwijst naar Data Landing Zone bestemming. Er is ook a Data Landing Zone bron in de broncatalogus. Voor meer informatie, lees de Data Landing Zone brondocumentatie.

Overzicht

Data Landing Zone is een interface voor cloudopslag die door Adobe Experience Platform is ingericht en waarmee u toegang hebt 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.

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.

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.

Diagram die tonen hoe de implementatie van de bestemmings van de Gebied van Gegevens verschillend is gebaseerd op de wolkensteun.

Verbinding maken met uw Data Landing Zone -opslag via API of UI

Om met uw Data Landing Zone opslagplaats te verbinden gebruikend het gebruikersinterface van het Platform, lees de secties verbinden met de bestemmingen actief publiek aan deze bestemminghieronder.
Om met uw Data Landing Zone opslagplaats programmatically te verbinden, lees actief publiek aan op dossier-gebaseerde bestemmingen door de dienst API van de Stroom te gebruiken leerprogramma.

Ondersteunde doelgroepen

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

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 toepasselijke schemagebieden (bijvoorbeeld uw PPID), 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.

Gegevensbestanden exporteren

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

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.

Verifieer aan de Gebied van Gegevens die in Azure Blob wordt verstrekt

AVAILABILITY

Deze sectie is van toepassing op implementaties van Experience Platform die op Microsoft Azure lopen. Meer over de gesteunde infrastructuur van het Experience Platform leren, zie het Experience Platform multi-cloud overzicht.

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.

Uitgezochte middel dat in Azure UI wordt benadrukt.

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

Uitgezochte verbindingsmethode die in Azure UI wordt benadrukt.

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

recommendation-more-help

De referenties voor uw Data Landing Zone ophalen

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

Query-parameters

Beschrijving

dlz_destination

Met het type dlz_destination kan de API een doelcontainer van de landingszone onderscheiden van de andere typen containers die voor u beschikbaar zijn.

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

Eigenschap

Beschrijving

containerName

De naam van uw landingszone.

SASToken

Het token voor gedeelde toegangshandtekeningen voor uw landingszone. Deze tekenreeks bevat alle informatie die nodig is om een aanvraag te autoriseren.

SASUri

De URI van de gedeelde toegangshandtekening voor uw landingszone. Deze tekenreeks is een combinatie van de URI naar de landingszone waarvoor u geauthenticeerd wordt en de bijbehorende SAS-token,

Data Landing Zone gebruikersgegevens bijwerken

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

Query-parameters

Beschrijving

dlz_destination

Met het type dlz_destination kan de API een doelcontainer van de landingszone onderscheiden van de andere typen containers die voor u beschikbaar zijn.

refresh

Met de handeling refresh kunt u de gegevens van de landingszone opnieuw instellen en automatisch een nieuwe SASToken genereren.

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.

ga verbindingsinfo in die in Azure UI wordt benadrukt.

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.

Samenvatting van montages die in Azure UI worden getoond.

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

Samenvatting van de DLZ gebruikerscontainer die in Azure UI wordt benadrukt.

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.

Verifiëren voor de AWS-provisioned Data Landing Zone

AVAILABILITY

Deze sectie is van toepassing op implementaties van Experience Platform dat op Amazon Web Services (AWS) loopt. Experience Platform dat op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van het Experience Platform leren, zie het Experience Platform multi-cloud overzicht.

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

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'

Query-parameters

Beschrijving

dlz_destination

Voeg de dlz_destination vraagparameter toe om te specificeren dat u het Data Landing Zone bestemmings type van containergeloofsbrieven wilt worden teruggewonnen. Om geloofsbrieven voor een Gegevens te verbinden en terug te winnen die Zone ** aanvoeren, bekijk de documentatie van bronnen.

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
}

Eigenschap

Beschrijving

credentials

Dit object bevat de tags awsAccessKeyId , awsSecretAccessKey en awsSessionToken die Experience Platform gebruikt om bestanden te exporteren naar de ingericht-landingslocatie voor gegevens.

dlzPath

Dit object bevat het pad op de AWS-locatie met Adobe-provisioning waar geëxporteerde bestanden worden gedeponeerd.

dlzProvider

Geeft aan dat dit een Amazon S3-provisioned Data Landing Zone is.

expiryTime

Geeft aan wanneer de referenties in het credentials -object verlopen. Voer de aanvraag opnieuw uit om de voorwaarden te vernieuwen.

Verbinden met de bestemming

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

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

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: vul de voorkeursnaam voor dit doel in.
Description: optioneel. U kunt bijvoorbeeld opgeven voor welke campagne u deze bestemming wilt gebruiken.
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.

Waarschuwingen inschakelen

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

IMPORTANT

Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemmingnodig.

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

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

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.