Detalhes rápidos

Tecnologia de conetor de dados	API (API de marketing do TikTok v. 1.3)
Divisão de dados (segmentação)	Seus dados são divididos pelas seguintes dimensões: Plataforma (predefinição) País Colocação DMA Importante: Para usar uma divisão diferente de Plataforma, entre em contato com o suporte da Singular. Devido às limitações da API do TikTok, não podemos extrair dados de várias subdivisões no nível da campanha. Se você não usar a divisão de país, as campanhas de segmentação única exibirão valores de país, mas uma campanha de segmentação múltipla será "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?"
Com que antecedência extraímos os dados	7 dias
Fuso horário	UTC por padrão
Os dados estão disponíveis ao nível do criativo (anúncio)?	Sim
O Singular mostra os seus activos criativos?	Sim

Mapeamento de dados

Campo em Singular UI	Campo na API da Singular	Campo na API do TikTok
Dimensões
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	platform app_type (If platform is empty) operating_system (If both are empty)
Public Id	site_public_id	mobile_app_id
Region	region_field	region.name
Standardized Bid Type	standardized_bid_strategy	optimize_goal
Timezone	adn_timezone	timezone
Text	creative_text	ad_text
Age	age	age
Gender	gender	gender
Métricas
Average Frequency	frequency	frequency
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)
Original Cost	adn_original_cost	stat_cost
Original Currency	adn_original_currency	currency
Page Follows	page_follows	follows
Reach	reach	reach
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

O Singular também suporta a 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 conetor de dados do TikTok for Business:

1. Na sua conta Singular, vá para Settings > Data Connectors.

   

2. Clique em Adicionar novo conetor e comece a digitar "TikTok". Selecione "TikTok Ads" na lista que aparece.

   

3. Na janela de configuração que se abre, clique em Sign In with TikTok e inicie sessão na sua conta TikTok For Business.

   

4. A plataforma TikTok pergunta se você deseja conceder permissões à Singular para acessar os dados do TikTok. Marque a caixa de seleção Concordar com o Contrato de serviço da plataforma e clique em Confirmar.

   

5. Depois de conceder as permissões, a janela de configuração no Singular indica que você está conectado. É possível fechar a janela.

6. O TikTok agora aparece na lista de conectores de dados. O status do conetor de dados é "Pendente" enquanto o Singular executa a primeira extração de dados. Quando a primeira extração de dados for concluída, o status será alterado para "Ativo".

   

7. Depois que o conetor de dados tiver puxado dados com sucesso para o Singular, você pode começar a executar relatórios que incluem dados do TikTok. Para obter mais informações, consulte as Perguntas frequentes sobre relatórios, Referência da API do Singular ou Perguntas frequentes sobre destinos de dados do Singular.

   Exemplo de relatório:

   

Métricas adicionais (eventos de conversão)

O 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 "métricas de eventos in-app" e os eventos SKAdNetwork da seção "Métricas SKAN suportadas" da lista. Além disso, é possível extrair qualquer métrica criando um evento de conversão no Singular.

Para criar um evento de conversão:

1. No Singular, vá para Configurações > Eventos. Se você tiver as guias Eventos personalizados e Eventos de conversão, selecione Eventos de conversão.
2. Clique em Novo evento.

3. No menu suspenso TikTok Ads, selecione a métrica desejada.

   No dia seguinte, quando o Singular extrair os dados diários da sua conta, ele também extrairá as conclusões.

4. Depois que o novo evento for preenchido com alguns dados, execute um relatório na página Relatórios e escolha o evento de conversão que você criou no menu suspenso Eventos.