Aktivera målgrupper för filbaserade mål med API:t för Flow Service
Använd de förbättrade funktionerna för filexport för att få bättre anpassningsfunktioner när du exporterar filer från Experience Platform:
- Ytterligare filnamnsalternativ.
- Möjlighet att ange anpassade filhuvuden i de exporterade filerna via förbättrat mappningssteg.
- Möjlighet att välja filtyp av den exporterade filen.
- Möjlighet att anpassa formateringen i exporterade CSV-datafiler.
Den här funktionen stöds av de sex molnlagringskorten som anges nedan:
I den här artikeln förklaras vilket arbetsflöde som krävs för att använda API för flödestjänst om du vill exportera kvalificerade profiler från Adobe Experience Platform till någon av de molnlagringsplatser som är länkade ovan.
Komma igång get-started
Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:
- Experience Data Model (XDM) System: Det standardiserade ramverk som Experience Platform organiserar kundupplevelsedata.
- Segmentation Service: Adobe Experience Platform Segmentation Service kan ni bygga målgrupper och generera målgrupper i Adobe Experience Platform från Real-Time Customer Profile data.
- Sandboxes: Experience Platform innehåller virtuella sandlådor som partitionerar en enda Platform till separata virtuella miljöer för att utveckla och utveckla applikationer för digitala upplevelser.
I följande avsnitt finns ytterligare information som du behöver känna till för att kunna aktivera data till filbaserade mål i Platform.
Nödvändiga behörigheter permissions
Om du vill exportera profiler måste du ha View Destinations, Activate Destinations, View Profiles och View Segments behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.
Exportera identiteter behöver du View Identity Graph behörighet för åtkomstkontroll.
Läser exempel-API-anrop reading-sample-api-calls
I den här självstudiekursen finns exempel-API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om konventionerna som används i dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i Experience Platform felsökningsguide.
Samla in värden för obligatoriska och valfria rubriker gather-values-headers
För att ringa Platform API:er måste du först slutföra Självstudiekurs om autentisering av Experience Platform. När du är klar med självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla Experience Platform API-anrop enligt nedan:
- Behörighet: Bearer
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Resurser i Experience Platform kan isoleras till specifika virtuella sandlådor. I förfrågningar till Platform API:er kan du ange namn och ID för sandlådan som åtgärden ska utföras i. Dessa är valfria parametrar.
- x-sandbox-name:
{SANDBOX_NAME}
Alla begäranden som innehåller en nyttolast (POST, PUT, PATCH) kräver ytterligare en medietypsrubrik:
- Innehållstyp:
application/json
API-referensdokumentation api-reference-documentation
Du hittar referensdokumentation för alla API-åtgärder i den här självstudiekursen. Se Flödestjänst - API-dokumentation för destinationer på Adobe Developer webbplats. Vi rekommenderar att du använder den här självstudiekursen och API-referensdokumentationen parallellt.
Ordlista glossary
Beskrivningar av termer som du kommer att stöta på i den här API-självstudiekursen finns i ordlista API-referensdokumentationen.
Välj mål där målgrupper ska exporteras select-destination
Innan du startar arbetsflödet för att exportera profiler, ska du identifiera anslutningsspec och flödesspec-ID för det mål som du tänker exportera målgrupper till. Använd tabellen nedan som referens.
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
Du behöver dessa ID:n för att skapa olika flödestjänstentiteter i nästa steg i den här självstudien. Du måste också referera till delar av själva anslutningsspecifikationen för att konfigurera vissa entiteter så att du kan hämta anslutningsspecifikationen från API:er för Flow Service. Se exemplen nedan om hur du hämtar anslutningsspecifikationer för alla mål i tabellen:
Begäran
accordion | ||
---|---|---|
Retrieve connection spec for Amazon S3 | ||
|
Svar
accordion | ||
---|---|---|
Amazon S3 - Anslutningsspecifikation | ||
|
Begäran
accordion | ||
---|---|---|
Retrieve connection spec for Azure Blob Storage | ||
|
Svar
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Begäran
accordion | ||
---|---|---|
Retrieve connection spec for Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Svar
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Begäran
accordion | ||
---|---|---|
Retrieve connection spec for Data Landing Zone(DLZ) | ||
|
Svar
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Begäran
accordion | ||
---|---|---|
Retrieve connection spec for Google Cloud Storage | ||
|
Svar
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Begäran
accordion | ||
---|---|---|
Retrieve connection spec för SFTP | ||
|
Svar
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
Följ stegen nedan för att konfigurera ett dataflöde för målgruppsexport till ett molnlagringsmål. I vissa steg skiljer sig förfrågningarna och svaren mellan de olika molnlagringsmålen. I dessa fall använder du flikarna på sidan för att hämta förfrågningar och svar som är specifika för det mål som du vill ansluta och exportera målgrupper till. Använd rätt connection spec
och flow spec
för målet som du konfigurerar.
Skapa en källanslutning create-source-connection
När du har bestämt vilket mål du vill exportera målgrupper till måste du skapa en källanslutning. The källanslutning representerar anslutningen till den interna Experience Platform Profile Store.
Begäran
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna när du kopierar och klistrar in begäran i valfri terminal.
code language-shell |
---|
|
Svar
code language-json |
---|
|
Ett godkänt svar returnerar ID:t (id
) av den nyligen skapade källanslutningen och etag
. Anteckna källanslutnings-ID som du behöver det senare när du skapar dataflödet.
Skapa en basanslutning create-base-connection
A basanslutning lagrar inloggningsuppgifterna säkert på målet. Beroende på måltypen kan de autentiseringsuppgifter som krävs för att autentisera mot det målet variera. Om du vill hitta de här autentiseringsparametrarna hämtar du först connection spec
för det önskade målet enligt beskrivningen i avsnittet Välj mål där målgrupper ska exporteras och sedan titta på authSpec
av svaret. Se flikarna nedan för authSpec
egenskaper för alla mål som stöds.
accordion | ||
---|---|---|
Amazon S3 - Connection spec visa auth spec | ||
Lägg märke till den markerade raden med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var autentiseringsparametrarna finns i connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec visa auth spec | ||
Lägg märke till den markerade raden med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var autentiseringsparametrarna finns i connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec visa auth spec | ||
Lägg märke till den markerade raden med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var autentiseringsparametrarna finns i connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec visa auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec visa auth spec | ||
Lägg märke till den markerade raden med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var autentiseringsparametrarna finns i connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec visa auth spec | |||||
Lägg märke till den markerade raden med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var autentiseringsparametrarna finns i connection spec.
|
Använda de egenskaper som anges i autentiseringsspecifikationen (dvs. authSpec
från svaret) kan du skapa en basanslutning med de nödvändiga inloggningsuppgifterna, som är specifika för varje måltyp, vilket visas i exemplen nedan:
Begäran
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Basanslutningsbegäran med åtkomstnyckel och autentisering med hemlig nyckel | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
++Amazon S3 - Bas anslutningsbegäran med autentisering med en antagen roll
note tip |
---|
TIP |
Mer information om hur du får de inloggningsuppgifter som krävs finns i autentisera mot mål på sidan för Amazon S3-måldokumentation. |
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
code language-shell line-numbers data-start-1 data-line-offset-4 h-17 |
---|
|
+++
Svar
accordion | ||
---|---|---|
Amazon S3 Basanslutningssvar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Bas anslutningsbegäran | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Azure Blob Storage - Basanslutningssvar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Bas anslutningsbegäran | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Basanslutningssvar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Bas anslutningsbegäran | |||||
|
Svar
accordion | ||
---|---|---|
Data Landing Zone - Basanslutningssvar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Bas anslutningsbegäran | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Google Cloud Storage - Basanslutningssvar | ||
|
Begäran
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP med lösenord - Bas anslutningsbegäran | |||||||||||||||||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP med SSH-nyckel - basanslutningsbegäran | |||||||||||||||||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
SFTP - basanslutningssvar | ||
|
Lägga till kryptering i exporterade filer
Du kan också lägga till kryptering till de exporterade filerna. Du måste lägga till objekt från encryptionSpecs
. Se exemplet nedan med obligatoriska parametrar markerade:
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
Begäran
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna när du kopierar och klistrar in begäran i valfri terminal.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
Svar
code language-json |
---|
|
Observera anslutnings-ID från svaret. Detta ID krävs i nästa steg när du skapar målanslutningen.
Skapa en målanslutning create-target-connection
Därefter måste du skapa en målanslutning. Målanslutningar lagra exportparametrarna för de exporterade målgrupperna. Exportparametrar omfattar exportplats, filformat, komprimering och annan information. För CSV-filer kan du till exempel välja flera exportalternativ. Få omfattande information om alla CSV-exportalternativ som stöds i konfigurationssida för filformatering.
Se targetSpec
egenskaper som anges i målets connection spec
för att förstå vilka egenskaper som stöds för varje måltyp. Se flikarna nedan för targetSpec
egenskaper för alla mål som stöds.
accordion | ||
---|---|---|
Amazon S3 - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
accordion | ||
---|---|---|
SFTP - Connection spec visa målanslutningsparametrar | ||
Lägg märke till de markerade raderna med textbundna kommentarer i connection spec nedan, som innehåller ytterligare information om var du hittar target spec parametrar i anslutningsspecifikationen. I exemplet nedan kan du också se vilka målparametrar som är not gäller för målgruppsexportdestinationer.
|
Genom att använda specifikationen ovan kan du skapa en målanslutningsbegäran som är specifik för ditt molnlagringsmål, vilket visas på flikarna nedan.
Begäran
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Ange anslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Ange anslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Ange anslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Ange anslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Ange anslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Begäran
accordion | |||||
---|---|---|---|---|---|
SFTP - Begäran om målanslutning | |||||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Målanslutningsbegäran med CSV-alternativ | |||||
|
Svar
accordion | ||
---|---|---|
Målanslutning - svar | ||
|
Anteckna target connection ID
från svaret. Detta ID krävs i nästa steg när du skapar dataflödet för att exportera målgrupper.
Ett godkänt svar returnerar ID:t (id
) av den nya målkällanslutningen och etag
. Anteckna målanslutnings-ID som du behöver det senare när du skapar dataflödet.
Skapa ett dataflöde create-dataflow
Nästa steg i målkonfigurationen är att skapa ett dataflöde. A dataflöde binder samman enheter som skapats tidigare och innehåller även alternativ för att konfigurera målgruppens exportschema. Om du vill skapa dataflödet använder du nyttolasterna nedan, beroende på vilket molnlagringsmål du vill ha, och ersätter flödenhets-ID:n från tidigare steg. Observera att du i det här steget inte lägger till någon information om attribut- eller identitetsmappning i dataflödet. Detta kommer att följa i nästa steg.
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport Amazon S3 mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport Azure Blob Storage mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport Azure Data Lake Gen 2(ADLS Gen2) mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport Data Landing Zone mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport Google Cloud Storage mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Begäran
accordion | ||
---|---|---|
Skapa dataflöde för målgruppsexport till SFTP-mål - begäran | ||
Lägg märke till de markerade raderna med textbundna kommentarer i exemplet med begäran som ger ytterligare information. Ta bort de textbundna kommentarerna i begäran när du kopierar och klistrar in begäran i valfri terminal.
|
Svar
accordion | ||
---|---|---|
Skapa dataflöde - svar | ||
|
Anteckna dataflödes-ID från svaret. Detta ID krävs i senare steg.
Lägga till målgrupper i exporten
I det här steget kan du även välja vilka målgrupper du vill exportera till målet. Utförlig information om det här steget och formatet för begäran om att lägga till en målgrupp i dataflödet finns i exemplen i Uppdatera ett måldataflöde i API-referensdokumentationen.
Ställ in attribut- och identitetsmappning attribute-and-identity-mapping
När du har skapat dataflödet måste du ange mappning för de attribut och identiteter som du vill exportera. Detta består av tre steg som anges nedan:
- Skapa ett inmatningsschema
- Skapa ett utdataschema
- Konfigurera en mappningsuppsättning för att ansluta till de skapade scheman
Om du till exempel vill få fram följande mappning som visas i användargränssnittet måste du gå igenom de tre stegen som listas ovan och som beskrivs i nästa rubriker.
Skapa ett inmatningsschema
Om du vill skapa ett indatabema måste du först hämta union och de identiteter som kan exporteras till målet. Det här är schemat med attribut och identiteter som du kan välja som källmappning.
Se nedan exempel på förfrågningar och svar för att hämta attribut och identiteter.
Begär att få attribut
code language-shell |
---|
|
Svar
Svaret nedan har förkortats av kortfattad anledning.
code language-json |
---|
|
Begär att få identiteter
code language-shell |
---|
|
Svar
Svaret returnerar de identiteter som du kan använda när du skapar indatarammet. Observera att det här svaret returnerar båda standard och anpassad identitetsnamnutrymmen som du konfigurerar i Experience Platform.
code language-json |
---|
|
Därefter måste du kopiera svaret ovan och använda det för att skapa ditt indatabchema. Du kan kopiera hela JSON-svaret från svaret ovan och placera det i jsonSchema
det objekt som anges nedan.
Begäran om att skapa indatabchema
code language-shell |
---|
|
Svar
code language-json |
---|
|
ID:t i svaret representerar den unika identifieraren för det indatabchema som du har skapat. Kopiera ID:t från svaret eftersom du kommer att återanvända det i ett senare steg.
Skapa ett utdataschema
Sedan måste du konfigurera utdataschemat för din export. Först måste du hitta och kontrollera ditt befintliga partnerschema.
Begäran
Observera att exemplet nedan använder connection spec ID
för Amazon S3. Ersätt det här värdet med det anslutningsspec-ID som är specifikt för ditt mål.
code language-shell |
---|
|
Svar med ett exempelschema
Inspect det svar du får när du genomför samtalet ovan. Du måste gå ned i svaret för att hitta objektet targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
Därefter måste du skapa ett utdataschema. Kopiera det JSON-svar du fick ovan och klistra in det i jsonSchema
objektet nedan.
Begäran
code language-shell |
---|
|
Svar
code language-json |
---|
|
ID:t i svaret representerar den unika identifieraren för det indatabchema som du har skapat. Kopiera ID:t från svaret eftersom du kommer att återanvända det i ett senare steg.
Skapa mappningsuppsättning create-mapping-set
Använd sedan API för dataförberedelse om du vill skapa mappningsuppsättningen med hjälp av indatabchema-ID, ID för utdatans schema och önskade fältmappningar.
Begäran
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
Svar
code language-json |
---|
|
Observera mappningsuppsättningens ID som du behöver i nästa steg för att uppdatera det befintliga dataflödet med mappningsuppsättnings-ID:t.
Hämta sedan ID:t för det dataflöde som du vill uppdatera.
Se hämta information om ett måldataflöde om du vill ha information om hur du hämtar ID:t för ett dataflöde.
Slutligen måste du PATCH dataflödet med den mappningsuppsättningsinformation som du nyss skapade.
Begäran
code language-shell |
---|
|
Svar
Svaret från API:t för Flow Service returnerar ID:t för det uppdaterade dataflödet.
code language-json |
---|
|
Gör andra dataflödesuppdateringar other-dataflow-updates
Använd PATCH
operation.Du kan till exempel uppdatera dina dataflöden och välja fält som obligatoriska nycklar eller dedupliceringsnycklar.
Lägg till en obligatorisk nyckel add-mandatory-key
Lägga till en obligatorisk nyckel, se exemplen på begäran och svar nedan
Begäran
code language-shell |
---|
|
code language-shell |
---|
|
Svar
code language-json |
---|
|
Lägg till en dedupliceringsnyckel add-deduplication-key
Lägga till en dedupliceringsnyckel, se exemplen på begäran och svar nedan
Begäran
code language-shell |
---|
|
code language-shell |
---|
|
Svar
code language-json |
---|
|
Validera dataflöde (hämta dataflödeskörningar) get-dataflow-runs
Använd API:t för dataflödeskörning om du vill kontrollera körningarna av ett dataflöde:
Begäran
code language-shell |
---|
|
Svar
code language-json |
---|
|
Du hittar information om olika parametrar som returneras av API:t för dataflöde i API-referensdokumentationen.
API-felhantering api-error-handling
API-slutpunkterna i den här självstudiekursen följer de allmänna felmeddelandeprinciperna för Experience Platform API. Se API-statuskoder och fel i begäranhuvudet i felsökningsguiden för plattformen för mer information om hur du tolkar felsvar.
Nästa steg next-steps
Genom att följa den här självstudiekursen har du anslutit plattformen till en av dina favoritplatser för molnlagring och konfigurerat ett dataflöde till respektive mål för att exportera målgrupper. På följande sidor finns mer information, till exempel om hur du redigerar befintliga dataflöden med API:t för Flow Service: