Condivisione

Uso degli oggetti

Argomenti correlati

Facebook ti permette di pubblicare notizie elaborate e strutturate costituite da oggetti e azioni dalla tua app tramite un'API fortemente tipizzata. Gli oggetti sono "nomi" oppure obiettivi per le azioni eseguite nella tua app.

Nelle pagine web, gli oggetti sono definiti dagli elementi HTML di markup Open Graph.

Creazione di oggetti

Gli oggetti sono creati aggiungendo metatag Open Graph alla pagina che ospita i tuoi contenuti.

I seguenti tag di base sono obbligatori per rendere la pagina un oggetto. Aggiungili all'<head> del codice HTML della pagina.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

Su alcune piattaforme di hosting e sviluppo, in cui puoi creare la pagina di un oggetto e pubblicare quest'ultimo su Open Graph simultaneamente, potrebbe essere visualizzato un errore indicante che l'oggetto non esiste. L'errore è dovuto a una race condition presente in alcuni sistemi. Ti consigliamo di verificare che la pagina dell'oggetto sia creata prima di pubblicare un'azione su Open Graph o di inserire un piccolo ritardo che tenga conto dell'intervallo di replica (ad es. 15-30 secondi).


Test

Puoi testare il markup passando un URL mediante il debugger di condivisione, che mostrerà i tag estratti dal crawler ed eventuali errori o avvisi.

Aggiornamento degli oggetti

Il crawler di Facebook estrarrà nuovamente i dati dagli oggetti (aggiornandoli):

  • quando l'URL dell'oggetto è inserito nel debugger di condivisione;
  • ogni 30 giorni dopo la prima estrazione;
  • quando l'app attiva l'estrazione tramite un endpoint API.

L'endpoint dell'API Graph è una semplice chiamata a:

POST /?id={object-instance-id or object-url}&scrape=true

La risposta dell'endpoint sarà un oggetto JSON contenente informazioni sull'oggetto da cui sono stati estratti i dati (gli stessi restituiti alla lettura dell'ID dell'oggetto tramite l'API Graph).

Il parametro id può essere l'URL canonico dell'oggetto o l'ID dell'istanza dell'oggetto nel graph.

È sempre possibile modificare le proprietà di un oggetto, con due eccezioni:

  • Titolo: una volta associate 50 azioni ("Mi piace", condivisioni e commenti) a un oggetto, non potrai più modificarne il titolo.
  • Tipo: non puoi modificare il tipo di oggetto dopo che è stato usato in una notizia. Per maggiori informazioni, consulta Tipi di Open Graph.

Se desideri aggiornare l'immagine di un oggetto, ti consigliamo di usare un URL diverso rispetto a quello dell'immagine originale. La memorizzazione nella cache potrebbe impedire l'aggiornamento dell'immagine.

Migrazione delle pagine e modifica degli URL

Se sposti una pagina su un altro URL, puoi usare quello vecchio come sorgente canonica per il nuovo URL, mantenendo i "Mi piace", i commenti e le condivisioni dell'oggetto. Scopri come fare nella guida alla condivisione per i webmaster.