Skip to main content
ПочетакБлогVodičiKako pružaoci usluga nakon kupovine koriste podatke za praćenje kako bi opsluživali više brendova pomoću jednog API-ja

Kako pružaoci usluga nakon kupovine koriste podatke za praćenje kako bi opsluživali više brendova pomoću jednog API-ja

17TRACK

Posleprodajni pružaoci usluga mogu opsluživati više brendova putem jedne integracije API-ja za praćenje tako što centralno prikupljaju ažuriranja o pošiljkama, povezuju svaku pošiljku sa odgovarajućim brendom i porudžbinom i pružaju iskustvo specifično za brend kroz sopstvene kanale svakog klijenta. Zajednička veza pojednostavljuje prikupljanje podataka o praćenju; ona ne uklanja potrebu za zasebnim podacima o korisnicima, pravilima za slanje poruka, dozvolama i servisnim tokovima rada za svaki brend.

Kako posleprodajni pružaoci usluga koriste podatke o praćenju za pružanje usluge

Ovaj model je koristan za agencije, platforme korisničke podrške, partnere za ispunjavanje porudžbina i druge pružaoce koji upravljaju komunikacijom o isporuci u ime više trgovaca. Praktično pitanje nije samo da li jedan API može da vrati status praćenja. Pitanje je da li pružalac može taj status da pretvori u pouzdanu, odgovarajuće brendiranu radnju, a da podatke jednog klijenta ne prikaže drugom.

Šta zajednički API zapravo radi

API za praćenje pružaocu usluge daje programski način da pošalje identifikatore pošiljke ili da ih potraži i primi informacije o praćenju. Umesto izgradnje zasebne integracije usmerene ka prevozniku za svakog trgovca, pružalac može da učini podatke o praćenju dostupnim svojoj aplikaciji putem zajedničke uzvodne veze. Aplikacija pružaoca zatim odlučuje koji brend je vlasnik pošiljke i šta treba uraditi sa tim informacijama.

Ova razlika je važna. Jedan API za praćenje nije isto što i jedan zajednički korisnički nalog, jedna stranica za praćenje ili jedan šablon obaveštenja. Uzvodna integracija rešava prikupljanje podataka. Pružalac usluge i dalje je odgovoran za svoj proizvod na nizvodnoj strani: uvođenje trgovaca, povezivanje porudžbina, jezik namenjen korisnicima, kontrole pristupa, alate za podršku i evidenciju onoga što je saopšteno.

Funkcionalna arhitektura ima tri sloja. Prvo, sloj za unos prihvata referencu pošiljke i preuzima ažuriranja o praćenju. Drugo, interni zapis pošiljke povezuje ta ažuriranja sa odgovarajućim trgovcem, porudžbinom, prevoznikom i primaocem. Treće, prezentacioni sloj koristi pravila trgovca da odluči da li treba ažurirati stranicu porudžbine, obavestiti agenta podrške ili poslati poruku korisniku. Razdvajanje ovih slojeva olakšava dodavanje drugog brenda bez prepravke veze za praćenje.

Pratite jednu pošiljku od registracije do radnje korisnika

Zamislite pružaoca koji upravlja ažuriranjima isporuke za dve nepovezane onlajn prodavnice. Obe prodavnice šalju detalje o pošiljkama pružaocu, ali svaki zapis mora da sadrži identifikator zakupca: nedvosmisleni interni ključ pružaoca za brend koji je njegov vlasnik. Pružaocu je takođe potrebno dovoljno informacija da poveže pošiljku sa porudžbinom. Sam broj za praćenje možda nije bezbedan globalni ključ, jer pošiljke mogu uključivati različite prevoznike, ponovo korišćene identifikatore ili ispravke prvobitnih podataka o porudžbini.

  1. Registrujte pošiljku. Primite identifikator brenda, referencu porudžbine, broj za praćenje i sve druge dozvoljene podatke potrebne za povezivanje. Proverite unos pre zahteva za podatke o praćenju. Gde je praktično, čuvajte akreditive i kontaktne podatke korisnika odvojeno od opštih zapisa događaja praćenja.
  2. Prikupite i sačuvajte izvorno ažuriranje. Preuzmite informacije o praćenju putem uzvodnog API-ja koristeći njegove dokumentovane metode. Sačuvajte izvorni status, opis događaja, vremensku oznaku i lokaciju kada su dostupni. Nemojte izvorni događaj zameniti samo pojednostavljenom oznakom; timovima za podršku može biti potreban originalni tekst radi ispitivanja izuzetka.
  3. Pažljivo normalizujte. Preslikajte izvorne događaje u mali interni skup stanja, kao što su u tranzitu, spremno za isporuku, isporučeno ili izuzetak. Zadržite izvorni događaj zajedno sa tim preslikavanjem. Široko stanje je korisno za automatizaciju, ali može sakriti razlike važne korisniku ili agentu podrške.
  4. Primeni­te pravila brenda. Jedan trgovac možda želi imejl kada je pošiljka spremna za isporuku; drugi možda želi samo ažuriranje stranice porudžbine. Utvrdite podobnost na osnovu konfiguracije brenda, komunikacionih podešavanja korisnika, ažurnosti događaja i istorije već poslatih poruka.
  5. Zabeležite ishod. Sačuvajte koji događaj je pokrenuo koju radnju, koja politika brenda je primenjena i da li je isporuka na nizvodni kanal uspela. To obezbeđuje trag za rešavanje problema sa duplim obaveštenjima i pritužbama korisnika.

Isti uzvodni status stoga može proizvesti različite radnje za različite brendove. To je svrha modela zajedničke usluge: centralizovati prikupljanje i operativno održavanje, uz očuvanje odnosa svakog trgovca sa njegovim korisnicima.

Odluke o dizajnu koje određuju da li se sistem može proširivati

Jasno definišite vlasništvo zakupca

Svaka pošiljka, događaj, veza sa porudžbinom, pravilo za obaveštenja i veza namenjena korisniku treba da vodi do konkretnog zakupca. Proverite vlasništvo zakupca kada podaci uđu u sistem i ponovo kada ih aplikacija ili korisnik podrške čita. Stranica brendirana za trgovca ne bi trebalo da se oslanja samo na broj za praćenje pri određivanju koji zapis korisnika treba prikazati. Pristup treba ograničiti autentifikovanim trgovcem ili odgovarajuće ograničenom korisničkom vezom.

Odvojite akreditive i dozvole u skladu sa stvarnim modelom naloga koji nudi uzvodni pružalac i ugovornim odnosom sa svakim trgovcem. Jedna tehnička integracija ne daje automatski dozvolu za objedinjavanje svih podataka trgovaca niti svakom klijentu daje istu vidljivost. Dokumentujte ko sme da registruje pošiljke, preuzima događaje, izvozi zapise i menja podešavanja obaveštenja.

Tretirajte događaje praćenja kao ažuriranja, a ne kao garantovane naredbe

Informacije o praćenju mogu stići sa zakašnjenjem, pojaviti se van redosleda ili sadržati ispravku. Sistem koji šalje novu poruku svaki put kada pročita događaj rizikuje slanje duplih ili obmanjujućih imejlova. Koristite stabilan ključ događaja kada ga izvor obezbeđuje; u suprotnom definišite dokumentovano pravilo za uklanjanje duplikata koristeći dostupna polja pošiljke i događaja. Vreme kada je pružalac uočio ažuriranje čuvajte odvojeno od vremena događaja koje je prijavio izvor.

Nemojte pretpostavljati da svaka pošiljka prati isti sled stanja. Izuzetak može naknadno biti rešen, a događaj sa kasnijim vremenom prijema može opisivati ranije fizičko skeniranje. Pre nego što status upotrebite za pokretanje obećanja ili eskalacije, odlučite kako aplikacija postupa sa zastarelim, protivrečnim ili nedostajućim informacijama. Za tvrdnju namenjenu korisniku, kao što je isporuka, prikažite potkrepljujući događaj umesto da sugerišete da interna oznaka dokazuje više nego što izvorni zapis navodi.

Planirajte anketiranje, povratne pozive i greške

Strategija ažuriranja pružaoca mora da prati stvarnu dokumentaciju uzvodnog API-ja. Ako su povratni pozivi dostupni za odgovarajući nalog i tip događaja, aplikacija i dalje mora da autentifikuje dolazne zahteve, obrađuje ponovne pokušaje i bezbedno obrađuje duple isporuke. Ako koristi anketiranje, potrebno je definisati raspored koji poštuje dokumentovana ograničenja i izbegava nepotrebne ponovljene zahteve. Nijedan pristup ne uklanja potrebu za oporavkom kada ažuriranje izostane ili nizvodno obaveštenje ne uspe.

HTTP odgovore takođe treba pravilno tumačiti. Prihvaćen zahtev, na primer, ne treba tretirati kao dokaz da je pošiljka već dobila novi događaj praćenja. Specifikacija HTTP Semantics definiše značenja kodova odgovora; sopstvena dokumentacija pružaoca praćenja mora utvrditi šta konkretan odgovor API-ja znači za registraciju ili preuzimanje pošiljke. Uspostavite nadzor i nad tehničkim i nad poslovnim greškama, kao što je važeći odgovor koji se ne može povezati sa porudžbinom.

Šta treba proveriti pre izbora API-ja za praćenje

Za pružaoca koji radi sa više brendova, najbolja integracija je ona koja odgovara celom operativnom modelu, a ne nužno ona koja vraća primer rezultata praćenja. Zamolite potencijalne pružaoce da pokažu kako njihov dokumentovani API podržava pošiljke i tokove rada kojima se zaista bavite. Kratak dokaz koncepta treba da obuhvati više trgovaca, prevoznike koje ti trgovci koriste i najmanje jedan nepotpun ili problematičan zapis pošiljke.

  • Prijem pošiljke: Koji identifikatori i detalji o prevozniku su obavezni? Kako se prijavljuju nevažeće ili duplirane prijave? Može li aplikacija da poveže sopstvenu porudžbinu ili referencu zakupca sa zahtevom ili ta veza mora u potpunosti ostati u njenoj bazi?
  • Isporuka ažuriranja: Da li se ažuriranja preuzimaju, šalju ili oba načina važe za odgovarajući plan? Koja su dokumentovana ograničenja zahteva, očekivanja u vezi sa ponovnim pokušajima, metode autentifikacije i odgovori na greške? Proverite ih u aktuelnoj dokumentaciji umesto da pretpostavite da je funkcija opisana na visokom nivou dostupna u svakoj konfiguraciji.
  • Kvalitet događaja: Koja izvorna polja se vraćaju i kako treba tumačiti vremenske oznake, nazive prevoznika, lokacije i događaje povezane sa isporukom? Testirajte sa stvarnim primerima pošiljki trgovaca koji se uvode.
  • Operacije zakupaca: Može li pružalac u sopstvenom sistemu da odvoji pristup, obračun korišćenja i istrage podrške po klijentu? Ako mu je potrebno odvajanje uzvodnih naloga, potvrdite da li je i na koji način to podržano pre nego što se obavežete na arhitekturu.
  • Rukovanje podacima: Koje podatke o korisniku ili pošiljci treba poslati uzvodno? Sa odgovornim stranama pregledajte zahteve u vezi sa čuvanjem, brisanjem, bezbednošću i ugovorima. Smernice za bezbednost API-ja, uključujući OWASP API Security Project, pružaju korisnu osnovu za ispitivanje rizika autorizacije i pristupa.

17TRACK stranica API-ja za praćenje i dokumentacija za programere predstavljaju relevantne početne tačke za pružaoca koji procenjuje zajedničku integraciju za praćenje. Dokumentaciju tretirajte kao autoritet za detalje implementacije i potvrdite potrebne metode, podržane scenarije pošiljki, uslove pristupa i komercijalne aranžmane za predviđenu upotrebu pre izgradnje usluge za više klijenata. Sama javna stranica API-ja ne potvrđuje da je svaki željeni tok rada trgovca podržan.

Gde pružalac treba da zadrži kontrolu

Podaci o praćenju mogu pomoći u oblikovanju posleprodajnog iskustva, ali ne treba da određuju čitavo iskustvo. Pružalac treba da upravlja povezivanjem pošiljke sa trgovcem, pravilima za kontaktiranje korisnika i jezikom koji se koristi kada je ažuriranje neizvesno. Ako događaj samo kaže da je paket stigao u objekat, brendirana poruka ne treba da obećava datum isporuke. Ako praćenje prestane da se ažurira, sistem treba da razlikuje nedostatak novih informacija od dokaza da je paket izgubljen.

Tokovi rada podrške zaslužuju jednaku pažnju. Ovlašćenim agentima prikažite originalni događaj praćenja, normalizovani status, vreme kada je svaki podatak zabeležen i istoriju obaveštenja. Takav prikaz pomaže agentu da objasni zašto je korisnik video određenu poruku i odluči da li problem zahteva dalju istragu. Takođe olakšava reviziju operacija sa više brendova: problem se može povezati sa uzvodnim ažuriranjem, greškom pri povezivanju, pravilom trgovca ili greškom u slanju poruke, umesto da se neodređeno pripiše API-ju.

Počnite sa ograničenim pilot-projektom. Povežite jednog ili dva trgovca, registrujte reprezentativne pošiljke i testirajte uobičajene događaje isporuke zajedno sa izuzecima, nedostajućim podacima o prevozniku, duplim ažuriranjima i ispravljenim porudžbinama. Potvrdite da svaki brend vidi samo svoje pošiljke i da neuspešno obaveštenje može ponovo da se pošalje bez stvaranja druge poruke korisniku. Dodajte još trgovaca tek kada takvo ponašanje postane predvidljivo. Jedan API može smanjiti obim integracionog rada, ali pouzdana usluga za više brendova proizlazi iz kontrola izgrađenih oko njega.

ČPP

Da li jedan API za praćenje znači da svaki brend koristi istu stranicu za praćenje?

Ne. API može da prosledi informacije o praćenju aplikaciji pružaoca, dok svaki brend zadržava sopstveni dizajn stranice, podešavanja domena, jezik namenjen korisnicima i pravila za obaveštenja. Ta brendirana iskustva moraju se zasebno implementirati i održavati.

Može li broj za praćenje sam da identifikuje pravi brend?

Ne bi trebalo da bude jedini identifikator zakupca. Sačuvajte eksplicitni ključ brenda ili zakupca kada pošiljka uđe u sistem, a zatim povežite broj za praćenje sa zapisom porudžbine tog brenda. Ponovo proverite tu vezu pre prikazivanja informacija o pošiljci ili slanja poruke.

Da li pružalac treba da šalje obaveštenje za svaki novi događaj praćenja?

Uglavnom ne. Neki događaji se ponavljaju, kasne ili su previše tehnički da bi bili korisni korisniku. Definišite tipove događaja koji ispunjavaju uslove, potisnite duplikate, proverite komunikacione postavke i sačuvajte originalno ažuriranje radi pregleda u podršci.

Šta treba testirati pre dodavanja drugog trgovca?

Testirajte stvarne unose pošiljki trgovca, kombinaciju prevoznika, povezivanje porudžbina, dozvole pristupa, pravila za obaveštenja i postupanje u slučaju izuzetaka. Uključite slučaj u kojem podaci o praćenju nedostaju ili kasne i proverite da nijedna pošiljka niti podaci o korisnicima ne mogu preći u nalog drugog trgovca.

Izvori