Dzīvescikls (servera pusē)

Nosūtiet atskaņojuma saiti uz ActiveCampaign, Mailchimp, Iterable vai Klaviyo no mūsu servera, tiklīdz sesija saņem jūsu pašu klienta ID.

1. Kāpēc tas pastāv līdzās pārlūka tiltam

MousePlayer jau ir dzīvescikla tilts, kas raksta jūsu pašu lapā darbojošā SDK — Klaviyo, Braze, Customer.io un vēl sešos. Šis veic to pašu darbu no mūsu servera un pastāv tāpēc, ka divām no lielākajām platformām pārlūka ceļš vienkārši nav pieejams:

  • ActiveCampaign vispār nav pārlūka API notikumiem. Tā vgo() var iestatīt kontu un e-pasta adresi un sākt izsekošanu — tas nevar nosūtīt notikumu. Notikumi tiek sūtīti caur Event Tracking API ar atsevišķu notikumu atslēgu tikai servera pusē.
  • Mailchimp tāds ir, taču ar slēgtu nosaukumu kopu. Tā vietnes izsekošanas pikselis pieņem PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED un dažus citus iepriekš definētus nosaukumus. Pielāgotam notikumam vietas nav, un mūsu datu iespiešana PAGE_VIEWED būtu meli jūsu pašu datu modelī.

Iterable un Klaviyo servera ceļš vienkārši ir uzticamāks: nav reklāmu bloķētāja, nav SDK, kas var būt vai nebūt ielādējies, nav priekšlaicīgi aizvērtas cilnes.

2. Kas tam vajadzīgs

Trīs lauki, un tas, kurus aizpildāt, ir atkarīgs no platformas.

PlatformaKonta lauksAtslēga
ActiveCampaignactidVietne → Vietnes izsekošana, blakus notikumu atslēgai
MailchimpAuditorijas IDAPI atslēga — paturiet tās -us14 stila sufiksu, no tā tiek nolasīts datu centrs
Iterablenav vajadzīgs — atstājiet tukšuAtslēga ar atļauju „Atļaut notikumu izsekošanas izsaukumus“
Klaviyonav vajadzīgs — atstājiet tukšu Privāta API atslēga

Trešais lauks ir notikuma nosaukums, ar kuru tas tiks parādīts. Izvēlieties īsu: ne vairāk kā 32 rakstzīmes. Tas ir API ierobežojums, nevis mūsu, un mēs to saīsinām saglabāšanas, nevis nosūtīšanas brīdī — citādi veidlapā redzētu ko citu nekā saņēmēja pusē.

Mailchimp: saglabājiet API atslēgas sufiksu. Daļa pēc pēdējās defises (-us14) norāda datu centru, kurā atrodas jūsu konts, un no tās tiek veidota adrese. Atslēga bez šīs daļas tiek noraidīta ar skaidru paziņojumu, nevis izraisa kļūmi vietā, kuru neredzat.

3. Kad tas nostrādā un kad ne

Brīdī, kad sesija tiek identificēta: kad jūsu vietne izsauc MousePlayer.setUserId(), kad mūsu analītikas tilts nolasa identifikatoru vai jūsu serveris izsauc identificēšanas galapunktu. Pirms tam nezinām, kam ieraksts pieder.

Tikai ar e-pasta adresi

Visas četras platformas adresē kontaktpersonu pēc tās e-pasta. Ja jūsu klienta ID ir līguma numurs, nekas netiek nosūtīts — tāda uzdevuma ievietošana rindā, kurš var tikai neizdoties, vien piepildītu žurnālu ar troksni.

Kontaktpersonai jau jāpastāv. Neviena no šīm platformām to neveido no notikuma; ActiveCampaign pilnībā atmet notikumu, ja neatpazīst adresi. Šis tilts papildina esošās kontaktpersonas — tas neveido jūsu sarakstu.

Katram notikumam ir ID

Lai vienu sesiju nevarētu saskaitīt divreiz pat tad, ja uzdevuma izpilde tiek atkārtota.

4. Kas pienāk otrā pusē

Viens notikums ar atskaņojuma saiti rekvizītā, kura nosaukums ir mouseplayer_session_url. Atveriet to, un nonāksiet tieši šīs sesijas ierakstā.

Tālāk darbojas pašas platformas loģika: izmantojiet notikumu kā automatizācijas aktivizētāju, segmenta nosacījumu vai vienkārši ļaujiet komandai atvērt ierakstu no kontaktpersonas.

Atslēga nekad neatstāj mūsu serveri

Tā tiek glabāta šifrēta ar AES-256-GCM, pēc saglabāšanas vairs netiek parādīta un apzināti netiek ievietota iekšējā rindā, kas pārvadā uzdevumu, — apstrādes process pats to iegūst no datubāzes.

HTTP 200 nenozīmē piegādāts

ActiveCampaign atbild ar statusu 200 un {"success":0}, kad noraida notikumu. Mēs nolasām atbildes saturu, nevis tikai statusu, tāpēc noraidījums piegādes žurnālā parādās kā kļūme, nevis klusa veiksme.

5. Braze, Customer.io un Brevo

Vēl trīs platformas servera puses ceļā. Divām no tām vajag kaut ko tādu, kas pārējām nav vajadzīgs: atrašanās vietu.

Jūs norādātIdentificē pēc
BrazeREST galapunkts un API atslēgae-pasta adreses
Customer.iovietnes ID, API atslēga un jūsu reģionsjūsu pašu klienta ID
Brevotikai izsekotāja atslēgae-pasta adreses

Divas no tām atrodas konkrētā vietā

Braze izmanto instancei piesaistītus REST galapunktus; Customer.io darbojas divos atsevišķos reģionos ar dažādiem resursdatoriem. Nevienu nevar noteikt no atslēgas, un, izvēloties nepareizo, tiek saņemts 401 — kas liek meklēt vainu atslēgā. Abi lauki pastāv tikai šā iemesla dēļ.

Customer.io ir vienīgais, kam nevajag e-pastu

Tas pazīst cilvēkus pēc tā paša ID, kuru viņiem piešķirat, tāpēc prasīt e-pastu būtu izdomāts šķērslis. Pārējie seši sasaista pēc e-pasta, un tajos sesija, kas identificēta ar līguma numuru, neko nerada — pareizi.

Nekādu jaunu profilu

Braze izsaukums ietver _update_existing_only. Tāds pats lēmums kā CRM tiltam: pārlūka sesija nav uzticams apliecinājums tam, kas ir jūsu klienti, un dzīvescikla platforma, kas veido profilu katram anonīmam apmeklētājam, ir sliktāka nekā integrācijas neesamība.

Brevo atbild ar 204, Braze atbild ar 201, taču ir nianse

Brevo vispār neatgriež atbildes saturu — tur 2xx tiešām pasaka visu. Braze atgriež "message": "success" un tam blakus var būt errors masīvs: fatālas problēmas parādās ziņojumā, pieļautie lauku zudumi — tikai errors. Lasot tikai vienu, kļūda rodas vienā vai otrā virzienā.

Visas šeit minētās preču zīmes pieder to attiecīgajiem īpašniekiem. MousePlayer nav darījumu attiecību ar šiem nodrošinātājiem.