Saiba como a Singular extrai os dados de custo de publicidade do TikTok For Business e os exibe nos seus relatórios. No dashboard da Singular, o TikTok Ads aparece como a fonte do TikTok For Business.
Detalhes rápidos
| Tecnologia do conetor de dados |
API (TikTok marketing API v. 1.3) |
| Detalhamento de dados (segmentação) |
Seus dados são detalhados pelas seguintes dimensões:
Se você não usar o detalhamento por país, as campanhas com um único segmento exibirão valores de país, mas uma campanha com vários segmentos aparecerá como "N/A", a menos que possamos estimá-la com base nos dados de atribuição. Os dados estimados podem não ser idênticos aos do TikTok. Consulte "Como o custo é calculado por país?" |
| Qual o intervalo de tempo em que extraímos dados | 7 dias |
| Fuso horário | O fuso horário configurado para a conta no TikTok |
| Os dados estão disponíveis no nível criativo (anúncio)? | Sim |
| O Singular mostra seus ativos criativos? | Sim |
Mapeamento de dados
Dica: Para mais informações sobre qualquer campo nos relatórios da Singular, consulte o Glossário de métricas e dimensões. Além disso, você pode ver o mapeamento dos recursos de campanha do TikTok para os campos da API de relatórios aqui.
| Field in Singular UI | Field in Singular API | Field in TikTok API |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | (Taken from [advertiser/info]) |
| Account Name | adn_account_name | advertiser_name |
| App | app | app_name |
| App Site ID | app_site_id | (Taken from the [app_download_url]) |
| Bid Type | bid_type | bid_type |
| Campaign Objective | campaign_objective | objective_type |
| Campaign Status | campaign_status | opt_status |
| Campaign URL | adn_campaign_url | landing_page_url |
| Country | country_field | location |
| Date | date_field | stat_time_day |
| DMA ID | dma_id_field | dma.id |
| DMA Name | dma_name_field | dma.name |
| Network Campaign ID | adn_campaign_id | campaign_id |
| Network Campaign Name | adn_campaign_name | campaign_name |
| Network Creative ID | adn_creative_id | ad_id |
| Network Creative Name | adn_creative_name | ad_name |
| Network Sub Campaign ID | adn_sub_campaign_id | adgroup_id |
| Network Sub Campaign Name | adn_sub_campaign_name | adgroup_name |
| Original Bid Amount | original_bid_amount | bid |
| Original Bid Currency | original_metadata_currency | currency |
| Platform | platform |
|
| Public Id | site_public_id | mobile_app_id |
|
Region |
region_field |
region.name (State or Province; displayed if sub-campaign targets a single region) |
| Standardized Bid Type | standardized_bid_strategy | optimize_goal |
| Timezone | adn_timezone | timezone |
| Text | creative_text | ad_text |
| TikTok - Campaign Automation Type | tiktok_campaign_automation_type | campaign_automation_type |
| TikTok - SmartPlus Ad ID | tiktok_smartplus_ad_id | ad_id_v2 / smart_plus_ad_id |
| TikTok - SmartPlus Ad Name | tiktok_smartplus_ad_name | ad_id_v2 / smart_plus_ad_id |
| TikTok - Post ID | tiktok_post_id | post_id |
| Age | age | age |
| Gender | gender | gender |
| Metrics | ||
| Comments | comments | comments |
| Likes | likes | likes |
| Network Clicks | adn_clicks | clicks |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs |
real_time_conversion (backup option: app_installs)
Note: If |
| Original Cost | adn_original_cost | stat_cost |
| Original Currency | adn_original_currency | currency |
|
Page Follows |
page_follows | follows |
|
Shares |
shares | shares |
| Video Views | video_views | total_play |
| Video Views - 25% | video_views_25pct | play_first_quartile |
| Video Views - 50% | video_views_50pct | play_midpoint |
| Video Views - 75% | video_views_75pct | play_third_quartile |
| Completed Video Views | completed_video_views | play_over |
A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.
Instruções de configuração
Etapas de configuração
Para configurar o conector de dados do TikTok For Business:
-
Na sua conta da Singular, acesse Settings > Data Connectors.
-
Clique em Add New Connector e comece a digitar "TikTok". Selecione "TikTok Ads" na lista exibida.
-
Na janela de configuração que abrir, clique em Sign In with TikTok e faça login na sua conta do TikTok For Business.
-
A plataforma do TikTok pergunta se você quer conceder à Singular permissões para acessar os dados do TikTok. Marque a caixa de seleção Agree to the Platform Service Agreement e clique em Confirm.
- Depois de conceder as permissões, a janela de configuração na Singular indica que você está conectado. Você pode fechar a janela.
-
O TikTok agora aparece na lista de conectores de dados. O status do conector de dados é "Pending" enquanto a Singular realiza a primeira extração de dados. Depois que a primeira extração for concluída, o status mudará para "Active".
-
Depois que o conector de dados extrair os dados para a Singular com sucesso, você poderá executar relatórios que incluam dados do TikTok. Para mais informações, consulte FAQ de relatórios, Referência da API da Singular, ou FAQ de destinos de dados da Singular.
Relatório de exemplo:
Métricas adicionais (eventos de conversão)
A Singular extrai métricas da lista de métricas do TikTok For Business. Por padrão, os eventos regulares são extraídos da seção "in-app events metrics" e os eventos SKAdNetwork da seção "Supported SKAN Metrics" da lista. Além destes, você pode extrair qualquer métrica criando um evento de conversão na Singular.
Para criar um evento de conversão:
- Na Singular, acesse Settings > Events. Se você tiver as abas Custom Events e Conversion Events, selecione Conversion Events.
- Clique em New Event.
-
No menu suspenso TikTok Ads, selecione a métrica desejada.
No dia seguinte, quando a Singular extrair os dados diários da sua conta, ela também extrairá as conversões concluídas.
- Depois que o novo evento for preenchido com alguns dados, execute um relatório na página Reports e escolha o evento de conversão que você criou no menu suspenso Events.
Campanhas TikTok Upgraded Smart+
À medida que o TikTok evolui seu conjunto de automação, estamos atualizando nossos relatórios para oferecer visibilidade total da estrutura de campanhas Upgraded Smart+. O TikTok está migrando de Smart Campaigns (que será descontinuado em breve) para o modelo Upgraded Smart+.
O objetivo principal desta atualização é oferecer um equilíbrio entre dados granulares e combinados nesses novos tipos de automação.
O que está mudando?
Para dar suporte a essa transição, adicionaremos os seguintes campos de relatório a partir de março de 2026:
- TikTok - Campaign Automation: Este campo identifica a lógica de automação utilizada e classifica as campanhas como Manual, Smart, ou Upgraded Smart+.
- TikTok - Upgraded Smart+ Ad ID & Name: Esses campos representam uma nova camada de relatórios que fica diretamente acima do criativo. Essa camada funciona como um contêiner para vários criativos.
Observação: O Upgraded Smart+ Ad ID e o Name são campos apenas do lado da rede. Embora isso adicione uma nova camada estrutural, seus dados de criativos continuarão sendo combinados para garantir um tracking holístico do desempenho.