Sharing for Devices

Con Sharing for Devices, gli utenti possono condividere facilmente i contenuti dai dispositivi su Facebook. Tali dispositivi includono smart TV, cornici digitali o dispositivi per l'Internet delle cose.

Con la condivisione dal dispositivo, i dispositivi mostrano agli utenti un codice alfanumerico da inserire in una pagina Web su PC o smartphone. Gli utenti che usano la tua app o il tuo servizio possono quindi condividere contenuti su Facebook con una finestra di condivisione associata al codice.

Se stai creando un'app per Apple TV o per i dispositivi Android, devi usare rispettivamente il nostro SDK per tvOS o SDK per Android.

Questa guida descrive:

Esperienza utente

1. Call to action

Per prima cosa, pensa a quando desideri chiedere agli utenti di condividere contenuti su Facebook. Per assicurare un'esperienza ottimale, crea un pulsante il più possibile simile al pulsante Condividi di Facebook ufficiale. In generale, il pulsante deve essere posizionato accanto al contenuto da condividere.

Dal punto di vista visivo:

  1. Associa al pulsante un'etichetta "Condividi" o "Condividi su Facebook".
  2. Usa il bianco e il blu ufficiale Facebook: #3B5998.
  3. Se il dispositivo supporta un display grafico, puoi anche incorporare il logo "f" ufficiale. Secondo le linee guida per la marca Facebook, il logo deve rimanere sempre bianco o essere colorato con il blu Facebook (#3B5998).

2. Visualizzazione del codice

Quando qualcuno clicca sulla call to action, il tuo dispositivo effettua una chiamata all'API di Facebook che restituisce un codice.

Nella tua interfaccia, invita gli utenti a visitare un sito Web e a inserire tale codice mostrando loro il messaggio seguente: "Successivamente, visita facebook.com/device (http://facebook.com/device) su computer o smartphone, quindi inserisci questo codice". Mostra il codice completo che hai ricevuto dall'API Device Share di Facebook. Il codice ha una lunghezza compresa tra 6 e 12 caratteri.

Per consentire agli utenti di completare il flusso di condivisione dal dispositivo, includi un pulsante Close o Done.

3. Condivisione

Questo è il flusso visualizzato dagli utenti quando accedono a facebook.com/device su computer o browser mobili. Per prima cosa, visualizzano un campo di testo in cui possono inserire il loro codice:

Dopo aver inserito il codice e aver cliccato su Continue, visualizzeranno una finestra di condivisione:

Gli utenti capiscono che la condivisione è stata effettuata correttamente e visualizzano un messaggio di conferma:

Implementazione di Sharing for Devices

Facebook Sharing for Devices funziona con i dispositivi che possono effettuare chiamate HTTP tramite Internet. Di seguito sono riportate le possibili chiamate e risposte API del dispositivo.

1. Abilitazione di Facebook Login per i dispositivi

Accedi alla dashboard dell'app e configura Settings > Advanced > OAuth Settings > Login from Devices su "Yes".

2. Generazione di un codice

Quando l'utente clicca sulla call to action Share, il tuo dispositivo deve effettuare una richiesta POST HTTP a:

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

Il CLIENT_TOKEN è disponibile in Impostazioni dell'app -> Avanzate e deve essere combinato con l'ID app (separato con una barra verticale, |) per formare l'access_token completo.

Se desideri condividere una notizia Open Graph, l'API supporta anche action_type e action_properties anziché href (allo stesso modo delle azioni Open Graph nella finestra di condivisione).

L'API supporta anche i parametri quote e hashtag (nello stesso modo dei parametri della finestra di condivisione).

La risposta viene visualizzata in questo modo:

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

La risposta indica che:

  1. Devi mostrare la stringa "A1NWZ9" sul dispositivo.
  2. Devi invitare l'utente ad accedere a "facebook.com/device", quindi a inserire il codice.
  3. Il codice scade dopo 420 secondi. Devi chiudere la finestra del codice dopo tale periodo di tempo.

3. Visualizzazione del codice

Dopo aver mostrato lo user_code, il dispositivo deve invitare gli utenti a visitare verification_uri tramite PC o smartphone, ad esempio facebook.com/device. Vedi Esperienza utente.

Risoluzione dei problemi

Posso effettuare le richieste nel flusso del dispositivo tramite HTTP?
L'API Graph con i token richiede TLS/HTTPS.

Posso effettuare le richieste nel flusso del dispositivo con il metodo GET?
Tutte richieste effettuate nel flusso del dispositivo devono essere di tipo POST.

Posso comunicare quando l'utente ha completato una condivisione?
No.

Posso pubblicare post per conto dell'utente in modo programmatico?
No. Per farlo, devi richiedere all'utente di effettuare l'accesso e concedere le autorizzazioni per consentirti di pubblicare contenuti per suo conto. Per scoprire di più, consulta l'articolo relativo alla pubblicazione con l'API Graph.