Fonti dei dati e API

Come collegare una fonte dati alla tua API

Ultimo aggiornamento

Con una fonte dati API collegata, Sendtric chiama la tua API per recuperare i dati di un iscritto quando la sua email viene aperta. Non viene copiato nulla su Sendtric, quindi le immagini mostrano esattamente ciò che la tua API restituisce in quel momento, come lo stato in tempo reale di un ordine o il saldo del conto di oggi.

Se preferisci inviare i dati a Sendtric in anticipo, dai un'occhiata a come inviare i record tramite l'API di Sendtric.

Cosa serve alla tua API

  • Un URL HTTPS raggiungibile dalla rete Internet pubblica.
  • Un modo per richiedere un record in base al suo identificatore, presente nel percorso o in un parametro di query. Ad esempio https://api.example.com/customers/12345.
  • A risposta JSON con i campi del record, come ad esempio {"first_name": "Sarah", "points": 1250}.
  • Una risposta veloce: Sendtric aspetta fino a 5 secondi e la risposta deve essere inferiore a 1 MB.

Configuralo

  1. Nella barra laterale a sinistra, clicca su Origini dati, poi Nuova fonte di dati.
  2. Sotto API, seleziona API e clicca su Continua.
  3. Scegli Recupera i dati da un'API e clicca su Continua.
  4. Compila Nome della fonte dati, Campo identificativo univoco (ad esempio customer_id) e, se vuoi, Descrizione.
  5. Scegli il Metodo: GET o POST.
  6. Inserisci l'URL della tua API e metti {{uid}} l'identificatore al posto del "", ad esempio https://api.example.com/customers/{{uid}}. Sendtric sostituisce {{uid}} con l’identificatore di ciascun iscritto.
  7. Aggiungi eventuali intestazioni di cui la tua API ha bisogno, come Authorization con il tuo token API. Clicca su + Aggiungi per ciascuna di esse.
  8. Aggiungi qualsiasi parametri di query. Se la tua API accetta l'identificatore come parametro, inseriscilo {{uid}} il suo valore al posto dell'URL, ad esempio id = {{uid}}.
  9. Inserisci un identificatore valido nel Verifica valore identificatore univoco e clicca su Prova API.
  10. Controlla la risposta, poi clicca su Salva origine dati.
Le impostazioni "Recupera dati da un'API" con un URL contenente {{uid}}, un'intestazione di autorizzazione, un valore di prova e una risposta di prova positiva

Salva fonte dati rimane disabilitata finché il test non va a buon fine e la risposta contiene almeno un campo. Se modifichi l'URL, il metodo, le intestazioni o i parametri, riprova il test.

Usa un endpoint di prova o un token API dedicato e di sola lettura. Sendtric mantiene segreti i valori dell'intestazione dopo il salvataggio, quindi dovrai inserirne uno nuovo per modificarlo.

Come funzionano le ricerche

  • Ogni ricerca invia una richiesta alla tua API per un singolo abbonato.
  • Gli identificatori vengono inviati esattamente come vengono inseriti dal tag di unione, quindi le maiuscole e le minuscole contano se la tua API ne tiene conto.
  • Sendtric conserva un'immagine generata per il tempo di cache che hai impostato nell'editor di immagini (da 2 a 60 minuti), così le aperture ripetute non richiamano la tua API ogni volta.
  • Se la tua API è lenta, restituisce un errore o non trova alcun record per l'identificatore, il valore viene considerato vuoto. In un'immagine personalizzata, quel livello viene nascosto, quindi progetta l'immagine in modo che risulti comunque corretta anche senza di esso.

Modifica la connessione

In Fonti dati, clicca sull'origine dati per aprirne le impostazioni. Puoi modificare l'URL, il metodo, le intestazioni e i parametri, quindi eseguire Test API di nuovo prima di salvare.

Prossimo passo

Questo articolo ti è stato utile?

Fai clic sull'immagine per ingrandirla. Trascina o scorri per spostarti.