api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/devicesRecupera 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. PassawebsiteId 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
| Parametro | Tipo | Descrizione |
|---|---|---|
websiteId | string | ID del sito da usare con un token API del workspace. Omettilo se ti autentichi con una chiave API del sito. |
domain | string | Dominio 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
| Parametro | Tipo | Descrizione |
|---|---|---|
startAt | string | Data/ora di inizio in formato ISO 8601. Se omessa, vengono usati gli ultimi 30 giorni. |
endAt | string | Data/ora di fine in formato ISO 8601. Se omessa, viene usato il momento attuale. |
timezone | string | Fuso orario per l'aggregazione (ad esempio UTC, America/New_York). Se assente, viene usato il fuso orario configurato per il tuo sito. |
limit | number | Numero massimo di righe da restituire (1-1000, predefinito: 100). |
offset | number | Righe da saltare per la paginazione (minimo 0, predefinito: 0). |
Parametri di filtro
| Parametro | Tipo | Descrizione |
|---|---|---|
filter_country | string | Nome del paese come restituito da /countries, ad esempio United States. Usa | per più valori, ! per escludere e ~ per cercare una parte del valore. |
filter_region | string | Nome della regione o dello stato come restituito da /regions, ad esempio California. |
filter_city | string | Nome della città. |
filter_device | string | Tipo di dispositivo: Desktop, Mobile o Tablet. I valori distinguono tra maiuscole e minuscole. |
filter_browser | string | Nome del browser. Safari include in automatico Mobile Safari. |
filter_os | string | Sistema operativo. |
filter_referrer | string | Referrer come restituito da /referrers: un nome di sorgente come Google per i siti riconosciuti, altrimenti il dominio. |
filter_ref | string | Il parametro URL ref. |
filter_source | string | Il parametro URL source. |
filter_via | string | Il parametro URL via. |
filter_utm_source | string | Sorgente UTM. |
filter_utm_medium | string | Mezzo UTM. |
filter_utm_campaign | string | Campagna UTM. |
filter_utm_term | string | Termine UTM. |
filter_utm_content | string | Contenuto UTM. |
filter_page | string | Percorso della pagina. |
filter_entry_page | string | Percorso della pagina di ingresso. |
filter_hostname | string | Hostname/dominio. |
filter_channel | string | Canale di marketing. |
filter_goal | string | Nome 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
}
}