Integrations

Le integrazioni sono il modo in cui Mediastilo pubblica le tue bozze finite nei luoghi dove il tuo pubblico legge davvero. Colleghi una destinazione una volta per brand e da quel momento puoi inviare direttamente lì qualsiasi bozza pronta. I collegamenti si gestiscono dalla sezione Integrations della dashboard.

Destinazioni supportate

Oggi Mediastilo offre tre destinazioni di pubblicazione:

Ogni destinazione è un collegamento per brand: collegare WordPress per un brand non lo collega per gli altri. Vedi Workspaces & Brands.

La pubblicazione dipende dal piano. Se non vedi Integrations o l'azione Push, controlla il tuo piano in Credits & Billing.

Collegare una destinazione

1. Vai su Integrations e scegli un tipo di destinazione.
2. Compila i campi (vedi sotto). I campi segreti (password, chiavi API, segreti di firma) sono cifrati a riposo e mascherati ogni volta che riapri il collegamento.
3. Mediastilo esegue un test di connessione per confermare che le credenziali funzionano prima di salvare.
4. Il collegamento risulta Active quando è tutto a posto, oppure Error se un controllo successivo fallisce (per esempio se rigeneri una chiave sulla destinazione).

Puoi ripetere il test in qualsiasi momento, ricollegarti con nuove credenziali o scollegare del tutto una destinazione.

WordPress

WordPress ha una configurazione guidata. Clicca su Set up with guide, inserisci l'indirizzo del sito e Mediastilo lo verifica e ti propone la strada più semplice:

• Autorizzazione con un clic (consigliata). Se il sito la supporta, Mediastilo ti porta sul tuo WordPress per approvare l'accesso, senza password da copiare. WordPress genera una Application Password e la restituisce in automatico.
• Inserimento manuale (alternativa). Se l'autorizzazione con un clic non è disponibile, crea una Application Password in WordPress (Users → Profile → Application Passwords) e incollala insieme all'URL del sito e al nome utente.

Dopo il collegamento, la procedura guidata ti permette di scegliere le impostazioni di pubblicazione predefinite (il tipo di contenuto, le categorie predefinite e se gli articoli escono pubblicati o come bozza) e, facoltativamente, di aggiornare la voce del brand rianalizzando il sito (consuma un credito di analisi). Potrai modificarle in seguito dal collegamento WordPress (Edit publishing defaults).

Ghost

Mediastilo usa la Ghost Admin API. In Ghost, crea una Custom Integration (Settings → Integrations → Add custom integration) per ottenere una Admin API key nel formato id:secret e la Admin API URL. Incolla entrambe qui.

Webhook / Custom REST

Per tutto il resto, indica a Mediastilo un URL di endpoint che controlli. Alla pubblicazione, Mediastilo invia un POST JSON che descrive il contenuto, firmato con un'intestazione X-Mediastilo-Signature: sha256=… derivata dal tuo segreto di firma, così il ricevente può verificare che la richiesta sia autentica. Quando testi il collegamento viene inviato un evento ping.

Pubblicare una bozza

Quando una destinazione è collegata e una bozza è Ready, usa Push nell'editor o nella vista della bozza per inviarla. Puoi pubblicare su più destinazioni contemporaneamente selezionandole. Per una destinazione WordPress selezionata puoi regolare lì stesso tipo di contenuto, categorie, tag e stato, già compilati con le impostazioni predefinite salvate e modificabili a ogni pubblicazione. Mediastilo:

• Invia titolo e testo come articolo pubblicato (o programmato, se imposti un orario di pubblicazione), con il tipo di contenuto, le categorie e i tag scelti.
• Registra il risultato: l'ID dell'articolo sulla destinazione e un link per visualizzarlo.
• Segna la pubblicazione come published o failed, con l'errore se qualcosa è andato storto, così puoi correggere il collegamento e riprovare.

Vedi Drafts & Publishing per il ciclo di vita completo di una bozza.

Cosa legge un collegamento

Un collegamento funziona in due direzioni. Oltre a inviare bozze, Mediastilo rilegge ciò che il sito ha già pubblicato (titolo, data, autore, categorie e tag), così la tua produzione può essere misurata come misuriamo quella di tutti gli altri. Non ti viene chiesto nulla in più: la lettura usa le credenziali che hai già fornito per pubblicare e riguarda solo gli articoli pubblicati. Bozze, articoli privati e tutto ciò che è ancora in un flusso redazionale restano dove sono.

È la differenza tra un sito su cui pubblichi e un sito che osservi: un CMS collegato fornisce date e categorie reali, non quello che una pagina pubblica mostra per caso, ed è quindi la base affidabile dei tuoi benchmark. Scollega la destinazione e anche la lettura si ferma.

Cosa torna indietro: Google Search Console

Le destinazioni sono il luogo dove vanno i tuoi contenuti. La Search Console è l'altra metà: cosa succede dopo che ci sono arrivati. Collegandola, Mediastilo vede i termini di ricerca che le persone hanno digitato prima di trovare il tuo sito, su quali pagine sono arrivate e con quale frequenza, così le idee che suggeriamo si basano su ciò che le persone cercano davvero e non solo su ciò che ci dici di trattare.

Si trova nella sezione What comes back della pagina Integrations, sotto le tue destinazioni.

Cosa leggiamo e cosa non possiamo fare

• Leggiamo termini di ricerca, pagine di destinazione, clic, impressioni e posizione media, fino agli ultimi 16 mesi.
• L'autorizzazione è di sola lettura. Mediastilo non può modificare nulla nella Search Console né in altre parti del tuo account Google.
• Non vediamo mai la tua password Google e puoi scollegarti in qualsiasi momento.

Puoi anche semplicemente chiedere

Quando esiste uno dei due collegamenti, Ask e l'assistente alle bozze possono consultarlo in una conversazione: «cosa digitano le persone per trovarci?», «com'è andato l'articolo della settimana scorsa?», «cosa abbiamo pubblicato davvero questo mese?». Gli strumenti vengono offerti a una conversazione solo quando il collegamento c'è, quindi una risposta sui tuoi termini di ricerca non viene mai costruita da conoscenze generiche. Finché non colleghi nulla, Ask dice cosa gli manca e può mostrarti una scheda che porta a questa pagina; il collegamento vero e proprio lo fai sempre tu, con il tuo account.

Prima di collegare

Devi essere già verificato come proprietario o utente del sito nella Search Console, con l'account Google che stai per collegare. Se colleghi un account non verificato per il tuo sito, il collegamento riesce ma non c'è nulla da misurare: Mediastilo te lo segnala e ti propone di provare con un altro account.

Scegliere il sito da misurare

Dopo l'autorizzazione scegli una proprietà. La Search Console ne ha due tipi, che non contengono gli stessi dati:

È il motivo più comune per cui un collegamento alla Search Console non restituisce nulla senza dare errori: un sito servito su example.com misurato con una proprietà per https://www.example.com/. Mediastilo confronta ogni proprietà con il sito su cui pubblichi già e segna quella più probabile con Matches your site, quindi nella maggior parte dei casi la risposta giusta è già in cima alla lista.

Le proprietà che vedi ma non puoi leggere (la Search Console le chiama utente non verificato) compaiono in grigio con il motivo. Chiedi al proprietario del sito un accesso completo o limitato e diventeranno selezionabili.

Non viene mai scelto nulla al posto tuo, nemmeno quando c'è una sola opzione, perché questa scelta decide il significato di ogni numero successivo.

Mentre lo storico si riempie

I giorni più recenti arrivano per primi, quindi l'ultimo mese è utilizzabile quasi subito. I mesi precedenti vengono raccolti in background nei giorni successivi e la scheda mostra quanti dei sedici mesi sono già disponibili.

La Search Console pubblica i dati con qualche giorno di ritardo, quindi i numeri più recenti sono sempre un po' indietro rispetto a oggi. Il ritardo è di Google, non nostro.

Ricollegare e scollegare

• Needs reconnecting significa che Google non accetta più il collegamento, di solito perché l'accesso è stato rimosso nell'account Google o perché la persona che l'aveva concesso non c'è più. Nulla di quanto raccolto va perso: ricollegati e la misurazione riprende da dove si era fermata.
• Disconnect rimuove il collegamento ed elimina i dati di ricerca raccolti attraverso di esso.

Risoluzione dei problemi

• Il collegamento mostra Error: ripeti il test. Le cause più comuni sono una chiave API rigenerata, una Application Password scaduta o un URL del sito cambiato. Ricollegati con credenziali nuove.
• WordPress non funziona: verifica di usare la Application Password (non la password di accesso) e che la REST API sia raggiungibile su …/wp-json/.
• Ghost non funziona: verifica che la chiave sia la Admin API key completa nel formato id:secret e che l'URL punti al dominio di amministrazione di Ghost.
• Il webhook non funziona: verifica che il tuo endpoint risponda con uno stato 2xx all'evento ping e che controlli l'intestazione X-Mediastilo-Signature.

Cosa arriverà per le integrazioni

Il modello di collegamento è pensato per crescere: le destinazioni sono modulari e l'autorizzazione con un clic è già attiva per WordPress. Portare lo stesso accesso senza copia e incolla su altre piattaforme è nella roadmap. Le nuove destinazioni compaiono in automatico nell'elenco Integrations appena vengono rilasciate.

Vedi anche

• Drafts & Publishing: generare e inviare bozze.
• Workspaces & Brands: i collegamenti sono per brand.
• Account & Settings: dove si trovano le Integrations.
• Credits & Billing: quali piani includono la pubblicazione.