Âncora Link PRO

Plugin para integração com TikTok Ads via bloco Gutenberg no frontend - permite configurar pixels e eventos sem acessar o painel administrativo.

Description

O Âncora Link PRO oferece uma solução completa para integração com TikTok for Business, permitindo que usuários não técnicos configurem pixels e eventos diretamente no frontend através de um bloco Gutenberg intuitivo.

✨ Principais Recursos

• Formulário Guiado em 4 Etapas: Interface visual intuitiva para configuração completa
• Autenticação OAuth2: Conexão segura com TikTok for Business API
• Gerenciamento de Pixels: Criação e configuração de pixels diretamente no frontend
• Eventos de Teste: Envio automático de eventos de teste para validação
• Integração Hotmart: Instruções específicas para implementação na plataforma
• Segurança Avançada: Tokens únicos por usuário e validação de nonce
• Conformidade LGPD/GDPR: Remoção completa de dados na desinstalação

🎯 Etapas do Processo

1. Autenticação TikTok for Business

   • Login OAuth2 seguro
   • Autorização com escopos específicos
   • Armazenamento seguro de tokens

2. Gerenciamento de Pixel e Evento de Teste

   • Listagem de contas de anunciante
   • Criação ou seleção de pixels existentes
   • Envio automático de evento de teste (Purchase R$ 0,01)

3. Instruções para Hotmart

   • Exibição do código do pixel
   • Instruções passo a passo
   • Botão de cópia para facilitar implementação

4. Conclusão

   • Confirmação da integração
   • Link direto para painel TikTok Ads
   • Informações sobre tempo de processamento

🔧 Configuração

1. Instale e ative o plugin
2. Vá em Configurações > Âncora Link PRO
3. Configure as credenciais do TikTok for Business:
   • App ID
   • App Secret
   • Redirect URI
4. Adicione o bloco "TikTok Ads Integration" em qualquer página/post

🛡️ Segurança

• Validação e sanitização de todos os dados de entrada
• Tokens únicos por usuário para autenticação da API
• Verificação de nonce em todas as requisições
• Bloqueio de acesso direto aos arquivos PHP
• Hash SHA-256 dos dados do usuário

🌐 Conformidade

• LGPD/GDPR: Remoção completa de dados pessoais na desinstalação
• Privacidade: Dados sensíveis nunca expostos no frontend
• Transparência: Log opcional das operações para auditoria

Installation

Instalação Automática

1. No painel do WordPress, vá em Plugins > Adicionar Novo
2. Pesquise por "Âncora Link PRO"
3. Clique em Instalar Agora e depois Ativar

Instalação Manual

1. Faça download do arquivo ZIP do plugin
2. No painel do WordPress, vá em Plugins > Adicionar Novo > Enviar Plugin
3. Selecione o arquivo ZIP e clique em Instalar Agora
4. Ative o plugin após a instalação

Configuração Inicial

1. Acesse Configurações > Âncora Link PRO
2. Configure as credenciais do TikTok for Business
3. O Redirect URI deve ser: https://seusite.com/alink-pro-callback

Frequently Asked Questions

É necessário ter conhecimento técnico para usar o plugin?

Não! O plugin foi desenvolvido especificamente para usuários não técnicos, com interface visual intuitiva e instruções passo a passo.

Onde obtenho as credenciais do TikTok for Business?

1. Acesse https://ads.tiktok.com/
2. Vá em "Tools" > "TikTok for Business" > "Developer Tools"
3. Crie uma aplicação ou use uma existente
4. Configure o Redirect URI conforme instruções do plugin

O plugin funciona com outros além da Hotmart?

Sim! O código do pixel pode ser usado em qualquer plataforma que aceite códigos de rastreamento personalizados.

Os dados dos usuários ficam seguros?

Sim! O plugin segue as melhores práticas de segurança, usando tokens únicos, hashing SHA-256 e conformidade total com LGPD/GDPR.

Posso usar em sites multisite?

Sim, o plugin é compatível com WordPress multisite.

Quanto tempo leva para os eventos aparecerem no TikTok?

Os eventos podem levar até 24 horas para aparecer no painel do TikTok Ads, conforme documentação oficial da plataforma.

Screenshots

1. Bloco Gutenberg no editor com preview das 4 etapas
2. Etapa 1: Tela de autenticação com TikTok for Business
3. Etapa 2: Seleção de conta e gerenciamento de pixels
4. Etapa 3: Código do pixel e instruções para Hotmart
5. Etapa 4: Conclusão com link para painel TikTok
6. Página de configurações no painel administrativo

Changelog

1.0.0

• Lançamento inicial
• Implementação completa das 4 etapas de integração
• Autenticação OAuth2 com TikTok for Business API
• Gerenciamento de pixels e eventos de teste
• Interface responsiva e intuitiva
• Conformidade LGPD/GDPR
• Documentação completa

Upgrade Notice

1.0.0

Primeira versão do plugin. Instale para começar a usar a integração com TikTok Ads.

Technical Details

Requisitos do Sistema

• WordPress 5.8+
• PHP 7.4+
• cURL extension
• JSON extension

APIs Utilizadas

• TikTok for Business API v1.3
• WordPress REST API
• Gutenberg Block API

Estrutura de Arquivos

ancora-link-pro/
├── ancora-link-pro.php (arquivo principal)
├── admin/
│   └── admin-page.php
├── assets/
│   ├── css/
│   │   ├── style.css
│   │   └── editor.css
│   └── js/
│       ├── frontend.js
│       └── editor.js
├── includes/
│   ├── api-routes.php
│   └── tiktok-callback.php
├── languages/
├── uninstall.php
└── readme.txt

Hooks e Filtros Disponíveis

• ancora_link_pro_before_auth - Executado antes da autenticação
• ancora_link_pro_after_auth - Executado após autenticação bem-sucedida
• ancora_link_pro_pixel_created - Executado quando pixel é criado
• ancora_link_pro_test_event_sent - Executado após envio de evento teste

Para mais informações técnicas, consulte a documentação completa no GitHub.