Event tracking

Event tracking is een geavanceerde functie waarbij er gewerkt kan worden met onze open API gegevens en waarbij kennis van programmeertaal vereist is. 
 
Event tracking is een flexibele toepassing dat je in staat stelt data te verzamelen over het gedrag van je contacten; in de breedste zin van het woord. Je kunt een event creëren voor iedere activiteit op je website of app en hier een waarde achter hangen. Als je begint met het verzamelen van event data en dit naar je MailBlue account stuurt, kun je dit gebruiken om je marketing- en salesprocessen te verbeteren evenals dat je het in kunt zetten om automatiseringen te triggeren, condities te bepalen in je segmentaties en er campagnes mee kunt personaliseren.
 
Event tracking vs. Site tracking

Event tracking is flexibel en stelt je in staat om elk virtueel gedrag van je contacten op je website te volgen. Zo kun je bijvoorbeeld videoweergaven volgen, kliks op buttons, geplaatste orders, log ins, gedrag binnen een app en nog veel meer. Met event tracking dien je een customized code te creëren voor iedere gebeurtenis (event) die je wilt volgen op je website.

Site tracking is een type event tracking. Het volgt simpelweg enkel de webpagina bezoeken van je contacten. We bieden je bij site tracking een code aan die je kunt plaatsen op iedere pagina op je site. Als je enkel je paginabezoeken wilt kunnen volgen, raden we je aan om voor site tracking te kiezen. Hoe je dit toevoegt op je site, lees je hier.


Hoe Event tracking werkt

Het beheersen van programmeertaal is vereist om te kunnen werken met Event tracking. Indien je zelf hier geen kennis van hebt, zou je kunnen werken met iemand binnen je team die over deze kennis beschikt of iemand in kunnen huren met deze kennis om dit voor je op te zetten. Het team van MailBlue beschikt zelf niet over deze kennis.

Om Event Tracking te gebruiken, dien je:
1. Event tracking aan te zetten in je MailBlue account (hieronder meer toelichting)
2. Een programmeertaal naar keuze te kiezen op je site om de volgende vier datapunten vast te kunnen leggen: wie (e-mailadres contact) voerde de gebeurtenis/het event (door jezelf gedefinieerd) uit, bestaand uit welke waarde (door jezelf gedefinieerd) en wanneer dit is gebeurd.
3. Gebruik de open API gegevens om de data van de gebeurtenissen naar MailBlue te sturen

Hoe je Event tracking aan zet

1. Klik linksonder in het hoofdmenu van MailBlue op 'Instellingen' en klik op de rode toggle bij Event tracking om Event tracking in te schakelen:

mceclip0.png

2. De eventsleutel zal verschijnen in het veld wat in onderstaande printscreen rood doorstreept is. Deze sleutel dien je door te geven als je de API aanroept om MailBlue de event data die je vastlegt op je site door te kunnen geven. Om de eventsleutel te zien in een voorbeeldcode klik je op de 'Event tracking api' link (meer informatie hieronder).

Events worden zichtbaar in de box zoals in onderstaand screenshot onder 'Evenement', evenals dat ze in de conditiebouwer verschijnen zodra contacten de betreffende gebeurtenis voltooien.

mceclip3.png

 

Event tracking voorbeeldcode

De code die je gebruikt zal variëren afhankelijk van verschillende factoren, zoals de soort gebeurtenis die je wilt volgen. Je kunt een voorbeeldcode genereren om te gebruiken als startpunt. Een voorbeeldcode genereren doe je door op 'Event tracking api' link te klikken zoals in bovenstaand screenshot. Er opent zich dan een nieuw venster waarbinnen een code gecreëerd is die het account ID en sleutel bevatten (rood doorstreept in onderstaand screenshot):
mceclip4.png

Een gebeurtenis/event kan getriggert worden door 'POST to send' data te sturen naar http://trackcmp.net/event. Dit kan in iedere programmeertaal gedaan worden. Hieronder een voorbeeld hoe dit gedaan kan worden met gebruik van PHP:

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://trackcmp.net/event");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, array(
"actid" => 23033,
"key" => "c12973b078007927842301eff932e7d78b74b3e",
"event" => "YOUR_EVENT",
"eventdata" => "ANY_DATA",
"visit" => json_encode(array(
// If you have an email address, assign it here.
"email" => "",
)),
));

$result = curl_exec($curl);
if ($result !== false) {
$result = json_decode($result);
if ($result->success) {
echo 'Success! ';
} else {
echo 'Error! ';
}

echo $result->message;
} else {
echo 'CURL failed to run: ', curl_error($curl);
}

 

Event tracking met de PHP API wrapper

Event tracking met de PHP API wrapper is één van de vele manieren waarop je event tracking data kunt sturen naar je MailBlue account. Als je eenmaal de code op je site geplaatst hebt om gebeurtenissen te kunnen definiëren en volgen, kun je de wrapper gebruiken om deze data naar MailBlue te versturen. Een API wrapper maakt het gemakkelijker om event data te versturen naar je account; wrappers kunnen met API connecties en specifieke API aanroepen als zijnde simpele functies omgaan.  Dit scheelt je tijd gezien je zelf geen API connectie en specifieke API aanroepingen van 'scratch' af aan hoeft te schrijven. 

1. Eerst dien je de API gegevens te definiëren: 

define("ACTIVECAMPAIGN_URL", "https://ACCOUNT.api-us1.com");define
("ACTIVECAMPAIGN_API_KEY", "3693354bb1...04c2d126b9c");require_once
("../activecampaign-api-php/includes/ActiveCampaign.class.php");$ac =
new ActiveCampaign(ACTIVECAMPAIGN_URL, ACTIVECAMPAIGN_API_KEY);

2. Dan zet je de tracking details op:

$ac->track_actid = "764325673";$ac->track_key = "oy5tbe34c564...
69079d18abc";

Het account ID en de tracksleutel vind je in MailBlue onder 'Instellingen' > 'Tracking'. Klik op die pagina op de link achter de tekst 'Event tracking api'. 

Als je een e-mailadres wilt associeren met de gebeurtenis, voeg je dit als volgt toe:
$ac->track_email = "test@test.com";
Indien je hier niet met een e-mailadres associeert, zal het event nog steeds toegevoegd worden en beschikbaar zijn om op basis hiervan segmentaties te kunnen gaan maken in MailBlue.

3. Vervolgens stel je je event data in en dien je het verzoek in:

$post_data = array("event" => "event_name1", // "event_name2", etc.
"eventdata" => "event_value",);$response = $ac->api("tracking/log",
$post_data);

De response zal er ongeveer zo uit zien:

stdClass Object([success] => 1[message] => Event spawned[http_code]
=> 200)

Nu zal de data van de events verschijnen onder 'recente activiteiten' bij de contactinformatie van een contact in MailBlue én je kunt de data gebruiken om binnen MailBlue segmenten te creëren.



Was dit artikel nuttig?
Aantal gebruikers dat dit nuttig vond: 0 van 0