Connettore TikTok Shop e Catalogo Pinterest: installazione e configurazione

Presentazione

Il modulo collega il tuo negozio PrestaShop 8 o 9 a due canali:

• TikTok Shop: creazione e aggiornamento degli annunci con l’API Partner, invio di stock e prezzi, importazione degli ordini, invio dei numeri di tracciamento.
• Pinterest: feed di catalogo TSV e, se vuoi, aggiornamenti in tempo reale con l’API Catalogs.

È incluso anche un feed CSV per i cataloghi TikTok Ads. Il modulo si trova in Catalogo > TikTok & Pinterest. La scheda Panoramica mostra una checklist di avvio con i passaggi mancanti.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e scegli il file ZIP.
2. Apri Catalogo > TikTok & Pinterest.
3. Nella scheda Impostazioni, controlla lingua, valuta e paese usati per i prezzi (inviati IVA inclusa per quel paese) e la dimensione delle immagini. TikTok Shop richiede almeno 600 x 600 pixel.

Pinterest

Solo feed, senza app

1. Scheda Pinterest: attiva Pinterest e copia l’URL del feed.
2. In Pinterest Business Hub apri Cataloghi > Origini dati, aggiungi un’origine e incolla l’URL. Pinterest importa il feed ogni 24 ore.

Aggiornamenti in tempo reale via API

1. Su developers.pinterest.com, crea un’app e aggiungi l’URI di reindirizzamento mostrato nella scheda Pinterest del modulo.
2. Inserisci App ID e App secret, lascia Aggiornamenti in tempo reale su Sì e clicca su Salva e collega Pinterest.
3. Una volta collegato, clicca su Crea l’origine dati su Pinterest: il modulo registra il feed con valuta e paese delle impostazioni.

Variazioni di stock, prezzo e rimozioni partono in pochi minuti. Due minuti dopo ogni invio il modulo legge l’esito di Pinterest. Un articolo rifiutato risulta in errore nella scheda Prodotti con il messaggio di Pinterest.

TikTok Shop

Creare l’app TikTok Shop

1. Su partner.tiktokshop.com, crea un’app venditore personalizzata o un’app di servizio di terze parti.
2. Attiva gli scope Product, Order, Fulfillment e Logistics.
3. Imposta come URL di reindirizzamento quello mostrato nella scheda TikTok Shop del modulo.
4. Copia App key, App secret e, se presente, il Service ID.

Collegare il negozio

1. Scheda TikTok Shop: attiva TikTok, scegli la regione (Europa e resto del mondo, o Stati Uniti), inserisci le credenziali e clicca su Salva e collega TikTok Shop.
2. Autorizza l’app sulla pagina TikTok. Il modulo recupera il negozio e il magazzino predefinito.
3. Scegli il magazzino se ne hai più di uno, poi produttore e persona responsabile per l’UE. Se gli elenchi sono vuoti, creali prima nel Seller Center e clicca su Aggiorna elenchi.
4. Clicca su Carica le categorie per scaricare l’albero delle categorie TikTok.

Impostazioni degli annunci

• Prezzo inviato: dopo gli sconti PrestaShop, o prezzo normale se gestisci le promozioni su TikTok.
• Pacco predefinito: peso e dimensioni per i prodotti che non li hanno.
• Crea nuovi annunci: se disattivato, il modulo aggiorna solo stock e prezzo degli annunci già online.

Annunci già presenti su TikTok Shop

Se vendi già su TikTok Shop, avvia Collega gli annunci esistenti nella scheda TikTok Shop prima della prima sincronizzazione. Il modulo collega gli annunci ai tuoi prodotti tramite SKU venditore:

• riferimento della combinazione;
• riferimento del prodotto, per un prodotto senza combinazioni;
• formato PS12 o PS12-34 usato dal modulo.

Un annuncio collegato mantiene titolo, immagini e descrizione TikTok: il modulo gestisce solo stock e prezzo. Per applicare il contenuto PrestaShop, apri l’anteprima del prodotto nella scheda Prodotti e clicca su Sostituisci il contenuto con i dati PrestaShop. Un annuncio i cui SKU puntano a più prodotti viene segnalato come conflitto e non collegato.

Mappatura delle categorie

La scheda Categorie associa ogni categoria PrestaShop a:

• una categoria Google, usata da Pinterest e dal feed TikTok Ads: digita qualche parola e scegli nella tassonomia Google integrata;
• una categoria TikTok Shop: digita per cercare, oppure clicca su Suggerisci perché TikTok proponga la categoria in base ai tuoi prodotti.

Una sottocategoria senza mappatura propria eredita quella del genitore, mostrata in grigio. I prodotti usano la loro categoria predefinita. Le modifiche si salvano insieme con Salva le modifiche.

Il pulsante Attributi apre gli attributi della categoria TikTok. Quelli con l’asterisco sono obbligatori e valgono per tutti i prodotti della categoria. La mappatura si esporta e importa in CSV (separatore punto e virgola).

Ordini TikTok

La scheda Ordini TikTok evita la sovravendita: senza importazione, una vendita su TikTok abbassa lo stock solo su TikTok. Le modalità sono tre:

• Crea ordini PrestaShop: ogni vendita diventa un ordine al prezzo pagato su TikTok (sconto venditore dedotto) e con le spese di spedizione TikTok. L’IVA la calcola PrestaShop e lo stock scende. Il pagamento compare come «TikTok Shop», con il numero d’ordine TikTok come transazione.
• Scala solo lo stock: per ordini spediti dal Seller Center o da TikTok.
• Disattivato.

Gli ordini vengono importati dal cron. All’attivazione vengono recuperati quelli delle ultime 24 ore. Scegli lo stato dei nuovi ordini e il corriere. Le spese di spedizione restano quelle pagate su TikTok, qualunque sia il corriere.

• Annullamenti: un annullamento su TikTok porta l’ordine su «Annullato», o ripristina lo stock in modalità solo stock.
• Errori: un ordine in errore (SKU non collegato, valuta non attiva) compare con il motivo ed è ritentato ogni 15 minuti. Il pulsante Riprova lo ripropone alla prossima importazione.
• Acquirenti: sono creati come clienti ospiti con un indirizzo @tiktokshop.invalid. TikTok vieta di contattarli fuori dalla piattaforma, quindi il modulo blocca qualsiasi e-mail a loro destinata.

La scheda ordine PrestaShop mostra un blocco TikTok Shop con numero TikTok, stato e tracciamento.

Numeri di tracciamento

Quando un numero di tracciamento viene aggiunto a un ordine importato, a mano o da un modulo corriere, viene inviato a TikTok entro 5 minuti e l’ordine TikTok risulta spedito. Gli ordini evasi da TikTok sono ignorati.

TikTok richiede un fornitore di spedizione. Nella scheda TikTok Shop, sezione Corrieri e fornitori di spedizione TikTok, associa ogni corriere a un fornitore TikTok. Senza associazione, il modulo cerca un fornitore con lo stesso nome. Se non lo trova, l’errore elenca i fornitori disponibili.

Scheda Prodotti

Ogni riga mostra miniatura, prezzo, stock, stato su ogni canale e un punteggio qualità su 100 con il problema principale. Le cause possibili sono:

• immagine mancante, prezzo zero o descrizione breve;
• EAN non valido;
• categoria non associata;
• più di 3 gruppi di attributi per TikTok.

I filtri mostrano i prodotti in errore, esclusi, senza categoria Google o TikTok, o collegati dal Seller Center. Seleziona i prodotti per esportarli o escluderli in massa, o per mettere in coda una sincronizzazione completa. L’anteprima mostra le varianti come saranno inviate e permette un titolo per canale. Sincronizza ora invia subito il prodotto.

Impostazioni avanzate

• Parametri UTM: aggiunti ai link dei feed e dei pin Pinterest per l’attribuzione in Google Analytics. Lascia vuoto per disattivarli.
• Etichette personalizzate: custom_label_0 = categoria, custom_label_1 = fascia di prezzo, custom_label_2 = promo o normale.
• Regole di esclusione: categorie (sottocategorie comprese), marchi, prezzo minimo IVA inclusa, e varianti esaurite tolte dai feed e da Pinterest. Un prodotto escluso viene tolto dai feed, eliminato da Pinterest e disattivato su TikTok Shop. Modificare una regola rimette in coda tutto il catalogo.
• Momento dell’invio: subito dopo ogni modifica (hosting PHP-FPM o LiteSpeed), o solo tramite cron.

Attività cron

Copia le due righe della scheda Panoramica nella crontab del tuo hosting:

• ogni 5 minuti, task=sync: coda, nuovi tentativi, ordini TikTok, tracciamento, esiti Pinterest;
• ogni ora, task=feeds: rigenerazione dei feed.

La panoramica indica se il cron è stato visto negli ultimi 20 minuti. Un errore dell’API viene ritentato dopo 2, 4, 8, 16 e 32 minuti.

Log e risoluzione dei problemi

La scheda Log conserva 30 giorni di eventi, filtrabili per canale: Pinterest, TikTok, ordini TikTok. Gli errori dell’API sono salvati con la risposta completa.

• Un prodotto non parte su TikTok: controlla il suo punteggio nella scheda Prodotti. Una categoria TikTok mancante o un prodotto virtuale bloccano l’invio.
• Un ordine TikTok resta in errore: lo SKU venditore deve corrispondere a un riferimento PrestaShop, o l’annuncio deve essere stato creato dal modulo. Correggi e clicca su Riprova.
• Le modifiche di un dipendente non partono: PrestaShop non esegue gli hook di un modulo per un profilo senza permesso «Visualizza» su quel modulo. Concedi il permesso o usa Sincronizza ora nella scheda Prodotti.