Conector TikTok Shop e Catálogo Pinterest: instalação e configuração

Apresentação

O módulo liga a sua loja PrestaShop 8 ou 9 a dois canais:

• TikTok Shop: criação e atualização de anúncios pela API Partner, envio de stock e preços, importação de encomendas e envio dos números de seguimento.
• Pinterest: feed de catálogo TSV e, opcionalmente, atualizações em tempo real pela API Catalogs.

Inclui também um feed CSV para catálogos TikTok Ads. O módulo está em Catálogo > TikTok & Pinterest. O separador Visão geral mostra uma lista de arranque com os passos em falta.

Instalação

1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e escolha o ficheiro ZIP.
2. Abra Catálogo > TikTok & Pinterest.
3. No separador Definições, verifique o idioma, a moeda e o país usados para os preços (enviados com IVA desse país) e o tamanho de imagem. O TikTok Shop exige pelo menos 600 x 600 píxeis.

Pinterest

Só o feed, sem app

1. Separador Pinterest: ative o Pinterest e copie o URL do feed.
2. No Pinterest Business Hub, abra Catálogos > Origens de dados, adicione uma origem e cole o URL. O Pinterest importa o feed a cada 24 horas.

Atualizações em tempo real pela API

1. Em developers.pinterest.com, crie uma app e adicione o URI de redirecionamento mostrado no separador Pinterest do módulo.
2. Introduza o App ID e o App secret, deixe Atualizações em tempo real em Sim e clique em Guardar e ligar o Pinterest.
3. Depois de ligado, clique em Criar a origem de dados no Pinterest: o módulo regista o feed com a moeda e o país das definições.

As alterações de stock, preço e remoções seguem então em poucos minutos. Dois minutos após cada envio, o módulo lê o resultado do Pinterest. Um artigo rejeitado fica com erro no separador Produtos com a mensagem do Pinterest.

TikTok Shop

Criar a app TikTok Shop

1. Em partner.tiktokshop.com, crie uma app de vendedor personalizada ou de serviço de terceiros.
2. Ative os scopes Product, Order, Fulfillment e Logistics.
3. Defina como URL de redirecionamento o que aparece no separador TikTok Shop do módulo.
4. Copie o App key, o App secret e, se a app o tiver, o Service ID.

Ligar a loja

1. Separador TikTok Shop: ative o TikTok, escolha a região (Europa e resto do mundo, ou Estados Unidos), introduza as credenciais e clique em Guardar e ligar o TikTok Shop.
2. Autorize a app na página do TikTok. O módulo obtém a loja e o armazém predefinido.
3. Escolha o armazém, se tiver vários, e depois o fabricante e a pessoa responsável para a UE. Se as listas estiverem vazias, crie-os primeiro no Seller Center e clique em Atualizar listas.
4. Clique em Carregar categorias para obter a árvore de categorias TikTok.

Definições dos anúncios

• Preço enviado: após os descontos PrestaShop, ou preço normal se gerir as promoções no TikTok.
• Encomenda predefinida: peso e dimensões para os produtos que não os têm.
• Criar novos anúncios: desativado, o módulo só atualiza o stock e o preço dos anúncios já publicados.

Anúncios já existentes no TikTok Shop

Se já vende no TikTok Shop, execute Ligar os anúncios existentes no separador TikTok Shop antes da primeira sincronização. O módulo liga os anúncios aos seus produtos pelo SKU de vendedor:

• referência da combinação;
• referência do produto, para um produto sem combinações;
• formato PS12 ou PS12-34 usado pelo módulo.

Um anúncio ligado mantém o título, as imagens e a descrição do TikTok: o módulo só gere o stock e o preço. Para lhe aplicar o conteúdo PrestaShop, abra a pré-visualização do produto no separador Produtos e clique em Substituir o conteúdo pelos dados do PrestaShop. Um anúncio cujos SKU apontam para vários produtos é assinalado como conflito e não é ligado.

Associação de categorias

O separador Categorias associa cada categoria PrestaShop a:

• uma categoria Google, usada pelo Pinterest e pelo feed TikTok Ads: escreva algumas palavras e escolha na taxonomia Google integrada;
• uma categoria TikTok Shop: escreva para pesquisar, ou clique em Sugerir para o TikTok propor uma com base nos seus produtos.

Uma subcategoria sem associação própria herda a da categoria-mãe, mostrada a cinzento. Os produtos usam a sua categoria predefinida. As alterações guardam-se em conjunto com Guardar alterações.

O botão Atributos abre os atributos da categoria TikTok. Os marcados com asterisco são obrigatórios e aplicam-se a todos os produtos da categoria. A associação exporta-se e importa-se em CSV (separador ponto e vírgula).

Encomendas TikTok

O separador Encomendas TikTok evita vender em excesso: sem importação, uma venda no TikTok só baixa o stock no TikTok. Há três modos:

• Criar encomendas PrestaShop: cada venda torna-se uma encomenda ao preço pago no TikTok (desconto do vendedor deduzido) e com os portes do TikTok. O IVA é calculado pelo PrestaShop e o stock baixa. O pagamento aparece como «TikTok Shop», com o número da encomenda TikTok como transação.
• Apenas descontar stock: para encomendas enviadas a partir do Seller Center ou pelo TikTok.
• Desativado.

As encomendas são importadas pela tarefa cron. Ao ativar, são recuperadas as das últimas 24 horas. Escolha o estado das novas encomendas e a transportadora. Os portes continuam a ser os pagos no TikTok, seja qual for a transportadora.

• Cancelamentos: um cancelamento no TikTok passa a encomenda a «Cancelada», ou repõe o stock no modo só stock.
• Erros: uma encomenda com erro (SKU não ligado, moeda não ativa) aparece com o motivo e é repetida a cada 15 minutos. O botão Repetir tenta novamente na próxima importação.
• Compradores: são criados como clientes convidados com uma morada @tiktokshop.invalid. O TikTok proíbe contactá-los fora da plataforma, por isso o módulo bloqueia qualquer e-mail dirigido a eles.

A ficha da encomenda PrestaShop mostra um bloco TikTok Shop com o número TikTok, o estado e o seguimento.

Números de seguimento

Quando um número de seguimento é adicionado a uma encomenda importada, à mão ou por um módulo de transportadora, é enviado ao TikTok em 5 minutos e a encomenda TikTok fica marcada como enviada. As encomendas processadas pelo TikTok são ignoradas.

O TikTok exige um fornecedor de envio. No separador TikTok Shop, secção Transportadoras e fornecedores de envio TikTok, associe cada transportadora a um fornecedor TikTok. Sem associação, o módulo procura um fornecedor com o mesmo nome. Se não encontrar, o erro lista os fornecedores disponíveis.

Separador Produtos

Cada linha mostra miniatura, preço, stock, estado em cada canal e uma pontuação de qualidade sobre 100 com o principal problema. As causas possíveis são:

• imagem em falta, preço zero ou descrição curta;
• EAN inválido;
• categoria não associada;
• mais de 3 grupos de atributos para o TikTok.

Os filtros mostram produtos com erro, excluídos, sem categoria Google ou TikTok, ou ligados a partir do Seller Center. Selecione produtos para os exportar ou excluir em massa, ou para colocar uma sincronização completa na fila. A pré-visualização mostra as variantes tal como serão enviadas e permite um título por canal. Sincronizar agora envia o produto de imediato.

Definições avançadas

• Parâmetros UTM: adicionados às ligações dos feeds e dos pins do Pinterest para a atribuição no Google Analytics. Deixe vazio para desativar.
• Etiquetas personalizadas: custom_label_0 = categoria, custom_label_1 = escalão de preço, custom_label_2 = promoção ou normal.
• Regras de exclusão: categorias (com subcategorias), marcas, preço mínimo com IVA, e variantes sem stock retiradas dos feeds e do Pinterest. Um produto excluído sai dos feeds, é eliminado do Pinterest e desativado no TikTok Shop. Alterar uma regra volta a pôr todo o catálogo na fila.
• Momento do envio: logo após cada alteração (alojamento PHP-FPM ou LiteSpeed), ou apenas por cron.

Tarefa cron

Copie as duas linhas do separador Visão geral para a crontab do seu alojamento:

• a cada 5 minutos, task=sync: fila, novas tentativas, encomendas TikTok, seguimento, resultados Pinterest;
• a cada hora, task=feeds: regeneração dos feeds.

A visão geral indica se o cron foi visto nos últimos 20 minutos. Um erro da API é repetido ao fim de 2, 4, 8, 16 e 32 minutos.

Registos e resolução de problemas

O separador Registos guarda 30 dias de eventos, filtráveis por canal: Pinterest, TikTok, encomendas TikTok. Os erros da API ficam guardados com a resposta completa.

• Um produto não segue para o TikTok: verifique a pontuação no separador Produtos. Uma categoria TikTok em falta ou um produto virtual bloqueiam o envio.
• Uma encomenda TikTok continua com erro: o SKU de vendedor tem de corresponder a uma referência PrestaShop, ou o anúncio tem de ter sido criado pelo módulo. Corrija e clique em Repetir.
• As alterações de um funcionário não seguem: o PrestaShop não executa os hooks de um módulo para um perfil sem permissão «Ver» nesse módulo. Dê essa permissão, ou use Sincronizar agora no separador Produtos.