Anúncios TikTok

Guia estratégico para gerenciar campanhas publicitárias no TikTok. Pesquise profundamente, valide os parâmetros cuidadosamente e oriente os usuários através dos requisitos específicos de cada objetivo da plataforma.

Esta skill é para anúncios pagos no TikTok (a superfície da API de Marketing do TikTok). Para postagem orgânica de vídeos no TikTok, veja a futura skill irmã tiktok-posting.

Requisitos

Hyper MCP instalado e conectado. https://app.hyperfx.ai/mcp
Integração de Marketing do TikTok conectada (Gerenciador de Anúncios / Central de Negócios do TikTok) em https://app.hyperfx.ai/integrations.

Se tiktok_get_advertiser_accounts não estiver na lista de ferramentas, pare e informe ao usuário que ele deve ativar o Hyper MCP e conectar o Marketing do TikTok.

Superfície de ferramentas

Ferramenta	Finalidade
`tiktok_get_advertiser_accounts`	Descoberta: lista os IDs de anunciantes disponíveis para o usuário conectado.
`tiktok_get_campaigns`, `tiktok_create_campaign`, `tiktok_update_campaign`, `tiktok_update_campaign_status`	Ciclo de vida da campanha.
`tiktok_get_adgroups`, `tiktok_create_adgroup`, `tiktok_update_adgroup`, `tiktok_update_adgroup_status`	Ciclo de vida do grupo de anúncios.
`tiktok_get_ads`, `tiktok_create_ad`, `tiktok_update_ad_status`	Ciclo de vida do anúncio. Nota: `tiktok_update_ad` não existe no MCP — edições de conteúdo do anúncio (criativo, texto, URL) exigem a interface do Gerenciador de Anúncios do TikTok. Apenas alterações de status (ativar / pausar / excluir) estão disponíveis via MCP.
`tiktok_ad_video_upload`, `tiktok_ad_video_info`, `tiktok_ad_video_search`	Upload + consulta de criativos de vídeo.
`tiktok_report_integrated_get`	Relatórios de desempenho.
`tiktok_create_custom_audience`, `tiktok_list_custom_audiences`, `tiktok_create_lookalike_audience`	Gerenciamento de públicos (opcional).

Fase 1: Descoberta de Conta

Configuração Inicial

Use tiktok_get_advertiser_accounts() para obter os IDs de anunciantes.
Se houver múltiplas contas: peça ao usuário para selecionar uma.
Se houver uma única conta: informe o usuário e prossiga.

Benchmarks de Lance (opcional, mas recomendado)

Antes de definir preços de lance, chame tiktok_ad_benchmarks para obter benchmarks de CPM/CPC específicos do setor. Isso evita o uso de valores genéricos que podem ser muito baixos para vencer leilões ou muito altos para o orçamento do usuário.

tiktok_ad_benchmarks(
    advertiser_id="123456789",
    dimensions=["industry"],
    filtering={"industry": "292801"}  # código do setor de tiktok_get_advertiser_accounts
)

Objetivos de Campanha Disponíveis

Objetivo	Melhor Para	Requisitos Principais
`TRAFFIC`	Gerar visitas ao site	`promotion_type="WEBSITE"`, faturamento CPC
`CONVERSIONS`	Gerar compras / leads	ID do Pixel, rastreamento de eventos de conversão
`REACH`	Reconhecimento de marca	Apenas posicionamento manual, faturamento CPM, limite de frequência
`APP_PROMOTION`	Instalações de aplicativos	ID do aplicativo, URL da loja de aplicativos
`VIDEO_VIEW`	Engajamento com vídeo	Ativos de criativos de vídeo

Fase 2: Criação da Campanha

Passo 1: Criar Campanha

Requisitos de Orçamento:

MÍNIMO $50 para orçamentos em nível de campanha (exigência do TikTok).
budget_mode: BUDGET_MODE_INFINITE (CBO), BUDGET_MODE_DAY ou BUDGET_MODE_TOTAL.

tiktok_create_campaign(
    advertiser_id="123456789",
    campaign_name="Summer Sale 2026",
    objective_type="TRAFFIC",
    budget_mode="BUDGET_MODE_DAY",
    budget=50.0,  # MÍNIMO $50/dia
    operation_status="ENABLE"
)

Passo 2: Criar Grupo de Anúncios

Parâmetros SEMPRE OBRIGATÓRIOS:

advertiser_id, campaign_id, adgroup_name.
location_ids (ex.: ["6252001"] para EUA).
schedule_type e schedule_start_time (DEVE ser uma data futura).
billing_event (CPC, CPM, OCPM).
budget_mode (OBRIGATÓRIO para grupos de anúncios).

Para Campanhas de TRÁFEGO:

tiktok_create_adgroup(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Website Traffic - Summer Sale",
    location_ids=["6252001"],  # EUA
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",  # DATA FUTURA
    billing_event="CPC",
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    promotion_type="WEBSITE",        # OBRIGATÓRIO para TRAFFIC
    optimization_goal="CLICK",       # OBRIGATÓRIO (ortografia correta)
    bid_price=0.50,
    placement_type="PLACEMENT_TYPE_AUTOMATIC",
    operation_status="ENABLE"
)

Para Campanhas de ALCANCE:

tiktok_create_adgroup(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Brand Awareness US",
    location_ids=["6252001"],
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",
    billing_event="CPM",                       # OBRIGATÓRIO para REACH
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    optimization_goal="REACH",
    placement_type="PLACEMENT_TYPE_NORMAL",    # OBRIGATÓRIO — automático NÃO suportado
    placements=["PLACEMENT_TIKTOK"],           # OBRIGATÓRIO
    bid_price=2.0,                             # OBRIGATÓRIO
    frequency=3,                               # OBRIGATÓRIO
    frequency_schedule=7,                      # OBRIGATÓRIO
    operation_status="ENABLE"
)

Passo 3: Fazer Upload de Ativos Criativos

Faça upload de um vídeo por variante de criativo. Capture o video_id retornado — você precisará dele no Passo 4.

video_response = tiktok_ad_video_upload(
    advertiser_id="123456789",
    video_file=video_data,
    upload_type="UPLOAD_BY_FILE"
)
video_id = video_response["data"]["video_id"]

Vídeos já enviados podem ser reutilizados. Use tiktok_ad_video_search para encontrar vídeos existentes pelo nome ou tiktok_ad_video_info para buscar metadados de um ID de vídeo conhecido.

Passo 4: Criar o Anúncio

tiktok_create_ad(
    advertiser_id="123456789",
    adgroup_id="1234567890123456",
    ad_name="Summer Sale - Hero Video",
    identity_type="CUSTOMIZED_USER",   # ou "AUTH_CODE" para anúncios spark da Conta TikTok
    identity_id="<advertiser_identity_id>",
    ad_format="SINGLE_VIDEO",
    video_id=video_id,
    ad_text="Limited-time summer drop. Shop now.",
    landing_page_url="https://example.com/summer",
    call_to_action="SHOP_NOW",
    operation_status="DISABLE"        # criar pausado, ativar após revisão
)

Sempre crie anúncios pausados (operation_status="DISABLE") e somente altere para ENABLE depois que o usuário revisar.

Regras de Parâmetros Críticos

Erros Comuns e Soluções

Erro	Solução
O orçamento deve ser de pelo menos $50	O TikTok exige um MÍNIMO de $50 para orçamentos de campanha.
Data de início no passado	Use uma data futura em `schedule_start_time` e o ano atual.
API do TikTok rejeita `optimize_goal` em alguns contextos	Tanto `optimize_goal` quanto `optimization_goal` existem no esquema, mas prefira `optimization_goal` — é o campo que o TikTok valida na maioria dos tipos de objetivo.
Suporta apenas posicionamento manual	REACH exige `placement_type="PLACEMENT_TYPE_NORMAL"`.
O lance precisa ser maior que $0	Defina `bid_price` > 0.
Defina limite de frequência	REACH exige tanto `frequency` quanto `frequency_schedule`.

Dependências de Parâmetros

Objetivo TRAFFIC exige:

promotion_type="WEBSITE".
optimization_goal="CLICK".
billing_event="CPC".
bid_price > 0.

Objetivo REACH exige:

optimization_goal="REACH".
billing_event="CPM".
placement_type="PLACEMENT_TYPE_NORMAL".
Array placements (ex.: ["PLACEMENT_TIKTOK"]).
bid_price > 0.
frequency e frequency_schedule.

Objetivo CONVERSIONS exige:

Um Pixel TikTok conectado e um evento de conversão configurado.
optimization_goal="CONVERT" (ou VALUE para baseado em valor).
billing_event="OCPM".
pixel_id e external_action definidos no grupo de anúncios.

Relatórios

tiktok_report_integrated_get(
    advertiser_id="123456789",
    report_type="BASIC",
    data_level="AUCTION_AD",
    dimensions=["ad_id"],   # Apenas baseados em ID — NÃO nomes
    start_date="2026-04-01",
    end_date="2026-04-30",
    metrics=["impressions", "clicks", "ctr", "spend", "cpc", "cpm"],
    page_size=20
)

Regras de Relatórios:

Com a dimensão stat_time_day: máximo de 30 dias por chamada.
Use apenas dimensões baseadas em ID (ad_id, campaign_id, adgroup_id — não nomes).
Métricas de conversão (conversion, cost_per_conversion, conversion_rate, etc.) exigem um pixel conectado e um evento de conversão configurado.
data_level deve corresponder à granularidade da dimensão: AUCTION_AD com ad_id, AUCTION_ADGROUP com adgroup_id, AUCTION_CAMPAIGN com campaign_id.

Regras de Segurança

Nunca:

Defina orçamentos de grupo de anúncios abaixo de $20/dia sem avisar o usuário.
Agende uma campanha com schedule_start_time no passado (o TikTok rejeita com um erro confuso).
Misture grupos de anúncios REACH com PLACEMENT_TYPE_AUTOMATIC — ele falhará silenciosamente na validação.
Crie anúncios com operation_status="ENABLE" antes de o usuário revisar o criativo + segmentação.
Execute relatórios com dimensões baseadas em nomes — o TikTok aceita apenas dimensões de ID.

hyperfx-ai/tiktok-ads

O que é tiktok-ads?

Perguntar na sua IA favorita

Documentação