Activeer publiek aan op dossier-gebaseerde bestemmingen door de Dienst API van de Stroom te gebruiken
Gebruik de uitgebreide mogelijkheden voor het exporteren van bestanden om toegang te krijgen tot de verbeterde aanpassingsfunctionaliteit wanneer u bestanden exporteert vanuit het Experience Platform:
- Aanvullende dossier noemende opties.
- Mogelijkheid om de kopballen van het douanedossier in uw uitgevoerde dossiers via de verbeterde toewijzingsstapte plaatsen.
- Mogelijkheid om het dossiertypevan het uitgevoerde dossier te selecteren.
- Mogelijkheid om het formatteren van uitgevoerde CSV gegevensdossiersaan 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 Stroomte 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
is
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 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 op dossier-gebaseerde bestemmingen in Platform te activeren.
Vereiste machtigingen permissions
Om profielen uit te voeren, 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.
{width="100" modal="regular"}
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 vraagin de Experience Platform het oplossen van problemengids te lezen.
Waarden verzamelen voor vereiste en optionele koppen gather-values-headers
Om vraag aan Platform APIs te maken, moet u het Experience Platform authentificatieleerprogrammaeerst 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 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 woordenlijstsectievan de API verwijzingsdocumentatie.
Doel selecteren waar publiek moet worden geëxporteerd select-destination
is
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-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
U 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 | ||
---|---|---|
Ophalen connection spec voor Amazon S3 | ||
|
Reactie
accordion | ||
---|---|---|
Amazon S3 - Verbindingsspecificatie | ||
|
Verzoek
accordion | ||
---|---|---|
Ophalen connection spec voor Azure Blob Storage | ||
|
Reactie
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Verzoek
accordion | ||
---|---|---|
ophalen connection spec voor Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Reactie
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Verzoek
accordion | ||
---|---|---|
Ophalen connection spec voor Data Landing Zone(DLZ) | ||
|
Reactie
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Verzoek
accordion | ||
---|---|---|
Ophalen connection spec voor Google Cloud Storage | ||
|
Reactie
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Verzoek
accordion | ||
---|---|---|
ophalen connection spec 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
is
Nadat u hebt bepaald naar welk doel u het publiek exporteert, moet u een bronverbinding maken. De bronverbindingvertegenwoordigt de verbinding aan de interne opslag van het Profiel van het 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
is
A basisverbindingslaat 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 publiekuit 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 - de Verzoek van de Verbinding van de basis | |||||||||||||||||||
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 - De reactie van de basisverbinding | ||
|
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
is
Vervolgens moet u een doelverbinding maken. de verbindingen van het Doelslaan 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 | ||
---|---|---|
Target-verbinding - 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 | ||
---|---|---|
Target-verbinding - 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 | ||
---|---|---|
Target-verbinding - 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 | ||
---|---|---|
Target-verbinding - 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 | ||
---|---|---|
Target-verbinding - Reactie | ||
|
Verzoek
accordion | |||||
---|---|---|---|---|---|
SFTP - verzoek 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 opties CSV | |||||
|
Reactie
accordion | ||
---|---|---|
Target-verbinding - 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
is
De volgende stap in de bestemmingsconfiguratie moet een dataflow tot stand brengen. A dataflowverbindt 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 | ||
---|---|---|
Maak doelpubliek exportgegevens naar Amazon S3 -doel - Verzoek | ||
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 | ||
---|---|---|
Maak doelpubliek exportgegevens naar Azure Blob Storage -doel - Verzoek | ||
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 | ||
---|---|---|
Maak doelpubliek exportgegevens naar Azure Data Lake Gen 2(ADLS Gen2) -doel - Verzoek | ||
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 | ||
---|---|---|
Maak doelpubliek exportgegevens naar Data Landing Zone -doel - Verzoek | ||
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 | ||
---|---|---|
Maak doelpubliek exportgegevens naar Google Cloud Storage -doel - Verzoek | ||
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 | ||
---|---|---|
Gegevens voor publiek exporteren naar SFTP-doel 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 bestemmingsdataflowvan de API verwijzingsdocumentatie.
Kenmerk en identiteitstoewijzing instellen attribute-and-identity-mapping
is
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 verenigingsschemaen 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 standaardals douaneidentiteitsnaamruimten 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
Inspect 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 bestemmingsdataflowvoor 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
is
Gebruik de bewerking PATCH
om updates van de gegevensstroom uit te voeren. U kunt bijvoorbeeld een marketingactie toevoegen aan uw gegevensstroom. U kunt uw gegevensstromen ook bijwerken en velden selecteren als verplichte toetsen of als deduplicatietoetsen.
Een marketingactie toevoegen add-marketing-action
Om a marketing actietoe 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 sleuteltoe 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 deduplicatiesleuteltoe 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 |
---|
|
Gegevensstroom valideren (de dataflow-runtime ophalen) get-dataflow-runs
is
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 Dataflowin de API verwijzingsdocumentatie zijn teruggekeerd.
API-foutafhandeling api-error-handling
De API-eindpunten in deze zelfstudie volgen de algemene beginselen van het API-foutbericht voor Experience Platforms. Verwijs naar API statuscodesen de fouten van de verzoekkopbalin de het oplossen van problemengids van het Platform voor meer informatie bij het interpreteren van foutenreacties.
Volgende stappen next-steps
Door deze zelfstudie te volgen, hebt u Platform met succes verbonden met een van uw voorkeursbestemmingen voor de 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: