Activeer publiek aan op dossier-gebaseerde bestemmingen door de Dienst API van de Stroom te gebruiken
Gebruik de verbeterde mogelijkheden voor het exporteren van bestanden om toegang te krijgen tot de verbeterde aanpassingsfunctionaliteit wanneer u bestanden exporteert vanuit Experience Platform:
- Aanvullende dossier noemende opties .
- Mogelijkheid om de kopballen van het douanedossier in uw uitgevoerde dossiers via de verbeterde toewijzingsstap te plaatsen.
- Mogelijkheid om het dossiertype van het uitgevoerde dossier te selecteren.
- Mogelijkheid om het formatteren van uitgevoerde CSV gegevensdossiers aan te passen.
Deze functionaliteit wordt ondersteund door de zes hieronder vermelde cloudopslagkaarten:
Dit artikel verklaart het werkschema dat wordt vereist om de Dienst API van de Stroom te gebruiken om gekwalificeerde profielen van Adobe Experience Platform naar één van de hierboven verbonden plaatsen van de wolkenopslag uit te voeren.
Aan de slag get-started
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Experience Data Model (XDM) System: Het gestandaardiseerde framework waarmee Experience Platform gegevens voor de klantervaring indeelt.
- Segmentation Service : Adobe Experience Platform Segmentation Service hiermee kunt u een publiek maken en in Adobe Experience Platform publiek genereren op basis van uw Real-Time Customer Profile -gegevens.
- Sandboxes: Experience Platform biedt virtuele sandboxen die één Experience Platform -instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
De volgende secties verstrekken extra informatie die u moet weten om gegevens aan dossier-gebaseerde bestemmingen in Experience Platform te activeren.
Vereiste machtigingen permissions
Om profielen uit te voeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingen nodig. Lees het overzicht van de toegangscontrole of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemming nodig.
API-voorbeeldaanroepen lezen reading-sample-api-calls
Deze zelfstudie biedt voorbeeld-API-aanroepen om aan te tonen hoe uw verzoeken moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraag in de Experience Platform het oplossen van problemengids te lezen.
Waarden verzamelen voor vereiste en optionele koppen gather-values-headers
Om vraag aan Experience Platform APIs te maken, moet u het de authentificatieleerprogramma van Experience Platform eerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Experience Platform , zoals hieronder wordt getoond:
- Autorisatie: Drager
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Bronnen in Experience Platform kunnen worden geïsoleerd naar specifieke virtuele sandboxen. In aanvragen voor Experience Platform API's kunt u de naam en id opgeven van de sandbox waarin de bewerking plaatsvindt. Dit zijn optionele parameters.
- x-sandbox-name:
{SANDBOX_NAME}
Alle verzoeken die een payload (POST, PUT, PATCH) bevatten vereisen een extra media type kopbal:
- Inhoudstype:
application/json
API-naslagdocumentatie api-reference-documentation
In deze zelfstudie vindt u begeleidende referentiedocumentatie voor alle API-bewerkingen. Verwijs naar de Dienst van de Stroom - Doelen API documentatie op de website van Adobe Developer . We raden u aan deze zelfstudie en de API-naslagdocumentatie parallel te gebruiken.
Woordenlijst glossary
Voor beschrijvingen van de termijnen die u in dit API leerprogramma zult ontmoeten, lees de verklarende woordenlijstsectie van de API verwijzingsdocumentatie.
Doel selecteren waar publiek moet worden geëxporteerd select-destination
Voordat u de workflow voor het exporteren van profielen start, moet u de specificaties van de verbinding en de stroom identificeren van het doel waarnaar u het publiek wilt exporteren. Gebruik de onderstaande tabel ter referentie.
4fce964d-3f37-408f-9778-e597338a21ee1a0514a6-33d4-4c7f-aff8-594799c475496d6b59bf-fb58-4107-9064-4d246c0e5bb2752d422f-b16f-4f0d-b1c6-26e448e3b388be2c3209-53bc-47e7-ab25-145db8b873e117be2013-2549-41ce-96e7-a70363bec29310440537-2a7b-4583-ac39-ed38d4b848e8cd2fc47e-e838-4f38-a581-8fff2f99b63ac5d93acb-ea8b-4b14-8f53-02138444ae99585c15c4-6cbf-4126-8f87-e26bff78b65736965a81-b1c6-401b-99f8-22508f1e6a26fd36aaa4-bf2b-43fb-9387-43785eeeb799U hebt deze IDs nodig om diverse entiteiten van de stroomdienst in de volgende stappen van dit leerprogramma te construeren. U moet ook naar delen van de verbindingsspecificatie zelf verwijzen om bepaalde entiteiten in te stellen zodat u de verbindingsspecificaties kunt ophalen van de Flow Service API's. Zie de voorbeelden hieronder van het terugwinnen van verbindingsspecificaties voor alle bestemmingen in de lijst:
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor Amazon S3 | ||
|
Reactie
| accordion | ||
|---|---|---|
| Amazon S3 - Verbindingsspecificatie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor Azure Blob Storage | ||
|
Reactie
| accordion | ||
|---|---|---|
| Azure Blob Storage - Connection spec | ||
|
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor Azure Data Lake Gen 2(ADLS Gen2 ) | ||
|
Reactie
| accordion | ||
|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor Data Landing Zone(DLZ) | ||
|
Reactie
| accordion | ||
|---|---|---|
| Data Landing Zone(DLZ) - Connection spec | ||
|
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor Google Cloud Storage | ||
|
Reactie
| accordion | ||
|---|---|---|
| Google Cloud Storage - Connection spec | ||
|
Verzoek
| accordion | ||
|---|---|---|
| connection spec ophalen voor SFTP | ||
|
Reactie
| accordion | ||
|---|---|---|
| SFTP - Connection spec | ||
|
Voer de onderstaande stappen uit om een doelpubliek voor het exporteren van gegevens naar een opslaglocatie in de cloud in te stellen. Voor sommige stappen verschillen de verzoeken en antwoorden tussen de verschillende cloudopslagbestemmingen. In die gevallen, gebruik de lusjes op de pagina om de verzoeken en de reacties terug te winnen specifiek voor de bestemming die u wilt verbinden en publiek uitvoeren naar. Gebruik de juiste connection spec en flow spec voor het doel dat u configureert.
Een Source-verbinding maken create-source-connection
Nadat u hebt bepaald naar welk doel u het publiek exporteert, moet u een bronverbinding maken. De bronverbinding vertegenwoordigt de verbinding aan de interne opslag van het Profiel van Experience Platform .
Verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
Een geslaagde reactie retourneert de id (id) van de nieuwe bronverbinding en een etag . Noteer de bron-verbindings-id zoals u deze later nodig hebt wanneer u de gegevensstroom maakt.
Een basisverbinding maken create-base-connection
A basisverbinding slaat veilig de geloofsbrieven aan uw bestemming op. Afhankelijk van het bestemmingstype, kunnen de geloofsbrieven nodig om tegen die bestemming voor authentiek te verklaren variëren. Om deze authentificatieparameters te vinden, wint eerst connection spec voor uw gewenste bestemming zoals die in de sectie wordt beschreven Uitgezochte bestemming waar te om publiek uit te voeren en bekijk dan authSpec van de reactie. Verwijs in de onderstaande tabbladen naar de eigenschappen authSpec van alle ondersteunde doelen.
| accordion | ||
|---|---|---|
| Amazon S3 - Connection spec show auth spec | ||
|
Noteer de gemarkeerde regel met inline opmerkingen in het onderstaande connection spec voorbeeld, die aanvullende informatie geven over waar u de verificatieparameters in connection spec kunt vinden.
|
| accordion | ||
|---|---|---|
| Azure Blob Storage - Connection spec show auth spec | ||
|
Noteer de gemarkeerde regel met inline opmerkingen in het onderstaande connection spec voorbeeld, die aanvullende informatie geven over waar u de verificatieparameters in connection spec kunt vinden.
|
| accordion | ||
|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Connection spec show auth spec | ||
|
Noteer de gemarkeerde regel met inline opmerkingen in het onderstaande connection spec voorbeeld, die aanvullende informatie geven over waar u de verificatieparameters in connection spec kunt vinden.
|
| accordion | |||||
|---|---|---|---|---|---|
| Data Landing Zone(DLZ) - Connection spec show auth spec | |||||
|
| accordion | ||
|---|---|---|
| Google Cloud Storage - Connection spec show auth spec | ||
|
Noteer de gemarkeerde regel met inline opmerkingen in het onderstaande connection spec voorbeeld, die aanvullende informatie geven over waar u de verificatieparameters in connection spec kunt vinden.
|
| accordion | |||||
|---|---|---|---|---|---|
| SFTP - Connection spec weergeven auth spec | |||||
Noteer de gemarkeerde regel met inline opmerkingen in het onderstaande connection spec voorbeeld, die aanvullende informatie geven over waar u de verificatieparameters in connection spec kunt vinden.
|
Met behulp van de eigenschappen die zijn opgegeven in de verificatietoets (d.w.z. authSpec uit het antwoord) kunt u een basisverbinding maken met de vereiste referenties, specifiek voor elk doeltype, zoals in de volgende voorbeelden wordt getoond:
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Amazon S3 - Verbindingsverzoek baseren met toegangstoets en geheime-sleutelverificatie | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Amazon S3 - Aanvraag van de basisverbinding met veronderstelde rolauthentificatie | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Amazon S3 Reactie basisverbinding | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Azure Blob Storage - Aanvraag voor basisverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Azure Blob Storage - Basisreactie verbinding | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Aanvraag voor basisverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Basisreactie verbinding | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Data Landing Zone(DLZ) - Aanvraag voor basisverbinding | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Data Landing Zone - Basisreactie verbinding | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Google Cloud Storage - Aanvraag voor basisverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Google Cloud Storage - Basisreactie verbinding | ||
|
Verzoek
| accordion | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFTP met wachtwoord - Aanvraag van de basisverbinding | |||||||||||||||||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFTP met SSH-sleutel - Aanvraag voor basisverbinding | |||||||||||||||||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| SFTP - Basisverbindingsreactie | ||
|
Codering toevoegen aan geëxporteerde bestanden
U kunt desgewenst versleuteling toevoegen aan uw geëxporteerde bestanden. Hiervoor moet u items toevoegen vanuit de map encryptionSpecs . Zie het onderstaande voorbeeld met de verplichte parameters:
| code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
|---|
|
Verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
| code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
|---|
|
Reactie
| code language-json |
|---|
|
Noteer de verbinding-id in het antwoord. Deze id is vereist in de volgende stap bij het maken van de doelverbinding.
Een doelverbinding maken create-target-connection
Vervolgens moet u een doelverbinding maken. de verbindingen van het Doel slaan de uitvoerparameters voor het uitgevoerde publiek op. Exportparameters zijn onder andere exportlocatie, bestandsindeling, compressie en andere details. Voor CSV-bestanden kunt u bijvoorbeeld verschillende exportopties selecteren. Krijg uitgebreide informatie over alle gesteunde CSV de uitvoeropties in de dossier formatterende configuratiepagina .
Raadpleeg de targetSpec -eigenschappen in de doelmap connection spec voor meer informatie over de ondersteunde eigenschappen voor elk doeltype. Verwijs in de onderstaande tabbladen naar de eigenschappen targetSpec van alle ondersteunde doelen.
| accordion | ||
|---|---|---|
| Amazon S3 - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
| accordion | ||
|---|---|---|
| Azure Blob Storage - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
| accordion | ||
|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
| accordion | ||
|---|---|---|
| Data Landing Zone(DLZ) - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
| accordion | ||
|---|---|---|
| Google Cloud Storage - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
| accordion | ||
|---|---|---|
| SFTP - Connection spec parameters voor doelverbinding weergeven | ||
|
Let op de gemarkeerde regels met inline opmerkingen in het onderstaande connection spec voorbeeld. Deze bevatten aanvullende informatie over waar u de target spec -parameters in de verbindingsspecificatie kunt vinden. U kunt ook in het voorbeeld zien waaronder de doelparameters ** niet van toepassing zijn op publiek de uitvoerbestemmingen.
|
Aan de hand van de bovenstaande specificatie kunt u een aanvraag voor een doelverbinding samenstellen die specifiek is voor uw gewenste bestemming voor cloudopslag, zoals weergegeven in de onderstaande tabbladen.
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Amazon S3 - Aanvraag voor doelverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Amazon S3 - Verbindingsverzoek als doel instellen met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Azure Blob Storage - Aanvraag voor doelverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Azure Blob Storage - Verbindingsverzoek als doel instellen met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Aanvraag voor doelverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Azure Data Lake Gen 2(ADLS Gen2) - Verbindingsverzoek als doel instellen met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Data Landing Zone - Aanvraag voor doelverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Data Landing Zone - Verbindingsverzoek als doel instellen met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| Google Cloud Storage - Aanvraag voor doelverbinding | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| Google Cloud Storage - Verbindingsverzoek als doel instellen met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Verzoek
| accordion | |||||
|---|---|---|---|---|---|
| SFTP - Aanvraag van de Verbinding van het doel | |||||
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
| accordion | |||||
|---|---|---|---|---|---|
| SFTP - Doel verbindingsverzoek met CSV-opties | |||||
|
Reactie
| accordion | ||
|---|---|---|
| Doelverbinding - Reactie | ||
|
Noteer de target connection ID uit het antwoord. Deze id is vereist in de volgende stap bij het maken van de gegevensstroom voor het exporteren van soorten publiek.
Een geslaagde reactie retourneert de id (id) van de nieuwe doelbronverbinding en een etag . Noteer de doel-verbindings-id zoals u deze later nodig hebt bij het maken van de gegevensstroom.
Een gegevensstroom maken create-dataflow
De volgende stap in de bestemmingsconfiguratie moet een dataflow tot stand brengen. A dataflow verbindt eerder gecreeerd entiteiten samen en verstrekt ook opties om het programma van de publieksuitvoer te vormen. Als u de gegevensstroom wilt maken, gebruikt u de onderstaande ladingen, afhankelijk van uw gewenste bestemming voor de cloudopslag, en vervangt u de id's van de flowentiteit uit vorige stappen. Merk op dat in deze stap, u geen informatie met betrekking tot attribuut of identiteitstoewijzing aan dataflow toevoegt. Dat zal in de volgende stap gebeuren.
Verzoek
| accordion | ||
|---|---|---|
| Doelgroep exportgegevens maken naar Amazon S3 -doel - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| Doelgroep exportgegevens maken naar Azure Blob Storage -doel - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| Doelgroep exportgegevens maken naar Azure Data Lake Gen 2(ADLS Gen2) -doel - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| Doelgroep exportgegevens maken naar Data Landing Zone -doel - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| Doelgroep exportgegevens maken naar Google Cloud Storage -doel - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Verzoek
| accordion | ||
|---|---|---|
| Gegevensstroom voor het exporteren van publiek naar SFTP-bestemming maken - Aanvraag | ||
|
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
|
Reactie
| accordion | ||
|---|---|---|
| Gegevensstroom maken - Reactie | ||
|
Noteer de Dataflow-id uit het antwoord. Deze id is vereist in latere stappen.
Soorten publiek toevoegen aan de exportbewerking
In deze stap kunt u ook selecteren welk publiek u naar het doel wilt exporteren. Voor uitgebreide informatie over deze stap en het verzoekformaat om een publiek aan dataflow toe te voegen, bekijk de voorbeelden in de Update een sectie van bestemmingsdataflow van de API verwijzingsdocumentatie.
Kenmerk en identiteitstoewijzing instellen attribute-and-identity-mapping
Nadat u de gegevensstroom hebt gemaakt, moet u toewijzingen instellen voor de kenmerken en identiteiten die u wilt exporteren. Dit bestaat uit drie stappen, die hieronder worden vermeld:
- Een invoerschema maken
- Een uitvoerschema maken
- Stel een toewijzingsset in om de gemaakte schema's te verbinden
Bijvoorbeeld, om de volgende afbeelding te verkrijgen die in UI wordt getoond, zou u door de drie hierboven vermelde stappen moeten gaan en in de volgende rubrieken worden gedetailleerd.
Een invoerschema maken
Om een inputschema tot stand te brengen, moet u eerst uw verenigingsschema en de identiteiten terugwinnen die naar de bestemming kunnen worden uitgevoerd. Dit is het schema van attributen en identiteiten die u als bronafbeelding kunt selecteren.
Hieronder vindt u voorbeelden van verzoeken en reacties om kenmerken en identiteiten op te halen.
Verzoek om attributen te krijgen
| code language-shell |
|---|
|
Reactie
De onderstaande reactie is verkort vanwege de beknoptheid.
| code language-json |
|---|
|
Verzoek om identiteiten te krijgen
| code language-shell |
|---|
|
Reactie
De reactie retourneert de identiteiten die u kunt gebruiken bij het maken van het invoerschema. Merk op dat deze reactie zowel standaard als douane identiteitsnaamruimten terugkeert die u opstelling in Experience Platform.
| code language-json |
|---|
|
Vervolgens moet u de reactie van boven kopiëren en deze gebruiken om uw invoerschema te maken. U kunt de gehele JSON-reactie van de bovenstaande reactie kopiëren en deze in het hieronder vermelde jsonSchema -object plaatsen.
Verzoek om inputschema tot stand te brengen
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
De id in de reactie vertegenwoordigt de unieke id van het invoerschema dat u hebt gemaakt. Kopieer de id uit het antwoord omdat u deze later opnieuw zult gebruiken.
Een uitvoerschema maken
Daarna, moet u opstelling het outputschema voor uw uitvoer. Eerst, moet u uw bestaand partnerschema vinden en inspecteren.
Verzoek
In het onderstaande voorbeeld wordt connection spec ID voor Amazon S3 gebruikt. Vervang deze waarde door de specifieke verbindingsspecificatie-id voor uw bestemming.
| code language-shell |
|---|
|
Reactie met een voorbeeldschema
Inspecteer de reactie u wanneer het uitvoeren van de hierboven vermelde vraag krijgt. U moet omlaag naar de reactie gaan om het object te zoeken targetSpec.attributes.partnerSchema.jsonSchema
| code language-json |
|---|
|
Vervolgens moet u een uitvoerschema maken. Kopieer de JSON-reactie die u hierboven hebt geplaatst en plak deze in het onderstaande jsonSchema -object.
Verzoek
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
De id in de reactie vertegenwoordigt de unieke id van het invoerschema dat u hebt gemaakt. Kopieer de id uit het antwoord omdat u deze later opnieuw zult gebruiken.
Toewijzingsset maken create-mapping-set
Daarna, gebruik prep API van 0} gegevens om de afbeelding tot stand te brengen die door input schemaidentiteitskaart, identiteitskaart van het outputschema, en de gewenste gebiedstoewijzingen te gebruiken wordt geplaatst.
Verzoek
| note important |
|---|
| IMPORTANT |
|
| code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
|---|
|
Reactie
| code language-json |
|---|
|
Noteer de id van de toewijzingsset omdat u deze in de volgende stap nodig hebt om de bestaande gegevensstroom bij te werken met de toewijzingsid.
Vervolgens haalt u de id op van de gegevensstroom die u wilt bijwerken.
Zie de details van een bestemmingsdataflow voor informatie terugwinnen over het terugwinnen van identiteitskaart van een dataflow.
Tot slot moet u PATCH de gegevensstroom met de informatie van de toewijzingsreeks die u enkel creeerde.
Verzoek
| code language-shell |
|---|
|
Reactie
De reactie van de Dienst API van de Stroom keert identiteitskaart van bijgewerkte dataflow terug.
| code language-json |
|---|
|
Andere updates voor gegevensstroom uitvoeren other-dataflow-updates
Gebruik de bewerking PATCH om updates van de gegevensstroom uit te voeren. Bijvoorbeeld, kunt u een marketing actie aan uw gegevensstroom toevoegen, uw gegevensstromen bijwerken om gebieden als verplichte sleutels of deduplicatietoetsen te selecteren, of de productie van dossiermanifest aan bestaande bestemmingen toevoegen.
Een marketingactie toevoegen add-marketing-action
Om a marketing actie toe te voegen, zie hieronder de verzoek en reactievoorbeelden.
If-Match is vereist wanneer u een PATCH -aanvraag indient. De waarde voor deze kopbal is de unieke versie van dataflow u wilt bijwerken. De etag waarde werkt met elke succesvolle update van een stroomentiteit zoals dataflow, doelverbinding, en anderen bij.https://platform.adobe.io/data/foundation/flowservice/flows/{ID} -eindpunt, waarbij {ID} de dataflow-id is die u wilt bijwerken.If-Match tussen dubbele aanhalingstekens plaatst, zoals in de onderstaande voorbeelden, wanneer u PATCH -aanvragen maakt.Verzoek
| code language-shell |
|---|
|
Reactie
Een geslaagde reactie retourneert de antwoordcode 200 samen met de id van de bijgewerkte gegevensstroom en de bijgewerkte eTag.
| code language-json |
|---|
|
Een verplichte toets toevoegen add-mandatory-key
Om a verplichte sleutel toe te voegen, zie hieronder de verzoek en reactievoorbeelden.
If-Match is vereist wanneer u een PATCH -aanvraag indient. De waarde voor deze kopbal is de unieke versie van dataflow u wilt bijwerken. De etag waarde werkt met elke succesvolle update van een stroomentiteit zoals dataflow, doelverbinding, en anderen bij.https://platform.adobe.io/data/foundation/flowservice/flows/{ID} -eindpunt, waarbij {ID} de dataflow-id is die u wilt bijwerken.If-Match tussen dubbele aanhalingstekens plaatst, zoals in de onderstaande voorbeelden, wanneer u PATCH -aanvragen maakt.Verzoek
| code language-shell |
|---|
|
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
Een deduplicatietoets toevoegen add-deduplication-key
Om a deduplicatiesleutel toe te voegen, zie hieronder de verzoek en reactievoorbeelden
If-Match is vereist wanneer u een PATCH -aanvraag indient. De waarde voor deze kopbal is de unieke versie van dataflow u wilt bijwerken. De etag waarde werkt met elke succesvolle update van een stroomentiteit zoals dataflow, doelverbinding, en anderen bij.https://platform.adobe.io/data/foundation/flowservice/flows/{ID} -eindpunt, waarbij {ID} de dataflow-id is die u wilt bijwerken.If-Match tussen dubbele aanhalingstekens plaatst, zoals in de onderstaande voorbeelden, wanneer u PATCH -aanvragen maakt.Verzoek
| code language-shell |
|---|
|
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
Bestandmanifest-generatie toevoegen aan bestaande bestemming add-file-manifest
Manifest JSON-bestanden bevatten informatie 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 looppas die 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.
Als u bestands-manifest-generatie wilt toevoegen aan een bestaand doel, moet u de parameters voor de doelverbinding bijwerken met de bewerking PATCH . Dit laat duidelijke dossiergeneratie voor uw bestemming toe, die meta-gegevens over de uitgevoerde dossiers verstrekt.
If-Match is vereist wanneer u een PATCH -aanvraag indient. De waarde voor deze header is de unieke versie van de doelverbinding die u wilt bijwerken. De etag waarde werkt met elke succesvolle update van een stroomentiteit zoals dataflow, doelverbinding, en anderen bij.https://platform.adobe.io/data/foundation/flowservice/targetConnections/{ID} -eindpunt, waarbij {ID} de doel-verbindings-id is die u wilt bijwerken.If-Match tussen dubbele aanhalingstekens plaatst, zoals in de onderstaande voorbeelden, wanneer u PATCH -aanvragen maakt.Verzoek
| code language-shell |
|---|
|
Gegevensstroom valideren (de dataflow-runtime ophalen) get-dataflow-runs
Om de uitvoering van een gegevensstroom te controleren, gebruik Dataflow loops API:
Verzoek
| code language-shell |
|---|
|
Reactie
| code language-json |
|---|
|
U kunt informatie over de diverse parameters vinden die door de looppasAPI van Dataflow in de API verwijzingsdocumentatie zijn teruggekeerd.
API-foutafhandeling api-error-handling
De API-eindpunten in deze zelfstudie volgen de algemene beginselen van het Experience Platform API-foutbericht. Verwijs naar API statuscodes en de fouten van de verzoekkopbal in de het oplossen van problemengids van Experience Platform voor meer informatie bij het interpreteren van foutenreacties.
Volgende stappen next-steps
Door deze zelfstudie te volgen, hebt u Experience Platform verbonden met een van uw voorkeursbestemmingen voor cloudopslag en een dataflow ingesteld op de respectievelijke bestemming om het publiek te exporteren. Zie de volgende pagina's voor meer informatie, zoals hoe u bestaande gegevensstromen kunt bewerken met de Flow Service API: