Adicionando a fonte de dados
Adicionando o conector
Baseado na documentação da API do Zeeng
Requisitos
- Não há menção de restrição de nível de acesso ou tipo de conta por parte da documentação do conector
Instruções
1) Envie um e-mail ao contato da Zeeng solicitando a sua chave de API para integração pela Kondado
2) Faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector da Zeeng
3) No conector, em "Nome" dê um nome para o seu conector e, em Chave cole o valor obtido no passo (1)
Agora basta clicar em SALVAR para começar a receber dados do Zeeng no Data Warehouse ou Data Lake
Pipelines
Resumo
Diagrama de relacionamento
Clique para expandir
Empresas
Tipo de replicacao: Integral
[pt] Cadastro das empresas/perfis monitorados na plataforma. Cada linha representa uma empresa monitorada com seus dados básicos.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
timestamp |
[pt] Data e hora em que a empresa/perfil foi cadastrado para monitoramento na plataforma. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
text |
[pt] Setor ou segmento de atuação atribuído à empresa monitorada. |
Métricas de Facebook
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
[pt] Métricas diárias agregadas do Facebook por empresa monitorada (seguidores, interações, reações por tipo, comentários, compartilhamentos e número de publicações). Uma linha por empresa por dia.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data de referência (dia) à qual as métricas agregadas do registro correspondem. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
float |
[pt] Número total de comentários recebidos pelos posts do perfil no período. |
|
|
float |
[pt] Número total de compartilhamentos dos posts do perfil no período. |
|
|
float |
[pt] Número total de interações (soma de reações/curtidas, comentários, compartilhamentos e demais engajamentos) dos posts do perfil no período. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Percentual das interações do período que correspondem a comentários. |
|
|
float |
[pt] Percentual das interações do período que correspondem a compartilhamentos. |
|
|
float |
[pt] Percentual das interações do período que correspondem a curtidas/reações. |
|
|
float |
[pt] Número de publicações feitas pelo perfil no período. |
|
|
float |
[pt] Número total de reações recebidas pelos posts do perfil no período. |
|
|
float |
[pt] Número de reações do tipo "Grr" (raiva) recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Haha" recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Curtir" recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Amei" recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Triste" recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Força/Gratidão" recebidas pelos posts no período. |
|
|
float |
[pt] Número de reações do tipo "Uau" recebidas pelos posts no período. |
|
|
float |
[pt] Número total de seguidores do perfil na rede social na data de referência. |
Métricas de Instagram
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
[pt] Métricas diárias agregadas do Instagram por empresa monitorada (seguidores, interações, curtidas, comentários e número de publicações). Uma linha por empresa por dia.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data de referência (dia) à qual as métricas agregadas do registro correspondem. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
float |
[pt] Número total de comentários recebidos pelos posts do perfil no período. |
|
|
float |
[pt] Número total de curtidas recebidas pelos posts do perfil no período. |
|
|
float |
[pt] Número total de interações (soma de reações/curtidas, comentários, compartilhamentos e demais engajamentos) dos posts do perfil no período. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Percentual das interações do período que correspondem a comentários. |
|
|
float |
[pt] Percentual das interações do período que correspondem a curtidas. |
|
|
float |
[pt] Número de publicações feitas pelo perfil no período. |
|
|
float |
[pt] Número total de seguidores do perfil na rede social na data de referência. |
Métricas de Notícias
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
[pt] Contagem diária de notícias/menções por empresa monitorada. Uma linha por empresa por dia.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data de referência (dia) à qual as métricas agregadas do registro correspondem. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Número total de notícias/menções da empresa monitorada na data de referência. |
Métricas de Twitter
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
[pt] Métricas diárias agregadas do Twitter/X por empresa monitorada (seguidores, tweets, curtidas, retweets e interações). Uma linha por empresa por dia.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data de referência (dia) à qual as métricas agregadas do registro correspondem. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
float |
[pt] Número de tweets publicados pelo perfil no período. |
|
|
float |
[pt] Número total de curtidas recebidas pelos tweets do perfil no período. |
|
|
float |
[pt] Número total de interações (soma de reações/curtidas, comentários, compartilhamentos e demais engajamentos) dos posts do perfil no período. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Número total de retweets recebidos pelos tweets do perfil no período. |
|
|
float |
[pt] Número total de seguidores do perfil na rede social na data de referência. |
Métricas de Youtube
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
[pt] Métricas diárias agregadas do YouTube por canal monitorado (visualizações, vídeos publicados, curtidas, descurtidas, comentários e interações). Uma linha por empresa por dia.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data de referência (dia) à qual as métricas agregadas do registro correspondem. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Número total de visualizações dos vídeos do canal no período. |
|
|
float |
[pt] Número total de inscritos do canal no período. |
|
|
float |
[pt] Crescimento do número de inscritos do canal no período (variação de inscritos). |
|
|
float |
[pt] Número de vídeos publicados pelo canal no período. |
|
|
float |
[pt] Número total de curtidas (likes) recebidas pelos vídeos do canal no período. |
|
|
float |
[pt] Número total de descurtidas (dislikes) recebidas pelos vídeos do canal no período. |
|
|
float |
[pt] Número total de comentários recebidos pelos vídeos do canal no período. |
|
|
float |
[pt] Percentual das interações do período que correspondem a curtidas (likes). |
|
|
float |
[pt] Percentual das interações do período que correspondem a descurtidas (dislikes). |
|
|
float |
[pt] Percentual das interações do período que correspondem a comentários. |
|
|
float |
[pt] Número total de interações (soma de reações/curtidas, comentários, compartilhamentos e demais engajamentos) dos posts do perfil no período. |
Notícias
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
Objeto principal
[pt] Notícias/menções individuais das empresas monitoradas, com título, fonte, link e data de publicação. Uma linha por notícia.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela plataforma, da notícia/menção. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] Título da notícia. |
|
|
text |
[pt] Subtítulo ou linha de apoio da notícia. |
|
|
text |
[pt] URL da notícia na fonte original. |
|
|
text |
[pt] Nome do veículo/fonte que publicou a notícia. |
|
|
text |
[pt] URL do veículo/fonte que publicou a notícia. |
|
|
timestamp |
[pt] Data de publicação da notícia. |
zeeng_facebook_noticias__Tags
[pt] Tags/categorias aplicadas a cada notícia. Tabela filha de zeeng_noticias, relacionada por idnoticia; uma linha por tag associada à notícia.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da notícia à qual esta tag está associada (chave de relação com a tabela pai de notícias). |
|
|
text |
[pt] Caminho hierárquico completo da tag/categoria aplicada (incluindo as tags pai), conforme a árvore de classificação da plataforma. |
|
|
text |
[pt] Cor (em hexadecimal) associada à tag para exibição visual. |
|
|
text |
[pt] Identificador único da tag/categoria aplicada. |
|
|
text |
[pt] Nome da tag/categoria aplicada ao registro. |
Posts de Facebook
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
Objeto principal
[pt] Publicações de maior destaque (top posts) do Facebook por empresa monitorada, com texto, data, métricas de engajamento e posição no ranking. Uma linha por publicação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela rede social/plataforma, da publicação. |
|
|
float |
[pt] Número de comentários recebidos pela publicação. |
|
|
float |
[pt] Número de compartilhamentos da publicação. |
|
|
float |
[pt] Número de curtidas/reações recebidas pela publicação. |
|
|
timestamp |
[pt] Data e hora de publicação do post. |
|
|
float |
[pt] Indicador de engajamento da publicação, refletindo o volume de interações em relação ao alcance/seguidores. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] URL da imagem ou miniatura associada à publicação. |
|
|
float |
[pt] Número total de interações registradas na publicação (soma de curtidas/reações, comentários, compartilhamentos e demais engajamentos). |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
boolean |
[pt] Indica se a publicação é patrocinada (impulsionada/anúncio) ou orgânica. |
|
|
float |
[pt] Percentual de destaque da publicação, indicando sua relevância relativa entre as publicações analisadas no período. |
|
|
float |
[pt] Posição (ranking) da publicação na lista de posts de maior destaque do período. |
|
|
text |
[pt] Texto/legenda da publicação. |
zeeng_facebook_posts__Tags
[pt] Tags/categorias aplicadas a cada publicação do Facebook. Tabela filha de zeeng_facebook_posts, relacionada por idpost; uma linha por tag associada à publicação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da publicação à qual esta tag está associada (chave de relação com a tabela pai de publicações). |
|
|
text |
[pt] Caminho hierárquico completo da tag/categoria aplicada (incluindo as tags pai), conforme a árvore de classificação da plataforma. |
|
|
text |
[pt] Cor (em hexadecimal) associada à tag para exibição visual. |
|
|
text |
[pt] Identificador único da tag/categoria aplicada. |
|
|
text |
[pt] Nome da tag/categoria aplicada ao registro. |
Posts de Instagram
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
Objeto principal
[pt] Publicações de maior destaque (top posts) do Instagram por empresa monitorada, com texto, data, métricas de engajamento e posição no ranking. Uma linha por publicação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela rede social/plataforma, da publicação. |
|
|
float |
[pt] Número de comentários recebidos pela publicação. |
|
|
float |
[pt] Número de curtidas recebidas pela publicação. |
|
|
timestamp |
[pt] Data e hora de publicação do post. |
|
|
float |
[pt] Indicador de engajamento da publicação, refletindo o volume de interações em relação ao alcance/seguidores. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] URL da imagem ou miniatura associada à publicação. |
|
|
float |
[pt] Número total de interações registradas na publicação (soma de curtidas/reações, comentários, compartilhamentos e demais engajamentos). |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Percentual de destaque da publicação, indicando sua relevância relativa entre as publicações analisadas no período. |
|
|
float |
[pt] Posição (ranking) da publicação na lista de posts de maior destaque do período. |
|
|
text |
[pt] Texto/legenda da publicação. |
zeeng_instagram_posts__Tags
[pt] Tags/categorias aplicadas a cada publicação do Instagram. Tabela filha de zeeng_instagram_posts, relacionada por idpost; uma linha por tag associada à publicação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da publicação à qual esta tag está associada (chave de relação com a tabela pai de publicações). |
|
|
text |
[pt] Caminho hierárquico completo da tag/categoria aplicada (incluindo as tags pai), conforme a árvore de classificação da plataforma. |
|
|
text |
[pt] Cor (em hexadecimal) associada à tag para exibição visual. |
|
|
text |
[pt] Identificador único da tag/categoria aplicada. |
|
|
text |
[pt] Nome da tag/categoria aplicada ao registro. |
Posts de Twitter
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
Objeto principal
[pt] Tweets de maior destaque (top posts) do Twitter/X por empresa monitorada, com texto, data, métricas de engajamento e posição no ranking. Uma linha por tweet.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela rede social/plataforma, da publicação. |
|
|
float |
[pt] Número de curtidas recebidas pelo tweet. |
|
|
timestamp |
[pt] Data e hora de publicação do tweet. |
|
|
float |
[pt] Indicador de engajamento da publicação, refletindo o volume de interações em relação ao alcance/seguidores. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] URL da imagem ou miniatura associada à publicação. |
|
|
float |
[pt] Número total de interações registradas na publicação (soma de curtidas/reações, comentários, compartilhamentos e demais engajamentos). |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
float |
[pt] Percentual de destaque da publicação, indicando sua relevância relativa entre as publicações analisadas no período. |
|
|
float |
[pt] Posição (ranking) da publicação na lista de posts de maior destaque do período. |
|
|
text |
[pt] Texto do tweet. |
zeeng_twitter_posts__Tags
[pt] Tags/categorias aplicadas a cada tweet. Tabela filha de zeeng_twitter_posts, relacionada por idpost; uma linha por tag associada ao tweet.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da publicação à qual esta tag está associada (chave de relação com a tabela pai de publicações). |
|
|
text |
[pt] Caminho hierárquico completo da tag/categoria aplicada (incluindo as tags pai), conforme a árvore de classificação da plataforma. |
|
|
text |
[pt] Cor (em hexadecimal) associada à tag para exibição visual. |
|
|
text |
[pt] Identificador único da tag/categoria aplicada. |
|
|
text |
[pt] Nome da tag/categoria aplicada ao registro. |
Vídeos de Youtube
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
Relacionamentos:
Objeto principal
[pt] Vídeos de maior destaque (top videos) do YouTube por canal monitorado, com título, data, métricas de engajamento e posição no ranking. Uma linha por vídeo.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único, atribuído pela plataforma, do vídeo. |
|
|
timestamp |
[pt] Data e hora de publicação do vídeo. |
|
|
text |
[pt] Identificador único, atribuído pela plataforma, da empresa/perfil monitorado ao qual o registro pertence. |
|
|
text |
[pt] Nome da empresa/perfil monitorado ao qual o registro se refere. |
|
|
text |
[pt] Título/descrição do vídeo. |
|
|
text |
[pt] URL da miniatura (thumbnail) do vídeo. |
|
|
float |
[pt] Indicador de engajamento da publicação, refletindo o volume de interações em relação ao alcance/seguidores. |
|
|
float |
[pt] Número total de interações registradas na publicação (soma de curtidas/reações, comentários, compartilhamentos e demais engajamentos). |
|
|
float |
[pt] Percentual de destaque da publicação, indicando sua relevância relativa entre as publicações analisadas no período. |
|
|
float |
[pt] Posição (ranking) da publicação na lista de posts de maior destaque do período. |
|
|
float |
[pt] Número de curtidas (likes) recebidas pelo vídeo. |
|
|
float |
[pt] Número de descurtidas (dislikes) recebidas pelo vídeo. |
|
|
float |
[pt] Número de comentários recebidos pelo vídeo. |
|
|
float |
[pt] Número de visualizações do vídeo. |
zeeng_youtube_vides__Tags
[pt] Tags/categorias aplicadas a cada vídeo do YouTube. Tabela filha de zeeng_youtube_videos, relacionada por idpost; uma linha por tag associada ao vídeo.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da publicação à qual esta tag está associada (chave de relação com a tabela pai de publicações). |
|
|
text |
[pt] Caminho hierárquico completo da tag/categoria aplicada (incluindo as tags pai), conforme a árvore de classificação da plataforma. |
|
|
text |
[pt] Cor (em hexadecimal) associada à tag para exibição visual. |
|
|
text |
[pt] Identificador único da tag/categoria aplicada. |
|
|
text |
[pt] Nome da tag/categoria aplicada ao registro. |
Notas
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas
Integrar dados do Zeeng na Kondado
Configure o conector Zeeng na Kondado para enviar métricas de redes sociais e notícias ao seu Data Warehouse ou Data Lake.
Solicitar chave de API ao Zeeng
Envie um email para contato@zeeng.com.br solicitando sua chave de acesso à API. Não há restrições de nível de conta ou tipo de acesso na documentação do conector.
Adicionar o conector na Kondado
Faça login na Kondado, vá para a seção de conectores e selecione o conector da Zeeng. Dê um nome ao conector e cole a chave obtida no campo correspondente.
Salvar e ativar a integração
Clique em SALVAR para começar a receber dados do Zeeng no seu Data Warehouse ou Data Lake. Os dados incluem métricas de Facebook, Instagram, Twitter, YouTube e notícias.
Explorar as tabelas disponíveis
Após a ativação, você terá acesso a tabelas como Empresas, Métricas e Posts de Facebook, Instagram, Twitter, YouTube, além de Métricas de Notícias e Vídeos do YouTube com seus respectivos campos e tipos.
Visualizar os dados integrados
Com os dados no destino, utilize ferramentas de visualização para criar dashboards e analisar o desempenho das redes sociais e monitoramento de notícias.
