Mixpanel

# Funcionalidades

| Funcionalidade                 | Suportado | Notas                                                                                                      |
| :----------------------------- | :-------- | :--------------------------------------------------------------------------------------------------------- |
| Definir frequência da pipeline | Sim       | Para mais detalhes, [acesse](https://docs.dadosfera.ai/docs/frequ%C3%AAncia-da-pipeline-1).                |
| Sincronização Full load        | Sim       | Consulte as tabelas                                                                                        |
| Sincronização Incremental      | Sim       | Consulte as tabelas                                                                                        |
| Conexão via API Secret         | Sim       | Encontre sua API Secret [aqui](https://help.mixpanel.com/hc/en-us/articles/115004490503-Project-Settings). |

> 📘 Este conector coleta as seguintes objetos do Mixpanel:
> 
> - [Export (Events)](https://data.mixpanel.com/api/2.0/export)
> - [Engage (People/Users)](https://mixpanel.com/api/2.0/engage)
> - [Funnels](https://mixpanel.com/api/2.0/funnels)
> - [Annotations](https://mixpanel.com/api/2.0/annotations)
> - [Cohorts](https://mixpanel.com/api/2.0/cohorts/list)
> - [Cohort Members](https://mixpanel.com/api/2.0/cohorts/list)
> - [Revenue](https://mixpanel.com/api/2.0/engage/revenue)

# Guia rápido

Para iniciar a criação de uma Pipeline, basta ir no módulo **Coletar**, **"Pipelines"** aperte em **"Nova Pipeline"**.

## Escolha a fonte de dados

###### Utilize uma fonte já cadastrada ou cadastre uma nova

## Parâmetros para conexão (cadastro da fonte)

[block:parameters]
{
  "data": {
    "h-0": "Nome do campo",
    "h-1": "Descrição",
    "h-2": "Exemplo",
    "0-0": "API Secret",
    "0-1": "Para gerar um token de acesso a API, você deve ser um administrador e o acesso ao token de acesso a API deve estar ativado.  \n  \nEncontre sua API Secret [aqui](https://help.mixpanel.com/hc/en-us/articles/115004490503-Project-Settings).",
    "0-2": "4b13fbaaaeb8cc4d4671cc827d9f04aa"
  },
  "cols": 3,
  "rows": 1,
  "align": [
    "left",
    "left",
    "left"
  ]
}
[/block]

## Informações da pipeline

###### Atribua o nome e uma breve descrição para sua Pipeline.

## Parâmetros para configurações da pipeline

| Nome do campo                      | Descrição                                                                                                                                                                 | Exemplo           |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------- |
| Timezone do projeto                | Encontre a Timezone do seu projeto [aqui](https://help.mixpanel.com/hc/en-us/articles/115004490503-Project-Settings).                                                     | America/Sao_Paulo |
| Data de início                     | Determina quantos dados históricos serão extraídos.                                                                                                                       | dd/mm/aaaa        |
| Dados hospedados na União Europeia | Selecione caso seus dados. Verifique essa informação [aqui](Encontre sua API Secret [aqui](https://help.mixpanel.com/hc/en-us/articles/115004490503-Project-Settings).). |                   |

Clique em **"Salvar e Continuar"**.

## Especificar os objetos

Sincronização disponível para cada objeto:

- `export`
  - Replication strategy: INCREMENTAL | FULL_TABLE
- `engage`
  - Replication strategy: FULL_TABLE
- `funnels`
  - Replication strategy: INCREMENTAL | FULL_TABLE
- `revenue`
  - Replication strategy: INCREMENTAL | FULL_TABLE
- `annotations`
  - Replication strategy: FULL_TABLE
- `cohorts`
  - Replication strategy: FULL_TABLE
- `cohort_members`
  - Replication strategy: FULL_TABLE

Após inserir as credenciais você estará apto a selecionar quais tabelas da fonte conectada serão importados na coleta de dados.

> 📘 
> 
> Ao selecionar mais de uma entidade, para cada tabela ou view importada será criado um dataset diferente no catálogo.

## Frequência

- Por último, configure a frequência desejada para que sua pipeline rode. É possível escolher dentre as opções apresentadas ou inserir uma frequência customizada através de uma expressão cron. Para saber mais, [acesse](https://docs.dadosfera.ai/docs/frequ%C3%AAncia-da-pipeline-1). 

> 📘 
> 
> - O fuso horário padrão utilizado na frequência é o UTC.
> 
> - Todos os métodos de frequência definem quando as extrações serão iniciadas. Eles não controlam por quanto tempo o trabalho de replicação será executado ou quando os dados estarão efetivamente no destino.

Pronto! Agora basta aguardar a coleta ser feita no horário e dia agendado.

Caso queira executar a pipeline imediatamente, é possível executá-la manualmente em até 30 segundos após a criação da pipeline. Vá em "Pipelines", **"Lista"** e **"Sincronizar Pipeline"**.

Após alguns minutos, sua pipeline estará catalogada na aba de exploração como um Data Asset.

É possível também consultar na lista de pipelines os detalhes da pipeline, como: resumo, lista de entidades e colunas coletadas, histórico de execução e de micro-transformação, em **"Ver pipeline"**.