Como utilizamos a TikTok API
1. Quem somos e o que é a AIADS
A AIADS é uma plataforma para a gestão e otimização de campanhas publicitárias, desenvolvida pela agência ICBM Polska Sp. z o.o., sediada em Gdańsk. Gerimos campanhas de empresas (B2B) no Google Ads, Microsoft Ads, Meta Ads e TikTok Ads, e o cliente acompanha os respetivos resultados na plataforma AIADS (app.aiads.pl).
Utilizamos a TikTok API exclusivamente para a gestão das contas publicitárias e das contas empresariais TikTok dos nossos clientes, com os quais temos um contrato assinado e que nos concederam, eles próprios, o acesso. Não recolhemos dados do TikTok para outros fins nem os revendemos.
2. Como ligamos a conta TikTok
- O proprietário da conta publicitária ou da conta empresarial inicia sessão no TikTok e autoriza, ele próprio, o acesso à aplicação AIADS (autorização OAuth TikTok for Business).
- A plataforma AIADS recebe um token de acesso às contas indicadas. O token é armazenado na base de dados de forma encriptada e serve exclusivamente para as funções descritas abaixo.
- A conta é gerida pela equipa de gestores de campanhas da ICBM Polska. O cliente visualiza os resultados, as recomendações e o histórico de alterações na plataforma AIADS.
3. TikTok Marketing API — campanhas publicitárias
Abaixo encontra cada área da API que utilizamos, com a respetiva função na plataforma AIADS e os endpoints invocados (TikTok API for Business v1.3).
| Área | Para que serve na AIADS | Endpoints |
|---|---|---|
| Conta publicitária | Leitura dos dados da conta (nome, moeda, fuso horário, estado) e das identidades publicitárias ao ligar o cliente. | advertiser/info/ identity/get/ |
| Gestão de anúncios | Sincronização de campanhas, conjuntos de anúncios e anúncios. Alterações aprovadas pelo gestor: estado, orçamento, lance, calendário. Os novos anúncios são sempre criados como desativados. | campaign/get/ campaign/update/ adgroup/get/ adgroup/update/ adgroup/budget/update/ ad/get/ ad/create/ ad/status/update/ |
| Relatórios | Resultados diários das campanhas (impressões, cliques, custo, conversões) para relatórios ao cliente, monitorização do orçamento e recomendações de otimização. | report/integrated/get/ |
| Medição de conversões | Envio de conversões do site e de conversões offline (p. ex. encomendas pagas do sistema da loja) através da Events API, configuração de pixels e eventos, verificação de que os eventos estão a chegar. | event/track/ pixel/list/ pixel/create/ pixel/event/create/ pixel/event/stats/ offline/create/ offline/get/ |
| Públicos | Listas de clientes do anunciante carregadas como endereços de e-mail ou números de telefone com hash (SHA-256), no mínimo 1000 registos, bem como públicos semelhantes (lookalike). | dmp/custom_audience/file/upload/ dmp/custom_audience/create/ dmp/custom_audience/update/ dmp/custom_audience/list/ dmp/custom_audience/lookalike/create/ dmp/custom_audience/delete/ |
| Leads | Obtenção dos pedidos dos formulários de contacto do TikTok (Instant Forms) para a caixa de leads do cliente na AIADS, para que o comercial possa ligar de volta rapidamente. | page/get/ page/lead/task/ page/lead/task/download/ |
| Catálogo de produtos | Catálogo para anúncios de produtos (DPA) alimentado pelo ficheiro de produtos da loja, que preparamos e alojamos para o cliente. | catalog/create/ catalog/get/ catalog/overview/ catalog/feed/create/ catalog/feed/get/ |
| Criativos | Carregamento de imagens e vídeos publicitários aprovados pelo cliente para a biblioteca da conta. | file/image/ad/upload/ file/video/ad/upload/ file/video/ad/info/ |
| Comentários nos anúncios | Lista de comentários nos anúncios, respostas da marca, bem como ocultar e repor comentários (p. ex. spam). Não eliminamos os comentários publicados nos anúncios. | comment/list/ comment/post/ comment/status/update/ |
| Diagnóstico de anúncios | Leitura das sugestões de diagnóstico do TikTok como um dos sinais nas recomendações destinadas ao gestor da campanha. | tool/diagnosis/get/ |
Não utilizamos os endpoints do Business Center (/bc/*) nem o TikTok Shop.
4. TikTok Accounts — publicações na conta da empresa
No módulo «Publicações social» da plataforma AIADS, o cliente pode encarregar-nos da publicação de materiais na sua conta de empresa do TikTok. Esta parte utiliza uma autorização separada (TikTok Accounts).
| Funcionalidade | Para que serve na AIADS | Endpoints |
|---|---|---|
| Perfil e estatísticas | Dados básicos da conta de empresa e estatísticas das publicações para o relatório do cliente e para a escolha dos melhores horários de publicação. | business/get/ business/video/list/ |
| Publicação | Publicação de vídeos e fotografias aprovados pelo cliente no calendário de publicações, bem como a verificação do estado da publicação. | business/video/settings/ business/video/publish/ business/photo/publish/ business/publish/status/ |
| Comentários | Moderação de comentários nas publicações a partir do painel: responder, ocultar, eliminar. É realizada por um membro da equipa. | business/comment/list/ business/comment/reply/list/ business/comment/reply/create/ business/comment/hide/ business/comment/delete/ |
5. Regras de segurança das alterações
- As operações de gravação funcionam por defeito «a seco» (sem envio para o TikTok). Após a gravação, a plataforma lê o estado a partir da API e confirma que a alteração foi aplicada.
- Criamos os novos anúncios como desativados e só ativamos campanhas e anúncios mediante instrução explícita do gestor.
- Os automatismos AIADS não aumentam o orçamento — o aumento é feito por uma pessoa após decisão do cliente. Cada alteração de orçamento e de licitação tem um limite de dimensão do passo e um limite máximo para toda a conta.
- Não eliminamos campanhas, grupos de anúncios nem anúncios — em vez disso, colocamo-los em pausa.
- Cada tentativa de gravação (executada, bloqueada ou falhada) é registada no registo de alterações, e um único interruptor pode bloquear todas as gravações (modo só de leitura).
6. Dados e privacidade
- Processamos os dados do TikTok em nome do cliente na qualidade de subcontratante (contrato de subcontratação), exclusivamente para efeitos de gestão das suas campanhas e de elaboração de relatórios.
- Os endereços de e-mail e os números de telefone são enviados ao TikTok apenas sob a forma de hash SHA-256. Nos eventos de conversão transmitimos também o identificador de clique (ttclid), o endereço IP e o navegador do utilizador, caso o consentimento para medição o permita.
- Não combinamos os dados de um cliente com os dados de outros clientes e não os utilizamos para treinar modelos de IA.
- Os leads dos formulários do TikTok são encaminhados exclusivamente para a caixa de leads do cliente que é titular da conta publicitária.
- Os pormenores do tratamento de dados são descritos na nossa política de privacidade.
7. Desassociação da conta e contacto
O titular da conta pode, a qualquer momento, revogar o acesso da aplicação AIADS nas definições do TikTok for Business ou solicitar-nos a desassociação da conta. Após a revogação do acesso, a plataforma deixa de recolher dados e de efetuar alterações nessa conta.
ICBM Polska Sp. z o.o.
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Contacto: formulário de contacto
ul. Dolne Migowo 13A/96, 80-282 Gdańsk
NIP: 9571102721, KRS: 0000722260
Contacto: formulário de contacto
