TikTok Orgânico

Adicionando o conector

Requisitos

  1. Tipo de conta: Conta Business ou Pessoal do TikTok
  2. Seguidores mínimos: Pelo menos 100 seguidores
  3. Analytics: Devem estar ativados
  4. Conteúdo público: Pelo menos uma publicação pública
  5. Credenciais de login: O login deve ser feito com as mesmas credenciais usadas no app móvel do TikTok

Instruções

  1. Acesse a página de criação do conector do Tiktok Orgânico clicando em CRIAR + > Conector
  2. Clique em Autenticar
  3. Na página de autorização, clique em Continuar
  4. Após autenticação, clique em SALVAR

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Conta

  1. Guarda um histórico diário (campo metric_date) das leituras realizadas desde que a integração foi criada
Campo Tipo

video_creator_username

text

[pt] Nome de usuário ou @ da conta do TikTok.

metric_date

date

[pt] Data de leitura dos dados

bio_description

text

[pt] Descrição inserida pelo usuário na seção bio do perfil.

display_name

text

[pt] Nome de exibição definido na conta TikTok.

followers_count

float

[pt] Número total de seguidores da conta.

following_count

float

[pt] Número de contas que este perfil segue no TikTok.

is_business_account

boolean

[pt] Indica se a conta é uma conta Business do TikTok.

is_verified

boolean

[pt] Indica se a conta é oficialmente verificada pelo TikTok.

profile_deep_link

text

[pt] Link direto (deep link) para o perfil do TikTok, geralmente em formato encurtado.

profile_image

text

[pt] URL da imagem de perfil associada à conta TikTok.

total_likes

float

[pt] Número total de curtidas recebidas pela conta TikTok em todos os vídeos.

videos_count

float

[pt] Número total de vídeos publicados pela conta.

Conta: métricas

  1. O período máximo de carga histórica é de 58 dias

Objeto principal

Campo Tipo

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data dos dados analíticos

profile_image

text

[pt] URL da imagem de perfil associada à conta TikTok.

    Conta > > profile_image

address_clicks

float

[pt] Número de cliques no link de endereço/localização no perfil do TikTok.

app_download_clicks

float

[pt] Número de cliques no link de download do app no perfil na data informada.

bio_link_clicks

float

[pt] Número de cliques no link da seção bio do perfil do TikTok.

comments

float

[pt] Número total de comentários recebidos nos vídeos na data informada.

daily_lost_followers

float

[pt] Número de seguidores perdidos na data informada.

daily_new_followers

float

[pt] Número de novos seguidores ganhos na data informada.

daily_total_followers

float

[pt] Número total de seguidores ao final da data informada.

email_clicks

float

[pt] Número de cliques no link de e-mail de contato no perfil do TikTok.

engaged_audience

float

[pt] Número de seguidores que interagiram (curtiram, comentaram, compartilharam, etc.) com o conteúdo na data informada.

followers_count

float

[pt] Número total de seguidores da conta no momento do relatório.

lead_submissions

float

[pt] Número de leads enviados por formulários do TikTok associados à conta.

likes

float

[pt] Número total de curtidas recebidas nos vídeos da conta na data informada.

phone_number_clicks

float

[pt] Número de cliques no link de telefone no perfil do TikTok.

profile_views

float

[pt] Número de vezes que o perfil do TikTok foi visualizado na data informada.

shares

float

[pt] Número total de vezes que os vídeos da conta foram compartilhados na data informada.

unique_video_views

float

[pt] Número total de visualizações únicas em todos os vídeos na data especificada.

video_views

float

[pt] Número total de visualizações em todos os vídeos na data especificada.

tiktok_organic_account_metrics_audience_activity

Campo Tipo

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data dos dados analíticos relacionados à atividade da audiência

audience_activity_count

float

[pt] Contagem de atividade da audiência na conta TikTok.

audience_activity_hour

float

[pt] Horas do dia associadas a cada contagem de atividade da audiência.

Vídeos

  1. Guarda um histórico diário (campo metric_date) das leituras realizadas desde que a integração foi criada
  2. Os dados deixarão de ser atualizados após 365 dias
  3. A janela de atualização (e savepoint) são baseadas na data de criação do vídeo

Objeto principal

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

app_download_clicks

float

[pt] Número de cliques para baixar o aplicativo a partir do vídeo.

average_time_watched

float

[pt] Tempo médio (em segundos) que os espectadores assistiram ao vídeo.

caption

text

[pt] Legenda ou descrição adicionada ao vídeo.

comments

float

[pt] Número de comentários no vídeo.

create_time

timestamp

[pt] Data/hora de publicação do vídeo no formato Unix/Epoch.

embed_url

text

[pt] URL usada para incorporar o vídeo em páginas externas.

favorites

float

[pt] Número de vezes que o vídeo foi adicionado aos favoritos.

full_video_watched_rate

float

[pt] Proporção de visualizações completas do vídeo (entre 0 e 1).

lead_submissions

float

[pt] Número de envios de formulário (leads) gerados pelo vídeo.

likes

float

[pt] Número de curtidas recebidas pelo vídeo.

new_followers

float

[pt] Número de novos seguidores conquistados pelo vídeo.

phone_number_clicks

float

[pt] Número de cliques no número de telefone exibido no vídeo ou perfil.

profile_views

float

[pt] Número de vezes que o perfil foi visualizado a partir do vídeo.

reach

float

[pt] Número de pessoas que assistiram ao vídeo pelo menos uma vez.

share_url

text

[pt] URL pública do vídeo, usada para compartilhamento.

shares

float

[pt] Número de vezes que o vídeo foi compartilhado.

thumbnail_url

text

[pt] URL da miniatura do vídeo.

total_time_watched

float

[pt] Tempo total (em segundos) que o vídeo foi assistido por todos os usuários.

video_duration

float

[pt] Duração do vídeo em segundos.

video_views

float

[pt] Número de visualizações do vídeo.

website_clicks

float

[pt] Número de cliques para visitar o site a partir do vídeo.

tiktok_organic_videos_impression_sources

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

impression_sources_impression_source

text

[pt] Fonte da impressão do vídeo (ex: Search, For You, Personal Profile).

impression_sources_percentage

float

[pt] Porcentagem de impressões que vieram da fonte indicada.

tiktok_organic_videos_engagement_likes

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

engagement_likes_percentage

float

[pt] Porcentagem de likes recebidos no segundo correspondente.

engagement_likes_second

float

[pt] Segundo específico em que os likes ocorreram durante o vídeo.

tiktok_organic_videos_audience_types

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

audience_types_percentage

float

[pt] Porcentagem correspondente ao tipo de audiência.

audience_types_type

text

[pt] Tipo de audiência (ex: FOLLOWER_PERCENT, NEW_VIEWER, NON_FOLLOWER_PERCENT, RETURN_VIEWER).

tiktok_organic_videos_audience_countries

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

audience_countries_country

text

[pt] Código do país (ex: BR, US) de onde vem a audiência do vídeo.

audience_countries_percentage

float

[pt] Porcentagem da audiência vinda do país especificado.

tiktok_organic_videos_audience_cities

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

audience_cities_city_name

text

[pt] Nome da cidade de onde vem a audiência do vídeo.

audience_cities_percentage

float

[pt] Porcentagem da audiência do vídeo vinda da cidade especificada.

tiktok_organic_videos_video_view_retention

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

video_view_retention_percentage

float

[pt] Porcentagem de visualizações retidas até o segundo correspondente.

video_view_retention_second

float

[pt] Segundo específico do vídeo onde houve retenção de visualização.

tiktok_organic_videos_audience_genders

Campo Tipo

item_id

text

[pt] Identificador único do vídeo.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

metric_date

date

[pt] Data da coleta dos dados do vídeo.

audience_genders_gender

text

[pt] Gênero da audiência (ex: male_vv, female_vv, other_vv).

audience_genders_percentage

float

[pt] Porcentagem da audiência de cada gênero.

Vídeos: comentários

  1. A janela de atualização (e savepoint) são baseadas na data de criação do vídeo
Campo Tipo

video_id

text

[pt] Identificador do vídeo ao qual o comentário está associado.

    Vídeos > > item_id

comment_id

text

[pt] Identificador único do comentário.

video_creator_username

text

[pt] Nome de usuário da conta TikTok ou @

    Conta > > video_creator_username

thumbnail_url

text

[pt] URL da miniatura do vídeo.

create_time

timestamp

[pt] Data/hora em que o comentário foi criado, no formato Unix/Epoch.

display_name

text

[pt] Nome de exibição do autor do comentário (pode conter caracteres especiais ou emojis).

liked

boolean

[pt] Indica se o comentário foi curtido pelo usuário autenticado na API (booleano).

likes

float

[pt] Número de curtidas recebidas por este comentário.

owner

boolean

[pt] Indica se o comentário foi feito pelo proprietário da conta (booleano).

pinned

boolean

[pt] Indica se o comentário está fixado no topo da seção de comentários (booleano).

profile_image

text

[pt] URL da imagem de perfil do autor do comentário.

replies

float

[pt] Número de respostas ao comentário (comentários em thread).

status

text

[pt] Status do comentário, como 'PUBLIC' para comentários publicamente visíveis.

text

text

[pt] Texto do comentário feito no vídeo.

unique_identifier

text

[pt] Identificador de comentário criptografado ou codificado (uso interno da plataforma).

user_id

text

[pt] Identificador único do autor do comentário.

comment_author_username

text

[pt] Nome de usuário do autor do comentário.