Obter análises de referência

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/referrers

Recupere dados analiticos segmentados por fonte de referencia.

Token Bearer (token de workspace ou chave API de website)

Os tokens do espaço de trabalho precisam de um seletor de site

Os tokens da API do Workspace podem acessar todos os sites do workspace. Passe <code>websiteId</code> ou <code>domain</code> para que Flowsery saiba qual site consultar ou alterar. As chaves da API do site já têm como escopo um site, portanto o seletor pode ser omitido.

Seletor de site

Parametro	Tipo	Descricao
`websiteId`	`string`	ID do site a ser usado com um token de API do workspace. Omitir ao autenticar com uma chave de API de site.
`domain`	`string`	Site domain para usar com um token de API do espaço de trabalho quando websiteId não for fornecido. Omitir ao autenticar com uma chave de API de site.

Parametros opcionais

Parametro	Tipo	Descricao
`startAt`	`string`	Data/hora de início da ISO 8601. A norma são os últimos 30 dias quando omitido.
`endAt`	`string`	Data/hora de término da ISO 8601. O padrão é agora quando omitido.
`timezone`	`string`	Fuso horario para agregacao (por ex., UTC, America/New_York). Recorre ao fuso horario configurado do seu site.
`limit`	`number`	Numero maximo de linhas a retornar (1-1000, padrao: 100).
`offset`	`number`	Linhas a pular para paginacao (min 0, padrao: 0).

Parametros de filtro

Parametro	Tipo	Descricao
`filter_country`	`string`	Nome ou indicativo do país. Usar \| para vários valores e! para eliminar valores.
`filter_region`	`string`	Regiao ou estado.
`filter_city`	`string`	Nome da cidade.
`filter_device`	`string`	Tipo de dispositivo. Utilize valores de back-end como Desktop\|Mobile\|Tablet e! para excluir.
`filter_browser`	`string`	Nome do navegador. Safari inclui automaticamente Mobile Safari.
`filter_os`	`string`	Sistema operacional.
`filter_referrer`	`string`	Dominio de referencia ou nome conhecido.
`filter_ref`	`string`	Parametro URL ref.
`filter_source`	`string`	Parametro URL source.
`filter_via`	`string`	Parametro URL via.
`filter_utm_source`	`string`	Fonte UTM.
`filter_utm_medium`	`string`	Meio UTM.
`filter_utm_campaign`	`string`	Campanha UTM.
`filter_utm_term`	`string`	Termo UTM.
`filter_utm_content`	`string`	Conteudo UTM.
`filter_page`	`string`	Caminho da pagina.
`filter_entry_page`	`string`	Caminho da pagina de entrada.
`filter_hostname`	`string`	Hostname/dominio.
`filter_channel`	`string`	Canal de marketing.
`filter_goal`	`string`	Nome do objetivo.

Exemplo de requisicao (curl)

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/referrers \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": [
    {
      "value": "x.com",
      "visitors": 3450,
      "revenue": 1240,
      "renewalRevenue": 120,
      "percentage": 29.2,
      "iconUrl": "https://icons.duckduckgo.com/ip3/x.com.ico"
    },
    {
      "value": "Direct/None",
      "visitors": 2890,
      "revenue": 4560,
      "renewalRevenue": 910,
      "percentage": 24.4,
      "iconUrl": null
    },
    {
      "value": "example.com",
      "visitors": 2150,
      "revenue": 2890,
      "renewalRevenue": 610,
      "percentage": 18.2,
      "iconUrl": "https://icons.duckduckgo.com/ip3/example.com.ico"
    },
    {
      "value": "google.com",
      "visitors": 1840,
      "revenue": 6780,
      "renewalRevenue": 1700,
      "percentage": 15.6,
      "iconUrl": "https://icons.duckduckgo.com/ip3/google.com.ico"
    },
    {
      "value": "newsletter.example.com",
      "visitors": 1230,
      "revenue": 2150,
      "renewalRevenue": 430,
      "percentage": 10.4,
      "iconUrl": "https://icons.duckduckgo.com/ip3/newsletter.example.com.ico"
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 119
  }
}