Skip to main content
Басты бетБлогНұсқаулықтарСатып алғаннан кейінгі қызмет провайдерлері бір API арқылы көп брендті бақылауды қалай басқара алады

Сатып алғаннан кейінгі қызмет провайдерлері бір API арқылы көп брендті бақылауды қалай басқара алады

17TRACK

Сатып алғаннан кейінгі қызмет провайдерлері ортақ жөнелту деректері қабатын әр брендтің клиенттерге арналған тәжірибесінен бөлу арқылы бірнеше ecommerce брендінің жөнелтілімдерін бір API арқылы бақылай алады. Практикалық модель — көптенантты бақылау қызметі: бір интеграция бақылау сұраулары мен оқиғаларын қабылдайды, ал тенант ережелері аутентификацияны, брендингті, тасымалдаушының әрекетін, хабарландыруларды және есептілікті басқарады. Бұл тәсіл қайталанатын интеграцияларды азайтады, бірақ ол деректердің иеленілуі, жөнелтілім идентификациясы, тасымалдаушыларды біріздендіру және операциялық бақылау құралдары ең басынан дұрыс жобаланғанда ғана тиімді жұмыс істейді.

Сатып алғаннан кейінгі қызмет провайдерлері бірнеше брендтің бақылауын қалай басқара алады

Мақсат — бірнеше брендті бір endpoint артына жай ғана орналастыру емес. Мақсат — қызмет провайдерін әр бренд үшін бөлек тасымалдаушы байланысын құруға және сүйемелдеуге мәжбүр етпей, әр клиентке сенімді сатып алғаннан кейінгі бақылау үдерісін ұсыну. Жақсы жобаланған жүйе ортақ инфрақұрылымды сатып алушыларға көрінбейтін етуі керек, сонымен бірге операторларға ерекшеліктерді зерттеуге және деректер шекараларын қорғауға жеткілікті бақылау беруі тиіс.

Көпбрендті модельде «бір API» нені білдіруі керек

Бұл контексте бір API әдетте бірнеше клиент брендіне арналған провайдер басқаратын бірыңғай интеграция қабатын білдіреді. Бұл әр клиент бірдей жауапты, интерфейсті немесе хабарландырулар жолын алады дегенді білдірмейді. API ортақ келісімшартты ұсына отырып, оның артында тенантқа тән ережелерді қолдана алады.

Әдеттегі сұрауда тенант идентификаторы, жөнелтілім немесе тапсырыс сілтемесі, қолжетімді болған жағдайда тасымалдаушы туралы ақпарат, бақылау нөмірі, тілдік аймақ және сұралған операция болуы мүмкін. Содан кейін қызмет қоңырау шалушыны аутентификациялайды, жөнелтілімнің қай брендке тиесілі екенін анықтайды, бақылау деректерін жібереді немесе алады, нәтижені біріздендіреді және тұрақты форматтағы жауап қайтарады. Брендтің интернет-дүкені, анықтама орталығы, тапсырыс порталы немесе клиенттерге қызмет көрсету қолданбасы әр тасымалдаушының жеке деректер моделін түсінбей-ақ осы жауапты пайдалана алады.

Бұл модельді бір-бірімен шатастырмау керек үш шекараны қалыптастырады:

  • Интеграция шекарасы: әр клиенттің провайдерге қалай қосылатыны.
  • Деректер шекарасы: әр клиент қандай жөнелтілімдерге, оқиғаларға және клиент сілтемелеріне қол жеткізе алатыны.
  • Тәжірибе шекарасы: әр бренд сатып алушыларына бақылауды, хабарландыруларды және қолдау мүмкіндіктерін қалай ұсынатыны.

Осы шекараларды нақты сақтау провайдерге техникалық жұмысты орталықтандыруға және сонымен қатар бренд деңгейіндегі бақылауды сақтауға мүмкіндік береді.

Тенанттарды ескеретін деректер моделінен бастаңыз

Ең маңызды жобалық шешім — платформа бренд пен оның жөнелтілімдерін қалай анықтайтыны. Бақылау нөмірін ғана жөнелтілімнің толық бизнес идентификаторы ретінде қарастыруға болмайды. Бір сілтеме әртүрлі жүйелерде кездесуі мүмкін, ал клиент қолданбалары тасымалдаушының бақылау нөмірлерімен бірге тапсырыс нөмірлерін, fulfillment ID немесе ішкі іс идентификаторларын пайдалануы мүмкін.

Қауіпсізірек модель әр брендке тұрақты tenant ID тағайындап, жөнелтілім жазбаларын нақты иелік ету ақпаратымен сақтайды. Пайдалы өрістерге tenant ID, shipment ID, тапсырыс сілтемесі, бақылау нөмірі, тасымалдаушы коды, қажет болған жағдайда жеткізу аймағы, ағымдағы күй, оқиғалар тарихы, жасалған уақыт, соңғы синхрондау уақыты және бастапқы жүйе кіруі мүмкін. Нақты схема әртүрлі болады, бірақ иелік ету тек клиент интерфейсіне сүйенбей, API және дерекқор деңгейлерінде қамтамасыз етілуі керек.

Бренд конфигурациясын да жөнелтілім деректерінен бөлек сақтау керек. Конфигурация жазбасы бақылау бетінің доменін, логотипті, қолдау көрсетілетін тілдерді, күй атауларын, хабарландыру параметрлерін, эскалация ережелерін және клиенттерге қызмет көрсету сілтемелерін басқара алады. Бұл жаңа клиент қосылған сайын брендке тән логиканы қолданба кодының ішіне қайта-қайта көшірудің алдын алады.

Қызмет провайдерлері үшін бұл бөлудің тағы бір пайдасы бар: тасымалдаушы интеграциясын бір рет жақсартып, кейін оны талаптарға сай тенанттардың барлығында пайдалануға болады. Алайда ортақ код ортақ рұқсаттарды білдірмеуі керек. Тасымалдаушы байланысы ортақ болуы мүмкін, ал жөнелтілімнің көрінуі оны жіберген немесе иеленетін тенантпен шектелуі тиіс.

Брендтерге ұсынбас бұрын тасымалдаушы деректерін біріздендіріңіз

Әр тасымалдаушы оқиға атауларын, күй логикасын, уақыт белгілерін және ерекшелік сипаттамаларын әртүрлі пайдаланғанда, көпбрендті бақылау күрделене түседі. Бір тасымалдаушы сәлемдеменің желі ішінде қозғалып жатқанын хабарлауы мүмкін, ал екіншісі нақтырақ тасымалдау немесе нысан оқиғасын қолданады. Осы бастапқы мәндерді әр клиентке тікелей беру клиент тәжірибесін бірізсіз етіп, есептілікті қиындатады.

Ортақ біріздендіру қабаты тасымалдаушыға тән оқиғаларды бақыланатын ішкі сөздікке түрлендіруі керек. Жалпы санаттарға ақпарат алынды, жолда, алып кетуге дайын, жеткізуге шықты, жеткізілді, жеткізу ерекшелігі және қайтаруға қатысты оқиғалар кіруі мүмкін. Ішкі модель бастапқы тасымалдаушы оқиғасын да, біріздендірілген күйді де сақтауы керек. Бұл қолдау топтарына қажет диагностикалық егжей-тегжейлерді жоғалтпай, клиент тәжірибесін қарапайым ұстауға мүмкіндік береді.

Біріздендіру белгісіздікті де ескеруі керек. Платформа тасымалдаушы растаған жеткізу оқиғасын, жаңартулардың уақытша болмауын және болжамды операциялық күйді ажыратуы тиіс. Ол түсініксіз тасымалдаушы хабарын нақты уәдеге айналдырмауы керек. Егер тасымалдаушы болжамды жеткізу күнін берсе, API оны кепілдендірілген кездесу ретінде емес, болжам ретінде көрсетуі тиіс.

17TRACK сияқты провайдерді қажетті тасымалдаушы және API мүмкіндіктері қызмет провайдерінің пайдалану жағдайына сәйкес келгенде ортақ бақылау деректері қабаты ретінде бағалауға болады. Өндіріске жоспарлау алдында қолдау көрсетілетін операцияларды, сұрау форматтарын, аутентификацияны, шектеулерді және іске асыру талаптарын растау үшін оның ресми API материалдары мен әзірлеуші құжаттамасын пайдалану керек.

API келісімшартын операциялық пайдалану жағдайлары негізінде жобалаңыз

Көпбрендті API тек тасымалдаушы ұсынатын деректерге емес, клиент жүйелерінің нақты не істеуі керектігіне негізделіп жобалануы тиіс. Кемінде келісімшартта клиенттің бақылау сұрауын қалай жасайтыны немесе тіркейтіні, ағымдағы жөнелтілім күйін алатыны, оқиғалар тарихын сұрайтыны және таңдалған қызметте оқиғаларды жеткізу қарастырылса, күй өзгерген кезде жаңартуларды алатыны анықталуы керек.

Келісімшартта мыналар құжатталуы керек:

  • Тенанттар мен қолданбалар қалай аутентификацияланады.
  • Қай идентификаторлар міндетті, ал қайсысы қосымша.
  • Тасымалдаушы кодтары қалай беріледі, анықталады немесе түзетіледі.
  • Сәтті жауап нені білдіреді және кейін өңдеуге қабылданған сұраудан айырмашылығы қандай.
  • Белгісіз, кешіккен, қайталанған немесе қайшы оқиғалар қалай көрсетіледі.
  • Беттерге бөлу, қайталап жіберу, сұрау жылдамдығының шектері және қателер қалай өңделеді.
  • Webhook қолданылса, webhook қолтаңбалары, қайталап жіберуден қорғау және оқиғалар реті қалай басқарылады.

Идемпотенттілік ерекше маңызды. Желі күту уақыты біткеннен кейін клиенттер сұрауды қайта жіберуі мүмкін, сондықтан платформа бір сұрау екі рет жіберілгені үшін қайталанатын жөнелтілім жазбаларын жасамауы тиіс. Әр тенантқа практикалық тұрғыдан ең шектеулі ауқымдағы тіркелгі деректері берілуі керек. Бренд қолданбасы сұраудағы идентификаторды өзгерту арқылы басқа брендтің жөнелтілім деректерін сұрата алмауы тиіс.

Ортақ деректер қабатын бренд тәжірибесінен бөлек ұстаңыз

Бір API бір бақылау бетін қажет етпейді. Қызмет провайдері біріздендірілген деректерді әртүрлі клиент тәжірибелерін қолдау үшін пайдалана алады: брендтелген тапсырыс күйі беті, ендірілген виджет, клиенттерге қызмет көрсету консолі немесе клиенттің қолданыстағы сауда платформасы басқаратын хабарландырулар.

Тәжірибе қабаты қанша ақпарат көрсетілетінін шешуі керек. Премиум бренд егжей-тегжейлі уақыт шкаласы мен қолдау сілтемесін көрсетуі мүмкін, ал басқа клиент ықшам күй картасын таңдауы мүмкін. Екеуі де бір негізгі оқиғалар моделін пайдалана алады. Тіл, уақыт белдеуін көрсету, бренд терминологиясы және байланыс нұсқаулары да осы қабатта орналасуы тиіс.

Ecommerce провайдерлері үшін тапсырыс сілтемесі сатып алушы үшін бақылау нөмірі сияқты маңызды болуы мүмкін. Сондықтан API жауабы жеке ақпаратты қажетсіз ашпай, жөнелтілім күйін дұрыс тапсырыспен байланыстыруға мүмкіндік беруі керек. Клиенттерге арналған беттер тек қажетті ең аз деректерді пайдалануы тиіс, ал операциялық панельдер агенттер, аккаунт менеджерлері және әкімшілер үшін рөлге негізделген қолжетімділікті қолдануы керек.

Бақылауды тек жөнелтілімдер үшін емес, платформа үшін де құрыңыз

Ортақ бақылау қызметінде екі түрлі мониторинг мәселесі бар. Ол жеткізу ерекшелігі немесе жаңартусыз өткен әдеттен тыс ұзақ кезең сияқты жөнелтілім деңгейіндегі мәселелерді, сондай-ақ API қателерінің көбеюі, оқиғаларды өңдеудің кешігуі немесе толық емес деректер қайтаратын тасымалдаушы коннекторы сияқты платформа деңгейіндегі мәселелерді анықтауы керек.

Деректер мүмкіндік берген жағдайда метрикалар тенант, тасымалдаушы, аймақ, endpoint және қате түрі бойынша бөлінуі керек. Пайдалы операциялық тексерулерге сұраулардың сәтті орындалу пайызы, жауап кідірісі, оқиғаларды өңдеу кідірісі, қайталанатын оқиғалар үлесі, аутентификация сәтсіздіктері және қолмен тексеруді қажет ететін жазбалар саны жатады. Бөлу маңызды, өйткені біріктірілген платформа метрикасы дұрыс көрінгенімен, бір бренд немесе тасымалдаушы елеулі мәселеге тап болуы мүмкін.

Іске қоспас бұрын эскалация жолын жасаңыз. Ескертуді кім алатынын, қандай дәлел тіркелетінін, тасымалдаушы мәселесінің клиент деректері мәселесінен қалай ажыратылатынын және клиенттерге қызмет көрсету тобы қашан хабардар етілуі керектігін анықтаңыз. Ортақ API операциялық бөлшектенуді азайтуы керек, мәселелерді бір жалпы қате хабарламасының артына жасыруы емес.

Әр бренд үшін бақыланатын онбординг үдерісін қолданыңыз

Жаңа бренд қосу қайталанатын іске асыру үдерісі болуы керек. Клиенттің тапсырыс, fulfillment және клиенттерге қызмет көрсету жүйелерін картаға түсіруден бастаңыз. Қандай жөнелтілім идентификаторлары бар екенін, қандай тасымалдаушылар қолданылатынын, қай аймақтарға ерекше өңдеу қажет екенін және клиент провайдердің хабарландыруларды басқаруын, тек деректер беруді немесе екеуін де қалайтынын растаңыз.

  1. Тенантты анықтаңыз: бренд жазбасын, тіркелгі деректерін, рөлдерді, орталарды және деректерді сақтау талаптарын жасаңыз.
  2. Идентификаторларды сәйкестендіріңіз: тапсырыстар, fulfillment жазбалары, бақылау нөмірлері және клиенттерге көрсетілетін сілтемелер арасындағы байланысты құжаттаңыз.
  3. Тасымалдаушы кірістерін тексеріңіз: брендтің негізгі бағыттары мен қызмет түрлері бойынша нақты үлгілік жөнелтілімдерді пайдаланыңыз.
  4. Біріздендірілген күйлерді растаңыз: API нәтижелерін тасымалдаушының қолжетімді бақылау ақпаратымен және клиент қалаған терминологиямен салыстырыңыз.
  5. Сәтсіз жағдайларды тексеріңіз: жарамсыз нөмірлерді, кешіккен сканерлеулерді, қайталанатын сұрауларды, белгісіз тасымалдаушыларды, қайтаруларды және ішінара жөнелтілімдерді қамтыңыз.
  6. Шектеулі шығарылым жүргізіңіз: толық клиенттік базаны қоспас бұрын бақыланатын топтың нақты трафигін бақылаңыз.
  7. Иелік етуді құжаттаңыз: күй атауларын кім бекітетінін, қолдау эскалацияларын кім өңдейтінін және платформа өзгерістерін кім қарайтынын тіркеңіз.

Бұл үдеріс провайдерге қолданыстағы бір API дизайнының жеткілікті екенін анықтаудың практикалық жолын да береді. Егер клиент ортақ қабат сенімді түрде қолдай алмайтын тасымалдаушыны, деректер өрісін, хабарландыру арнасын немесе аймақтық үдерісті талап етсе, бұл олқылықты арнайы уақытша шешіммен жасырудың орнына тіркеп, тексеру керек.

Жиі кездесетін қателерден аулақ болыңыз

  • Бренд атауларын қауіпсіздік бақылауы ретінде пайдалану: көрсету конфигурациясы тенант авторизациясының орнын баспайды.
  • Шикі тасымалдаушы күйлерін барлық жерде қайтару: бұл клиенттерге түсініксіз тіл мен бірізсіз аналитикаға әкеледі.
  • Бір бақылау нөмірі бір тапсырысқа тең деп есептеу: бөлінген жөнелтілімдер, ауыстырулар және қайтарулар бұл байланысты өзгертуі мүмкін.
  • Уақыт белдеулерін елемеу: оқиға уақыт белгілері бірізді сақталып, пайдаланушылар түсінетін түрде көрсетілуі керек.
  • Хабарландыруларды негізгі деректер моделіне енгізу: әртүрлі брендтер әртүрлі арналар мен мәтіндерді пайдалана алуы үшін хабарландыру параметрлері конфигурацияланатын болуы тиіс.
  • Тек сәтті жеткізілімдерді тексеру: қолдау шығындары әдетте ерекшеліктер мен жоғалған жаңартулар кезінде пайда болады.
  • Тексерусіз тасымалдаушы қамтуын уәде ету: ресми құжаттама немесе техникалық proof of concept арқылы ағымдағы тасымалдаушыны, аймақты және операция талаптарын растаңыз.

Практикалық шешім қабылдау шеңбері

Бір API тәсілі бірнеше брендтің жөнелтілім үдерістері жалпы алғанда ұқсас болғанда, тасымалдаушы деректерінің бірізділігін қажет еткенде және интеграцияларға қызмет көрсетуді провайдердің өзіне тапсырғысы келгенде тиімді. Әр клиент түбегейлі өзгеше деректер келісімшарттарын, қатаң аймақтық оқшаулауды немесе тасымалдаушыға тән операциялық үдерістерді талап еткенде, бұл тәсіл күрделірек болады. Мұндай талаптар ортақ платформаны автоматты түрде жоққа шығармайды, бірақ конфигурацияға, тестілеуге және нақты анықталған қызмет шекараларына деген қажеттілікті арттырады.

API провайдерін таңдаудан бұрын нақты, бірақ бақыланатын жөнелтілім мысалдарын пайдаланып proof of concept жүргізіңіз. Тасымалдаушыны анықтауды, оқиғаларды біріздендіруді, жаңарту уақытын, қате жауаптарын, аутентификацияны, тенанттарды оқшаулауды және клиенттерге қызмет көрсету топтарына қажет ақпаратты алу мүмкіндігін тексеріңіз. Провайдердің ресми көп тасымалдаушыны бақылау жөніндегі нұсқаулығын және API құжаттамасын қарап, шешілмеген талаптарды тікелей растаңыз. Дұрыс шешім маркетингтік бетте аталған тасымалдаушылар санына емес, провайдердің платформа нақты басқаратын брендтерді, бағыттарды, үдерістерді және бақылау құралдарын қолдай алуына негізделеді.

Дұрыс орындалса, бір бақылау API-і тағы бір оқшауланған интеграция емес, қайта пайдалануға болатын операциялық қабатқа айналады. Ол сатып алғаннан кейінгі қызмет провайдерлеріне жөнелтілім жаңартуларын жинаудың, бренд деңгейіндегі тәжірибелерді сақтаудың және әр ecommerce аккаунты үшін бірдей тасымалдаушы жұмысын қайталамай, клиенттерді қосуды масштабтаудың бірізді тәсілін береді.

Жиі қойылатын сұрақтар

Бір API деректерді ортақ пайдаланбай бірнеше брендке қызмет көрсете ала ма?

Иә, егер тенант идентификациясы мен авторизациясы бүкіл жүйеде қамтамасыз етілсе. Әр сұрау рұқсат етілген тенантпен байланыстырылып, деректер қайтарылмас бұрын жөнелтілім сұраулары сол тенантқа сәйкестігі бойынша тексерілуі керек. Бөлек тіркелгі деректері, рөлге негізделген қолжетімділік, аудит журналдары және оқшаулау тестілері іске асырудың бір бөлігі болуы тиіс.

Әр бренд бірдей бақылау бетін пайдалануы керек пе?

Жоқ. Ортақ API біріздендірілген бақылау деректерін ұсына алады, ал әр бренд өз бетын, виджетін, тілін, терминологиясын және қолдау сілтемелерін пайдаланады. Көрсетілімді деректер қабатынан бөлек сақтау көпбрендті операцияларды басқаруды жеңілдетеді.

Өндіріске дейін нені тексеру керек?

Нақты тасымалдаушы кірістерін, жарамсыз бақылау нөмірлерін, кешіккен оқиғаларды, қайталанатын сұрауларды, бөлінген жөнелтілімдерді, қайтаруларды, белгісіз тасымалдаушыларды, қажет болса webhook қайталауларын және тенанттарды оқшаулау бақылауларын тексеріңіз. Сондай-ақ біріздендірілген күйлер клиент сатып алушыларға көрсеткісі келетін тілге сәйкес келетінін растаңыз.

Бір API тасымалдаушылар арасындағы айырмашылықтарды басқару қажеттілігін жоя ма?

Жоқ. Ол интеграциялық жұмыстың көп бөлігін орталықтандырады, бірақ тасымалдаушылар арасындағы айырмашылықтар әлі де мұқият бақыланып, көрсетілуі керек. Провайдер пайдалы бастапқы оқиға егжей-тегжейлерін сақтап, клиент қолданбаларына тұрақты біріздендірілген модель ұсынуы тиіс.

Провайдер бақылау API-ін қалай бағалауы керек?

API-ді провайдердің нақты брендтері, тасымалдаушылары, аймақтары, оқиға талаптары, аутентификация моделі, шектеулері, қателерді өңдеуі, жаңарту әрекеті және қолдау үдерісі бойынша бағалаңыз. Бақыланатын proof of concept барлық қажетті үдеріс жалпы мүмкіндіктер сипаттамасында қамтылған деп болжаудан сенімдірек.

Дереккөздер