Skip to main content
CasaBlogGuideCome i fornitori di servizi post-acquisto utilizzano i dati di tracciamento per servire più brand con un’unica API

Come i fornitori di servizi post-acquisto utilizzano i dati di tracciamento per servire più brand con un’unica API

17TRACK

I fornitori di servizi post-acquisto possono servire più brand attraverso un’unica integrazione con l’API di tracciamento, raccogliendo centralmente gli aggiornamenti sulle spedizioni, associando ogni spedizione al brand e all’ordine corretti e offrendo un’esperienza specifica per il brand attraverso i canali di ciascun cliente. La connessione condivisa semplifica la raccolta dei dati di tracciamento; non elimina la necessità di disporre di dati dei clienti, regole di messaggistica, autorizzazioni e flussi di lavoro di assistenza separati per ogni brand.

Come i fornitori di servizi post-acquisto utilizzano i dati di tracciamento per fornire assistenza

Questo modello è utile per agenzie, piattaforme di assistenza clienti, partner logistici e altri fornitori che gestiscono le comunicazioni sulle consegne per conto di diversi merchant. La questione pratica non è semplicemente se una singola API possa restituire uno stato di tracciamento. È se il fornitore possa trasformare quello stato in un’azione affidabile e adeguatamente brandizzata, senza mostrare i dati di un cliente a un altro.

Cosa fa realmente l’API condivisa

Un’API di tracciamento offre al fornitore di servizi un modo programmatico per inviare o cercare identificativi delle spedizioni e ricevere informazioni di tracciamento. Invece di creare un’integrazione separata rivolta ai corrieri per ogni merchant, il fornitore può rendere disponibili i dati di tracciamento alla propria applicazione attraverso una connessione upstream comune. L’applicazione del fornitore decide quindi quale brand possiede la spedizione e cosa fare con le informazioni.

Questa distinzione è importante. Un’unica API di tracciamento non equivale a un unico account cliente condiviso, a un’unica pagina di tracciamento o a un unico modello di notifica. L’integrazione upstream gestisce la raccolta dei dati. Il fornitore di servizi resta responsabile del proprio prodotto downstream: onboarding dei merchant, associazione degli ordini, linguaggio rivolto ai clienti, controlli degli accessi, strumenti di assistenza e registri di ciò che è stato comunicato.

Un’architettura funzionale prevede tre livelli. Il primo è un livello di acquisizione che accetta un riferimento della spedizione e ottiene gli aggiornamenti di tracciamento. Il secondo è un record interno della spedizione che collega tali aggiornamenti al merchant, all’ordine, al corriere e al destinatario corretti. Il terzo è un livello di presentazione che utilizza le regole del merchant per decidere se aggiornare una pagina dell’ordine, avvisare un operatore dell’assistenza o inviare un messaggio al cliente. Mantenere separati questi livelli facilita l’aggiunta di un altro brand senza riscrivere la connessione di tracciamento.

Segui una spedizione dalla registrazione all’azione del cliente

Consideriamo un fornitore che gestisce gli aggiornamenti sulle consegne per due negozi online non correlati. Entrambi i negozi inviano i dettagli delle spedizioni al fornitore, ma ogni record deve includere un identificativo del tenant: la chiave interna univoca del fornitore per il brand che ne è proprietario. Il fornitore ha inoltre bisogno di informazioni sufficienti per associare la spedizione a un ordine. Il solo numero di tracciamento potrebbe non essere una chiave globale sicura, perché le spedizioni possono coinvolgere corrieri diversi, identificativi riutilizzati o correzioni ai dati dell’ordine originale.

  1. Registra la spedizione. Ricevi l’identificativo del brand, il riferimento dell’ordine, il numero di tracciamento e gli altri dettagli consentiti necessari per l’associazione. Convalida l’input prima di richiedere i dati di tracciamento. Quando possibile, conserva le credenziali e le informazioni di contatto dei clienti separatamente dai record generali degli eventi di tracciamento.
  2. Raccogli e conserva l’aggiornamento originale. Recupera le informazioni di tracciamento tramite l’API upstream utilizzando i metodi documentati. Conserva lo stato di origine, la descrizione dell’evento, il timestamp e la posizione quando forniti. Evita di sostituire l’evento originale con una sola etichetta semplificata; i team di assistenza potrebbero aver bisogno della formulazione sottostante per analizzare un’eccezione.
  3. Normalizza con attenzione. Mappa gli eventi di origine in un insieme ridotto di stati interni, come in transito, in consegna, consegnato o eccezione. Conserva l’evento originale insieme alla mappatura. Uno stato generale è utile per l’automazione, ma può nascondere distinzioni importanti per il cliente o per l’operatore dell’assistenza.
  4. Applica le regole del brand. Un merchant potrebbe volere un’email quando la spedizione è in consegna; un altro potrebbe desiderare solo un aggiornamento della pagina dell’ordine. Decidi l’idoneità in base alla configurazione del brand, alle preferenze di comunicazione del cliente, all’aggiornamento dell’evento e alla cronologia dei messaggi già inviati.
  5. Registra il risultato. Salva quale evento ha attivato quale azione, quale politica del brand è stata applicata e se la consegna al canale downstream è riuscita. Questo fornisce una traccia per risolvere i problemi relativi a notifiche duplicate e reclami dei clienti.

Lo stesso stato upstream può quindi produrre azioni diverse per brand diversi. Questo è il punto del modello di servizio condiviso: centralizzare la raccolta e la manutenzione operativa preservando al contempo la relazione di ciascun merchant con i propri clienti.

Le decisioni di progettazione che determinano la scalabilità

Rendi esplicita la titolarità del tenant

Ogni spedizione, evento, associazione d’ordine, regola di notifica e link rivolto al cliente dovrebbe ricondurre a uno specifico tenant. Verifica la titolarità del tenant quando i dati entrano nel sistema e nuovamente quando un’applicazione o un utente dell’assistenza li legge. Una pagina brandizzata del merchant non dovrebbe basarsi soltanto su un numero di tracciamento per determinare quale record cliente mostrare. L’accesso dovrebbe essere limitato dal merchant autenticato o da un link cliente adeguatamente circoscritto.

Separa credenziali e autorizzazioni in base all’effettivo modello di account offerto dal fornitore upstream e al rapporto contrattuale con ciascun merchant. Una singola integrazione tecnica non concede automaticamente il permesso di aggregare tutti i dati dei merchant o di offrire a ogni cliente la stessa visibilità. Documenta chi può registrare spedizioni, recuperare eventi, esportare record e modificare le impostazioni delle notifiche.

Considera gli eventi di tracciamento come aggiornamenti, non come comandi garantiti

Le informazioni di tracciamento possono arrivare in ritardo, apparire fuori ordine o contenere una correzione. Un sistema che invia un nuovo messaggio ogni volta che legge un evento rischia di generare email duplicate o fuorvianti. Utilizza una chiave evento stabile quando la fonte ne fornisce una; in caso contrario, definisci una regola documentata di deduplicazione usando i campi disponibili della spedizione e dell’evento. Conserva separatamente il momento in cui il fornitore ha osservato un aggiornamento e l’ora dell’evento comunicata dalla fonte.

Non presumere che ogni spedizione segua la stessa sequenza di stati. Un’eccezione potrebbe essere risolta in seguito e un evento con un orario di arrivo successivo potrebbe descrivere una scansione fisica precedente. Prima di utilizzare uno stato per attivare una promessa o un’escalation, stabilisci come l’applicazione gestisce informazioni obsolete, in conflitto o mancanti. Per un’affermazione rivolta al cliente, come la consegna, mostra l’evento di supporto invece di lasciare intendere che un’etichetta interna dimostri più di quanto affermi il record della fonte.

Pianifica polling, callback e guasti

La strategia di aggiornamento del fornitore deve seguire la documentazione effettiva dell’API upstream. Se sono disponibili callback per l’account e il tipo di evento pertinenti, l’applicazione deve comunque autenticare le richieste in arrivo, gestire i tentativi e trattare in sicurezza le consegne duplicate. Se utilizza il polling, deve prevedere una pianificazione che rispetti i limiti documentati ed eviti richieste ripetute non necessarie. Nessuno dei due approcci elimina la necessità di recuperare un aggiornamento mancante o una notifica downstream non riuscita.

Anche le risposte HTTP devono essere interpretate correttamente. Una richiesta accettata, per esempio, non dovrebbe essere considerata una prova che una spedizione abbia già ricevuto un nuovo evento di tracciamento. La specifica HTTP Semantics definisce il significato dei codici di risposta; la documentazione del fornitore di tracciamento deve stabilire cosa significhi una particolare risposta API per la registrazione o il recupero di una spedizione. Crea il monitoraggio sia per i guasti tecnici sia per quelli aziendali, come una risposta valida che non può essere associata a un ordine.

Cosa verificare prima di scegliere un’API di tracciamento

Per un fornitore multi-brand, la migliore integrazione è quella che si adatta all’intero modello operativo, non semplicemente quella che restituisce un risultato di tracciamento di esempio. Chiedi ai potenziali fornitori di mostrare come la loro API documentata supporti le spedizioni e i flussi di lavoro che gestisci effettivamente. Una breve proof of concept dovrebbe includere più merchant, i corrieri utilizzati da tali merchant e almeno un record di spedizione incompleto o problematico.

  • Acquisizione della spedizione: quali identificativi e dettagli del corriere sono obbligatori? Come vengono segnalati gli invii non validi o duplicati? L’applicazione può associare a una richiesta il proprio riferimento dell’ordine o del tenant oppure tale associazione deve rimanere interamente nel suo database?
  • Distribuzione degli aggiornamenti: per il piano pertinente gli aggiornamenti vengono recuperati, inviati o entrambe le cose? Quali sono i limiti documentati delle richieste, le aspettative sui tentativi, i metodi di autenticazione e le risposte di errore? Verificali nella documentazione corrente invece di presumere che una funzionalità descritta ad alto livello sia disponibile in ogni configurazione.
  • Qualità degli eventi: quali campi originali vengono restituiti e come devono essere interpretati timestamp, nomi dei corrieri, località ed eventi relativi alla consegna? Esegui test con esempi reali di spedizioni dei merchant in fase di onboarding.
  • Operazioni sui tenant: il fornitore può separare nel proprio sistema accessi, contabilizzazione dell’utilizzo e analisi delle richieste di assistenza per cliente? Se ha bisogno di separare gli account upstream, conferma se e come ciò sia supportato prima di impegnarti nell’architettura.
  • Gestione dei dati: quali informazioni del cliente o della spedizione devono essere inviate upstream? Esamina i requisiti di conservazione, cancellazione, sicurezza e contratto con le parti responsabili di tali dati. Le indicazioni sulla sicurezza delle API, incluso OWASP API Security Project, forniscono una base utile per esaminare i rischi relativi all’autorizzazione e agli accessi.

La pagina Tracking API di 17TRACK e la documentazione per sviluppatori sono punti di partenza pertinenti per un fornitore che valuti un’integrazione di tracciamento condivisa. Considera la documentazione come autorità per i dettagli di implementazione e conferma i metodi richiesti, gli scenari di spedizione supportati, i termini di accesso e gli accordi commerciali per l’uso previsto prima di costruirvi un servizio multi-cliente. Una pagina API pubblica, da sola, non dimostra che ogni flusso di lavoro desiderato dal merchant sia supportato.

Dove il fornitore dovrebbe mantenere il controllo

I dati di tracciamento possono contribuire a un’esperienza post-acquisto, ma non dovrebbero dettarne l’intera struttura. Il fornitore dovrebbe gestire l’associazione tra spedizione e merchant, le regole per contattare il cliente e il linguaggio utilizzato quando un aggiornamento è incerto. Se un evento indica soltanto che un pacco ha raggiunto una struttura, il messaggio brandizzato non dovrebbe promettere una data di consegna. Se il tracciamento smette di aggiornarsi, il sistema dovrebbe distinguere l’assenza di nuove informazioni dalla prova che il pacco sia perso.

I flussi di assistenza meritano la stessa attenzione. Fornisci agli operatori autorizzati l’evento di tracciamento originale, lo stato normalizzato, l’orario in cui ciascun elemento è stato registrato e la cronologia delle notifiche. Questa visualizzazione aiuta l’operatore a spiegare perché un cliente abbia visto un determinato messaggio e a decidere se un problema richieda ulteriori verifiche. Inoltre rende più semplice controllare un’operazione multi-brand: un problema può essere ricondotto a un aggiornamento upstream, a un errore di associazione, a una regola del merchant o a un errore di messaggistica, invece di essere attribuito genericamente all’API.

Inizia con un progetto pilota ristretto. Collega uno o due merchant, registra spedizioni rappresentative e testa gli eventi ordinari di consegna insieme a eccezioni, dettagli mancanti del corriere, aggiornamenti duplicati e ordini corretti. Conferma che ogni brand veda soltanto le proprie spedizioni e che una notifica non riuscita possa essere ritentata senza creare un secondo messaggio al cliente. Aggiungi altri merchant solo dopo che questi comportamenti saranno prevedibili. Un’unica API può ridurre il lavoro di integrazione, ma un servizio affidabile tra più brand nasce dai controlli costruiti intorno ad essa.

FAQ

Un’unica API di tracciamento significa che ogni brand utilizza la stessa pagina di tracciamento?

No. L’API può fornire informazioni di tracciamento all’applicazione del fornitore, mentre ogni brand mantiene il proprio design della pagina, le proprie configurazioni di dominio, il linguaggio rivolto ai clienti e le regole di notifica. Queste esperienze brandizzate devono essere implementate e gestite separatamente.

Un numero di tracciamento può identificare da solo il brand corretto?

Non dovrebbe essere l’unico identificativo del tenant. Salva una chiave esplicita del brand o del tenant quando la spedizione entra nel sistema, quindi associa il numero di tracciamento al record dell’ordine di quel brand. Verifica nuovamente l’associazione prima di mostrare le informazioni sulla spedizione o inviare un messaggio.

Un fornitore dovrebbe inviare una notifica per ogni nuovo evento di tracciamento?

Di solito no. Alcuni eventi sono ripetitivi, ritardati o troppo tecnici per essere utili al cliente. Definisci quali tipi di evento sono idonei, elimina i duplicati, verifica le preferenze di comunicazione e conserva l’aggiornamento originale per la revisione da parte dell’assistenza.

Cosa dovrebbe essere testato prima di aggiungere un altro merchant?

Testa gli input effettivi delle spedizioni del merchant, il mix di corrieri, l’associazione degli ordini, le autorizzazioni di accesso, le regole di notifica e la gestione delle eccezioni. Includi un caso in cui i dati di tracciamento siano mancanti o in ritardo e verifica che nessuna informazione relativa a spedizioni o clienti possa passare all’account di un altro merchant.

Fonti