Lifecycle (dhinaca seerfarka)

Xiriirka dib-u-ciyaarista ugu dir ActiveCampaign, Mailchimp, Iterable ama Klaviyo seerfarkayaga isla marka fadhi helo ID-ga macmiilkaaga.

1. Sababta tani uga ag jirto buundada biraawsarka

MousePlayer hore ayuu u leeyahay buundo lifecycle oo ku qorta SDK-ga ka shaqaynaya boggaaga — Klaviyo, Braze, Customer.io iyo lix kale. Tani isla hawshaas ayay ka qabataa seerfarkayaga beddelkeeda, waxayna jirtaa sababtoo ah laba ka mid ah madallada ugu waaweyn waddada biraawsarku haba yaraatee ma jirto:

  • ActiveCampaign haba yaraatee ma laha API biraawsar oo dhacdooyin ah. Habkiisa vgo() wuxuu dejin karaa akoon iyo cinwaan iimayl oo bilaabi karaa dabagalka — dhacdo ma diri karo. Dhacdooyinku waxay maraan Event Tracking API oo leh fure dhacdo oo gaar ah, dhinaca seerfarka oo keliya.
  • Mailchimp mid wuu leeyahay, laakiin ereyadiisu waa xaddidan yihiin. Pixel-kiisa dabagalka websaytku wuxuu aqbalaa PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED iyo dhowr magac oo kale oo horay loo qeexay. Meel dhacdo gaar ah ma jirto, ku qasbidda xogtayada dhacdo PAGE_VIEWED ahna waxay been ka noqon lahayd moodelkaaga xogta.

Iterable iyo Klaviyo, waddada seerfarku waa tan lagu kalsoonaan badan yahay: xannibaad xayaysiis ma jirto, SDK laga yaabo inuu rarmay ama uusan rarmin ma jiro, tab hore u xirmayana ma jiro.

2. Waxa ay u baahan tahay

Saddex goobood, kuwa aad buuxisana waxay ku xiran yihiin madasha.

MadalGoobta akoonkaFure
ActiveCampaignactidWebsaytka → Dabagalka Site-ka, agta furaha dhacdada
MailchimpID-ga audienceFure API — hay daba-galkiisa nooca -us14 ah; xarunta xogta ayaa laga akhriyaa
Iterablelooma baahna — ka tag isagoo madhanFure leh oggolaanshaha “Allow event track calls”
Klaviyolooma baahna — ka tag isagoo madhanFure API oo gaar ah

Goobta saddexaad waa magaca dhacdada ee ay ku soo muuqanayso. Ka dhig mid gaaban: ugu badnaan 32 xaraf. Taasi waa xadka API-ga, ma aha kayaga, waxaanan soo gaabinnaa markaad kaydiso halkii marka aan dirno — haddii kale foomku wuxuu ku tusi lahaa wax ka duwan waxa gaara.

Mailchimp: hay daba-galka furahaaga API. Qaybta ka dambaysa xariijinta ugu dambaysa (-us14) waxay magacowdaa xarunta xogta akoonkaagu ku jiro, cinwaankana iyada ayaa laga dhisaa. Fure aan lahayn waxaa lagu diidaa farriin cad halkii uu ku fashilmi lahaa meel aadan arki karin.

3. Goorta ay shaqayso — iyo goorta aysan shaqayn

Isla marka fadhi la aqoonsado: marka websaytkaagu waco MousePlayer.setUserId(), marka buundadayada falanqayntu dib u akhrido aqoonsi gaar ah ama marka seerfarkaagu waco endpoint-ka identify. Ka hor ma naqaan cidda duubistu ka tirsan tahay.

Cinwaan iimayl leh oo keliya

Afarta madalba waxay qofka lala xiriirayo ku aqoonsadaan iimaylkiisa. Haddii ID-ga macmiilkaagu yahay lambar heshiis, waxba lama diro — saf-gelinta hawl fashilmi karta oo keliya waxay buuq ka buuxin lahayd diiwaankaaga.

Qofka lala xiriirayo waa inuu hore u jiraa. Madalladan midna dhacdo kama abuuro qof; ActiveCampaign gebi ahaanba way tuurtaa dhacdada haddii aysan garanayn cinwaanka. Buundadani waxay kobcisaa xogta xiriirradaada jira — liiskaaga ma dhisto.

Dhacdo kasta waxay wadataa ID

Si isla fadhiga aan laba jeer loo tirin, xitaa haddii hawsha mar kale la isku dayo.

4. Waxa gaara dhinaca kale

Hal dhacdo, oo wadata xiriirka dib-u-ciyaarista sida sifo la yiraahdo mouseplayer_session_url. Fur, waxaadna ku jirtaa duubista isla fadhigaas.

Halkaas ka dib waa habka madashaada: dhacdada u adeegso kiciye otomaatig, shuruud qayb ama kooxdaada si fudud uga fur duubista qofka lala xiriirayo.

Furuhu waligiis kama baxo seerfarkayaga

Waxaa lagu kaydiyaa sirgelin AES-256-GCM ah, dibna looma muujiyo kaydinta ka dib, si ula kac ahna looguma daro safka gudaha ee hawsha sida — worker-ka ayaa isagu ka soo qaata kaydka xogta.

HTTP 200 macnaheedu ma aha waa la gudbiyay

ActiveCampaign wuxuu ku jawaabaa xaalad 200 iyo {"success":0} marka uu diido dhacdo. Waxaan akhrinnaa jirka jawaabta, ma aha xaaladda oo keliya, si diidmo u muuqato fashil ku jira diiwaanka gudbinta halkii guul aamusan.

5. Braze, Customer.io iyo Brevo

Saddex madal oo kale oo ku jira waddada dhinaca seerfarka. Laba ka mid ahi waxay u baahan yihiin wax kuwa kale aysan u baahnayn: meel.

Waxa aad bixisoWaxa lagu aqoonsado
BrazeREST endpoint iyo fure APIcinwaan iimayl
Customer.ioID-ga site-ka, fure API iyo gobolkaagaID-ga macmiilkaaga
Brevofuraha tracker-ka oo keliyacinwaan iimayl

Laba ka mid ahi meelo gaar ah ayay ku jiraan

Braze wuxuu socodsiiyaa REST endpoints ku xiran instance; Customer.io wuxuu leeyahay laba gobol oo gaar ah oo leh hosts kala duwan. Midna furaha lagama soo saari karo, doorashada kan khaldanina waxay soo celisaa 401 — taas oo kuu jeedinaysa inaad furaha baarto. Labada goobood sababtaas oo keliya ayay u jiraan.

Customer.io waa kan aan iimayl u baahnayn

Wuxuu dadka ku yaqaan isla ID-ga aad u qoondeyso, sidaas darteed dalbashada cinwaan iimayl waxay noqon lahayd caqabad la hindisay. Lixda kale iimayl ayay ku waafajiyaan, iyagana fadhi lagu aqoonsaday lambar heshiis waxba ma soo saaro — si sax ah.

Profiles cusub ma jiraan

Wicitaanka Braze wuxuu wataa _update_existing_only. Waa isla go'aanka buundada CRM: fadhi biraawsar ma aha sheegasho lagu kalsoonaan karo oo cidda macaamiishaadu yihiin ah, madal lifecycle oo booqde aqoonsi-la'aan kasta profile u samaysana waxay ka xun tahay isku-xir la'aan.

Brevo wuxuu ku jawaabaa 204, Braze-na 201 oo shardi leh

Brevo haba yaraatee jir jawaab ah ma soo celiyo — halkaas, 2xx runtii waa runta oo dhan. Braze wuxuu soo celiyaa "message": "success" waxaana laga yaabaa inuu agtiisa ku wato array errors ah: dhibaatooyinka daran waxay ka muuqdaan message, luminta goobaha ee la oggol yahayna errors oo keliya. Akhrinta midkood oo keliya waxay ka dhigaysaa mid khaldan dhinac ama dhinaca kale.

Dhammaan calaamadaha ganacsi ee halkan lagu magacaabay waxaa leh milkiilayaashooda. MousePlayer xiriir ganacsi lama laha bixiyeyaashan.