FastOG

Guida alla piattaforma FastOG

FastOG genera l'immagine che appare quando qualcuno condivide una delle tue pagine — il prodotto, la categoria, la home page, il post del blog. Sostituisce il default statico con una copertina live: la foto del prodotto, il suo prezzo attuale, la sua valutazione, il tuo logo e qualunque titolo tu scelga.

Questa guida è la mappa. Spiega cosa fa ogni funzionalità, dove modificarla su ciascuna piattaforma e quale piano la include. Per l'API, la firma HMAC e i tutorial sui framework, parti da la reference dell'API.

Dove viene eseguito FastOG

Piattaforma Dove si trova l'app Cosa apre il merchant
WooCommerce Admin di WordPress → FastOG Studio per modificare le copertine, Plan per cambiare piano, Support per un ticket, Tools per la connessione
Shopify Admin di Shopify → Apps → FastOG Covers, Plan, Support; i dettagli avanzati della connessione sono in fondo all'app
Wix Dashboard di Wix → Apps → FastOG Covers, Customize, Plans

La prima volta che apri l'app ti propone una breve configurazione: scegli quali tipi di pagina ricevono una copertina e scegli un aspetto iniziale. Puoi modificare entrambi in seguito — nulla nella configurazione è permanente.

Come viene scelta una copertina

FastOG firma un URL per la pagina che viene condivisa. La richiesta porta con sé lo store e il tipo di pagina, e il server applica la regola salvata per quel tipo di pagina:

  1. La regola del tipo di pagina — la copertina che hai modificato in Copertine per prodotti, collezioni/categorie, home o articoli del blog.
  2. Una regola più specifica, se ne esiste una corrispondente — una regola per un tag, una categoria, un fornitore o una collezione ha la precedenza sulla regola del tipo di pagina.
  3. Una copertina per singolo prodotto, se ne è salvata una — la più specifica di tutte; disponibile su Pro e superiori.

Se nessuna di queste corrisponde, la pagina mantiene l'immagine del suo tema. Ogni piattaforma assegna a ciascun tipo di pagina la propria copertina, quindi modificare la copertina di un prodotto non tocca la home page.

Copertine e tipi di pagina

Apri Copertine (Shopify, Wix) o FastOG → Studio (WooCommerce) e scegli il tipo di pagina sopra l'anteprima.

Piattaforma Tipi di pagina
WooCommerce Prodotto, Categoria, Home, Articolo del blog
Shopify Prodotto, Collezione, Home, Articolo del blog
Wix Prodotto, Collezione, Home, Articolo del blog, Pagina del sito

Ogni scheda ha il suo aspetto, i suoi testi e i suoi interruttori live. Salvare un tipo di pagina non modifica mai un altro. L'anteprima è la copertina reale: viene generata dallo stesso template e dagli stessi props che userà la pagina live.

WooCommerce aggiunge anche un piccolo pannello della copertina nella schermata di modifica del prodotto, così puoi vedere e modificare la copertina senza uscire dal prodotto. Shopify inserisce un blocco FastOG nella pagina del prodotto nell'admin per lo stesso motivo. Wix tiene tutto nell'app.

Scegliere un aspetto

L'aspetto è il layout che la copertina disegna — il template. Il selettore mostra l'intero catalogo, con gli aspetti bloccati contrassegnati per il piano che li sblocca.

Piano Aspetti
Community Il set gratuito
Starter Il set Starter curato
Pro Ogni template
Scale Ogni template, più il rendering prioritario

Un aspetto bloccato è una vetrina, non una scelta: puoi visualizzarne l'anteprima, e il prompt di upgrade indica il piano che lo sblocca. Il salvataggio viene rifiutato lato server, così l'anteprima e la copertina live non possono divergere.

Lo stesso selettore viene usato quando parti dalla procedura guidata di configurazione, e puoi cambiare l'aspetto di un tipo di pagina senza toccare gli altri.

Copia e stile

Dopo l'aspetto, l'editor ha due gruppi di campi:

  • Contenuto — il titolo, il sottotitolo, il badge, le righe delle caratteristiche, l'immagine e qualsiasi altra cosa stampi quel template. I campi lasciati vuoti ricadono sui dati dello store quando il template può compilarli.
  • Stile — tema, colori, font, pattern e finitura. Gli stili sono per template: un valore che ha senso in un layout non viene imposto a un altro.

Su WooCommerce e Shopify ogni piano può modificare la copia e lo stile della regola valida per tutto lo store. Su Wix i campi di contenuto e stile liberi sono il builder personalizzato Pro: Starter sceglie l'aspetto, e i campi fissi del preset vengono mostrati anziché modificabili liberamente.

L'editor per prodotto riservato a Pro applica gli stessi campi a un singolo articolo (vedi sotto), più l'override del logo.

Un campo contrassegnato come mai compilabile è un campo che FastOG si rifiuta di inventare. Le valutazioni sono il caso più comune: una riga di stelle vuota non viene riempita con una media fittizia.

Segnali live

I segnali live sono interruttori sotto la copertina, non testo che digiti. Decidono se la copertina può mostrare il valore che FastOG già conosce al momento della condivisione:

Segnale Cosa mostra Piano
Prezzo Il prezzo corrente, incluso il prezzo di confronto barrato quando il prodotto è in sconto Tutti i piani
Sconto Il nastro dello sconto / il trattamento del prezzo di confronto Tutti i piani
Disponibilità Scorte in esaurimento ("Solo 3 rimasti") ed esaurito Tutti i piani
Valutazione e numero di recensioni La media reale del negozio e il numero di recensioni Starter e superiori
Soglia di valutazione Nasconde del tutto la riga delle stelle sotto una valutazione o un numero di recensioni minimo Pro e superiori

Lo scopo dell'interruttore è permetterti di mantenere un campo nel layout ma nasconderlo quando i dati sono deboli. Un prodotto con 3,1 stelle e due recensioni di solito è meglio senza riga delle stelle che con una riga debole accanto al prezzo.

Disattivare un segnale non elimina nulla: il valore viene comunque letto dal negozio e la copertina semplicemente non lo stampa. Riattivandolo, ricompare al render successivo.

Copertine per prodotto e per articolo

Una copertina per prodotto è una copertina salvata per un singolo articolo, sovrapposta alla regola del tipo di pagina. È una funzionalità Pro e Scale.

Piattaforma Dove aprirla
WooCommerce Schermata di modifica del prodotto → il pannello FastOG cover → Customize cover
Shopify Apri il prodotto nell'admin di Shopify → il blocco prodotto FastOG → Customize cover
Wix Non ancora disponibile per singolo articolo; usa la copertina del tipo di pagina o un look che funzioni bene per ogni prodotto

Su Pro puoi modificare il look, i testi, i badge e lo stile per quel singolo prodotto. I prodotti senza override continuano a usare la regola del tipo di pagina. Rimuovere l'override su un prodotto ripristina la copertina condivisa; la scelta salvata viene conservata, non distrutta, se in seguito cambia il piano.

Il pannello del prodotto rimanda anche allo Studio, così la regola valida per tutto il negozio è a un clic di distanza quando il prodotto non ha bisogno di una copertina propria.

Regole per le linee di prodotto

Una regola con ambito (scoped rule) affina la copertina del prodotto per un gruppo di prodotti — un tag, una categoria, un tipo di prodotto, una collezione (Shopify) o un fornitore. È una funzionalità Scale.

Apri Copertine → Copertine per prodotti specifici (l'intestazione è la stessa su WooCommerce e Shopify). Aggiungi una regola, scegli l'ambito e l'aspetto, e salva. I prodotti che corrispondono usano l'aspetto e i testi della regola; tutto il resto mantiene la copertina del tipo di pagina.

Vince la corrispondenza più specifica, quindi non devi gestire un ordine. Il contatore delle regole mostra quante ne hai usate rispetto alla quota del piano; una regola può essere eliminata in qualsiasi momento. Wix non espone ancora le regole con ambito.

Campagne e ritorni programmati

Un ritorno programmato è la metà sicura di una campagna: pubblichi ora una copertina per il Black Friday o per una stagione e scegli la data e l'ora in cui deve tornare alla copertina che era attiva prima. La metà del ritorno è disponibile su tutti i piani, incluso Community.

Un avvio programmato è la metà Scale. Su Scale puoi anche impostare la data in cui la copertina della campagna va online; sotto Scale l'avvio è in pausa, con il design e le date conservati così che un upgrade possa riprenderlo. Entrambe le transizioni vengono verificate ogni cinque minuti, e gli orari usano il fuso orario mostrato sotto i campi.

Entrambe le metà richiedono una fine: una campagna con un avvio ma senza fine non verrebbe mai rimossa, quindi il modulo la rifiuta. Cancellare la fine annulla la campagna. Nulla viene eliminato da una scadenza del piano — le date e il design restano.

Esporta un PNG

L'azione Scarica PNG esegue il rendering della copertina che stai visualizzando a 1200×630 e la scarica. È una funzionalità Pro e Scale in WooCommerce e Shopify; Wix non la offre ancora.

Il file viene generato dal template e dalle props dell'editor stesso, quindi corrisponde all'anteprima e non a un template di esportazione separato. Usalo per una scheda su un marketplace, una presentazione o un post manuale in cui non puoi usare l'URL live.

Piani, copertura e limiti

FastOG vende copertura, non crediti di rendering. Un piano copre un certo numero di elementi del tuo catalogo e un insieme di funzionalità; i rendering non hanno un tetto massimo.

Community Starter Pro Scale
Prezzo Gratis $19 / mese $49 / mese $119 / mese
Elementi coperti 100 250 1.000 Illimitati
Tipi di pagina Tutti Tutti Tutti Tutti
Look Set gratuito Set curato Tutti Tutti
Prezzo, saldo e disponibilità Sì Sì Sì Sì
Valutazioni (stelle + conteggio) — Sì Sì Sì
Soglia di valutazione — — Sì Sì
Copertina per prodotto — — Sì Sì
Mappatura dei metafield — — Sì Sì
Esportazione PNG — — Sì Sì
Regole per le linee di prodotto — — — Sì
Avvio campagna — — — Sì
Ritorno programmato Sì Sì Sì Sì
Rendering prioritario — — — Sì

Il pannello copertura mostra quanti dei tuoi elementi copre il piano, suddivisi per prodotti, categorie, home e articoli del blog. Se il catalogo supera il limite, il pannello indica il piano successivo e il suo limite; non smette di eseguire il rendering in silenzio. Esegui l'upgrade da Plan (WooCommerce, Shopify) o Plans (Wix).

La fatturazione annuale è lo stesso livello a 10 mesi per un anno di 12 mesi. Wix fattura tramite Wix; WooCommerce e Shopify fatturano tramite la vista del piano nell'app.

Wix usa la stessa scala ma non espone ancora l'override per prodotto, le regole con ambito o l'esportazione PNG. Lì il piano controlla comunque copertura, look, valutazioni e il builder personalizzato.

Controlli di stato e aggiornamenti della cache

L'app esegue un breve controllo di stato e mantiene l'elenco completo dietro Details / What we checked. Risponde alle domande che in pratica rompono un'anteprima:

  • FastOG riesce a leggere i dati e il catalogo di questo store?
  • Il og:image della vetrina punta a FastOG, oppure sta vincendo un tema o un plugin SEO?
  • Il prodotto di esempio è reale e l'anteprima lo usa?
  • La chiave di firma e la connessione sono ancora valide?

Ogni rilevamento include una correzione, dove esiste. Il report è il blocco da copiare in un messaggio al supporto; è pensato per essere incollato, non interpretato.

Una copertina modificata non è sempre una copertina che la piattaforma ha riletto. L'URL firmato è deterministico, quindi l'immagine stessa si aggiorna; ciò che resta in cache è la copia dell'anteprima della pagina da parte della piattaforma. Esegui di nuovo lo scraping o attendi che scada la cache della piattaforma — vedi la guida alla cache e forzare un aggiornamento di Facebook. Se il og:image della pagina è ancora quello del tema, il controllo di stato mostrerà che sta vincendo un altro plugin o il tema.

Supporto

Usa Supporto per un problema di configurazione, consegna delle copertine, fatturazione o prodotto. Includi la pagina o il prodotto interessato, cosa ti aspettavi e cosa è successo; il report di stato è l'allegato più rapido. Si tratta di supporto prodotto asincrono, non di chat dal vivo o consulenza generale.

Prima di aprire un ticket, prova il controllo di stato: intercetta le cause più comuni (non connesso, copertine non servite, un plugin SEO che sovrascrive og:image, una cache della piattaforma non aggiornata).

Risoluzione dei problemi in una pagina

Sintomo Controlla prima
Il link condiviso non ha un'immagine Controllo di stato → lo storefront og:image è di FastOG? Il tipo di pagina è coperto?
L'anteprima mostra il vecchio prezzo La cache della piattaforma; l'URL live viene firmato a ogni render. Esegui di nuovo lo scraping della pagina
La copertina ha l'aspetto sbagliato La regola del tipo di pagina, una regola con ambito, o un override per prodotto (vince la più specifica)
Un aspetto bloccato non si salva Appartiene a un piano superiore; il selettore indica il piano
Manca una valutazione Il prodotto non ha ancora recensioni, oppure il piano è inferiore a Starter, oppure l'interruttore della valutazione è disattivato
Una modifica per prodotto non ha avuto effetto Le copertine per prodotto sono Pro/Scale, e il server rifiuta il salvataggio al di sotto di quel piano
La copertina è sfocata su WhatsApp Vedi Dimensione dell'immagine OG e Anteprime su WhatsApp

Provalo gratis — nessuna registrazione richiesta

Anteprima e test delle immagini OG dinamiche in pochi secondi.

Apri il tester gratuito di immagini OG