Satınalmadan sonrakı xidmət təminatçıları bir API ilə çoxmarkalı izləməni necə idarə edə bilər
Satınalmadan sonrakı xidmət təminatçıları ortaq göndəriş məlumatları qatını hər bir brendin müştəriyə yönəlmiş təcrübəsindən ayırmaqla, bir API vasitəsilə bir neçə e-ticarət brendi üçün izləməni idarə edə bilərlər. Praktik model çoxkirayəçili izləmə xidmətidir: bir inteqrasiya izləmə sorğularını və hadisələrini qəbul edir, kirayəçi qaydaları isə autentifikasiyanı, brendinqi, daşıyıcı davranışını, bildirişləri və hesabatları idarə edir. Bu yanaşma təkrarlanan inteqrasiyaları azaldır, lakin yalnız məlumat sahibliyi, göndəriş identifikasiyası, daşıyıcı məlumatlarının normallaşdırılması və əməliyyat nəzarətləri başlanğıcdan düzgün layihələndirildikdə yaxşı işləyir.
Məqsəd sadəcə bir neçə brendi bir endpoint-in arxasında yerləşdirmək deyil. Məqsəd xidmət təminatçısını hər bir brend üçün ayrıca daşıyıcı bağlantısı qurmağa və saxlamağa məcbur etmədən hər bir müştəriyə etibarlı satınalma sonrası izləmə iş axını təqdim etməkdir. Yaxşı layihələndirilmiş sistem ortaq infrastrukturu alıcılardan gizlətməli, eyni zamanda operatorlara istisnaları araşdırmaq və məlumat sərhədlərini qorumaq üçün kifayət qədər nəzarət imkanı verməlidir.
Çoxbrendli modeldə “bir API” nə deməlidir
Bu kontekstdə bir API adətən bir neçə müştəri brendi üçün təminatçı tərəfindən idarə olunan vahid inteqrasiya qatını nəzərdə tutur. Bu, mütləq hər bir müştərinin eyni cavabı, interfeysi və ya bildiriş səyahətini alması demək deyil. API ümumi müqavilə təqdim edə, arxasında isə kirayəçiyə xas qaydaları tətbiq edə bilər.
Tipik sorğuya kirayəçi identifikatoru, göndəriş və ya sifariş istinadı, mövcud olduqda daşıyıcı məlumatı, izləmə nömrəsi, lokal, eləcə də tələb olunan əməliyyat daxil ola bilər. Xidmət daha sonra çağıranı autentifikasiya edir, göndərişin hansı brendə məxsus olduğunu müəyyənləşdirir, izləmə məlumatlarını göndərir və ya əldə edir, nəticəni normallaşdırır və ardıcıl cavab qaytarır. Brendin vitrin səhifəsi, yardım mərkəzi, sifariş portalı və ya müştəri xidməti tətbiqi hər bir daşıyıcının ayrıca məlumat modelini anlamadan bu cavabdan istifadə edə bilər.
Bu model qarışdırılmamalı olan üç sərhəd yaradır:
- İnteqrasiya sərhədi: hər bir müştərinin təminatçıya necə qoşulması.
- Məlumat sərhədi: hər bir müştərinin hansı göndərişlərə, hadisələrə və müştəri istinadlarına çıxış əldə edə bilməsi.
- Təcrübə sərhədi: hər bir brendin izləməni, bildirişləri və dəstək seçimlərini alıcılara necə təqdim etməsi.
Bu sərhədlərin açıq şəkildə qorunması təminatçıya texniki işi mərkəzləşdirməyə, eyni zamanda brend səviyyəsində nəzarəti saxlamağa imkan verir.
Kirayəçi məlumat modelindən başlayın
Ən vacib layihələndirmə qərarı platformanın brendi və onun göndərişlərini necə müəyyənləşdirməsidir. Təkcə izləmə nömrəsi göndərişin tam biznes identikliyi kimi qəbul edilməməlidir. Eyni istinad müxtəlif sistemlərdə görünə bilər və müştəri tətbiqləri daşıyıcının izləmə nömrələri ilə yanaşı sifariş nömrələrindən, icra ID-lərindən və ya daxili iş ID-lərindən istifadə edə bilər.
Daha təhlükəsiz model hər bir brendə sabit kirayəçi ID-si verir və göndəriş qeydlərini açıq sahibliyə malik şəkildə saxlayır. Faydalı sahələrə kirayəçi ID-si, göndəriş ID-si, sifariş istinadı, izləmə nömrəsi, daşıyıcı kodu, uyğun olduqda təyinat regionu, cari status, hadisə tarixçəsi, yaradılma vaxtı, son sinxronizasiya vaxtı və mənbə sistemi daxil ola bilər. Dəqiq sxem dəyişə bilər, lakin sahibliyə yalnız müştəri interfeysinə güvənmək əvəzinə API və verilənlər bazası qatlarında nəzarət edilməlidir.
Brend konfiqurasiyası da göndəriş məlumatlarından ayrılmalıdır. Konfiqurasiya qeydi izləmə səhifəsinin domenini, loqonu, dəstəklənən dilləri, status ifadələrini, bildiriş seçimlərini, eskalasiya qaydalarını və müştəri xidməti bağlantılarını idarə edə bilər. Bu, hər yeni müştəri əlavə edildikdə operatorların brendə xas məntiqi tətbiq koduna köçürməsinin qarşısını alır.
Xidmət təminatçıları üçün bu ayrılmanın ikinci faydası var: daşıyıcı inteqrasiyası bir dəfə təkmilləşdirildikdən sonra uyğun kirayəçilər arasında istifadə edilə bilər. Lakin ortaq kod ortaq icazələr demək deyil. Daşıyıcı bağlantısı ümumi ola bilər, göndərişin görünməsi isə onu təqdim edən və ya ona sahib olan kirayəçi ilə məhdud qalmalıdır.
Brendlərə təqdim etməzdən əvvəl daşıyıcı məlumatlarını normallaşdırın
Hər bir daşıyıcı müxtəlif hadisə adlarından, status məntiqindən, vaxt nişanlarından və istisna təsvirlərindən istifadə etdikdə çoxbrendli izləmə çətinləşir. Bir daşıyıcı bağlamanın şəbəkə üzrə hərəkət etdiyini bildirə bilər, digəri isə daha konkret nəqliyyat və ya obyekt hadisəsindən istifadə edə bilər. Bu xam dəyərlərin birbaşa hər bir müştəriyə ötürülməsi ziddiyyətli müştəri təcrübələri yaradır və hesabat hazırlamağı çətinləşdirir.
Ortaq normallaşdırma qatı daşıyıcıya xas hadisələri idarə olunan daxili lüğətə uyğunlaşdırmalıdır. Ümumi kateqoriyalara məlumat alındı, tranzitdə, götürülməyə hazır, çatdırılmaya çıxarılıb, çatdırıldı, çatdırılma istisnası və qaytarma ilə bağlı hadisələr daxil ola bilər. Daxili model normallaşdırılmış statusla yanaşı ilkin daşıyıcı hadisəsini də saxlamalıdır. Bu, müştəri təcrübəsini sadə saxlamağa və dəstək komandalarının ehtiyac duyduğu diaqnostik detalları itirməməyə imkan verir.
Normallaşdırma qeyri-müəyyənliyi də nəzərə almalıdır. Platforma daşıyıcı tərəfindən təsdiqlənmiş çatdırılma hadisəsi, yeniləmələrin müvəqqəti olmaması və nəticə əsasında çıxarılan əməliyyat vəziyyəti arasında fərq qoymalıdır. Qeyri-müəyyən daşıyıcı mesajını qəti vədə çevirməkdən çəkinməlidir. Daşıyıcı təxmini çatdırılma tarixi təqdim edirsə, API bunu zəmanətli görüş kimi deyil, təxmin kimi göstərməlidir.
Tələb olunan daşıyıcı və API imkanları xidmət təminatçısının istifadə ssenarisi ilə uyğun gəldikdə, 17TRACK kimi təminatçı ortaq izləmə məlumatları qatı kimi qiymətləndirilə bilər. İstehsala hazırlıqdan əvvəl dəstəklənən əməliyyatları, sorğu formatlarını, autentifikasiyanı, məhdudiyyətləri və tətbiq tələblərini təsdiqləmək üçün onun rəsmi API materiallarından və tərtibatçı sənədlərindən istifadə edilməlidir.
API müqaviləsini əməliyyat istifadə ssenariləri ətrafında layihələndirin
Çoxbrendli API yalnız daşıyıcının təqdim etdiyi məlumatlar ətrafında deyil, müştəri sistemlərinin nə etməli olduğu əsasında layihələndirilməlidir. Müqavilə ən azı müştərinin izləmə sorğusu yaratması və ya qeydiyyata alması, cari göndəriş vəziyyətini əldə etməsi, hadisə tarixçəsini alması və seçilmiş xidmətə hadisə çatdırılması daxildirsə, vəziyyət dəyişdikdə yeniləmələri qəbul etməsi qaydalarını müəyyənləşdirməlidir.
Müqavilə aşağıdakıları sənədləşdirməlidir:
- Kirayəçilər və tətbiqlər necə autentifikasiya olunur.
- Hansı identifikatorlar tələb olunur, hansılar isə isteğe bağlıdır.
- Daşıyıcı kodları necə təqdim edilir, müəyyənləşdirilir və ya düzəldilir.
- Uğurlu cavab nə deməkdir və sonrakı emal üçün qəbul edilmiş sorğudan nə ilə fərqlənir.
- Naməlum, gecikmiş, təkrarlanan və ya ziddiyyətli hadisələr necə göstərilir.
- Səhifələmə, təkrar cəhdlər, sürət məhdudiyyətləri və xətalar necə idarə olunur.
- Webhook-lardan istifadə edilirsə, webhook imzaları, təkrar göndərişlərdən qorunma və hadisələrin sıralanması necə idarə olunur.
İdempotentlik xüsusilə vacibdir. Müştərilər şəbəkə vaxtı bitdikdən sonra sorğunu təkrar göndərə bilər və platforma eyni sorğunun iki dəfə təqdim edilməsinə görə təkrarlanan göndəriş qeydləri yaratmamalıdır. Hər bir kirayəçi praktik baxımdan ən məhdud əhatəyə malik etimadnamələr almalıdır. Brendin tətbiqi sorğudakı identifikatoru dəyişməklə başqa brendin göndəriş məlumatlarını sorğulaya bilməməlidir.
Ortaq məlumat qatını brend təcrübəsindən ayrı saxlayın
Bir API vahid izləmə səhifəsi tələb etmir. Xidmət təminatçısı eyni normallaşdırılmış məlumatlardan müxtəlif müştəri təcrübələrini dəstəkləmək üçün istifadə edə bilər: brendli sifariş statusu səhifəsi, daxil edilmiş vidcet, müştəri xidməti konsolu və ya müştərinin mövcud kommersiya platforması tərəfindən idarə olunan bildirişlər.
Təcrübə qatı nə qədər məlumat göstəriləcəyinə qərar verməlidir. Premium brend ətraflı zaman xətti və dəstək bağlantısı göstərə bilər, digər müştəri isə yığcam status kartına üstünlük verə bilər. Hər ikisi eyni əsas hadisə modelindən istifadə edə bilər. Dil, saat qurşağının təqdimatı, brend terminologiyası və əlaqə təlimatları da məhz burada yerləşməlidir.
E-ticarət təminatçıları üçün sifariş istinadı alıcı üçün çox vaxt izləmə nömrəsi qədər vacibdir. Buna görə API cavabı lazımsız şəxsi məlumatları açıqlamadan göndəriş statusunu düzgün sifarişlə əlaqələndirməyə imkan verməlidir. Müştəriyə yönəlmiş səhifələr yalnız zəruri minimum məlumatlardan istifadə etməli, əməliyyat panelləri isə agentlər, hesab menecerləri və administratorlar üçün rollara əsaslanan giriş tətbiq etməlidir.
Yalnız göndərişlər üçün deyil, platforma üçün monitorinq qurun
Ortaq izləmə xidmətinin iki monitorinq problemi var. O, çatdırılma istisnası və ya yeniləmə olmadan keçən qeyri-adi müddət kimi göndəriş səviyyəsindəki problemləri, eləcə də yüksək API xətaları, hadisələrin emalında gecikmə və ya natamam məlumat qaytaran daşıyıcı konnektoru kimi platforma səviyyəsindəki problemləri müəyyənləşdirməlidir.
Məlumat dəstəklədikdə metrikalar kirayəçi, daşıyıcı, region, endpoint və xəta növü üzrə bölünməlidir. Faydalı əməliyyat yoxlamalarına sorğuların uğur faizi, cavab gecikməsi, hadisələrin emal gecikməsi, təkrarlanan hadisələrin faizi, autentifikasiya xətaları və əl ilə nəzərdən keçirilməli qeydlərin sayı daxildir. Bölümləndirmə vacibdir, çünki ümumi platforma metrikası sağlam göründüyü halda bir brend və ya daşıyıcı ciddi problemlə üzləşə bilər.
İşə başlamazdan əvvəl eskalasiya yolu yaradın. Xəbərdarlığı kimin alacağını, hansı sübutların əlavə ediləcəyini, daşıyıcı probleminin müştəri məlumatı problemindən necə fərqləndiriləcəyini və müştəri xidməti komandasının nə vaxt məlumatlandırılacağını müəyyənləşdirin. Ortaq API əməliyyat parçalanmasını azaltmalı, problemləri vahid ümumi xəta mesajının arxasında gizlətməməlidir.
Hər bir brend üçün nəzarətli işə qəbul prosesi tətbiq edin
Yeni brendin əlavə edilməsi təkrarlana bilən tətbiq prosesi olmalıdır. Müştərinin sifariş, icra və müştəri xidməti sistemlərini xəritələndirməklə başlayın. Hansı göndəriş identifikatorlarının mövcud olduğunu, hansı daşıyıcılardan istifadə edildiyini, hansı regionların xüsusi emal tələb etdiyini və müştərinin təminatçının bildirişləri idarə etməsini, yalnız məlumat təqdim etməsini, yoxsa hər ikisini istədiyini təsdiqləyin.
- Kirayəçini müəyyənləşdirin: brend qeydini, etimadnamələri, rolları, mühitləri və məlumatların saxlanma gözləntilərini yaradın.
- İdentifikatorları xəritələndirin: sifarişlər, icra qeydləri, izləmə nömrələri və müştəriyə yönəlmiş istinadlar arasındakı əlaqəni sənədləşdirin.
- Daşıyıcı girişlərini sınaqdan keçirin: brendin əsas istiqamətləri və xidmət növləri üzrə real göndərişlərdən istifadə edin.
- Normallaşdırılmış statusları təsdiqləyin: API nəticələrini daşıyıcının mövcud izləmə məlumatları və müştərinin istədiyi terminologiya ilə müqayisə edin.
- Uğursuzluq hallarını sınaqdan keçirin: etibarsız nömrələri, gecikmiş skanları, təkrarlanan sorğuları, naməlum daşıyıcıları, qaytarmaları və qismən göndəriş ssenarilərini daxil edin.
- Məhdud buraxılış həyata keçirin: tam müştəri bazasını aktivləşdirməzdən əvvəl real trafiki nəzarət olunan qrup üzrə izləyin.
- Sahibliyi sənədləşdirin: status ifadələrini kimin təsdiqlədiyini, dəstək eskalasiyalarını kimin idarə etdiyini və platforma dəyişikliklərini kimin nəzərdən keçirdiyini qeyd edin.
Bu proses həmçinin təminatçıya mövcud bir API dizaynının kifayət edib-etmədiyini müəyyənləşdirmək üçün praktik üsul verir. Müştəri ortaq qatın etibarlı şəkildə dəstəkləyə bilmədiyi daşıyıcı, məlumat sahəsi, bildiriş kanalı və ya regional iş axını tələb edirsə, bu boşluq xüsusi keçici həll ilə gizlədilmək əvəzinə qeyd edilməli və sınaqdan keçirilməlidir.
Yayılmış uğursuzluq hallarından çəkinin
- Brend adlarından təhlükəsizlik nəzarəti kimi istifadə etmək: göstərmə konfiqurasiyası kirayəçi avtorizasiyasını əvəz etmir.
- Xam daşıyıcı statuslarını hər yerdə qaytarmaq: bu, çaşdırıcı müştəri dili və ziddiyyətli analitika yaradır.
- Bir izləmə nömrəsinin bir sifarişə bərabər olduğunu düşünmək: bölünmüş göndərişlər, əvəzləmələr və qaytarmalar bu əlaqəni dəyişə bilər.
- Saat qurşaqlarına məhəl qoymamaq: hadisə vaxtları ardıcıl şəkildə saxlanmalı və istifadəçilərin anlaya biləcəyi formada təqdim edilməlidir.
- Bildirişləri əsas məlumat modelinə daxil etmək: bildiriş seçimləri konfiqurasiya edilə bilən olmalıdır ki, müxtəlif brendlər fərqli kanallardan və ifadələrdən istifadə edə bilsin.
- Yalnız uğurlu çatdırılmaları sınaqdan keçirmək: dəstək xərcləri adətən istisnalar və yeniləmələrin itməsi zamanı yaranır.
- Yoxlamadan daşıyıcı əhatə dairəsi vəd etmək: cari daşıyıcı, region və əməliyyat tələblərini rəsmi sənədlərdə və ya texniki konsepsiya sübutunda təsdiqləyin.
Praktik qərar çərçivəsi
Bir API yanaşması bir neçə brendin əsasən oxşar göndəriş iş axınlarını paylaşdığı, ardıcıl daşıyıcı məlumatlarına ehtiyac duyduğu və inteqrasiyaların saxlanmasını xidmət təminatçısının üzərinə götürmək istədiyi hallarda uyğundur. Hər bir müştərinin əsaslı şəkildə fərqli məlumat müqavilələrinə, ciddi regional izolyasiyaya və ya daşıyıcıya xas əməliyyat proseslərinə ehtiyacı olduqda yanaşma daha az sadə olur. Bu tələblər ortaq platformanı avtomatik olaraq istisna etmir, lakin konfiqurasiya, sınaq və aydın müəyyən edilmiş xidmət sərhədlərinə ehtiyacı artırır.
API təminatçısı seçməzdən əvvəl real, lakin nəzarət olunan göndəriş nümunələrindən istifadə edərək konsepsiya sübutu həyata keçirin. Daşıyıcının müəyyənləşdirilməsini, hadisələrin normallaşdırılmasını, yeniləmə vaxtını, xəta cavablarını, autentifikasiyanı, kirayəçi izolyasiyasını və müştəri xidməti komandalarının ehtiyac duyduğu məlumatı əldə etmək imkanını sınaqdan keçirin. Təminatçının rəsmi çoxdaşıyıcılı izləmə təlimatını və API sənədlərini nəzərdən keçirin, sonra həll edilməmiş tələbləri birbaşa təsdiqləyin. Düzgün qərar marketinq səhifəsində adı çəkilən daşıyıcıların sayına deyil, təminatçının platformanın faktiki idarə edəcəyi brendləri, istiqamətləri, iş axınlarını və nəzarətləri dəstəkləyə bilib-bilməməsinə əsaslanır.
Düzgün qurulduqda bir izləmə API-si başqa bir təcrid olunmuş inteqrasiya deyil, təkrar istifadə edilə bilən əməliyyat qatı olur. O, satınalmadan sonrakı xidmət təminatçılarına göndəriş yeniləmələrini ardıcıl şəkildə toplamaq, brend səviyyəsində təcrübələri qorumaq və hər bir e-ticarət hesabı üçün eyni daşıyıcı işini təkrarlamadan müştəri işə qəbulunu genişləndirmək imkanı verir.
FAQ
Bir API məlumatlarını paylaşmadan bir neçə brendə xidmət göstərə bilərmi?
Bəli, əgər kirayəçi identikliyi və avtorizasiya bütün sistem boyunca tətbiq edilirsə. Hər bir sorğu icazə verilmiş kirayəçi ilə əlaqələndirilməli və məlumat qaytarılmazdan əvvəl göndəriş sorğuları həmin kirayəçi ilə yoxlanılmalıdır. Ayrı etimadnamələr, rollara əsaslanan giriş, audit jurnalları və izolyasiya sınaqları tətbiqin bir hissəsi olmalıdır.
Hər bir brend eyni izləmə səhifəsindən istifadə etməlidirmi?
Xeyr. Ortaq API normallaşdırılmış izləmə məlumatları təqdim edə bilər, hər bir brend isə öz səhifəsindən, vidcetindən, dilindən, terminologiyasından və dəstək bağlantılarından istifadə edə bilər. Təqdimatı məlumat qatından ayrı saxlamaq çoxbrendli əməliyyatları idarə etməyi asanlaşdırır.
İstehsaldan əvvəl nə sınaqdan keçirilməlidir?
Real daşıyıcı girişlərini, etibarsız izləmə nömrələrini, gecikmiş hadisələri, təkrarlanan sorğuları, bölünmüş göndərişləri, qaytarmaları, naməlum daşıyıcıları, uyğun olduqda webhook təkrar cəhdlərini və kirayəçi izolyasiyası nəzarətlərini sınaqdan keçirin. Həmçinin normallaşdırılmış statusların müştərinin görməsini istədiyi dilə uyğun olduğunu yoxlayın.
Bir API daşıyıcı fərqlərini idarə etmək ehtiyacını aradan qaldırırmı?
Xeyr. O, inteqrasiya işlərinin böyük hissəsini mərkəzləşdirir, lakin daşıyıcı fərqləri hələ də diqqətlə izlənməli və təqdim edilməlidir. Təminatçı faydalı xam hadisə detallarını saxlamalı, müştəri tətbiqlərinə isə sabit normallaşdırılmış model təqdim etməlidir.
Təminatçı izləmə API-sini necə qiymətləndirməlidir?
API-ni təminatçının faktiki brendləri, daşıyıcıları, regionları, hadisə tələbləri, autentifikasiya modeli, məhdudiyyətləri, xəta emalı, yeniləmə davranışı və dəstək prosesi əsasında qiymətləndirin. Nəzarətli konsepsiya sübutu ümumi funksiya təsvirinin bütün tələb olunan iş axınlarını əhatə etdiyini fərz etməkdən daha etibarlıdır.


