Adicionando o conector
Requisitos
- Tipo de conta: Conta Business ou Pessoal do TikTok
- Seguidores mínimos: Pelo menos 100 seguidores
- Analytics: Devem estar ativados
- Conteúdo público: Pelo menos uma publicação pública
- Credenciais de login: O login deve ser feito com as mesmas credenciais usadas no app móvel do TikTok
Instruções
- Acesse a página de criação do conector do Tiktok Orgânico clicando em CRIAR + > Conector
- Clique em Autenticar
- Na página de autorização, clique em Continuar
- Após autenticação, clique em SALVAR
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Conta
- Guarda um histórico diário (campo metric_date) das leituras realizadas desde que a integração foi criada
Campo | Tipo | |
---|---|---|
text |
[pt] Nome de usuário ou @ da conta do TikTok. |
|
date |
[pt] Data de leitura dos dados |
|
text |
[pt] Descrição inserida pelo usuário na seção bio do perfil. |
|
text |
[pt] Nome de exibição definido na conta TikTok. |
|
float |
[pt] Número total de seguidores da conta. |
|
float |
[pt] Número de contas que este perfil segue no TikTok. |
|
boolean |
[pt] Indica se a conta é uma conta Business do TikTok. |
|
boolean |
[pt] Indica se a conta é oficialmente verificada pelo TikTok. |
|
text |
[pt] Link direto (deep link) para o perfil do TikTok, geralmente em formato encurtado. |
|
text |
[pt] URL da imagem de perfil associada à conta TikTok. |
|
float |
[pt] Número total de curtidas recebidas pela conta TikTok em todos os vídeos. |
|
float |
[pt] Número total de vídeos publicados pela conta. |
Conta: métricas
- O período máximo de carga histórica é de 58 dias
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data dos dados analíticos |
|
text |
[pt] URL da imagem de perfil associada à conta TikTok. |
|
float |
[pt] Número de cliques no link de endereço/localização no perfil do TikTok. |
|
float |
[pt] Número de cliques no link de download do app no perfil na data informada. |
|
float |
[pt] Número de cliques no link da seção bio do perfil do TikTok. |
|
float |
[pt] Número total de comentários recebidos nos vídeos na data informada. |
|
float |
[pt] Número de seguidores perdidos na data informada. |
|
float |
[pt] Número de novos seguidores ganhos na data informada. |
|
float |
[pt] Número total de seguidores ao final da data informada. |
|
float |
[pt] Número de cliques no link de e-mail de contato no perfil do TikTok. |
|
float |
[pt] Número de seguidores que interagiram (curtiram, comentaram, compartilharam, etc.) com o conteúdo na data informada. |
|
float |
[pt] Número total de seguidores da conta no momento do relatório. |
|
float |
[pt] Número de leads enviados por formulários do TikTok associados à conta. |
|
float |
[pt] Número total de curtidas recebidas nos vídeos da conta na data informada. |
|
float |
[pt] Número de cliques no link de telefone no perfil do TikTok. |
|
float |
[pt] Número de vezes que o perfil do TikTok foi visualizado na data informada. |
|
float |
[pt] Número total de vezes que os vídeos da conta foram compartilhados na data informada. |
|
float |
[pt] Número total de visualizações únicas em todos os vídeos na data especificada. |
|
float |
[pt] Número total de visualizações em todos os vídeos na data especificada. |
tiktok_organic_account_metrics_audience_activity
Campo | Tipo | |
---|---|---|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data dos dados analíticos relacionados à atividade da audiência |
|
float |
[pt] Contagem de atividade da audiência na conta TikTok. |
|
float |
[pt] Horas do dia associadas a cada contagem de atividade da audiência. |
Vídeos
- Guarda um histórico diário (campo metric_date) das leituras realizadas desde que a integração foi criada
- Os dados deixarão de ser atualizados após 365 dias
- A janela de atualização (e savepoint) são baseadas na data de criação do vídeo
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
float |
[pt] Número de cliques para baixar o aplicativo a partir do vídeo. |
|
float |
[pt] Tempo médio (em segundos) que os espectadores assistiram ao vídeo. |
|
text |
[pt] Legenda ou descrição adicionada ao vídeo. |
|
float |
[pt] Número de comentários no vídeo. |
|
timestamp |
[pt] Data/hora de publicação do vídeo no formato Unix/Epoch. |
|
text |
[pt] URL usada para incorporar o vídeo em páginas externas. |
|
float |
[pt] Número de vezes que o vídeo foi adicionado aos favoritos. |
|
float |
[pt] Proporção de visualizações completas do vídeo (entre 0 e 1). |
|
float |
[pt] Número de envios de formulário (leads) gerados pelo vídeo. |
|
float |
[pt] Número de curtidas recebidas pelo vídeo. |
|
float |
[pt] Número de novos seguidores conquistados pelo vídeo. |
|
float |
[pt] Número de cliques no número de telefone exibido no vídeo ou perfil. |
|
float |
[pt] Número de vezes que o perfil foi visualizado a partir do vídeo. |
|
float |
[pt] Número de pessoas que assistiram ao vídeo pelo menos uma vez. |
|
text |
[pt] URL pública do vídeo, usada para compartilhamento. |
|
float |
[pt] Número de vezes que o vídeo foi compartilhado. |
|
text |
[pt] URL da miniatura do vídeo. |
|
float |
[pt] Tempo total (em segundos) que o vídeo foi assistido por todos os usuários. |
|
float |
[pt] Duração do vídeo em segundos. |
|
float |
[pt] Número de visualizações do vídeo. |
|
float |
[pt] Número de cliques para visitar o site a partir do vídeo. |
tiktok_organic_videos_impression_sources
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
text |
[pt] Fonte da impressão do vídeo (ex: Search, For You, Personal Profile). |
|
float |
[pt] Porcentagem de impressões que vieram da fonte indicada. |
tiktok_organic_videos_engagement_likes
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
float |
[pt] Porcentagem de likes recebidos no segundo correspondente. |
|
float |
[pt] Segundo específico em que os likes ocorreram durante o vídeo. |
tiktok_organic_videos_audience_types
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
float |
[pt] Porcentagem correspondente ao tipo de audiência. |
|
text |
[pt] Tipo de audiência (ex: FOLLOWER_PERCENT, NEW_VIEWER, NON_FOLLOWER_PERCENT, RETURN_VIEWER). |
tiktok_organic_videos_audience_countries
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
text |
[pt] Código do país (ex: BR, US) de onde vem a audiência do vídeo. |
|
float |
[pt] Porcentagem da audiência vinda do país especificado. |
tiktok_organic_videos_audience_cities
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
text |
[pt] Nome da cidade de onde vem a audiência do vídeo. |
|
float |
[pt] Porcentagem da audiência do vídeo vinda da cidade especificada. |
tiktok_organic_videos_video_view_retention
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
float |
[pt] Porcentagem de visualizações retidas até o segundo correspondente. |
|
float |
[pt] Segundo específico do vídeo onde houve retenção de visualização. |
tiktok_organic_videos_audience_genders
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do vídeo. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
date |
[pt] Data da coleta dos dados do vídeo. |
|
text |
[pt] Gênero da audiência (ex: male_vv, female_vv, other_vv). |
|
float |
[pt] Porcentagem da audiência de cada gênero. |
Vídeos: comentários
- A janela de atualização (e savepoint) são baseadas na data de criação do vídeo
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador do vídeo ao qual o comentário está associado. |
|
text |
[pt] Identificador único do comentário. |
|
text |
[pt] Nome de usuário da conta TikTok ou @ |
|
text |
[pt] URL da miniatura do vídeo. |
|
timestamp |
[pt] Data/hora em que o comentário foi criado, no formato Unix/Epoch. |
|
text |
[pt] Nome de exibição do autor do comentário (pode conter caracteres especiais ou emojis). |
|
boolean |
[pt] Indica se o comentário foi curtido pelo usuário autenticado na API (booleano). |
|
float |
[pt] Número de curtidas recebidas por este comentário. |
|
boolean |
[pt] Indica se o comentário foi feito pelo proprietário da conta (booleano). |
|
boolean |
[pt] Indica se o comentário está fixado no topo da seção de comentários (booleano). |
|
text |
[pt] URL da imagem de perfil do autor do comentário. |
|
float |
[pt] Número de respostas ao comentário (comentários em thread). |
|
text |
[pt] Status do comentário, como 'PUBLIC' para comentários publicamente visíveis. |
|
text |
[pt] Texto do comentário feito no vídeo. |
|
text |
[pt] Identificador de comentário criptografado ou codificado (uso interno da plataforma). |
|
text |
[pt] Identificador único do autor do comentário. |
|
text |
[pt] Nome de usuário do autor do comentário. |