Skip to main content
EtusivuBlogiOppaatKuinka integroida lähetysten seurantatiedot BI-järjestelmiin rajat ylittävää verkkokauppaa varten

Kuinka integroida lähetysten seurantatiedot BI-järjestelmiin rajat ylittävää verkkokauppaa varten

17TRACK

Jotta rajat ylittävän verkkokaupan lähetysten seurantatiedot voidaan integroida BI-järjestelmiin, kerää seurantapäivitykset API:n tai tuetun tapahtumasyötteen kautta, tallenna alkuperäiset tietueet, normalisoi kuljetusyhtiöiden tapahtumat ja yhdistä jokainen lähetys tilaustietoihisi. Rakenna sitten tietovarastomallit, jotka laskevat toimitusten suorituskyvyn, poikkeamat ja tietojen ajantasaisuuden, ennen kuin tuot mallit koontinäyttöihin. Tärkein suunnitteluratkaisu on erottaa toisistaan se, mitä paketille tapahtui, ja se, milloin järjestelmäsi sai siitä tiedon.

Kuinka lähetysten seurantatiedot integroidaan BI-järjestelmiin

Tämä opas on tarkoitettu data-insinööreille, analytiikkatiimeille ja logistiikan operatiivisille johtajille, jotka rakentavat tällaista putkea. Teknisen tiimin tulisi vastata tietojen noutamisesta ja luotettavuudesta; operatiivisen tiimin tulisi määritellä lähetyksen virstanpylväät ja poikkeamasäännöt; analytiikkatiimin tulisi vastata mittarien määritelmistä. Ilman näitä yhteisiä määritelmiä teknisesti onnistunut integraatio voi silti tuottaa harhaanjohtavia raportteja.

Rakenna dataputki, älä koontinäytön ja API:n välistä yhteyttä

Hyödyllinen viitearkkitehtuuri on:

Seurantalähde → tietojen vastaanottopalvelu → kestävä raakatallennus → muunnos ja validointi → analytiikan tietovarasto → BI:n semanttinen malli → koontinäytöt ja hälytykset

Pidä tilausta, toimituksen käsittelyä ja asiakaspalvelua koskevat tiedot seurantaputken rinnalla ja käytä niiden välillä hallittuja liitoksia. Seurantatapahtumat selittävät paketin liikkumista. Ne eivät yksinään määritä asiakkaalle luvattua toimituspäivää, tilauksen arvoa, hyvityksen lopputulosta tai tukipalveluhistoriaa.

Koontinäytön yhdistäminen suoraan seuranta-API:in voi toimia pienessä prototyypissä, mutta se vaikeuttaa historiatietojen rekonstruointia, uudelleenyrityksiä ja yhteisten mittarimääritelmien hallintaa. Toistuvaa operatiivista raportointia varten tallenna tiedot ennen niiden esittämistä.

17TRACKin rooli

17TRACK Tracking API on käyttökelpoinen lähdevaihtoehto seurantatietojen integraatioon. Vahvista toteutuksesi integraatiosopimus käyttämällä sen virallista API-dokumentaatiota. Vahvista todennus, lähetysten rekisteröinti, saatavilla olevat tapahtumakentät, päivitysten toimitustavat, käyttörajoitukset ja virheenkäsittely ennen niiden varaan suunnittelua.

Käsittele seurantatietolähdettä ja BI-putkea erillisinä kerroksina. Älä oleta, että seurantatietojen käyttöoikeus sisältää natiivin yhdistimen tietovarastoon tai BI-työkaluun. Testaa todelliset kuljetusyhtiöt, toimituspalvelut, kohdemarkkinat ja käyttämäsi tilin asetukset.

1. Määrittele operatiiviset kysymykset ja raportoinnin rakeisuus

Aloita päätöksistä, joita koontinäytön on tuettava. Viivästyneitä paketteja tutkiva logistiikkapäällikkö tarvitsee lähetyskohtaiset poikkeamat. Toimituspalveluja vertaileva kaupallinen analyytikko tarvitsee toimituskohortit ja yhdenmukaiset nimittäjät. Nämä ovat toisiinsa liittyviä näkymiä, mutta niitä ei tulisi rakentaa määrittelemättömästä seurantatilojen kokoelmasta.

  • Toimitusten suorituskyky: Mitkä toimitusreitit eivät täytä asiakkaalle luvattua toimitusta?
  • Poikkeamien hallinta: Mitkä aktiiviset lähetykset tarvitsevat tutkimista?
  • Siirrot kuljetusyhtiöiden välillä: Missä näkyvyys katoaa kuljetusvaiheiden välillä?
  • Vaikutus asiakkaisiin: Mitkä toimitusmallit liittyvät yhteydenottoihin tai hyvityksiin?
  • Integraation tila: Mitkä lähteet toimittavat puutteellisia tai vanhentuneita tietoja?

Valitse ensisijainen raportoinnin rakeisuus: yleensä yksi fyysinen paketti tai lähetys, ei yksi tilaus. Tilaus voi sisältää useita paketteja, ja korvaava lähetys voi olla olemassa alkuperäisen rinnalla. Säilytä nämä suhteet sen sijaan, että pakottaisit jokaisen tilauksen yhteen seurantatunnukseen.

Määrittele tilauksen valmistuminen erikseen. Tilaus voidaan esimerkiksi laskea toimitetuksi vasta, kun kaikki vaaditut lähtevät paketit on toimitettu. Palautukset, peruutetut paketit ja korvaavat lähetykset on käsiteltävä nimenomaisesti, jotta ne eivät vääristä nimittäjää.

2. Luo lähetyksen identiteetti ennen tapahtumien tuontia

Älä käytä seurantatunnusta ainoana tietokanta-avaimena. Sen tulkinta voi riippua kuljetusyhtiöstä ja lähetyksen asiayhteydestä. Luo sisäinen lähetys-tunniste ja säilytä ulkoiset viitteet, joita tarvitaan tietueiden täsmäyttämiseen.

KenttäTarkoitusSuunnitteluhuomio
shipment_idVakaa sisäinen identiteettiPidä se riippumattomana ulkoisten viitteiden muutoksista.
order_id and fulfillment_idToimituksen yhdistäminen kaupankäyntitietoihinTue jaettuja tilauksia ja korvaavia lähetyksiä.
tracking_number and carrier_referenceSeurattavan liikkeen tunnistaminenSäilytä sekä raaka-arvot että standardoidut tunnisteet.
shipment_leg_idKuljetusvaiheen esittäminenKäytä tätä, kun kansainväliselle kuljetukselle ja viimeiselle etapille on erilliset viitteet.
source_systemTietueen alkuperän selittäminenErota tilausjärjestelmän arvot seurantatietolähteen arvoista.
promised_delivery_atSuorituskyvyn mittaaminen lupausta vastenSäilytä sovellettava lupaus ja sen muutoshistoria.

Rakenna siltataulu, kun yhdellä lähetyksellä on useita seurantaviitteitä tai etappeja. Näin analyytikot voivat seurata rajat ylittävää pakettia luovutuksesta toiseen laskematta sitä kahdeksi toimitetuksi lähetykseksi.

3. Vastaanota päivitykset uudelleentoisto ja täsmäytys huomioiden

Käytä lähteesi tukemaa päivitysmekanismia. Jos tapahtumien toimitus on käytettävissä, vastaanota päivitykset palvelun kautta, joka validoi pyynnöt ja kirjoittaa hyväksytyt hyötykuormat kestävään tallennukseen. Jos kysely on tarpeen, ajoita pyynnöt dokumentoitujen rajoitusten ja liiketoiminnan ajantasaisuusvaatimusten mukaan.

Tapahtumapohjaisessa tietojen vastaanotossa kuittaa onnistunut vastaanotto vasta, kun hyötykuorma on turvallisesti tallennettu tai sijoitettu kestävään jonoon. Pidä vastaanottopäätepiste kevyenä ja suorita raskaat muunnokset myöhemmin. Noudata lähteen dokumentoituja todennus- ja pyyntöjen varmennusmekanismeja sen sijaan, että olettaisit allekirjoitusmuodon.

Kyselyissä tallenna noutotarkistuspisteet ja käytä päällekkäisiä noutoikkunoita, jos API sallii sen. Päällekkäisyys voi auttaa havaitsemaan myöhästyneitä päivityksiä, mutta se edellyttää myös kaksoiskappaleiden poistamista. Älä oleta, että sivutuskursori on pysyvä historiatietojen tarkistuspiste, ellei dokumentaatiossa niin sanota.

  • Säilytä alkuperäinen hyötykuorma, vastaanottoaika, lähdetunniste ja tietojen vastaanottoajon tunniste.
  • Yritä tilapäisiä virheitä uudelleen hallitulla viiveellä ja noudata dokumentoituja nopeusrajoituksia.
  • Ohjaa toistuvasti epäonnistuvat tietueet tarkistusjonoon sen sijaan, että hylkäisit ne hiljaisesti.
  • Täsmäytä seurattavat lähetykset toimituksen käsittelyjärjestelmään puuttuvien rekisteröintien tunnistamiseksi.
  • Suorita säännöllisiä tarkistuksia aktiivisille lähetyksille, joiden seurantatietojen päivitys on lakannut.

Tee kirjoituksista idempotentteja: saman päivityksen käsittely uudelleen ei saa luoda ylimääräistä loogista tapahtumaa. Suosi dokumentoitua vakaata tapahtumatunnistetta. Jos sellaista ei ole, määrittele ja testaa yhdistelmäjälki käyttämällä lähetyksen identiteettiä, tapahtuma-aikaa, tapahtumakoodia, sijaintia ja muita olennaisia kenttiä. Säilytä raakatietueet, jotta törmäyksiä tai korjauksia voidaan tutkia.

4. Normalisoi tapahtumat menettämättä niiden merkitystä

Kuljetusyhtiöiden kuvauksista ei pidä tehdä suoraan koontinäytön luokkia. Luo dokumentoitu määrityskerros, joka muuntaa lähdetapahtumat pienemmäksi joukoksi liiketoiminnan virstanpylväitä ja säilyttää samalla alkuperäisen kuvauksen ja koodin.

Alustava luokittelu voi sisältää tiedot vastaanotettu, kuljetusyhtiön hyväksymä, kuljetuksessa, jakeluun lähtenyt, toimitettu, toimitusyritys, poikkeama ja palautusliike. Nämä ovat ehdotettuja sisäisiä luokkia, eivät väite siitä, että jokainen seurantatietolähde käyttäisi samoja tiloja.

Pidä virstanpylvään tila erillään poikkeamaominaisuuksista. Lähetys voi olla edelleen kuljetuksessa ja sisältää samalla tulliin liittyvän poikkeaman. Molempien käsitteiden pakottaminen yhteen kenttään vaikeuttaa fyysisen etenemisen ja operatiivisen riskin erottamista.

Käsittele rajat ylittävät epäselvyydet nimenomaisesti

  • Tullitapahtumat: Säilytä ilmoitettu tapahtuman merkitys. Älä tulkitse jokaista tulliviitettä viivästykseksi tai loppuun saatetuksi tulliselvitykseksi.
  • Siirrot kuljetusyhtiöiden välillä: Liitä toisiinsa liittyvät viitteet samaan lähetykseen, kun suhde on varmistettu. Uusi viite ei välttämättä tarkoita uutta pakettia.
  • Tuntemattomat tapahtumat: Pidä ne näkyvissä luokittelemattomina tietueina. Älä pakota tuntemattomia koodeja sopivaan luokkaan.
  • Korjaukset: Salli myöhempien tietojen muuttaa tulkittua tilaa poistamatta aiempaa näyttöä.

Versioi määrityssäännöt. Kun tulkinta muuttuu, sinun on voitava selittää, muuttuiko historiallinen kaavio toimitusten suorituskyvyn muutoksen vuoksi vai siksi, että muunnoslogiikka muuttui.

5. Mallinna tapahtuma-aika, vastaanottoaika ja paikalliset päivämäärät erikseen

Tallenna vähintään ilmoitettu tapahtuman aikaleima ja aikaleima, jolloin alustasi vastaanotti tietueen. Tietovarastoon lataamisen aikaleima on myös hyödyllinen sisäisten käsittelyviiveiden diagnosoinnissa. Nämä aikaleimat vastaavat eri kysymyksiin.

Käytä siirtymän huomioivaa vaihtomuotoa aina, kun se on saatavilla. RFC 3339 määrittelee aikaleimamuodon, joka sisältää UTC-ajan tai numeerisen siirtymän. Säilytä alkuperäinen arvo, normalisoi yksiselitteiset ajanhetket UTC:ksi kuluneen ajan laskelmia varten ja johda paikalliset raportointipäivät käyttämällä nimenomaista aikavyöhykesääntöä.

Jos lähde toimittaa paikallisen aikaleiman ilman siirtymää tai luotettavaa aikavyöhykettä, merkitse epävarmuus. Älä käsittele sitä hiljaisesti UTC-aikana. Maatason oletukset voivat olla riittämättömiä alueilla, joilla käytetään useita aikavyöhykkeitä.

Myöhään saapuvat tapahtumat vaativat myös huolellisuutta. Tänään vastaanotettu vanhempi tapahtuma ei saa automaattisesti korvata uudempaa lähetyksen tilaa. Johda nykyinen tila dokumentoitujen tapahtumamerkitysten, aikaleimojen ja korjaussääntöjen perusteella, älä yksinkertaisesti viimeksi lisätystä tietokantarivistä.

6. Rakenna tietovarastomallit selkeillä mittarisopimuksilla

Käytännöllinen malli erottaa tapahtumahistorian lähetysyhteenvedoista:

  • Tapahtumafakta: Yksi rivi loogista seurantatapahtumaa kohti, alkuperätiedot ja normalisoidut ominaisuudet mukaan lukien.
  • Lähetysfakta: Yksi rivi lähetystä kohti, johdetut virstanpylväät ja nykyinen tila mukaan lukien.
  • Suhdetaulut: Tilauksien, pakettien, kuljetusetappien ja ulkoisten viitteiden väliset yhteydet.
  • Dimensiot: Kuljetusyhtiö, palvelu, lähtöpaikka, määränpää, kanava ja muut hyväksytyt raportointiominaisuudet.

Vältä tilausten tulojen yhdistämistä suoraan jokaiseen seurantatapahtumaan ja niiden summamista sen jälkeen. Tämä toistaa tilauksen arvon tapahtumariveillä. Aggregoi oikealla rakeisuudella tai käytä semanttisessa mallissa nimenomaisesti hallittuja suhteita.

MittariSuositeltu määritelmäTulkinnan suojaus
Kuljetuksen kestoToimituksen aikaleima miinus ensimmäinen kelvollinen kuljetusyhtiön hyväksyntäaikaleimaRaportoi puuttuvat hyväksyntäskannaukset; älä korvaa niitä tarran luomisella ilman ilmoitusta.
Ajallaan toimitettujen osuusSovellettuun lupaukseen mennessä toimitettujen kelvollisten lähetysten määrä jaettuna lupauksen eräpäivän kohortin kelvollisten lähetysten määrälläMäärittele katkaisuaika, aikavyöhyke, poissulkemiset ja toimittamatta jääneiden myöhästyneiden pakettien käsittely.
Poikkeamien esiintyvyysKelvollisen poikkeaman sisältävien yksilöllisten lähetysten määrä jaettuna kelvollisen lähetyskohortin määrälläLaske lähetykset, älä toistuvia poikkeamaviestejä.
Seurannan passiivisuusRaportointiaika miinus viimeisimmän kelvollisen seurantatapahtuman aikaPassiivisuus on tutkittava signaali, ei todiste paketin katoamisesta.
Havaittu päivitysviiveVastaanottoaika miinus ilmoitettu tapahtuma-aikaErota lähteen viive aikaleiman epävarmuudesta ja tietovaraston viiveestä.

Käytä toimitettujen lähetysten kohortteja valmiiden kuljetusaikojen ymmärtämiseen, mutta älä käsittele niitä koko suorituskykykuvana. Vielä kuljetuksessa olevat hitaat lähetykset puuttuvat laskelmasta. Yhdistä valmiiden toimitusten tilastot avoimien lähetysten ikänäkymään ja lupauksen eräpäivän kohorttiin.

Kun vertaat toimitusreittejä, näytä otoskoko, palvelutaso, määränpää ja raportointijakso. Lähetysten koostumuksen erot voivat selittää näennäisen eron kuljetusyhtiöiden suorituskyvyssä. Koontinäytön tulisi auttaa tutkimaan eroa eikä esittää perusteetonta syy-seurauspäätelmää.

7. Validoi putki ennen operatiivisten koontinäyttöjen julkaisemista

Testaa tilanteita, älä vain onnistuneita API-vastauksia. Sisällytä normaali toimitus, jaettu tilaus, korvaava lähetys, siirto kuljetusyhtiöiden välillä, kaksoispäivitys, väärässä järjestyksessä saapuva tapahtuma, puuttuva aikavyöhyke, tulliin liittyvä tapahtuma, palautusliike ja myöhäinen korjaus.

Seuraa jokaisessa tilanteessa raakahyötykuormaa normalisoituihin tapahtumiin, lähetysyhteenvetoihin ja lopulliseen koontinäyttöön asti. Operatiivisen tiimin tulee vahvistaa, että näytetty tila ja suositeltu toimenpide vastaavat taustalla olevaa näyttöä.

  • Kattavuus: Vertaa kelvollisia toimitettuja lähetyksiä seurantaputkessa oleviin lähetyksiin.
  • Täydellisyys: Mittaa puuttuvat lähetyksen tunnisteet, tapahtuma-ajat, kuljetusyhtiöiden viitteet ja toimituslupaukset.
  • Yhdenmukaisuus: Merkitse mahdottomat tai epäilyttävät virstanpylväsjärjestykset tarkistettaviksi sen sijaan, että kirjoittaisit ne automaattisesti uudelleen.
  • Ajantasaisuus: Seuraa lähteen vastaanottoa, tietovaraston käsittelyä ja koontinäytön päivitystä erikseen.
  • Toistettavuus: Rakenna raportointijakso uudelleen säilytetyistä syötteistä ja vahvista odotettu tulos.

Näytä operatiivisissa koontinäytöissä tietojen ajantasaisuuden ilmaisin. Paketin poikkeama ja tietojen vastaanoton häiriö voivat näyttää samalta, kun molemmat näkyvät muodossa ”ei viimeaikaista päivitystä”. Käyttäjät tarvitsevat riittävästi asiayhteyttä erottaakseen ne toisistaan.

8. Ota käyttöön omistajuus, käyttöoikeudet ja hyödylliset hälytykset huomioiden

Testaa integraatio rajatulla joukolla toimitusreittejä, joka sisältää edustavaa rajat ylittävää monimutkaisuutta. Laajenna käyttöönottoa, kun lähetyksien täsmäytys, tilojen tulkinta ja mittarien täsmäytys täyttävät sovitut hyväksymiskriteerit. Pelkästään helpoista toimituksista koostuva pilotti ei testaa mallin vaikeita osia.

Rajoita analytiikan tietojen vastaanotto raportointitarkoitukseen tarvittaviin kenttiin. Rajoita pääsyä seurantaviitteisiin ja henkilötietoihin, pidä tunnistetiedot BI-raporttien ulkopuolella ja määrittele säilytys- ja poistamismenettelyt sovellettavien velvoitteiden mukaisesti.

Määritä jokaiselle hälytykselle omistaja. Vanhentunut tietojen vastaanottosyöte kuuluu tekniselle tiimille; luokittelematon tapahtuma kuuluu datatiimille ja logistiikan asiantuntijoille; erääntynyt paketti kuuluu asiaankuuluvaan operatiiviseen työnkulkuun. Aloita pienellä määrällä toiminnallisia hälytyksiä sen sijaan, että loisit ilmoituksen jokaisesta epätavallisesta skannauksesta.

Integraatio on valmis laajempaan käyttöön, kun liiketoimintakäyttäjä voi jäljittää koontinäytön tuloksen lähetykseen, normalisoituun tapahtumaan ja sen lähdetietueeseen sekä ymmärtää, mitkä oletukset vaikuttivat tulokseen.

UKK

Tarvitsenko reaaliaikaisia seurantatietoja BI-raportointiin?

En välttämättä. Historiallinen suorituskykyraportointi voi toimia ajoitetuilla päivityksillä, kun taas aktiivisten poikkeamien käsittely voi tarvita tuoreempia tietoja. Määrittele ensin vaadittu vasteaika ja huomioi sitten lähteen päivitysviiveet, tietojen vastaanoton viive, tietovaraston käsittely ja koontinäytön päivitys. Nopeampi koontinäytön päivitys ei voi luoda kuljetusyhtiön tapahtumia, joita ei ole ilmoitettu.

Voidaanko seurantatiedoilla mitata tulliselvityksen kestoa?

Vain silloin, kun lähde tarjoaa tapahtumia, jotka kuvaavat luotettavasti mitattavan tullivaiheen alkua ja loppua. Kahden skannauksen välinen aukko ei riitä todisteeksi tullikäsittelyn kestosta. Jos rajat ovat epäselvät, merkitse mittari havaituksi aikaväliksi vahvistetun tulliselvityksen keston sijaan.

Miten yhtä tilausta koskevia useita seurantatunnuksia pitäisi käsitellä?

Mallinna tilauksen ja lähetyksen välinen suhde erillään lähetyksen ja seurantaviitteiden välisistä suhteista. Useat paketit voivat kuulua yhteen tilaukseen, kun taas useat viitteet voivat kuvata yhden paketin matkan eri etappeja. Näiden suhteiden pitäminen erillään estää lähetysmäärien kaksoislaskennan ja virheellisen tilauksen valmistumisen raportoinnin.

Pitäisikö käyttää kyselyitä vai tapahtumapohjaisia päivityksiä?

Käytä lähteen tukemia mekanismeja ja valitse niiden välillä ajantasaisuus- ja luotettavuusvaatimusten perusteella. Tapahtumapohjainen toimitus voi vähentää toistuvia pyyntöjä, kun taas kysely voi tukea noutoa tai täsmäytystä silloin, kun se on mahdollista. Kumpikaan lähestymistapa ei poista kaksoiskappaleiden poiston, uudelleenyritysten, valvonnan ja puuttuneista päivityksistä palautumisen tarvetta.

Voivatko seurantatiedot selittää hyvitysten lisääntymisen?

Ne voivat tukea tutkimusta, kun ne yhdistetään hyvitys- ja tukitietueisiin asianmukaisten tunnisteiden ja aikajaksojen avulla. Ne eivät kuitenkaan yksinään voi osoittaa syy-yhteyttä. Tarkista hyvitysten syyt, tuoteongelmat, asiakassegmentit, toimituspalvelut ja muut olennaiset tekijät ennen lisääntymisen yhdistämistä toimitusten suorituskykyyn.

Lähteet