Avanziamo di livello

Quelle che abbiamo visto fin'ora sono le funzionalità più importanti e utili di Pulsing.io, e sono anche molto semplici da implementare nella propria Web-Application!

Ci sono però molte altre Features da scoprire, più o meno ardue da integrare, ma che possono sempre tornare utili ai nostri utilizzatori. Vediamole singolarmente e nel dettaglio.

📘

Moltissime opzioni per moltissime possibilità

Tutte le opzioni attivabili e configurabili per i nostri due Scripts, sono completamente intercambiabili e utilizzabili assieme. Potreste infatti volere attivare la modalità di Debug assieme a quella di Testing. Per farlo, vi basterà utilizzare entrambi gli appositi attributi contemporaneamente.

Attivare il Debug nei nostri Scripts

Vuoi essere certo che i nostri Scripts funzionino al massimo e correttamente sulla tua piattaforma? Il nostro Debug integrato è, allora, ciò che fa per te!

Per attivarlo, non ti basta che aggiungere un semplice attributo all'elemento script a cui è associato il nostro File pulsing.js o pulsing-min.js:

<script id="pulse" type="text/javascript" src="https://api.pulsing.io/media/pulsing-min.js" data-debug="true"></script>

In questo modo, ogni Response verrà stampata sulla Console del tuo Browser preferito, sia in caso di successo, sia in caso di errore. Potrai così conoscere al meglio come reagisce il tuo Web-Site a Pulsing.io e alle sue componenti!

Testare la piattaforma senza contaminare i dati reali

Se una volta integrato tutto il necessario nella tua piattaforma vorresti provare e testare il corretto funzionamento di Pulsing.io, questa sezione fa a caso tuo.

Il nostro servizio, infatti, vi permette di distinguere i dati reali da quelli di testing senza il minimo sforzo, e in questo modo sarete sicuri di non contaminare i dati corretti e attendibili recuperati dai vostri utenti!

Tutto quello che dovete fare per utilizzare dati di testing è:

  • Per i Logs e le Interactions, aggiungete un semplice attributo personalizzato all'elemento script che incapsula il nostro File:
<script id="pulse" type="text/javascript" src="https://api.pulsing.io/media/pulsing-min.js" data-test="true"></script>

In questo modo, ogni visualizzazione (Log) e interazione (Interaction) avvenuta sulle pagine dove il nostro Script possiede quell'impostazione verrà registrata separatamente dal resto come dato di test, e non verrà considerato durante i nostri calcoli sulle statistiche del vostro Web-Site.

  • Per le Emissions, aggiungete un semplice campo al corpo che invierete insieme alla vostra HTTP Request di metodo POST:
curl --request POST \
  --url https://api.pulsing.io/api/emissions \
  --header 'content-type: application/json' \
  --data '{"domain": [DOMAIN], "label": [LABEL], "test": true}'

var request = require("request");

var options = {
  method: 'POST',
  url: 'https://api.pulsing.io/api/emissions',
  headers: {'content-type': 'application/json'},
  body: {
    domain: [DOMAIN], 
    label: [LABEL], 
    test: true
  },
  json: true
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.pulsing.io/api/emissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'

request.body = '{
  "domain": [DOMAIN], 
  "label": [LABEL], 
  "test": true
}'

response = http.request(request)
puts response.read_body

var data = JSON.stringify({
  "domain": [DOMAIN], 
  "label": [LABEL], 
  "test": true
});

var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.pulsing.io/api/emissions");
xhr.setRequestHeader("content-type", "application/json");

xhr.send(data);

import requests

url = "https://api.pulsing.io/api/emissions"

payload = '{
  "domain": [DOMAIN], 
  "label": [LABEL], 
  "test": True
}'

headers = {'content-type': 'application/json'}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Tutto qui! Finchè avrete queste impostazioni configurate, i vostri dati reali non verranno affatto contaminati. Per visualizzare i dati di testing al posto di quelli normali vi basterà selezionare l'apposita impostazione nella Dashboard, oppure utilizzare il corretto Query Parameter con i nostri Endpoints.

Utilizzare i Cookies al posto degli Storage

Come abbiamo visto in precedenza, per memorizzare l'identità dell'utente attualmente autenticato, il nostro Script utilizza la Storage API e il window.localStorage.

Potrebbe essere necessario, però, l'utilizzo di questa funzionalità su Browsers anche molto vecchi, che non supportano la versione minima richiesta per essi.

Per questo, pulsing.js e pulsing-min.js possiedono un opzione adatta a risolvere questo problema. Aggiungendo appunto un semplice attributo all'elemento script contenente il nostro File, potrete infatti utilizzare e memorizzare l'identifier dell'utente all'interno dei Cookies del vostro Browser:

<script id="pulse" type="text/javascript" src="https://api.pulsing.io/media/pulsing-min.js" data-cookie="true"></script>

In questo modo, potrete iniziare il tracciamento di un utente specifico (e anche terminarlo) in questo modo:

document.cookie = "pulse-identifier=[EMAIL]"; // Il metodo più semplice per impostare un Cookie, senza utilizzare un data di Expiring o una Path

document.cookie = new String(); // Il metodo più semplice per pulire tutti i Cookies

Il nostro Script si occuperà in automatico di ottenere l'identificatore dell'utente dalla Location corretta, un gioco da ragazzi!

Cambiare la Location del pulse-identifier

Come abbiamo visto in precedenza, pulse-identifier è la Location di default per l'identificatore dell'utente attualmente autenticato (nel caso di tracciamento di un utente specifico).

Questo nome è però modificabile in maniera molto semplice, permettendovi di sceglierne uno che ritenete più adatto!

Per farlo, vi basta inserire il nuovo nome che desiderate utilizzare come valore di un attributo specifico dei nostri Scripts:

<script id="pulse" type="text/javascript" src="https://api.pulsing.io/media/pulsing-min.js" data-identifier="identifier"></script>

In questo modo, potrete utilizzare quella nuova Location per memorizzare l'identità dei vostri utenti:

window.localStorage.setItem("identifier", [EMAIL]);

// Oppure, nel caso abbiate attivato l'utilizzo dei Cookies

document.cookie = "identifier=[EMAIL]";

Più semplice di così, si muore!