Ìgbésí ayé oníbàárà (ní ẹ̀rọ ìpèsè)
Ẹ fi ìjápọ̀ ìtúnṣeré sínú ActiveCampaign, Mailchimp, Iterable tàbí Klaviyo láti ẹ̀rọ ìpèsè wa ní kété tí ìgbà ìlò bá gba ID oníbàárà tiyín.
1. Ìdí tí èyí fi wà lẹ́gbẹ̀ẹ́ afárá aṣàwákiri
MousePlayer ti ní afárá ìgbésí ayé oníbàárà tó ń kọ sínú SDK tó ń ṣiṣẹ́ lórí ojú ìwé tiyín — Klaviyo, Braze, Customer.io àti mẹ́fà yòókù. Èyí ń ṣe iṣẹ́ kan náà láti ẹ̀rọ ìpèsè wa dípò rẹ̀, ó sì wà nítorí ọ̀nà aṣàwákiri kò sí rárá fún méjì nínú pẹpẹ tó tóbi jù:
- ActiveCampaign kò ní API aṣàwákiri fún ìṣẹ̀lẹ̀ rárá.
vgo()rẹ̀ lè ṣètò àkáǹtì àti àdírẹ́sì ímeèlì, kí ó sì bẹ̀rẹ̀ ìtọ́pa — kò lè fi ìṣẹ̀lẹ̀ ránṣẹ́. Ìṣẹ̀lẹ̀ ń lọ nípasẹ̀ Event Tracking API pẹ̀lú event key ọ̀tọ̀, ní ẹ̀rọ ìpèsè nìkan. - Mailchimp ní ọ̀kan, ṣùgbọ́n pẹ̀lú ọ̀rọ̀ tí a ti dí mọ́. Pixel ìtọ́pa ojúlé rẹ̀ ń gba
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDàti díẹ̀ lára orúkọ tí a ti ṣàlàyé. Kò sí ààyè fún ìṣẹ̀lẹ̀ tiyín, fífi dátà wa sínúPAGE_VIEWEDyóò jẹ́ irọ́ nínú àwòṣe dátà tiyín.
Fún Iterable àti Klaviyo, ọ̀nà ẹ̀rọ ìpèsè jẹ́ èyí tó ṣeé gbẹ́kẹ̀ lé sí i nìkan: kò sí ad blocker, kò sí SDK tí ó lè ti wọlé tàbí má wọlé, kò sí táàbù tó pa dé ṣáájú.
2. Ohun tí ó nílò
Pápá mẹ́ta, èyí tí ẹ kún dá lórí pẹpẹ.
| Pẹpẹ | Pápá àkáǹtì | Key |
|---|---|---|
| ActiveCampaign | actid | Ojúlé wẹ́ẹ̀bù → Site Tracking, lẹ́gbẹ̀ẹ́ event key |
| Mailchimp | Audience ID | API key — ẹ pa suffix rẹ̀ ní ìrísí -us14 mọ́, a ń ka ibùdó dátà láti inú rẹ̀ |
| Iterable | kò nílò — fi sílẹ̀ ní òfo | Key pẹ̀lú àṣẹ “Allow event track calls” |
| Klaviyo | kò nílò — fi sílẹ̀ ní òfo | API key àṣírí kan |
Pápá kẹta ni orúkọ ìṣẹ̀lẹ̀ tí yóò hàn lábẹ́ rẹ̀. Ẹ jẹ́ kí ó kúrú: lẹ́tà 32 tó pọ̀ jù. Ààlà API nìyẹn, kì í ṣe tiwa, a sì ń gé e kúrú nígbà tí ẹ fi pamọ́ dípò nígbà fífiránṣẹ́ — bí bẹ́ẹ̀ kọ́ fọ́ọ̀mù yóò fi ohun tó yàtọ̀ sí èyí tó dé hàn yín.
Mailchimp: ẹ pa suffix mọ́ lórí API key yín. Apá lẹ́yìn dash ìkẹyìn (-us14) ń dárúkọ ibùdó dátà tí àkáǹtì yín wà, a sì ń kọ àdírẹ́sì láti inú rẹ̀. A kọ key láìsí rẹ̀ pẹ̀lú ìfiránṣẹ́ tó ṣe kedere dípò kíkùnà níbi tí ẹ kò lè rí.
3. Ìgbà tí ó ń ṣiṣẹ́ — àti ìgbà tí kò ṣiṣẹ́
Ní kété tí a bá mọ ìgbà ìlò: nígbà tí ojúlé yín pe MousePlayer.setUserId(), nígbà tí afárá ìtúpalẹ̀ wa ka distinct ID padà, tàbí nígbà tí ẹ̀rọ ìpèsè yín pe identify endpoint. Ṣáájú ìyẹn a kò mọ ẹni tí ìgbàsílẹ̀ jẹ́ tirẹ̀.
Pẹ̀lú àdírẹ́sì ímeèlì nìkan
Gbogbo pẹpẹ mẹ́rin ń tọ́ka sí ẹni nípa ímeèlì rẹ̀. Bí ID oníbàárà yín bá jẹ́ nọ́ńbà àdéhùn, a kò fi ohunkóhun ránṣẹ́ — fífi iṣẹ́ tí kò lè ṣe ohun míì ju kíkùnà lọ sí ìlà yóò kan kún àkọsílẹ̀ yín pẹ̀lú ariwo.
Ẹni náà gbọ́dọ̀ ti wà tẹ́lẹ̀. Kò sí pẹpẹ wọ̀nyí tó ń ṣẹ̀dá ọ̀kan láti ìṣẹ̀lẹ̀; ActiveCampaign ń sọ gbogbo ìṣẹ̀lẹ̀ nù bí kò bá mọ àdírẹ́sì. Afárá yìí ń mú àlàyé àwọn ẹni tí ẹ ti ní pọ̀ sí i — kò kọ àtòjọ yín.
Gbogbo ìṣẹ̀lẹ̀ ní ID
Kí a má lè ka ìgbà ìlò kan náà lẹ́ẹ̀mejì, kódà bí a bá tún iṣẹ́ gbìyànjú.
4. Ohun tó ń dé ní ọ̀dọ̀ kejì
Ìṣẹ̀lẹ̀ kan, pẹ̀lú ìjápọ̀ ìtúnṣeré gẹ́gẹ́ bí property tí a pè ní mouseplayer_session_url. Ẹ ṣí i, ẹ sì wà nínú ìgbàsílẹ̀ ìgbà ìlò gangan yẹn.
Láti ibẹ̀, ìlànà pẹpẹ tiyín ni: ẹ lo ìṣẹ̀lẹ̀ gẹ́gẹ́ bí ohun ìmúṣiṣẹ́ aládàáṣiṣẹ́, gẹ́gẹ́ bí ìlànà ẹ̀ka, tàbí jẹ́ kí ẹgbẹ́ yín ṣí ìgbàsílẹ̀ láti inú àlàyé ẹni náà nìkan.
Key kò kúrò lórí ẹ̀rọ ìpèsè wa láéláé
A fi pamọ́ pẹ̀lú ìpàrokò AES-256-GCM, a kò tún fi hàn lẹ́yìn fífi pamọ́, a sì mọ̀ọ́mọ̀ kò fi sínú ìlà inú tó gbé iṣẹ́ — worker ń gbà á láti ibi ìpamọ́ dátà fúnra rẹ̀.
HTTP 200 kò túmọ̀ sí a fi jiṣẹ́
ActiveCampaign ń dá ipò 200 àti {"success":0} padà nígbà tó kọ ìṣẹ̀lẹ̀ kan. A ka ara ìdáhùn, kì í ṣe ipò nìkan, kí ìkọ̀ lè hàn gẹ́gẹ́ bí ìkùnà nínú àkọsílẹ̀ ìfijiṣẹ́ dípò àṣeyọrí tí kò pariwo.
5. Braze, Customer.io àti Brevo
Pẹpẹ mẹ́ta sí i lórí ọ̀nà ẹ̀rọ ìpèsè. Méjì nínú wọn nílò ohun tí ìyókù kò nílò: ibi.
| Ohun tí ẹ pèsè | A mọ̀ nípasẹ̀ | |
|---|---|---|
| Braze | REST endpoint àti API key | àdírẹ́sì ímeèlì |
| Customer.io | site ID, API key àti agbègbè yín | ID oníbàárà tiyín |
| Brevo | tracker key, kò sí ohun míì | àdírẹ́sì ímeèlì |
Méjì nínú wọn wà ní ibi pàtó
Braze ń lo REST endpoint tó so mọ́ instance; Customer.io ń lo agbègbè méjì ọ̀tọ̀ pẹ̀lú host tó yàtọ̀. A kò lè mú èyíkéyìí jáde láti key, yíyan èyí tí kò tọ́ sì ń dá 401 padà — tó ń mú kí ẹ wo key. Ìdí yẹn nìkan ni pápá méjèèjì fi wà.
Customer.io ni èyí tí kò nílò ímeèlì
Ó mọ ènìyàn lábẹ́ ID kan náà tí ẹ yàn fún wọn, nítorí náà béèrè àdírẹ́sì ímeèlì yóò jẹ́ ìdènà tí a dá sílẹ̀. Mẹ́fà yòókù ń bá mu lórí ímeèlì, fún wọn ìgbà ìlò tí a mọ̀ nípa nọ́ńbà àdéhùn kò dá ohunkóhun sílẹ̀ — lọ́nà tó tọ́.
Kò sí profaili tuntun
Ìpè Braze ní _update_existing_only. Ìpinnu kan náà bí afárá CRM: ìgbà ìlò aṣàwákiri kì í ṣe ẹ̀rí tó ṣeé gbẹ́kẹ̀ lé nípa ẹni tí oníbàárà yín jẹ́, pẹpẹ ìgbésí ayé oníbàárà tó ń dá profaili sílẹ̀ fún àlejò aláìlórúkọ kọ̀ọ̀kan burú ju àìsí ìsopọ̀ lọ.
Brevo ń dá 204 padà, Braze ń dá 201 padà pẹ̀lú àlàyé pàtàkì
Brevo kò dá ara ìdáhùn kankan padà — níbẹ̀, 2xx jẹ́ gbogbo òótọ́ ní tòótọ́. Braze ń dá "message": "success" padà, ó sì lè ní array errors lẹ́gbẹ̀ẹ́ rẹ̀: ìṣòro pàtàkì ń hàn nínú message, àìsí pápá tí a gba láyè ń hàn nínú errors nìkan. Kíkà ọ̀kan ṣoṣo ń yọrí sí àṣìṣe ní ọ̀nà kan tàbí kejì.
Àwọn àmì ìṣòwò tí a dárúkọ níbí jẹ́ ti àwọn olówó wọn. MousePlayer kò ní ìbáṣepọ̀ òwò pẹ̀lú àwọn olùpèsè yìí.