Attivare i tipi di pubblico nelle destinazioni basate su file utilizzando l’API del servizio Flusso
Utilizza le funzionalità avanzate di esportazione dei file per accedere a funzionalità avanzate di personalizzazione durante l’esportazione di file da Experience Platform:
- Nuove opzioni di denominazione file.
- Possibilità di impostare intestazioni di file personalizzate nei file esportati tramite il passaggio di mappatura migliorato.
- Possibilità di selezionare il tipo di file del file esportato.
- Possibilità di personalizzare la formattazione dei file CSV esportati.
Questa funzionalità è supportata dalle sei schede di archiviazione cloud elencate di seguito:
In questo articolo viene illustrato il flusso di lavoro necessario per utilizzare l'API Flow Service per esportare profili qualificati da Adobe Experience Platform in una delle posizioni di archiviazione cloud collegate in precedenza.
Introduzione get-started
Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Experience Data Model (XDM) System: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Segmentation Service: Adobe Experience Platform Segmentation Service consente di creare tipi di pubblico e generarli in Adobe Experience Platform dai dati di Real-Time Customer Profile.
- Sandboxes: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per attivare i dati nelle destinazioni basate su file in Platform.
Autorizzazioni richieste permissions
Per esportare i profili, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
{width="100" modal="regular"}
Lettura delle chiamate API di esempio reading-sample-api-calls
Questo tutorial fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.
Raccogli i valori per le intestazioni obbligatorie e facoltative gather-values-headers
Per effettuare chiamate alle API Platform, devi prima completare l'esercitazione di autenticazione Experience Platform. Completando il tutorial sull’autenticazione si ottengono i valori per ciascuna delle intestazioni richieste in tutte le chiamate API di Experience Platform, come mostrato di seguito:
- Autorizzazione: Bearer
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Le risorse in Experience Platform possono essere isolate in specifiche sandbox virtuali. Nelle richieste alle API Platform, puoi specificare il nome e l'ID della sandbox in cui verrà eseguita l'operazione. Si tratta di parametri facoltativi.
- x-sandbox-name:
{SANDBOX_NAME}
Tutte le richieste che contengono un payload (POST
, PUT
, PATCH
) richiedono un'intestazione del tipo di supporto aggiuntiva:
- Tipo di contenuto:
application/json
Documentazione di riferimento API api-reference-documentation
Questa esercitazione contiene la documentazione di riferimento per tutte le operazioni API. Consulta la documentazione Flow Service - Destinations API (Servizio di flusso - Destinazioni) sul sito Web Adobe Developer. È consigliabile utilizzare questa esercitazione e la documentazione di riferimento API in parallelo.
Glossario glossary
Per le descrizioni dei termini che incontrerai in questa esercitazione API, leggi la sezione del glossario della documentazione di riferimento API.
Seleziona la destinazione in cui esportare i tipi di pubblico select-destination
Prima di avviare il flusso di lavoro per l’esportazione dei profili, identifica la specifica di connessione e gli ID delle specifiche di flusso della destinazione in cui intendi esportare i tipi di pubblico. Utilizzare la tabella seguente come riferimento.
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
Nei passaggi successivi di questa esercitazione, sono necessari questi ID per creare varie entità del servizio di flusso. È inoltre necessario fare riferimento a parti della specifica di connessione stessa per impostare determinate entità in modo da poter recuperare la specifica di connessione dalle API del servizio Flusso. Vedi gli esempi seguenti di recupero delle specifiche di connessione per tutte le destinazioni nella tabella:
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per Amazon S3 | ||
|
Risposta
accordion | ||
---|---|---|
Amazon S3 - Specifica di connessione | ||
|
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per Azure Blob Storage | ||
|
Risposta
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Risposta
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per Data Landing Zone(DLZ) | ||
|
Risposta
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per Google Cloud Storage | ||
|
Risposta
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
Richiesta
accordion | ||
---|---|---|
Recupera connection spec per SFTP | ||
|
Risposta
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
Segui i passaggi seguenti per configurare un flusso di dati di esportazione del pubblico in una destinazione di archiviazione cloud. Per alcuni passaggi, le richieste e le risposte differiscono tra le varie destinazioni dell’archiviazione cloud. In questi casi, utilizza le schede nella pagina per recuperare le richieste e le risposte specifiche della destinazione a cui desideri connettere ed esportare i tipi di pubblico. Assicurarsi di utilizzare connection spec
e flow spec
corretti per la destinazione che si sta configurando.
Creare una connessione Source create-source-connection
Dopo aver deciso la destinazione in cui esportare i tipi di pubblico, devi creare una connessione sorgente. La connessione di origine rappresenta la connessione all'archivio profili di Experience Platform interno.
Richiesta
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea quando copi-incolla la richiesta nel terminale desiderato.
code language-shell |
---|
|
Risposta
code language-json |
---|
|
In caso di esito positivo, la risposta restituisce l'ID (id
) della connessione di origine appena creata e un etag
. Prendi nota dell’ID della connessione sorgente in quanto sarà necessario in un secondo momento durante la creazione del flusso di dati.
Creare una connessione di base create-base-connection
Una connessione base memorizza in modo sicuro le credenziali nella destinazione. A seconda del tipo di destinazione, le credenziali necessarie per l’autenticazione a fronte di tale destinazione possono variare. Per trovare questi parametri di autenticazione, recupera connection spec
per la destinazione desiderata come descritto nella sezione Seleziona la destinazione in cui esportare i tipi di pubblico, quindi controlla authSpec
della risposta. Fai riferimento alle schede seguenti per le proprietà authSpec
di tutte le destinazioni supportate.
accordion | ||
---|---|---|
Amazon S3 - Connection spec visualizzazione di auth spec | ||
Annotare la riga evidenziata con i commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri di autenticazione in connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec visualizzazione di auth spec | ||
Annotare la riga evidenziata con i commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri di autenticazione in connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec visualizzazione di auth spec | ||
Annotare la riga evidenziata con i commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri di autenticazione in connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec visualizzazione di auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec visualizzazione di auth spec | ||
Annotare la riga evidenziata con i commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri di autenticazione in connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec visualizzazione di auth spec | |||||
Annotare la riga evidenziata con i commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri di autenticazione in connection spec.
|
Utilizzando le proprietà specificate nella specifica di autenticazione (ovvero authSpec
dalla risposta) è possibile creare una connessione di base con le credenziali richieste, specifiche per ogni tipo di destinazione, come illustrato negli esempi seguenti:
Richiesta
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Richiesta di connessione di base con autenticazione chiave di accesso e chiave segreta | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Richiesta di connessione di base con autenticazione ruolo assunta | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Amazon S3 risposta connessione di base | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Richiesta di connessione di base | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Azure Blob Storage - Risposta connessione di base | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Richiesta di connessione di base | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Risposta connessione di base | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Richiesta di connessione di base | |||||
|
Risposta
accordion | ||
---|---|---|
Data Landing Zone - Risposta connessione di base | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Richiesta di connessione di base | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Google Cloud Storage - Risposta connessione di base | ||
|
Richiesta
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP con password - Richiesta di connessione di base | |||||||||||||||||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP con chiave SSH - Richiesta di connessione di base | |||||||||||||||||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
SFTP - Risposta di connessione di base | ||
|
Aggiungi crittografia ai file esportati
È inoltre possibile aggiungere la crittografia ai file esportati. A tale scopo, è necessario aggiungere elementi da encryptionSpecs
. Vedi l’esempio di richiesta seguente con i parametri obbligatori evidenziati:
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
Richiesta
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea quando copi-incolla la richiesta nel terminale desiderato.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
Risposta
code language-json |
---|
|
Prendi nota dell’ID di connessione dalla risposta. Questo ID sarà richiesto nel passaggio successivo durante la creazione della connessione di destinazione.
Creare una connessione di destinazione create-target-connection
Successivamente, devi creare una connessione di destinazione. Le connessioni di destinazione memorizzano i parametri di esportazione per i tipi di pubblico esportati. I parametri di esportazione includono la posizione di esportazione, il formato del file, la compressione e altri dettagli. Ad esempio, per i file CSV, puoi selezionare diverse opzioni di esportazione. Ottieni informazioni dettagliate su tutte le opzioni di esportazione CSV supportate nella pagina configurazioni di formattazione file.
Per informazioni sulle proprietà supportate per ciascun tipo di destinazione, fare riferimento alle proprietà targetSpec
fornite in connection spec
della destinazione. Fai riferimento alle schede seguenti per le proprietà targetSpec
di tutte le destinazioni supportate.
accordion | ||
---|---|---|
Amazon S3 - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
accordion | ||
---|---|---|
SFTP - Connection spec visualizzazione dei parametri di connessione di destinazione | ||
Prendere nota delle righe evidenziate con commenti in linea nell'esempio connection spec seguente, che forniscono informazioni aggiuntive su dove trovare i parametri target spec nella specifica di connessione. Puoi anche vedere nell'esempio seguente quali parametri di destinazione sono non applicabili alle destinazioni di esportazione del pubblico.
|
Utilizzando la specifica di cui sopra, puoi creare una richiesta di connessione di destinazione specifica per la destinazione di archiviazione cloud desiderata, come illustrato nelle schede seguenti.
Richiesta
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Richiesta
accordion | |||||
---|---|---|---|---|---|
SFTP - Richiesta di connessione Target | |||||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Richiesta di connessione Target con opzioni CSV | |||||
|
Risposta
accordion | ||
---|---|---|
Connessione Target - Risposta | ||
|
Prendi nota di target connection ID
dalla risposta. Questo ID sarà richiesto nel passaggio successivo quando crei il flusso di dati per esportare i tipi di pubblico.
In caso di esito positivo, la risposta restituisce l'ID (id
) della nuova connessione di origine di destinazione e un etag
. Prendi nota dell’ID connessione di destinazione, in quanto sarà necessario in un secondo momento durante la creazione del flusso di dati.
Creare un flusso di dati create-dataflow
Il passaggio successivo nella configurazione di destinazione consiste nel creare un flusso di dati. Un flusso di dati unisce entità create in precedenza e fornisce inoltre opzioni per configurare la pianificazione dell'esportazione del pubblico. Per creare il flusso di dati, utilizza i payload riportati di seguito, a seconda della destinazione di archiviazione cloud desiderata, e sostituisci gli ID delle entità di flusso dei passaggi precedenti. In questo passaggio non vengono aggiunte al flusso di dati informazioni relative alla mappatura di attributi o identità. Questo sarà il prossimo passo.
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione Amazon S3 - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione Azure Blob Storage - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione Azure Data Lake Gen 2(ADLS Gen2) - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione Data Landing Zone - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione Google Cloud Storage - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Richiesta
accordion | ||
---|---|---|
Crea flusso di dati di esportazione del pubblico nella destinazione SFTP - Richiesta | ||
Nell’esempio di richiesta, annota le righe evidenziate con commenti in linea, che forniscono informazioni aggiuntive. Rimuovi i commenti in linea nella richiesta quando copia e incolla la richiesta nel terminale scelto.
|
Risposta
accordion | ||
---|---|---|
Crea flusso di dati - Risposta | ||
|
Prendi nota dell’ID del flusso di dati dalla risposta. Questo ID sarà richiesto nei passaggi successivi.
Aggiungere tipi di pubblico all’esportazione
In questo passaggio, puoi anche selezionare i tipi di pubblico da esportare nella destinazione. Per informazioni dettagliate su questo passaggio e sul formato della richiesta per aggiungere un pubblico al flusso di dati, vedi gli esempi nella sezione Aggiornamento di un flusso di dati di destinazione della documentazione di riferimento API.
Impostare la mappatura di attributi e identità attribute-and-identity-mapping
Dopo aver creato il flusso di dati, devi impostare la mappatura per gli attributi e le identità che desideri esportare. Si tratta di tre passaggi, elencati di seguito:
- Creare uno schema di input
- Creare uno schema di output
- Impostare un set di mappatura per collegare gli schemi creati
Ad esempio, per ottenere la seguente mappatura mostrata nell’interfaccia utente, dovrai seguire i tre passaggi elencati sopra e descritti nei titoli successivi.
Creare uno schema di input
Per creare uno schema di input, devi innanzitutto recuperare lo schema di unione e le identità che possono essere esportate nella destinazione. Schema di attributi e identità che puoi selezionare come mappatura sorgente.
Di seguito sono riportati alcuni esempi di richieste e risposte per recuperare attributi e identità.
Richiesta di ottenere gli attributi
code language-shell |
---|
|
Risposta
La risposta seguente è stata ridotta per brevità.
code language-json |
---|
|
Richiesta per ottenere le identità
code language-shell |
---|
|
Risposta
La risposta restituisce le identità utilizzabili durante la creazione dello schema di input. Questa risposta restituisce sia gli spazi dei nomi di identità standard che quelli personalizzati configurati in Experience Platform.
code language-json |
---|
|
Successivamente, devi copiare la risposta dall’alto e utilizzarla per creare lo schema di input. È possibile copiare l'intera risposta JSON dalla risposta precedente e inserirla nell'oggetto jsonSchema
indicato di seguito.
Richiesta di creazione dello schema di input
code language-shell |
---|
|
Risposta
code language-json |
---|
|
L’ID nella risposta rappresenta l’identificatore univoco dello schema di input creato. Copia l’ID dalla risposta, poiché lo riutilizzerai in un passaggio successivo.
Creare uno schema di output
Successivamente, devi impostare lo schema di output per l’esportazione. Innanzitutto, devi trovare e verificare lo schema di partner esistente.
Richiesta
Nell'esempio seguente viene utilizzato connection spec ID
per Amazon S3. Sostituisci questo valore con l’ID della specifica di connessione specifico della tua destinazione.
code language-shell |
---|
|
Risposta con schema di esempio
Inspect la risposta ottenuta durante l’esecuzione della chiamata precedente. È necessario analizzare in profondità la risposta per trovare l'oggetto targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
Successivamente, devi creare uno schema di output. Copia la risposta JSON ottenuta e incollala nell'oggetto jsonSchema
di seguito.
Richiesta
code language-shell |
---|
|
Risposta
code language-json |
---|
|
L’ID nella risposta rappresenta l’identificatore univoco dello schema di input creato. Copia l’ID dalla risposta, poiché lo riutilizzerai in un passaggio successivo.
Crea set di mappatura create-mapping-set
Quindi, utilizza l'API di preparazione dati per creare il set di mappatura utilizzando l'ID dello schema di input, l'ID dello schema di output e le mappature di campi desiderate.
Richiesta
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
Risposta
code language-json |
---|
|
Prendi nota dell’ID del set di mappatura in base alle tue esigenze nel passaggio successivo per aggiornare il flusso di dati esistente con l’ID del set di mappatura.
Quindi, ottieni l’ID del flusso di dati da aggiornare.
Per informazioni sul recupero dell'ID di un flusso di dati, vedere recuperare i dettagli di un flusso di dati di destinazione.
Infine, devi PATCH
il flusso di dati con le informazioni sul set di mappatura appena creato.
Richiesta
code language-shell |
---|
|
Risposta
La risposta dall’API del servizio Flusso restituisce l’ID del flusso di dati aggiornato.
code language-json |
---|
|
Effettuare altri aggiornamenti del flusso di dati other-dataflow-updates
Per aggiornare il flusso di dati, utilizzare l'operazione PATCH
. Ad esempio, puoi aggiungere un’azione di marketing ai flussi di dati. In alternativa, puoi aggiornare i flussi di dati per selezionare i campi come chiavi obbligatorie o chiavi di deduplicazione.
Aggiungere un’azione di marketing add-marketing-action
Per aggiungere una azione di marketing, vedi gli esempi di richieste e risposte seguenti.
If-Match
è obbligatoria quando si effettua una richiesta PATCH
. Il valore di questa intestazione è la versione univoca del flusso di dati che desideri aggiornare. Il valore etag viene aggiornato a ogni aggiornamento riuscito di un’entità di flusso come flusso di dati, connessione di destinazione e altre.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, dove {ID}
è l'ID del flusso di dati che desideri aggiornare.If-Match
tra virgolette doppie, come negli esempi seguenti, quando si eseguono PATCH
richieste.Richiesta
code language-shell |
---|
|
Risposta
In caso di esito positivo, la risposta restituisce il codice di risposta 200
insieme all’ID del flusso di dati aggiornato e all’eTag aggiornato.
code language-json |
---|
|
Aggiungi una chiave obbligatoria add-mandatory-key
Per aggiungere una chiave obbligatoria, vedi gli esempi di richieste e risposte seguenti.
If-Match
è obbligatoria quando si effettua una richiesta PATCH
. Il valore di questa intestazione è la versione univoca del flusso di dati che desideri aggiornare. Il valore etag viene aggiornato a ogni aggiornamento riuscito di un’entità di flusso come flusso di dati, connessione di destinazione e altre.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, dove {ID}
è l'ID del flusso di dati che desideri aggiornare.If-Match
tra virgolette doppie, come negli esempi seguenti, quando si eseguono PATCH
richieste.Richiesta
code language-shell |
---|
|
code language-shell |
---|
|
Risposta
code language-json |
---|
|
Aggiungere una chiave di deduplicazione add-deduplication-key
Per aggiungere una chiave di deduplicazione, vedi gli esempi di richieste e risposte seguenti
If-Match
è obbligatoria quando si effettua una richiesta PATCH
. Il valore di questa intestazione è la versione univoca del flusso di dati che desideri aggiornare. Il valore etag viene aggiornato a ogni aggiornamento riuscito di un’entità di flusso come flusso di dati, connessione di destinazione e altre.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
, dove {ID}
è l'ID del flusso di dati che desideri aggiornare.If-Match
tra virgolette doppie, come negli esempi seguenti, quando si eseguono PATCH
richieste.Richiesta
code language-shell |
---|
|
code language-shell |
---|
|
Risposta
code language-json |
---|
|
Convalida del flusso di dati (ottiene l’esecuzione del flusso di dati) get-dataflow-runs
Per verificare le esecuzioni di un flusso di dati, utilizza l’API Esecuzioni flusso di dati:
Richiesta
code language-shell |
---|
|
Risposta
code language-json |
---|
|
Nella documentazione di riferimento API sono disponibili informazioni sui vari parametri restituiti dal flusso di dati esegue l'API.
Gestione degli errori API api-error-handling
Gli endpoint API in questa esercitazione seguono i principi generali dei messaggi di errore API di Experience Platform. Per ulteriori informazioni sull'interpretazione delle risposte di errore, consultare codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.
Passaggi successivi next-steps
Seguendo questa esercitazione, Platform è stato connesso correttamente a una delle destinazioni di archiviazione cloud preferite e hai impostato un flusso di dati per la rispettiva destinazione per esportare i tipi di pubblico. Per ulteriori dettagli, vedi le pagine seguenti, ad esempio come modificare i flussi di dati esistenti utilizzando l’API del servizio Flusso: