api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/devices

Recupera dati di analytics segmentati per tipo di dispositivo.

Bearer token (token del workspace o chiave API del sito)

I token del workspace richiedono un selettore del sito

I token API del workspace possono accedere a tutti i siti del workspace. Passa websiteId o domain perché Flowsery sappia quale sito interrogare o modificare. Le chiavi API del sito sono già limitate a un sito, quindi puoi omettere il selettore.

Selettore del sito

ParametroTipoDescrizione
websiteIdstringID del sito da usare con un token API del workspace. Omettilo se ti autentichi con una chiave API del sito.
domainstringDominio del sito da usare con un token API del workspace quando websiteId non è indicato. Omettilo se ti autentichi con una chiave API del sito.

Parametri facoltativi

ParametroTipoDescrizione
startAtstringData/ora di inizio in formato ISO 8601. Se omessa, vengono usati gli ultimi 30 giorni.
endAtstringData/ora di fine in formato ISO 8601. Se omessa, viene usato il momento attuale.
timezonestringFuso orario per l'aggregazione (ad esempio UTC, America/New_York). Se assente, viene usato il fuso orario configurato per il tuo sito.
limitnumberNumero massimo di righe da restituire (1-1000, predefinito: 100).
offsetnumberRighe da saltare per la paginazione (minimo 0, predefinito: 0).

Parametri di filtro

ParametroTipoDescrizione
filter_countrystringNome del paese come restituito da /countries, ad esempio United States. Usa | per più valori, ! per escludere e ~ per cercare una parte del valore.
filter_regionstringNome della regione o dello stato come restituito da /regions, ad esempio California.
filter_citystringNome della città.
filter_devicestringTipo di dispositivo: Desktop, Mobile o Tablet. I valori distinguono tra maiuscole e minuscole.
filter_browserstringNome del browser. Safari include in automatico Mobile Safari.
filter_osstringSistema operativo.
filter_referrerstringReferrer come restituito da /referrers: un nome di sorgente come Google per i siti riconosciuti, altrimenti il dominio.
filter_refstringIl parametro URL ref.
filter_sourcestringIl parametro URL source.
filter_viastringIl parametro URL via.
filter_utm_sourcestringSorgente UTM.
filter_utm_mediumstringMezzo UTM.
filter_utm_campaignstringCampagna UTM.
filter_utm_termstringTermine UTM.
filter_utm_contentstringContenuto UTM.
filter_pagestringPercorso della pagina.
filter_entry_pagestringPercorso della pagina di ingresso.
filter_hostnamestringHostname/dominio.
filter_channelstringCanale di marketing.
filter_goalstringNome dell'obiettivo.
Esempio di richiesta (curl)
curl --request GET \
  --url 'https://analytics.flowsery.com/analytics/api/v1/devices?limit=10' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "value": "Desktop",
      "visitors": 7892,
      "revenue": 18234,
      "newRevenue": 14114,
      "renewalRevenue": 4120,
      "percentage": 55.3
    },
    {
      "value": "Mobile",
      "visitors": 6124,
      "revenue": 8934,
      "newRevenue": 6554,
      "renewalRevenue": 2380,
      "percentage": 42.9
    },
    {
      "value": "Tablet",
      "visitors": 234,
      "revenue": 567,
      "newRevenue": 567,
      "renewalRevenue": 0,
      "percentage": 1.6
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 3
  }
}