API Marketing

Creazione di contenuti brandizzati

I creator, i personaggi famosi e le aziende media possono condividere contenuti brandizzati su Facebook. I post con contenuto brandizzato sono quei contenuti che mettono in evidenza un inserzionista o un marketer o ne sono influenzati in cambio di valore. Per usarli, devi rispettare la nostra normativa sui contenuti brandizzati e le nostre Normative pubblicitarie. Inoltre, devi taggare il tuo partner commerciale nei post che usano lo strumento per i contenuti brandizzati o l'API Marketing.

La maggior parte degli utenti che creano post con contenuto brandizzato ha già accesso al relativo strumento e dispone di Pagine o profili verificati. Se lo strumento per i contenuti brandizzati non è disponibile nella tua Pagina, invia una richiesta di accesso.

Puoi usare l'API Marketing per creare post con contenuto brandizzato. In alternativa, puoi usare lo strumento per i contenuti brandizzati, che trovi in Gestione inserzioni e nell'app Mentions. Consulta il Centro assistenza per le inserzioni, Contenuto brandizzato.

Panoramica

Crea contenuti brandizzati per i vari formati dei post elencati in Centro assistenza per le inserzioni, Contenuto brandizzato.

Devi chiamare endpoint diversi in base al formato del post e includere sponsor_tags nel post stesso. Il tag di uno sponsor indirizza a una Pagina Facebook.

Puoi consentire ai tuoi partner commerciali di mettere in evidenza direttamente i tuoi post, aggiungendo direct_share_status al post interessato. Imposta direct_share_status = 1 per autorizzare un partner commerciale a mettere in evidenza il tuo post. In caso contrario, imposta direct_share_status = 0.

Creazione di un aggiornamento di stato

Per iniziare, pubblica un contenuto nell'endpoint feed della Pagina per creare un aggiornamento di stato. L'elemento POST deve contenere valori per i campi sponsor_id, share_status e message.

curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1"
  
  {"id":"ID"}

Aggiunta di foto

Puoi aggiungere foto al post sull'endpoint photos della Pagina. L'elemento POST deve contenere valori per i campi sponsor_id, share_status e message.

Specifica un campo url che rimandi a una foto esistente. Puoi anche caricare la foto come allegato al post. Consulta Caricamento di foto.

  curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1" 
  -F "url=https://xx.cdn.net/v/t31.0-8/13064650_505613696297499_6399089570275517473_o.jpg"
  
 {"id":"372501189608751_701886166670250"}

Pubblicazione di un video

Per pubblicare un video con contenuto brandizzato devi seguire diversi passaggi:

  • Effettua una chiamata per specificare l'intenzione di caricare video. L'API restituisce un ID oggetto video che puoi usare per il caricamento.
  • Carica il video.
  • Completa il trasferimento del video impostando lo stato di condivisione. Inserisci anche l'elemento sponsor_id per il video, che aggiunge il contenuto brandizzato alla storia.

Consulta Caricamento di video.

In questo esempio, iniziamo una richiesta, carichiamo il video e impostiamo sponsor_id e direct_share_status.

 curl -X POST "https://graph-video.facebook.com/VERSION/PAGE_ID/videos" 
  -F "access_token=$at" 
  -F "upload_phase=finish" 
  -F "upload_session_id=SESSION_ID" 
  -F "sponsor_id=ID" 
  **-F "direct_share_status=1"**

In caso di azione eseguita correttamente, ottieni questo risultato:

{"success":true}

Video in diretta

Per creare un video in diretta brandizzato, attieniti a questa procedura:

  • Crea un oggetto del video in diretta.
  • Aggiorna l'oggetto del video in diretta e aggiungi sponsor_id.
  • Avvia il tuo streaming video.

Per scoprire di più sulla creazione e sulla gestione degli streaming video in diretta, consulta la nostra API Live Video. Puoi eseguire una query per la lista dei video in diretta di una pagina e usare un ID video per l'aggiornamento di sponsor_id. In alternativa, puoi usare l'ID restituito quando hai creato per la prima volta il tuo video in diretta.

Aggiornamento dei contenuti brandizzati

Non supportiamo modifiche al contenuto del post con un ID brand sul web o sui dispositivi mobili. In alternativa, puoi usare l'API Marketing per aggiornare un post affinché includa o modifichi uno sponsor. Puoi modificare lo sponsor cambiando il valore del campo sponsor_id su un oggetto del post.

Per aggiungere uno sponsor a un post, effettua una richiesta POST sul post della Pagina e specifica un elemento sponsor_id. Per modificare lo sponsor in un post, passa il nuovo campo sponsor_id.

Puoi consentire o vietare ai partner commerciali di mettere in evidenza un post in modo diretto. Inserisci sponsor_id e la modifica a direct_share_status.

curl -X POST "https://graph.facebook.com/PAGE_POST_ID" 
  -F "access_token=TOKEN" 
  -F "direct_share_status=1"
  
 {"success":true}