Kaip pridėti Asyntai DI pokalbių robotą prie Adobe Experience Manager

Žingsnis po žingsnio vadovas AEM svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Pridėkite kodą naudodami puslapio komponentą (Rekomenduojama)

Rekomenduojamas metodas yra pridėti pokalbių roboto kodą į AEM puslapio komponento antraštės skyrių visai svetainei:

Prisijunkite prie savo AEM Author instancijos
Eikite į CRXDE Lite (paprastai http://your-aem-instance:4502/crx/de)
Raskite savo puslapio komponento šabloną (paprastai /apps/your-project/components/page)
Raskite arba sukurkite head.html arba headerlibs.html failą
Pridėkite savo Asyntai įterpimo kodą į šį failą
Spustelėkite "Save All" viršutiniame meniu
Replikuokite pakeitimus į savo publikavimo instanciją

Patarimas: Kodo įdėjimas į head.html failą užtikrina, kad pokalbių robotas bus rodomas visuose puslapiuose, naudojančiuose tą šabloną. Tai švariausias būdas visos svetainės diegimui.

Alternatyvus metodas 1: Klientų bibliotekos (ClientLibs)

Struktūriškesniam požiūriui galite naudoti AEM klientų bibliotekų sistemą:

Sukurkite naują klientų bibliotekos aplanką /apps/your-project/clientlibs
Nustatykite cq:clientLibraryFolder mazgo tipą
Sukurkite js.txt failą su savo JavaScript failų sąrašu
Pridėkite savo Asyntai įterpimo kodą į JavaScript failą šiame aplanke
Įtraukite klientų biblioteką į savo puslapio komponentą naudodami:

<sly data-sly-use.clientlib="/libs/granite/sightly/templates/clientlib.html"
     data-sly-call="${clientlib.js @ categories='your-category-name'}" />

Pastaba: Šis metodas rekomenduojamas projektams su esama ClientLib struktūra ir suteikia geresnę organizaciją didesnėms implementacijoms.

Alternatyvus metodas 2: Žymių valdymas (Adobe Launch)

Jei naudojate Adobe Launch (anksčiau DTM) ar kitą žymių tvarkyklę:

Prisijunkite prie Adobe Experience Platform Launch
Eikite į savo nuosavybę
Eikite į Rules ir sukurkite naują taisyklę
Nustatykite įvykį kaip "Page Bottom" arba "DOM Ready"
Pridėkite veiksmą: Custom Code
Įklijuokite savo Asyntai įterpimo kodą
Išsaugokite ir publikuokite biblioteką

Patarimas: Adobe Launch naudojimas yra Adobe rekomenduojamas būdas trečiųjų šalių skriptams pridėti. Jis suteikia geresnę kontrolę, testavimo galimybes ir nereikalauja kodo diegimų.

Alternatyvus metodas 3: Patirties fragmentas

Lanksčiam, autoriui patogiam diegimui:

Eikite į Experience Fragments AEM sistemoje
Sukurkite naują patirties fragmentą
Pridėkite teksto komponentą arba HTML komponentą
Perjunkite į HTML šaltinio režimą
Įklijuokite savo Asyntai įterpimo kodą
Įtraukite šį patirties fragmentą į puslapio šablono poraštę

Svarbu: Įsitikinkite, kad turite tinkamus AEM leidimus modifikuoti šablonus ir komponentus. AEM kaip debesijos paslaugai pakeitimai gali turėti eiti per jūsų CI/CD procesą.

3 žingsnis: Patikrinkite diegimą

Pritaikius pakeitimus, išvalykite naršyklės talpyklą ir apsilankykite savo svetainėje. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Patikrinkite naršyklės konsolę (F12) dėl JavaScript klaidų. Patikrinkite, ar kodas tinkamai išdiegtas jūsų publikavimo instancijoje. AEM kaip debesijos paslaugai įsitikinkite, kad jūsų pakeitimai sėkmingai praėjo per diegimo procesą.