Instagram

Adicionando o conector

Apenas dados orgânicos são retornados neste conector. Para obter dados de anúncios, você deve utilizar o conector do Facebook, que também traz os dados de anúncio do Instagram. Por limitações da API do Instagram utilizada, os dados de métricas podem estar com até 48h de defasagem durante a leitura

Requisitos

Os perfis utilizados devem ter no mínimo 100 seguidores
As contas do instagram a serem integradas devem ser do tipo Business - contas pessoais não serão integradas
Os perfis do instagram devem estar vínculados a uma página do Facebook
O usuário que cadastrar o conector deve ter um papel de Dono, Administrador ou Editor na página do Facebook

Instruções

Após fazer login na Kondado, clique em “Conectores”
Clique em “Novo Conector”
E então na barra de pesquisa de conectores procure pelo conector do Instagram e selecione-o
Dê um nome ao seu conector e clique em "Continue with Facebook"
1. ATENÇÃO: Além de bloqueadores de pop-up, alguns antivirus também podem impedir a exibição do botão “Continue with Facebook”. Então, caso você já esteja utilizando o navegador chrome e com uma janela anônima e o botão ainda não esteja aparecendo, desative o seu antivirus por alguns instantes e recarregue a página para que o botão apareça. Reative o seu antivirus após terminar o processo
Insira as informações de login da conta do Facebook vinculada a conta de Instagram que deseja extrair dados e clique em "Entrar"
1. Caso a sua página do Facebook não esteja vinculada à conta do Instagram, siga este tutorial
2. O usuário do Facebook precisa ter um papel de Dono, Administrador ou Editor para a página do Facebook que está conectada ao instagram
Clique em "Continuar como..."
Caso você tenha mais de uma conta empresarial vinculada ao Facebook, ele solicitará quais contas e páginas você deseja usar com a Kondado. Selecione e clique em "Avançar"
Na página de permissões, deixe todas marcadas como "Sim" e clique em "Concluir
E então clique em "Ok" para voltar à plataforma Kondado
Agora os campos de conta vinculada e data de expiração estarão preenchidos, clique então em "Salvar" para salvar as informações do conector
Agora basta testar a conexão para garantir que os dados de acesso estão todos corretos e que o aplicativo da Kondado consegue se conectar com a fonte. Com a conexão estando operacional, o conector está pronto para ser usado em uma integração

💡Veja aqui o guia das dúvidas mais comuns sobre as integrações do Instagram

Integrações

Gráfico de relacionamento

Clique para ampliar

Estatísticas de audiência

Este objeto traz dados sobre a situação atual dos seguidores (audiência) da sua conta, não guarda histórico

Caso esteja recebendo valores nulos em todas as colunas dessa integração, siga estas instruções para solucionar o problema

Campo	Tipo
kdd_account_id	text	[pt] ID da Kondado para o perfil Perfis > > kdd_account_id
ig_username	text	[pt] Username do perfil Perfis > > ig_username
metric	text	[pt] Categoria da métrica. Várias métricas que se referem a categorias diferentes serão retornadas, então será necessário utilizar esse campo para filtrar o que você deseja - audience_city: cidade da audiência. Neste caso, metric_key virá com as cidades e metric_value com a contagem; audience_country: país dos seguidores. Neste caso, metric_key virá com os países e metric_value com a contagem; audience_gender_age: Grupo gênero+idade. Neste caso, metric_key virá com os o grupo gênero+idade (por exemplo, 'M.35-44' para homens (male) entre 35 e 44 anos) e metric_value com a contagem
metric_key	text	[pt] Grupo ao qual o metric_value se refere, veja o campo 'metric' para mais detalhes
metric_value	float	[pt] Contagem de seguidores referentes a uma metric_key - veja o campo 'metric' para mais detalhes

Estatísticas de mídias

Este objeto irá trazer informações sobre a performance consolidada (período total) das suas mídias

Por limitação do Instagram, mídias com menos de 5 visualizações não serão retornadas
Por limitação do Instagram, stories ficam disponíveis por apenas 24 horas. Isso quer dizer que, caso a execução da sua integração seja realizada durante esse período de disponibilidade, os dados serão integrados e permanecerão no seu destino
Caso nenhuma mídia esteja sendo retornada ou esteja recebendo valores nulos, siga estas instruções para solucionar o problema

Campo	Tipo
media_id	text	[pt] ID da mídia Mídias > > id
kdd_account_id	text	[pt] ID da Kondado para o perfil Perfis > > kdd_account_id
media_type	text	[pt] Tipo da mídia (IMAGE, CAROUSEL_ALBUM, VIDEO, etc)
media_product_type	text	[pt] Superfície onde a mídia é publicada. Pode ser AD, FEED, STORY ou REELS.
ig_is_story	boolean	[pt] Booleano que indica se a mídia é uma story
ig_username	text	[pt] Username do perfil Perfis > > ig_username
story_tap_forward	float	[pt] Número total de taps para ver a próxima foto ou vídeo de uma story
story_tap_back	float	[pt] Número total de taps para ver a foto ou vídeo anterior de uma story
video_views	float	[pt] Número total de vezes que o vídeo foi assistido - exclui atividade patrocinada
story_tap_exit	float	[pt] Número total de vezes que alguém saiu da story
story_swipe_forward	float	[pt] Número total de swipes de uma story
story_replies	float	[pt] Número total de respostas (comentários) na story. O valor não inclui respostas de usuários da European Economic Area (EEA). Se a story foi criada por um usuário na EEA, o valor retornado será zero
impressions	float	[pt] Número total de vezes que a mídia foi visualizada - exclui atividade patrocinada
reach	float	[pt] Número total de contas únicas do instagram que visualizaram a mídia - exclui atividade patrocinada
saved	float	[pt] Número total de contas de instagram únicas que salvaram a mídia - exclui atividade patrocinada
reels_plays	float	[pt] O número de vezes que o seu vídeo começa a ser reproduzido após uma impressão já ter sido contabilizada. Isso será definido como sessões de vídeo com 1 ms ou mais de reprodução e exclui repetições
total_interactions	float	[pt] O número de curtidas, salvamentos, comentários e compartilhamentos menos o número de descurtidas, remoções dos Salvos e comentários excluídos. Se story: número de respostas e compartilhamentos
follows	float	[pt] Número de contas que começaram a seguir o perfil
comments	float	[pt] Número de comentários na publicação
likes	float	[pt] Número de curtidas na publicação
profile_visits	float	[pt] Número de visitas ao perfil
shares	float	[pt] O número de compartilhamentos de sua publicação

Estatísticas diárias de perfil

Este objeto traz dados sobre a performance diária de um dado perfil

Caso esteja recebendo valores nulos em todas as colunas dessa integração, siga estas instruções para solucionar o problema
O instagram disponibiliza apenas dados até 2 anos atrás

Campo	Tipo
kdd_account_id	text	[pt] ID da Kondado para o perfil Perfis > > kdd_account_id
metric_date	date	[pt] Data à qual as métricas se referem
ig_username	text	[pt] Username do perfil Perfis > > ig_username
email_contacts	float	[pt] Número de vezes em que o link de e-mail do perfil foi tocado
follower_count	float	[pt] Número total de novos seguidores por dia - retorna dados até 30 dias para trás, trazendo nulo caso esteja fora desse período. Dados de dias mais recentes serão retornados como zero e serão preenchidos conforme o savepoint é atualizado e os dados sejam disponibilizados pelo instagram (este efeito é controlado com janela de atualização). Não são retornados dados para perfis com menos de 100 seguidores
get_directions_clicks	float	[pt] Número de vezes em que o link de direções do perfil foi clicado
impressions	float	[pt] Número total de vezes em que os objetos de mídia da conta foram visualizados
phone_call_clicks	float	[pt] Número total de vezes em que o link de ligação do perfil foi tocado
profile_views	float	[pt] Número total de usuários que visualizaram o perfil da conta no período especificado
reach	float	[pt] Número total de vezes em que os objetos de mídia da conta foram vistos unicamente
text_message_clicks	float	[pt] Número de vezes em que o link de mensagem de texto do perfil foi tocado
website_clicks	float	[pt] Número de vezes em que o link do site do perfil foi tocado

Mídias

Mídias são fotos, vídeos, stories ou albuns. Este objeto irá trazer informações básicas sobre uma dada mídia, como sua legenda e data de publicação.

Por limitação do Instagram, este objeto retorna apenas as 10 mil mídias mais recentes
Por limitação do Instagram, stories ficam disponíveis por apenas 24 horas. Isso quer dizer que, caso a execução da sua integração seja realizada durante esse período de disponibilidade, os dados serão integrados e permanecerão no seu destino
Caso nenhuma mídia esteja sendo retornada ou esteja recebendo valores nulos, siga estas instruções para solucionar o problema

Campo	Tipo
id	text	[pt] ID da mídia
kdd_account_id	text	[pt] ID do perfil Perfis > > kdd_account_id
ig_username	text	[pt] Username do perfil Perfis > > ig_username
timestamp	timestamp	[pt] Data de criação da mídia em UTC
like_count	float	[pt] Contagem de likes - exclui atividade patrocinada. Retorna 0 caso a conta tenha ocultado a exibição de likes
owner_id	text	[pt] ID do dono da mídia
is_comment_enabled	boolean	[pt] Booleano que indica se os comentários estão habilitados
permalink	text	[pt] Link da publicação
caption	text	[pt] Texto da publicação. O símbolo '@' não será retornado. O texto será tratado para remoção/substituição de caracteres não conformes com o padrão ANSI
thumbnail_url	text	[pt] URL da imagem de prévia da mídia - disponível apenas para vídeos
comments_count	float	[pt] Contagem de comentários
media_type	text	[pt] Tipo da mídia (IMAGE, CAROUSEL_ALBUM, VIDEO, etc)
media_product_type	text	[pt] Superfície onde a mídia é publicada. Pode ser AD, FEED, STORY ou REELS.
ig_is_story	boolean	[pt] Booleano que indica se a mídia é uma story
shortcode	text	[pt] Código da mídia, faz parte do permalink
media_url	text	[pt] URL da imagem/vídeo da mídia

Perfis

Caso algum perfil que você está conectado não esteja sendo retornado ou mesmo as colunas estejam vindo quase todas com valores nulos, siga estas instruções para solucionar o problema

Campo	Tipo
kdd_account_id	text	[pt] ID interno da Kondado para este perfil
fb_page_id	text	[pt] ID da página do Facebook associada
ig_username	text	[pt] Nome de usuário do perfil
ig_name	text	[pt] Nome do perfil
ig_website	text	[pt] URL do site do perfil
ig_biography	text	[pt] Texto da biografia do perfil
followers_count	float	[pt] Número total de usuários do Instagram que seguem o usuário
follows_count	float	[pt] Número total de usuários do Instagram que o usuário segue
media_count	float	[pt] Número total de mídias publicadas pelo usuário

Notas

Vinculando sua conta do Instagram à página do Facebook

1. No Facebook, na sua página, clique em "Configurações":

2. Em configurações da página, clique então em "Instagram":

3. Clique em "Conectar Conta":

4. Insira suas informações de login do Instagram e clique em "Entrar":

5. Clique em "Analisar Conexão" e clique em "Continuar" até chegar a pagina de autenticação do Instagram (para fazer esse processo é necessário que você seja o(a) proprietário(a) da página):

6. Insira suas informações de login do Instagram:

7. Sua página de Facebook estará vinculada ao Instagram.

Solucionando problemas de permissão

Primeiramente, verifique se os requisitos listados aqui estão cumpridos.

Caso estejam e mesmo assim você não esteja conseguindo obter os dados de um dado perfil, isto pode ser devido a uma falha de conexão do lado do Facebook e será necessário refazer o processo de autorização da Kondado:

Faça login na sua conta de Facebook que está conectada à página do perfil do Instagram
Acesse a página de configuração de conexões em https://www.facebook.com/settings?tab=business_tools
Encontre o ícone da Kondado, selecione-o e clique em Remove

Acesse a plataforma da Kondado > Conectores > encontre o seu conector do Instagram e clique no botão de switch mais a direita para desabilitá-lo

Siga as instruções para adicionar um novo conector do Instagram
Tente criar uma nova integração com o novo conector criado acima

Caso tenha outro conector de Facebook ou Instagram da Kondado, o processo acima irá remover a permissão que foi anteriormente concedida à Kondado e será necessário reautorizar os outros conectores. Neste caso, basta acessá-los > EDITAR > Botão de autorizar > Processo de autorização > Salvar

Se mesmo assim o problema persistir, pode ser necessário recriar o vínculo entre Instagram e Facebook:

Siga os passos descritos na seção "Disconnect Your Facebook Page and Instagram Account" deste artigo do Facebook https://www.facebook.com/help/1148909221857370
Siga estes passos para reconectar Instagram e Facebook