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

Pobiera zagregowane wskaźniki analityczne witryny.

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

ParametrTypOpis
websiteIdstringID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny.
domainstringDomena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny.

Parametry zapytania

ParametrTypOpis
startAtstringData i godzina początku w ISO 8601. Po pominięciu: ostatnie 30 dni.
endAtstringData i godzina końca w ISO 8601. Po pominięciu: teraz.
timezonestringIdentyfikator strefy czasowej IANA. Domyślnie strefa skonfigurowana dla witryny.

Parametry filtrowania

ParametrTypOpis
filter_countrystringNazwa kraju zwracana przez /countries, np. United States. | rozdziela kilka wartości, ! wyklucza, a ~ dopasowuje fragment wartości.
filter_regionstringNazwa regionu lub stanu zwracana przez /regions, np. California.
filter_citystringNazwa miasta.
filter_devicestringTyp urządzenia: Desktop, Mobile lub Tablet. Wielkość liter ma znaczenie.
filter_browserstringNazwa przeglądarki (Chrome, Safari, Firefox, Edge). Safari automatycznie obejmuje Mobile Safari.
filter_osstringSystem operacyjny (Mac OS, Windows, iOS, Android).
filter_referrerstringŹródło odesłania zwracane przez /referrers: nazwa źródła, np. Google, dla rozpoznanych witryn, a w pozostałych przypadkach domena.
filter_refstringWartość parametru URL ref.
filter_sourcestringWartość parametru URL source.
filter_viastringWartość parametru URL via.
filter_utm_sourcestringŹródło UTM.
filter_utm_mediumstringMedium UTM.
filter_utm_campaignstringKampania UTM.
filter_utm_termstringTermin UTM.
filter_utm_contentstringTreść UTM.
filter_pagestringŚcieżka lub adres URL strony.
filter_entry_pagestringŚcieżka lub adres URL strony wejścia.
filter_hostnamestringHost/domena.
filter_channelstringKanał marketingowy.
filter_goalstringNazwa celu.

Uwagi

Bez zakresu dat API domyślnie zwraca ostatnie 30 dni do teraz. bounceRate i conversionRate to wartości procentowe, a avgSessionDuration i avgEngagedTime są w sekundach. Wartości filtrów przyjmują | dla kilku wartości, ! do wykluczenia i ~ do dopasowania fragmentu wartości.
Przykładowe żądanie (Curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/overview \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "visitors": 12450,
      "sessions": 16890,
      "bounceRate": 65.32,
      "avgSessionDuration": 246,
      "avgEngagedTime": 187,
      "revenue": 28450,
      "renewalRevenue": 6320,
      "refundedRevenue": 410,
      "revenuePerVisitor": 2.29,
      "conversionRate": 1.15,
      "kpiValue": 28450,
      "kpiPerVisitor": 2.29,
      "kpiConversionRate": 1.15,
      "currency": "USD"
    }
  ]
}