Levenscyclus (via de server)
Stuur de afspeellink vanuit onze server naar ActiveCampaign, Mailchimp, Iterable of Klaviyo zodra een sessie uw eigen klant-ID krijgt.
1. Waarom dit naast de browserkoppeling bestaat
MousePlayer heeft al een levenscycluskoppeling die schrijft naar de SDK op uw eigen pagina: Klaviyo, Braze, Customer.io en zes andere. Deze doet hetzelfde vanuit onze server en bestaat omdat de browserroute voor twee van de grootste platforms simpelweg niet beschikbaar is:
- ActiveCampaign heeft helemaal geen browser-API voor gebeurtenissen. De functie
vgo()kan een account en een e-mailadres instellen en tracking starten, maar geen gebeurtenis versturen. Gebeurtenissen lopen via de Event Tracking API met een afzonderlijke gebeurtenissleutel, uitsluitend vanaf de server. - Mailchimp heeft er een, maar met een gesloten woordenschat. De pixel voor sitetracking accepteert
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDen enkele andere vooraf gedefinieerde namen. Er is geen plek voor een aangepaste gebeurtenis, en onze gegevens in eenPAGE_VIEWEDpersen zou een onwaarheid in uw eigen gegevensmodel opleveren.
Voor Iterable en Klaviyo is de serverroute simpelweg betrouwbaarder: geen advertentieblokkeerder, geen SDK die mogelijk niet geladen is en geen tabblad dat te vroeg wordt gesloten.
2. Wat nodig is
Drie velden; welke u invult, hangt af van het platform.
| Platform | Accountveld | Sleutel |
|---|---|---|
| ActiveCampaign | actid | Website → Sitetracking, naast de gebeurtenissleutel |
| Mailchimp | De doelgroep-ID | Een API-sleutel; behoud het achtervoegsel in de vorm -us14 want daaruit wordt het datacenter afgeleid |
| Iterable | niet nodig; laat leeg | Een sleutel met het recht “Gebeurtenistracking toestaan” |
| Klaviyo | niet nodig; laat leeg | Een niet-openbare API-sleutel |
Het derde veld is de gebeurtenisnaam waaronder deze verschijnt. Houd die kort: maximaal 32 tekens. Dat is de limiet van de API, niet die van ons. We korten de naam in bij het opslaan in plaats van bij het versturen; anders zou het formulier iets anders tonen dan wat aankomt.
Mailchimp: behoud het achtervoegsel van uw API-sleutel. Het deel na het laatste streepje (-us14) geeft aan in welk datacenter uw account staat, en wordt gebruikt om het adres op te bouwen. Een sleutel zonder dat deel wordt met een duidelijke melding afgewezen in plaats van ergens onzichtbaar te mislukken.
3. Wanneer de koppeling wordt geactiveerd en wanneer niet
Op het moment dat een sessie wordt geïdentificeerd: wanneer uw site MousePlayer.setUserId()aanroept, wanneer onze analysekoppeling een unieke ID uitleest of wanneer uw server het identify-endpoint aanroept. Daarvoor weten we niet bij wie de opname hoort.
Alleen met een e-mailadres
Alle vier de platforms spreken een contact aan via het e-mailadres. Als uw klant-ID een contractnummer is, wordt er niets verstuurd. Een taak in de wachtrij plaatsen die alleen maar kan mislukken, zou uw logboek alleen met ruis vullen.
Het contact moet al bestaan. Geen van deze platforms maakt een contact aan op basis van een gebeurtenis; ActiveCampaign gooit de gebeurtenis helemaal weg als het adres onbekend is. Deze koppeling verrijkt uw bestaande contacten, maar bouwt uw lijst niet op.
Elke gebeurtenis bevat een ID
Zo kan dezelfde sessie niet twee keer worden geteld, ook niet als een taak opnieuw wordt geprobeerd.
4. Wat er aan de andere kant aankomt
Eén gebeurtenis, met de afspeellink als property met de naam mouseplayer_session_url. Open die en u ziet de opname van precies die sessie.
Vanaf daar geldt de logica van uw eigen platform: gebruik de gebeurtenis als automatiseringstrigger of segmentvoorwaarde, of laat uw team simpelweg de opname vanuit het contact openen.
De sleutel verlaat onze server nooit
Deze wordt met AES-256-GCM versleuteld opgeslagen, na het opslaan nooit meer getoond en bewust niet in de interne wachtrij voor de taak geplaatst. De worker haalt de sleutel zelf uit de database.
HTTP 200 betekent niet dat iets is afgeleverd
ActiveCampaign antwoordt met status 200 en {"success":0} wanneer het een gebeurtenis afwijst. We lezen de antwoordtekst, niet alleen de status. Zo verschijnt een afwijzing als fout in het afleverlogboek, in plaats van als stilzwijgend succes.
5. Braze, Customer.io en Brevo
Nog drie platforms voor de serverroute. Twee daarvan hebben iets nodig wat de andere niet nodig hebben: een locatie.
| U geeft op | Geïdentificeerd via | |
|---|---|---|
| Braze | REST-endpoint en API-sleutel | e-mailadres |
| Customer.io | site-ID, API-sleutel en uw regio | uw eigen klant-ID |
| Brevo | alleen de trackingsleutel | e-mailadres |
Twee daarvan hebben een specifieke locatie
Braze gebruikt REST-endpoints die aan een instantie zijn gebonden; Customer.io heeft twee afzonderlijke regio’s met verschillende hosts. Geen van beide is af te leiden uit de sleutel, en de verkeerde keuze levert 401 op, waarna u de oorzaak bij de sleutel zoekt. Alleen daarom bestaan beide velden.
Customer.io heeft geen e-mailadres nodig
Het kent mensen onder dezelfde ID die u hun toewijst, dus een e-mailadres eisen zou een onnodig bedachte hindernis zijn. De andere zes koppelen wel via e-mail; voor hen levert een sessie met een contractnummer als identificatie terecht niets op.
Geen nieuwe profielen
De Braze-aanroep bevat _update_existing_only. Dezelfde keuze als bij de CRM-koppeling: een browsersessie is geen betrouwbare uitspraak over wie uw klanten zijn, en een levenscyclusplatform dat voor elke anonieme bezoeker een profiel aanmaakt, is slechter dan geen integratie.
Brevo antwoordt met 204, Braze met 201 en een kanttekening
Brevo geeft helemaal geen antwoordtekst terug; daar vertelt een 2xx-status werkelijk het hele verhaal. Braze retourneert "message": "success" en kan daarnaast een array errors bevatten: fatale problemen staan in message, geaccepteerd verlies van velden alleen in errors. Wie slechts één van beide leest, krijgt in de ene of de andere richting een verkeerd beeld.
Alle genoemde handelsmerken zijn eigendom van hun respectieve eigenaren. MousePlayer heeft geen zakelijke relatie met deze aanbieders.