Utilizzare le integrazioni standard external-sources

Passa alla sezione Configurazioni nel menu a sinistra e fai clic su Gestisci dalla scheda Integrazioni.

Quindi, fai clic su Crea integrazione per avviare una nuova configurazione.

{modal="regular"}

Facoltativamente, incolla un comando cURL per compilare automaticamente l’URL, il metodo HTTP, le intestazioni e i parametri di query.

Fornisci Nome e Descrizione per l’integrazione.

Immetti l’endpoint API URL.

Per le variabili di percorso, racchiudi un’etichetta tra parentesi graffe nell’URL, ad esempio https://api.example.com/v1/products/{{productId}}, quindi imposta ogni segnaposto in Parametro percorso.

Seleziona Abilita esplorazione per collegare un’integrazione di esplorazione attiva, in modo che i relativi campi di risposta possano essere mappati su variabili nelle intestazioni, nei parametri di query e percorso e nel payload.

➡️ Consulta Creare integrazioni Esplorazione

{modal="regular"}

Configura il Parametro percorso con Nome e Valore predefinito per ogni segnaposto aggiunto nell’URL.

Name è un’etichetta rivolta agli addetti al marketing solo nell’editor e non viene inviata nella richiesta API.

{modal="regular"}

Selezionare il metodo HTTP tra GET e POST.

Fai clic su Aggiungi intestazione e/o Aggiungi parametri di query in base alle esigenze per la tua integrazione. Per ogni parametro, fornisci i seguenti dettagli:

• Parametro: il nome effettivo del parametro di intestazione o query previsto dall’API.

• Nome: etichetta intuitiva per questo parametro. Gli autori lo selezionano durante la mappatura dei valori nelle campagne.

• Tipo: scegliere Costante per un valore fisso o Variabile per l’input dinamico.

• Valore: immettere il valore direttamente per le costanti oppure selezionare una mappatura variabile.

• Obbligatorio: specificare se questo parametro è obbligatorio. Per i parametri Variable obbligatori, se non viene risolto alcun valore in fase di esecuzione e non viene fornito alcun valore predefinito, la generazione della richiesta non riesce e viene generato un errore e la chiamata API in uscita non viene effettuata.

{modal="regular"}

Scegli un tipo di autenticazione:

• Nessuna autenticazione: per le API aperte che non richiedono credenziali.

• Chiave API: autentica le richieste utilizzando una chiave API statica. Immetti il nome chiave API ​, valore chiave API ​ e specifica la posizione.

• Autenticazione di base: utilizza l’autenticazione di base HTTP standard. Immettere Nome utente e Password.

• OAuth 2.0: esegui l’autenticazione utilizzando il protocollo OAuth 2.0. Fai clic sull’icona per configurare o aggiornare il payload.

{modal="regular"}

Imposta la configurazione dei criteri, ad esempio il periodo di timeout per le richieste API e scegli di abilitare la limitazione, la cache e/o un nuovo tentativo.

Per un metodo POST, configura il payload scegliendo un tipo di corpo:

• JSON: fai clic sull’icona e incolla il payload della richiesta JSON. Mappa le variabili da soddisfare nel payload.

• GraphQL: incolla la query GraphQL. Journey Optimizer genera automaticamente un nome operazione e consente di mappare le variabili di query corrispondenti.

  {modal="regular"}

Scegli il tipo di risposta tra JSON e HTML.

Con il campo Payload di risposta, puoi decidere quali campi dell’output di esempio devono essere utilizzati per la personalizzazione dei messaggi.

Fai clic sull’icona e incolla un payload di risposta JSON di esempio per rilevare automaticamente i tipi di dati.

Scegli i campi da esporre per la personalizzazione e specifica i tipi di dati corrispondenti.

{modal="regular"}

Una volta definiti l’URL, il metodo HTTP, le intestazioni e i parametri di query, fare clic su Invia connessione di prova per eseguire un test di connettività e confermare la configurazione.

Nella finestra di dialogo Invia connessione di prova, immetti i valori predefiniti per qualsiasi segnaposto Variabile nel percorso URL, nelle intestazioni e nei parametri di query.

Tali valori sono inclusi nella richiesta di test. Journey Optimizer richiama l’endpoint e segnala se la connessione è riuscita o meno.

{modal="regular"}

Se il test restituisce una risposta corretta, selezionare Utilizza come payload di risposta per copiare il corpo della risposta nel campo Payload di risposta. Vedere il passaggio 10 in Configurare l’integrazione, dove è possibile rilevare i tipi di dati e selezionare i campi per la personalizzazione.

{modal="regular"}

Se il test non riesce, espandi il menu a discesa Errore per esaminare i dettagli dell’errore, aggiornare la configurazione dell’integrazione in base alle esigenze ed eseguire di nuovo Invia connessione di test.

{modal="regular"}

Una volta convalidata, fai clic su Attiva.

Accedi all’integrazione appena creata per:

• Aggiornamento: modificare solo i dettagli di Autenticazione e la configurazione dei criteri. Gli aggiornamenti sono applicabili a percorsi e campagne live. Prima di salvare le modifiche, usa il menu Esplora riferimenti per confermare dove viene utilizzata l’integrazione.

• Archivio: archiviare una configurazione di integrazione.

  {modal="regular"}

Dopo l’attivazione, fare clic sull’icona del per accedere al menu Esplora riferimenti e per esaminare l’utilizzo di questa configurazione, inclusi i percorsi e le campagne che dipendono da essa.

{modal="regular"}