api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/countriesPobiera dane analityczne według kraju.
Bearer Token (token obszaru roboczego lub klucz API witryny)
Tokeny obszaru roboczego wymagają wskazania witryny
Tokeny API obszaru roboczego mają dostęp do wszystkich witryn w obszarze. Należy przekazaćwebsiteId lub domain, aby Flowsery wiedziało, której witryny dotyczy zapytanie lub zmiana. Klucze API witryn są już przypisane do jednej witryny, więc można to pominąć.Wskazanie witryny
| Parametr | Typ | Opis |
|---|---|---|
websiteId | string | ID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
domain | string | Domena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
startAt | string | Data i godzina początku w ISO 8601 (np. 2024-01-01T00:00:00Z). Po pominięciu: ostatnie 30 dni. |
endAt | string | Data i godzina końca w ISO 8601. Po pominięciu: teraz. |
timezone | string | Strefa czasowa agregacji (np. UTC, America/New_York). Domyślnie strefa skonfigurowana dla witryny. |
limit | number | Maksymalna liczba zwracanych wierszy (1-1000, domyślnie: 100). |
offset | number | Liczba wierszy do pominięcia przy paginacji (min. 0, domyślnie: 0). |
Parametry filtrowania
| Parametr | Typ | Opis |
|---|---|---|
filter_country | string | Nazwa kraju zwracana przez /countries, np. United States. | rozdziela kilka wartości, ! wyklucza, a ~ dopasowuje fragment wartości. |
filter_region | string | Nazwa regionu lub stanu zwracana przez /regions, np. California. |
filter_city | string | Nazwa miasta. |
filter_device | string | Typ urządzenia: Desktop, Mobile lub Tablet. Wielkość liter ma znaczenie. |
filter_browser | string | Nazwa przeglądarki. Safari automatycznie obejmuje Mobile Safari. |
filter_os | string | System operacyjny (Mac OS, Windows, iOS, Android). |
filter_referrer | string | Źródło odesłania zwracane przez /referrers: nazwa źródła, np. Google, dla rozpoznanych witryn, a w pozostałych przypadkach domena. |
filter_ref | string | Wartość parametru URL ref. |
filter_source | string | Wartość parametru URL source. |
filter_via | string | Wartość parametru URL via. |
filter_utm_source | string | Źródło UTM. |
filter_utm_medium | string | Medium UTM. |
filter_utm_campaign | string | Kampania UTM. |
filter_utm_term | string | Termin UTM. |
filter_utm_content | string | Treść UTM. |
filter_page | string | Ścieżka lub adres URL strony. |
filter_entry_page | string | Ścieżka lub adres URL strony wejścia. |
filter_hostname | string | Host/domena. |
filter_channel | string | Kanał marketingowy. |
filter_goal | string | Nazwa celu. |
Pola odpowiedzi
Każdy element tablicy data zawiera nazwę kraju jako value, kod ISO 3166-1 alpha-2 countryCode, liczbę odwiedzających, przychód podzielony na newRevenue i renewalRevenue oraz udział w odwiedzających jako percentage.
Łączenie filtrów
Kilka wartości w jednym parametrze filtra rozdziela się znakiem |. Połączenie różnych parametrów filtrów dodatkowo zawęża wyniki (np.filter_country=United States|Canada&filter_device=Mobile).Przykładowe żądanie (Curl)
curl --request GET \
--url 'https://analytics.flowsery.com/analytics/api/v1/countries?limit=5' \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": [
{
"value": "United States",
"countryCode": "US",
"visitors": 2840,
"revenue": 6780,
"newRevenue": 5040,
"renewalRevenue": 1740,
"percentage": 44.1
},
{
"value": "France",
"countryCode": "FR",
"visitors": 1230,
"revenue": 2450,
"newRevenue": 1920,
"renewalRevenue": 530,
"percentage": 19.1
},
{
"value": "United Kingdom",
"countryCode": "GB",
"visitors": 920,
"revenue": 1450,
"newRevenue": 1130,
"renewalRevenue": 320,
"percentage": 14.3
},
{
"value": "Germany",
"countryCode": "DE",
"visitors": 780,
"revenue": 1230,
"newRevenue": 1020,
"renewalRevenue": 210,
"percentage": 12.1
},
{
"value": "Spain",
"countryCode": "ES",
"visitors": 650,
"revenue": 980,
"newRevenue": 840,
"renewalRevenue": 140,
"percentage": 10.1
}
],
"pagination": {
"limit": 5,
"offset": 0,
"total": 148
}
}