Kaip po pirkimo teikiamų paslaugų teikėjai naudoja sekimo duomenis, kad naudodami vieną API aptarnautų kelis prekių ženklus
Po pirkimo paslaugų teikėjai gali aptarnauti kelis prekių ženklus naudodami vieną sekimo API integraciją: centralizuotai rinkdami siuntų atnaujinimus, susiedami kiekvieną siuntą su tinkamu prekių ženklu ir užsakymu bei kiekvieno kliento kanaluose teikdami konkrečiam prekių ženklui pritaikytą patirtį. Bendra jungtis supaprastina sekimo duomenų rinkimą, tačiau nepanaikina poreikio kiekvienam prekių ženklui atskirai tvarkyti klientų duomenis, pranešimų taisykles, leidimus ir paslaugų darbo eigas.
Šis modelis naudingas agentūroms, klientų aptarnavimo platformoms, užsakymų vykdymo partneriams ir kitiems teikėjams, kurie kelių prekybininkų vardu tvarko pristatymo komunikaciją. Praktinis klausimas nėra vien tai, ar viena API gali grąžinti sekimo būseną. Svarbu, ar teikėjas gali paversti šią būseną patikimu, tinkamai prekės ženklui pritaikytu veiksmu, neparodydamas vieno kliento duomenų kitam.
Ką iš tikrųjų daro bendra API
Sekimo API suteikia paslaugų teikėjui programinį būdą pateikti arba rasti siuntų identifikatorius ir gauti sekimo informaciją. Užuot kūręs atskirą integraciją su vežėjais kiekvienam prekybininkui, teikėjas gali pasiekti sekimo duomenis savo programoje per bendrą aukštesnio lygio jungtį. Tada teikėjo programa nustato, kuriam prekių ženklui priklauso siunta ir ką daryti su šia informacija.
Šis skirtumas svarbus. Viena sekimo API nėra tas pats, kas viena bendra klientų paskyra, vienas sekimo puslapis ar vienas pranešimo šablonas. Aukštesnio lygio integracija sprendžia duomenų rinkimo klausimą. Paslaugų teikėjas ir toliau atsako už savo galutinio produkto dalis: prekybininkų įtraukimą, užsakymų susiejimą, klientams skirtą kalbą, prieigos kontrolę, palaikymo įrankius ir įrašus apie išsiųstus pranešimus.
Veiksmingą architektūrą sudaro trys sluoksniai. Pirmasis – duomenų gavimo sluoksnis, priimantis siuntos nuorodą ir gaunantis sekimo atnaujinimus. Antrasis – vidinis siuntos įrašas, susiejantis šiuos atnaujinimus su tinkamu prekybininku, užsakymu, vežėju ir gavėju. Trečiasis – pateikimo sluoksnis, naudojantis prekybininko taisykles sprendimui, ar atnaujinti užsakymo puslapį, įspėti palaikymo darbuotoją, ar išsiųsti klientui pranešimą. Atskirti šiuos sluoksnius lengviau, kai norima pridėti kitą prekių ženklą neperrašant sekimo jungties.
Vienos siuntos kelias nuo registracijos iki kliento veiksmo
Įsivaizduokime teikėją, tvarkantį dviejų nesusijusių internetinių parduotuvių pristatymo atnaujinimus. Abi parduotuvės siunčia teikėjui siuntų duomenis, tačiau kiekviename įraše turi būti nuomininko identifikatorius – nedviprasmiškas vidinis teikėjo raktas, nurodantis siuntą valdantį prekių ženklą. Teikėjui taip pat reikia pakankamai informacijos, kad siunta būtų susieta su užsakymu. Vien sekimo numeris gali būti nesaugus visuotinis raktas, nes siuntos gali būti perduodamos skirtingiems vežėjams, identifikatoriai gali būti pakartotinai naudojami arba pradiniai užsakymo duomenys gali būti taisomi.
- Užregistruokite siuntą. Gaukite prekių ženklo identifikatorių, užsakymo nuorodą, sekimo numerį ir kitus leidžiamus duomenis, reikalingus susiejimui. Prieš prašydami sekimo duomenų patikrinkite įvestį. Jei įmanoma, prisijungimo duomenis ir klientų kontaktinę informaciją saugokite atskirai nuo bendrųjų sekimo įvykių įrašų.
- Surinkite ir išsaugokite šaltinio atnaujinimą. Gaukite sekimo informaciją per aukštesnio lygio API, naudodami dokumentacijoje nurodytus metodus. Išsaugokite šaltinio būseną, įvykio aprašymą, laiko žymą ir vietą, jei jie pateikiami. Nepakeiskite pradinio įvykio vien supaprastinta etikete – palaikymo komandoms gali prireikti originalios formuluotės tiriant išimtį.
- Atsargiai normalizuokite. Susiekite šaltinio įvykius su nedideliu vidinių būsenų rinkiniu, pavyzdžiui, „gabenama“, „pristatinėjama“, „pristatyta“ arba „išimtis“. Kartu su šiuo susiejimu išsaugokite pradinį įvykį. Plati būsena naudinga automatizavimui, tačiau gali paslėpti klientui ar palaikymo darbuotojui svarbius skirtumus.
- Taikykite prekių ženklo taisykles. Vienas prekybininkas gali pageidauti el. laiško, kai siunta pristatinėjama, o kitas – tik užsakymo puslapio atnaujinimo. Tinkamumą nustatykite pagal prekių ženklo konfigūraciją, kliento komunikacijos nuostatas, įvykio naujumą ir jau išsiųstų pranešimų istoriją.
- Užregistruokite rezultatą. Išsaugokite, kuris įvykis sukėlė konkretų veiksmą, kuri prekių ženklo politika buvo pritaikyta ir ar pristatymas į galutinį kanalą buvo sėkmingas. Tai suteikia galimybę tirti pasikartojančius pranešimus ir klientų skundus.
Todėl ta pati aukštesnio lygio būsena skirtingiems prekių ženklams gali sukelti skirtingus veiksmus. Tai ir yra bendrų paslaugų modelio esmė: centralizuoti rinkimą ir operacinę priežiūrą, kartu išsaugant kiekvieno prekybininko santykį su klientais.
Sprendimai, lemiantys, ar sistema bus pritaikoma didesniam mastui
Aiškiai nurodykite nuomininko nuosavybę
Kiekviena siunta, įvykis, užsakymo susiejimas, pranešimo taisyklė ir klientams skirta nuoroda turi būti susieta su konkrečiu nuomininku. Patikrinkite nuomininko nuosavybę duomenims patekus į sistemą ir dar kartą, kai juos skaito programa arba palaikymo naudotojas. Prekybininko prekės ženklu pažymėtas puslapis neturėtų remtis vien sekimo numeriu spręsdamas, kurio kliento įrašą rodyti. Prieiga turi būti ribojama autentifikuotu prekybininku arba tinkamai apribota kliento nuoroda.
Akredituotus duomenis ir leidimus atskirkite pagal tikrąją aukštesnio lygio teikėjo siūlomą paskyros struktūrą ir sutartinius santykius su kiekvienu prekybininku. Viena techninė integracija automatiškai nesuteikia teisės kaupti visų prekybininkų duomenų ar suteikti visiems klientams vienodą matomumą. Dokumentuokite, kas gali registruoti siuntas, gauti įvykius, eksportuoti įrašus ir keisti pranešimų nustatymus.
Laikykite sekimo įvykius atnaujinimais, o ne garantuotomis komandomis
Sekimo informacija gali vėluoti, pasirodyti ne eilės tvarka arba būti pataisyta. Sistema, siunčianti naują pranešimą kaskart perskaičiusi įvykį, rizikuoja siųsti pasikartojančius ar klaidinančius el. laiškus. Kai šaltinis pateikia stabilų įvykio raktą, jį naudokite; kitu atveju nustatykite dokumentuotą dublikatų pašalinimo taisyklę, pagrįstą turimais siuntos ir įvykio laukais. Atskirai saugokite laiką, kada teikėjas pastebėjo atnaujinimą, ir šaltinio nurodytą įvykio laiką.
Nelaikykite savaime suprantamu dalyku, kad kiekviena siunta pereina tas pačias būsenas. Išimtis vėliau gali būti išspręsta, o vėliau gautas įvykis gali apibūdinti ankstesnį fizinį nuskaitymą. Prieš naudodami būseną pažadui ar eskalavimui sukelti, nuspręskite, kaip programa tvarkys pasenusią, prieštaringą ar trūkstamą informaciją. Klientui skirtame teiginyje, pavyzdžiui, apie pristatymą, parodykite pagrindžiantį įvykį, o ne sudarykite įspūdį, kad vidinė etiketė įrodo daugiau, nei teigia šaltinio įrašas.
Suplanuokite apklausas, atgalinius iškvietimus ir klaidas
Teikėjo atnaujinimų strategija turi atitikti faktinę aukštesnio lygio API dokumentaciją. Jei atgaliniai iškvietimai prieinami atitinkamai paskyrai ir įvykio tipui, programa vis tiek turi autentifikuoti gaunamas užklausas, tvarkyti pakartotinius bandymus ir saugiai apdoroti pasikartojančius pristatymus. Jei naudojamos apklausos, reikia grafiko, kuris atsižvelgtų į dokumentuotas ribas ir vengtų nereikalingų pakartotinių užklausų. Nė vienas būdas nepanaikina atkūrimo poreikio, kai atnaujinimas praleidžiamas arba galutinis pranešimas nepavyksta.
HTTP atsakymai taip pat turi būti tinkamai interpretuojami. Pavyzdžiui, priimta užklausa neturėtų būti laikoma įrodymu, kad siunta jau gavo naują sekimo įvykį. HTTP semantikos specifikacija apibrėžia atsakymo kodų reikšmes; konkretaus sekimo teikėjo dokumentacija turi paaiškinti, ką konkretus API atsakymas reiškia registruojant ar gaunant siuntos duomenis. Stebėseną kurkite tiek techninėms, tiek verslo klaidoms, pavyzdžiui, galiojančiam atsakymui, kurio nepavyksta susieti su užsakymu.
Ką patikrinti prieš pasirenkant sekimo API
Kelių prekių ženklų teikėjui geriausia integracija yra ta, kuri atitinka visą veiklos modelį, o ne tik grąžina pavyzdinį sekimo rezultatą. Paprašykite potencialių teikėjų parodyti, kaip jų dokumentuota API palaiko siuntas ir darbo eigas, kurias iš tikrųjų tvarkote. Trumpas koncepcijos patikrinimas turėtų apimti kelis prekybininkus, jų naudojamus vežėjus ir bent vieną neužbaigtą arba probleminį siuntos įrašą.
- Siuntos priėmimas: Kokie identifikatoriai ir vežėjo duomenys būtini? Kaip pranešama apie neteisingus arba pasikartojančius pateikimus? Ar programa gali susieti savo užsakymo arba nuomininko nuorodą su užklausa, ar šis susiejimas turi likti tik jos duomenų bazėje?
- Atnaujinimų pristatymas: Ar atitinkamam planui atnaujinimai gaunami, siunčiami, ar taikomi abu būdai? Kokie dokumentuoti užklausų limitai, pakartotinių bandymų lūkesčiai, autentifikavimo metodai ir klaidų atsakymai? Patikrinkite tai pagal naujausią dokumentaciją, o ne manykite, kad aukšto lygio aprašyta funkcija prieinama visose konfigūracijose.
- Įvykių kokybė: Kurie originalūs laukai grąžinami ir kaip reikėtų interpretuoti laiko žymas, vežėjų pavadinimus, vietas bei su pristatymu susijusius įvykius? Išbandykite realius siuntų pavyzdžius įtraukiamiems prekybininkams.
- Nuomininkų operacijos: Ar teikėjas savo sistemoje gali atskirti prieigą, naudojimo apskaitą ir palaikymo tyrimus pagal klientą? Jei reikia atskirti aukštesnio lygio paskyras, prieš įsipareigodami architektūrai patvirtinkite, ar tai palaikoma ir kaip.
- Duomenų tvarkymas: Kokią klientų ar siuntų informaciją būtina siųsti aukštesnio lygio teikėjui? Su už šiuos duomenis atsakingomis šalimis peržiūrėkite saugojimo, trynimo, saugumo ir sutartinius reikalavimus. API saugumo gairės, įskaitant OWASP API Security Project, suteikia naudingą pagrindą autorizacijos ir prieigos rizikai vertinti.
17TRACK’s Tracking API page ir developer documentation yra tinkami pradiniai šaltiniai teikėjui, vertinančiam bendrą sekimo integraciją. Dokumentaciją laikykite įgyvendinimo detalių autoritetu ir prieš kurdami kelių klientų paslaugą patvirtinkite reikalingus metodus, palaikomus siuntų scenarijus, prieigos sąlygas ir komercinius susitarimus. Vien viešas API puslapis neįrodo, kad palaikoma kiekviena pageidaujama prekybininko darbo eiga.
Kur teikėjas turėtų išlaikyti kontrolę
Sekimo duomenys gali padėti kurti patirtį po pirkimo, tačiau neturėtų nulemti visos šios patirties. Teikėjas turėtų valdyti siuntos susiejimą su prekybininku, klientų kontaktavimo taisykles ir kalbą, vartojamą, kai atnaujinimas neaiškus. Jei įvykis nurodo tik tai, kad siunta pasiekė objektą, firminis pranešimas neturėtų žadėti pristatymo datos. Jei sekimo informacija nustoja atsinaujinti, sistema turėtų atskirti naujos informacijos trūkumą nuo įrodymo, kad siunta prarasta.
Palaikymo darbo eigoms reikia skirti tiek pat dėmesio. Įgaliotiems darbuotojams pateikite originalų sekimo įvykį, normalizuotą būseną, kiekvieno įrašo laiką ir pranešimų istoriją. Toks vaizdas padeda darbuotojui paaiškinti, kodėl klientas pamatė konkretų pranešimą, ir nuspręsti, ar problemą reikia tirti toliau. Be to, taip kelių prekių ženklų veiklą lengviau audituoti: problemą galima susieti su aukštesnio lygio atnaujinimu, susiejimo klaida, prekybininko taisykle ar pranešimo klaida, o ne miglotai kaltinti API.
Pradėkite nuo riboto bandomojo projekto. Prijunkite vieną ar du prekybininkus, užregistruokite tipines siuntas ir išbandykite įprastus pristatymo įvykius kartu su išimtimis, trūkstamais vežėjo duomenimis, pasikartojančiais atnaujinimais ir pataisytais užsakymais. Įsitikinkite, kad kiekvienas prekių ženklas mato tik savo siuntas ir kad nepavykusį pranešimą galima išsiųsti pakartotinai nesukuriant antro pranešimo klientui. Daugiau prekybininkų pridėkite tik tada, kai toks elgesys tampa nuspėjamas. Viena API gali sumažinti integracijos darbą, tačiau patikimą paslaugą keliems prekių ženklams užtikrina aplink ją sukurta kontrolė.
DUK
Ar viena sekimo API reiškia, kad visi prekių ženklai naudoja tą patį sekimo puslapį?
Ne. API gali teikti sekimo informaciją teikėjo programai, o kiekvienas prekių ženklas gali išlaikyti savo puslapio dizainą, domeno sprendimus, klientams skirtą kalbą ir pranešimų taisykles. Šios firminės patirtys turi būti įgyvendinamos ir prižiūrimos atskirai.
Ar sekimo numeris pats savaime gali nustatyti tinkamą prekių ženklą?
Jis neturėtų būti vienintelis nuomininko identifikatorius. Siuntai patekus į sistemą išsaugokite aiškų prekių ženklo arba nuomininko raktą, tada susiekite sekimo numerį su to prekių ženklo užsakymo įrašu. Prieš rodydami siuntos informaciją ar siųsdami pranešimą dar kartą patikrinkite šį susiejimą.
Ar teikėjas turėtų siųsti pranešimą apie kiekvieną naują sekimo įvykį?
Paprastai ne. Kai kurie įvykiai kartojasi, vėluoja arba klientui yra per daug techniniai. Apibrėžkite, kurie įvykių tipai yra tinkami, slopinkite dublikatus, patikrinkite komunikacijos nuostatas ir išsaugokite pradinį atnaujinimą, kad palaikymo komanda galėtų jį peržiūrėti.
Ką reikėtų išbandyti prieš pridedant kitą prekybininką?
Išbandykite faktines prekybininko siuntų įvestis, vežėjų derinį, užsakymų susiejimą, prieigos leidimus, pranešimų taisykles ir išimčių tvarkymą. Įtraukite atvejį, kai sekimo duomenų trūksta arba jie vėluoja, ir patikrinkite, kad jokia siuntos ar kliento informacija nepatektų į kito prekybininko paskyrą.


