DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

TikTok Ads

Última atualização: 26 de outubro de 2026

Criado para:

  • Desenvolvedor
NOTE
A origem TikTok Ads está na versão beta. Leia a Visão geral das fontes para obter mais informações sobre o uso de conectores rotulados com beta.
IMPORTANT
A origem TikTok Ads está disponível como parte da SKU do Customer Journey Analytics.

A origem TikTok Ads é um conector de mídia paga do Adobe Experience Platform. Use-o para conectar suas contas de anúncio do TikTok e assimilar dados de campanha, publicidade e desempenho, como métricas de envolvimento, na Experience Platform.

O conector publica os dados capturados nos conjuntos de dados de Mídia paga. A Customer Journey Analytics usa esses conjuntos de dados para fornecer informações sobre suas campanhas de marketing do TikTok.

Para conectar sua conta, entre no TikTok e autorize o Experience Platform a acessar sua conta de anunciante. Não é necessário gerar ou fornecer credenciais de API manualmente.

Como funciona

Depois de criar um fluxo de dados TikTok Ads e selecionar a conta de anunciante a ser direcionada, o Experience Platform executa automaticamente os seguintes trabalhos.

  • Se os conjuntos de dados de Mídia paga ainda não existirem para sua organização, a Experience Platform os criará.
  • Um trabalho de preenchimento retroativo único é executado após a criação do fluxo de dados.
  • Um job incremental é executado uma vez por dia, iniciando no dia seguinte à criação do fluxo de dados.

Pré-requisitos

Antes de conectar TikTok Ads ao Experience Platform, verifique se você tem o seguinte:

  • Um aplicativo para desenvolvedores TikTok for Business existente com o produto API de marketing adicionado.
  • Aprovação do aplicativo de TikTok. Os aplicativos são iniciados em um modo de sandbox e exigem que TikTok revise e aprove o aplicativo antes que ele possa acessar os dados da produção e da conta.
  • Verificação comercial. Esse é um processo de aprovação separado da revisão do aplicativo e é necessário para camadas de limite de taxa mais alta.
  • Os grupos de permissão de aplicativo a seguir foram concedidos antes que você autorizasse sua conta pela primeira vez. TikTok não permite que você aumente essas permissões posteriormente sem reautorizar: Gerenciamento de anúncios, Relatórios, Gerenciamento de contas de anúncios e Gerenciamento de público-alvo.
  • Uma cota de limite de taxa apropriada para o volume de preenchimento retroativo. A camada padrão da sandbox é acelerada de forma agressiva, portanto, solicite um aumento antes de executar um preenchimento retroativo grande.
  • Campanhas e anúncios já configurados em sua conta de anúncio TikTok. O conector lê a partir desses dados de publicidade existentes. Ele não cria, modifica ou exclui TikTok campanhas, anúncios ou outros recursos.

Provisionamento de esquema e conjunto de dados

A origem TikTok Ads atribui automaticamente um conjunto de dados, esquema e mapeamento de campo de destino. Você não seleciona um conjunto de dados de destino ou mapeia campos sozinho ao criar o fluxo de dados.

O conector provisiona um conjunto de dados de Mídia paga por tipo de entidade: conta, campanha, grupo de anúncios, anúncio, ativo e métricas de resumo. Esses são os mesmos esquemas canônicos que as fontes do Meta Ads e Google Ads já preenchem. Leia a seção a seguir para os campos de identidade principais que o conector mapeia para cada entidade.

Esquema XDM TikTok Ads

Leia esta seção para obter informações sobre os campos de identidade e status principais que a origem TikTok Ads mapeia para cada esquema de Mídia paga. Todo registro mapeado também inclui um valor entityType que identifica a entidade e um valor paidMedia.adNetwork de tiktok.

Campos de conta

O esquema de conta armazena os detalhes da sua conta de anunciante do TikTok.

Campo TikTok
Campo XDM
Descrição
advertiser_id
paidMedia.accountID
O identificador exclusivo da conta do anunciante em TikTok.
name
paidMedia.metadata.name
O nome para exibição da conta do anunciante.
status
paidMedia.metadata.status
O status da conta, como ativo.
currency
paidMedia.metadata.currency
A moeda em que a conta relata.
create_time
paidMedia.metadata.createdTime
O carimbo de data/hora de criação da conta.

Campos de campanha

O esquema de campanha armazena os detalhes da campanha TikTok.

Campo TikTok
Campo XDM
Descrição
campaign_id
paidMedia.campaignID
O identificador exclusivo da campanha em TikTok.
advertiser_id
paidMedia.accountID
O identificador da conta pai do anunciante.
campaign_name
paidMedia.metadata.name
O nome de exibição da campanha.
operation_status
paidMedia.metadata.status
O status da campanha, como ativo ou pausado.
create_time
paidMedia.metadata.createdTime
O carimbo de data e hora de criação da campanha.
modify_time
paidMedia.metadata.updatedTime
O carimbo de data e hora da última modificação da campanha.

Campos de grupo de anúncios

O esquema do grupo de anúncios armazena os detalhes do seu grupo de anúncios TikTok.

Campo TikTok
Campo XDM
Descrição
adgroup_id
paidMedia.adGroupID
O identificador exclusivo do grupo de anúncios em TikTok.
campaign_id
paidMedia.campaignID
O identificador da campanha principal.
adgroup_name
paidMedia.metadata.name
O nome de exibição do grupo de anúncios.
operation_status
paidMedia.metadata.status
O status do grupo de anúncios, como ativo ou pausado.

Campos de publicidade

O esquema de anúncios armazena os detalhes do anúncio TikTok.

Campo TikTok
Campo XDM
Descrição
ad_id
paidMedia.adID
O identificador exclusivo do anúncio em TikTok.
adgroup_id
paidMedia.adGroupID
O identificador do grupo de anúncios principal.
ad_name
paidMedia.metadata.name
O nome de exibição do anúncio.
operation_status
paidMedia.metadata.status
O status do anúncio, como ativo ou pausado.

Campos de ativos

O esquema de ativo armazena os detalhes de criação de vídeo e imagem do TikTok.

Campo TikTok
Campo XDM
Descrição
image_id / video_id
paidMedia.assetID
O identificador exclusivo para o ativo de imagem ou vídeo em TikTok.
advertiser_id
paidMedia.accountID
O identificador da conta pai do anunciante.

Campos de métricas de resumo

O esquema de métricas de resumo armazena dados de desempenho para suas contas, campanhas, grupos de anúncios, anúncios e ativos do TikTok.

Cada registro de métrica mapeia para o identificador da entidade que ele mede.

Entidade
Mapeia para o campo XDM
Conta
paidMedia.accountID
Campaign
paidMedia.campaignID
Grupo de publicidade
paidMedia.adGroupID
Anúncio
paidMedia.adID
Ativo
paidMedia.assetID

Solução de problemas

Use a tabela a seguir para solucionar problemas comuns com a origem TikTok Ads.

Problema
Causa
A conexão foi bem-sucedida, mas nenhuma conta de anunciante parece selecionar.
O usuário TikTok autorizador não tem acesso ao Ads Management em nenhuma conta de anunciante, ou o aplicativo não concluiu a verificação de negócios. Verifique o status do aplicativo no TikTok for Business Developer Portal.
O fluxo de dados é executado, mas nenhum dado chega a ele.
O aplicativo provavelmente ainda está com o status de revisão da sandbox. TikTok não retorna dados de produção até que o aplicativo passe pela revisão, mesmo que a própria conexão seja bem-sucedida.
Um preenchimento retroativo falha parcialmente com erros de limite de taxa.
A camada de limite de taxa padrão do aplicativo é muito baixa para o intervalo de datas solicitado. Solicite um aumento de limite de taxa de TikTok antes de executar um preenchimento retroativo grande.
Um detalhamento de métricas específicas, como desempenho de ativos, retorna menos linhas do que o esperado ou erros.
Nem todas as métricas são suportadas em todas as combinações de dimensões de relatórios. Valide o detalhamento afetado em relação a uma conta de anunciante de teste antes de depender dele na produção.

Próximas etapas

Depois de confirmar que você tem uma conta de anunciante do TikTok qualificada com campanhas e anúncios existentes, continue em conectando o TikTok Ads ao Experience Platform usando a interface do usuário.

Mais ajuda sobre este tópico

recommendation-more-help
experience-platform-help-sources