Condivisione

Condivisione per dispositivi

Questo endpoint è stato dichiarato obsoleto il 2 novembre 2020.

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

Con la condivisione per dispositivi, il dispositivo mostra un codice alfanumerico e indica agli utenti di inserirlo in una pagina web sul proprio PC o smartphone. Le persone che utilizzano la tua app o il tuo servizio possono quindi condividere i contenuti su Facebook con una finestra di condivisione associata al codice.

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

Questa guida descrive:

Esperienza utente

1. Call to action

Per prima cosa considera in che punto della tua esperienza utente vuoi chiedere alle persone di condividere contenuti su Facebook. Per garantire la migliore esperienza possibile, progetta il pulsante in modo che assomigli il più possibile al pulsante ufficiale Condividi di Facebook. In generale, il pulsante dovrebbe essere posizionato accanto al contenuto da condividere.

Dal punto di vista visivo, ciò significa che dovresti eseguire le seguenti azioni:

  1. Inserire per il pulsante l'etichetta con "Condividi" o "Condividi su Facebook"
  2. Usare 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 sul brand di 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". Visualizza il codice completo che hai ricevuto dall'API Device Share di Facebook. Il codice ha una lunghezza compresa tra 6 e 12 caratteri.

Includi un pulsante Close o Done in modo che le persone possano completare il flusso di condivisione per il dispositivo.

3. Condivisione

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

Dopo aver inserito il codice e cliccato su Continue, verrà presentata una finestra di condivisione:

Per informare gli utenti che la loro condivisione è andata a buon fine, viene visualizzato un messaggio di conferma:

Implementazione di Condivisione per dispositivi

La Condivisione per dispositivi di Facebook è destinata ai dispositivi che possono effettuare chiamate HTTP su Internet. Di seguito sono riportate le possibili chiamate e risposte API del dispositivo.

1. Abilitazione di Facebook Login per i dispositivi

Carica la dashboard dell'app e modifica Impostazioni > Avanzate > Impostazioni OAuth > Accesso da dispositivi su "Sì".

2. Generazione di un codice

Quando l'utente clicca sulla call to action Share, il dispositivo dovrebbe eseguire una richiesta HTTP POST a:

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

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

L'API supporta anche action_type e action_properties invece di href se vuoi condividere una notizia Open Graph (allo stesso modo di Azioni Open Graph nella finestra di condivisione).

L'API supporta anche i parametri quote e hashtag (allo 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. Dopo questo periodo di tempo, il codice non deve più essere visibile.

3. Visualizzazione del codice

Dopo aver mostrato lo user_code, il dispositivo deve invitare le persone 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 token richiede TLS/HTTPS.

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

Posso sapere quando la persona ha completato una condivisione?
No.

Posso pubblicare per conto della persona da codice?
No. Per farlo, devi chiedere all'utente di accedere e concederti le autorizzazioni per pubblicare per suo conto. Fai riferimento alla pubblicazione con l'API Graph per saperne di più.