Torna alle notizie per sviluppatori

Introducing Graph API v20.0 and Marketing API v20.0

Oggi rilasciamo l'API Graph v20.0 e l'API Marketing v20.0 di Facebook. Nell'ambito del lancio riportiamo di seguito le modifiche che riteniamo rilevanti per parte della nostra community di sviluppatori. Queste modifiche includono annunci, aggiornamenti di prodotti e notifiche di obsolescenze relative all'integrazione di una o più applicazioni con la nostra piattaforma.

Per un elenco completo di tutte le modifiche e i relativi dettagli, visita il nostro registro modifiche.

Aggiornamenti generali

Aggiornamento automatico della versione dell'API Marketing

Per migliorare l'esperienza API complessiva rendendola più intuitiva ed efficiente, siamo entusiasti di annunciare il lancio previsto della funzione di aggiornamento automatico della versione dell'API Marketing. A partire da oggi, abiliteremo la funzione di aggiornamento automatico della versione per gli endpoint dell'API Marketing non interessati tra una versione e l'altra. Questo significa che tra una versione da disattivare e la successiva versione disponibile, se un endpoint non è interessato, la piattaforma effettuerà automaticamente l'aggiornamento della chiamata alla successiva versione disponibile piuttosto che respingere direttamente la richiesta.

Per maggiori informazioni su questo comportamento, fai riferimento al documento Gestione delle versioni dell'API Marketing e all'articolo sul lancio.

Per controllare gli endpoint interessati per ogni versione, consulta il registro modifiche.

Per aggiornamenti specifici sulla versione 20.0, continua a leggere.

Inserzioni con promemoria per l'API Marketing

Prima del 13 maggio 2024, gli sviluppatori non potevano supportare la creazione di inserzioni con promemoria di Instagram tramite l'API Marketing di Instagram e i loro clienti potevano creare questo tipo di inserzioni esclusivamente da Gestione inserzioni di Meta. Questa mancanza di compatibilità ha creato un attrito indesiderato per i nostri partner e i loro clienti che volevano pubblicare inserzioni con promemoria.

Abbiamo ricevuto diversi feedback su questa incompatibilità e, a partire dal 13 maggio 2024, supportiamo la creazione delle inserzioni con promemoria tramite l'API Marketing di Instagram.

Apprezziamo il feedback ricevuto dalla nostra community di sviluppatori e dai loro clienti e vogliamo continuare a migliorare l'esperienza delle inserzioni con promemoria disponibili tramite l'API Marketing.

Informazioni sulle inserzioni con promemoria di Instagram

Le inserzioni con promemoria di Instagram aiutano gli inserzionisti a colmare il divario temporale tra promozione e lancio incoraggiando le persone interessate a impostare promemoria. Le persone che aderiscono ricevono promemoria in momenti importanti prima dell'evento.

Informazioni sulla creazione e sulla modifica degli eventi

Le inserzioni con promemoria di Instagram usano l'orario e la data di inizio dell'evento per stabilire quando inviare i promemoria. Questa novità consente agli sviluppatori di creare e modificare gli eventi nell'API Instagram Graph. Puoi creare inserzioni con promemoria attraverso l'API Marketing di Instagram dopo aver aggiunto gli eventi alle creatività dell'inserzione.

Nuova API sul nodo dell'account pubblicitario

Il nuovo aggiornamento per il nodo dell'account pubblicitario non è un cambiamento sostanziale, ma piuttosto un'aggiunta all'API. Chiamando l'API, vengono elencate sotto il relativo account pubblicitario tutte le campagne con consigli e istruzioni, oltre a indicazioni e miglioramenti attesi in termini di costo per azione (CPA).

La nuova API consentirà agli inserzionisti di visualizzare le indicazioni di Meta per le proprie campagne. Questi dati esistono già nel Centro partner e sono disponibili per tutti i partner. Tuttavia, sono accessibili attraverso l'interfaccia utente che richiede la selezione manuale di un singolo account pubblicitario per visualizzare le indicazioni.

Automatizzando l'accesso di questi dati tramite l'API CPA_GUIDANCE, vorremmo eliminare il lavoro manuale necessario a controllare le indicazioni per ogni account pubblicitario. L'accesso a questa API consentirà ai nostri partner di creare visualizzazioni personalizzate a livello interno e vedere le tendenze nel tempo.

Se la tua azienda gestisce centinaia o migliaia di account, è difficile verificare singolarmente ogni relativa metrica, soprattutto quando soggetta a variabili temporali (i suggerimenti RSS si aggiornano ogni giorno e considerano campagne attive degli ultimi 28 giorni). Questa API consentirà alle agenzie di individuare le campagne più promettenti che possono essere ottimizzate seguendo i consigli forniti, che in seguito saranno integrati nei propri sistemi.

L'API CPA_GUIDANCE permette nello specifico alle agenzie di fornire linee guida ai propri brand partner su quali prodotti o categorie hanno il costo per acquisizione (CPA) più elevato. Condividendo queste informazioni, le agenzie possono aiutare i brand partner a ottimizzare la spesa pubblicitaria e migliorare le prestazioni complessive delle campagne collaborative.

Le agenzie saranno anche in grado di monitorare se sono state applicate indicazioni verificando eventuali tendenze migliorative del CPA.

Inserzioni di più inserzionisti

Oggi introduciamo la possibilità per gli inserzionisti di attivare le inserzioni di più inserzionisti tramite l'API Marketing. Prima di questo aggiornamento, gli sviluppatori non potevano supportare la creazione delle inserzioni di più inserzionisti tramite l'API e i clienti potevano attivare questo tipo di inserzioni solo da Gestione inserzioni di Meta.

Informazioni sulle inserzioni di più inserzionisti

Le inserzioni di più inserzionisti aiutano le persone a scoprire prodotti e servizi di più aziende. Per determinati posizionamenti su Facebook e Instagram, le inserzioni possono essere mostrate insieme ad altre nella stessa unità pubblicitaria per aiutare le persone a scoprire prodotti e servizi di aziende scelte appositamente per loro. Un'unità pubblicitaria è un contenitore che mostra più inserzioni, in genere nella stessa pagina. Scopri di più nel Centro assistenza per le aziende.

Cosa significa per gli sviluppatori

Al momento del lancio, la pubblicazione di inserzioni di più inserzionisti tramite l'API Marketing è disattivata per impostazione predefinita; pertanto gli sviluppatori dovranno implementare modifiche al codice per fare in modo che le inserzioni dei clienti siano idonee a essere pubblicate nell'esperienza. La creazione di inserzioni di più inserzionisti è supportata da tutte le versioni dell'API Marketing, ma tutte le richieste di creazione che sono idonee alle inserzioni di più inserzionisti devono specificare se questa opzione viene usata o meno. Il 19 agosto 2024 le inserzioni di più inserzionisti saranno attive per impostazione predefinita e gli sviluppatori che non hanno ancora modificato il codice dovranno farlo per poter dare ai clienti la possibilità di disattivare l'esperienza.

Funzioni creative dell'IA generativa nell'API Marketing: generazione di testo, espansione dell'immagine e generazione di sfondi

A ottobre 2023 abbiamo annunciato il lancio delle nostre prime funzioni creative per le inserzioni alimentate dall'IA generativa (generazione di testo, espansione dell'immagine e generazione di sfondi) per le aziende in Gestione inserzioni. Oggi ti informiamo che stiamo offrendo le funzioni creative dell'IA generativa agli inserzionisti tramite la nostra API Marketing, in modo che anche partner, agenzie e inserzionisti possano sfruttare GenAI di Meta attraverso l'API Marketing.

Queste funzioni permettono di generare variazioni creative velocemente e automaticamente, inaugurando una nuova era per le creatività che massimizza la produttività, la personalizzazione e le prestazioni per tutti gli inserzionisti:

  • Generazione di sfondi: crea fino a quattro sfondi per completare le immagini del prodotto, consentendo la diversificazione della creatività in base ai segmenti di pubblico. Gli sfondi generati si baseranno sulle tue immagini originali dei prodotti e spesso sono semplicemente sfondi con colori e motivi.

  • Espansione dell'immagine: modifica con facilità le immagini delle creatività per adattarle alle varie proporzioni usate sulle diverse piattaforme, cominciando dal Feed e passando poi a Reels, per risparmiare tempo e risorse nel riadattamento delle creatività.

  • Generazione di testo: genera più versioni di testi pubblicitari basati sul tuo testo originale, mettendo in evidenza i punti di forza di prodotti e servizi e generando più proposte per diversificare le tue inserzioni in base ai segmenti di pubblico.

Oggi mettiamo queste funzioni a disposizione di più inserzionisti e siamo lieti di offrire la nostra potente IA generativa a un pubblico più ampio.

Coerentemente al nostro approccio alla sperimentazione di nuovi prodotti che potrebbero essere soggetti a ulteriori controlli, settori come quello dei servizi finanziari, dei farmaci/benessere, delle inserzioni relative al settore abitativo, creditizio o dell'occupazione oppure su temi sociali, elezioni o politica, potrebbero non avere subito accesso a tutte le funzioni dell'IA generativa.

Come funzionerà?

Da oggi supportiamo queste funzioni nell'ambito della nostra API Marketing, più specificatamente le API Ad Creative. Gli inserzionisti potranno attivare queste funzioni dall'API e vedere in anteprima le creatività dell'IA generativa dall'API.

Il seguente esempio mostra come attivare le creatività dell'inserzione dalle funzioni dell'IA generativa in API Marketing.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Nota: l'esempio di cui sopra riporta l'opzione Opt-in (Attiva) per la funzione Generazione di sfondi. Analogamente, per l'espansione dell'immagine, usa image_uncrop e per la generazione di testo text_generation in creative_features_spec.

Gli inserzionisti inoltre potranno vedere in anteprima le creatività trasformate dall'IA generativa tramite l'API. Segui il link contenuto nella documentazione per gli sviluppatori per scoprire come generare, fornire le creatività delle inserzioni e vedere in anteprima i contenuti generati per ognuna delle funzioni di GenAI.

API Video di Instagram: Resumable Upload per l'API Video di Instagram

A partire dal 15 maggio 2024 il nuovo "Resumable Upload Protocol" supporterà la pubblicazione di video Instagram (ad es. Reels, Stories con video e Carosello con video) usando sia video locali che URL di video con hosting pubblico. Questo nuovo protocollo permette di caricare file locali e video più lunghi solo per Reels (es. fino a 15 minuti) e di riprendere un'operazione di caricamento dopo un'interruzione di rete o altro errore di trasmissione.

In passato, per creare video Instagram i file video dovevano essere caricati su un servizio di hosting con accesso pubblico, che generava un URL condivisibile da fornire a Meta per la pubblicazione.

I dettagli del flusso di pubblicazione migliorato dei contenuti si trovano nella documentazione per gli sviluppatori sulla pubblicazione dei contenuti, mentre qui sono disponibili informazioni aggiuntive sui contenuti multimediali di Instagram.

API Instagram Graph: incorporate nuove metriche

Da oggi sono disponibili per l'API Graph 6 nuove metriche per i contenuti multimediali del contenitore carosello: Mi piace, Commenti, Condivisioni, Seguiti, Attività del profilo (es. numero di azioni intraprese quando un utente visita il tuo profilo), Visite al profilo (es. numero di volte in cui il tuo profilo è stato visitato). Queste metriche sono state già rese disponibili nella pagina Insights di Instagram, ma adesso saranno disponibili anche tramite API Graph.

Aggiungendo Mi piace, Commenti, Condivisioni, Seguiti, Attività del profilo, Visite al profilo agli endpoint dell'API Graph per i post Carosello, dovresti riuscire a leggere queste metriche direttamente dalla chiamata API.

Fai riferimento alla lista completa di queste metriche disponibile qui per aggiungere le metriche pertinenti alla tua chiamata API GET per i post del contenitore carosello.

Aggiornamento dei tempi previsti per la rimozione: API Offline Conversions di Meta

L'anno scorso abbiamo annunciato che l'API Offline Conversions versione 17 non supporterà più gli eventi offline e che abbiamo anticipato che l'uso dell'API Offline Conversions sarebbe stato interrotto nel terzo trimestre del 2024. In seguito, questa previsione di tempistica per la rimozione anticipata è stata modificata e comunichiamo che l'API Offline Conversions non sarà più disponibile da maggio 2025. Sebbene la deprecazione dell'API Offline Conversions sia stata rimandata dal terzo trimestre 2024 a maggio 2025, incoraggiamo comunque gli inserzionisti che attualmente inviano eventi online tramite API Offline Conversions a continuare a pianificare la migrazione della loro configurazione esistente per avviare l'invio di eventi offline tramite l'API Conversions.

Rimozioni e modifiche sostanziali

Eliminazione del pulsante di prenotazione nell'API Messenger

Con efficacia immediata, il pulsante di prenotazione non sarà più supportato nelle chiamate all'API Messenger. Ciò non influirà su altri modelli e pulsanti e le aziende possono continuare a gestire le prenotazioni usando Meta Business Suite.

Interruzione della creazione del tipo di inserzione Messaggi sponsorizzati nell'API Marketing

Al momento, la creazione del tipo di inserzione Messaggi sponsorizzati non sarà più disponibile nell'API Marketing v20.0 e la creazione delle inserzioni per questo tipo di inserzione nelle precedenti versioni dell'API non sarà più disponibile dopo 90 giorni. Questa modifica non influirà sugli altri tipi di inserzione che rimandano ai messaggi.

Consigliamo di rivedere le integrazioni attualmente utilizzate e modificare le applicazioni secondo le necessità per garantire agli utenti una transizione agevole.

Rimozione degli intervalli di tempo non critici per le metriche demografiche degli insight (tramite l'API External Instagram Graph)

Il 21 maggio 2024 abbiamo rilasciato la versione 20 dell'API Instagram Graph.

A 90 giorni da questo lancio (vale a dire il 19 agosto 2024), l'API Graph non condividerà più le metriche demografiche sul pubblico coinvolto e raggiunto in intervalli di tempo non critici per l'API Instagram Graph (es. informazioni sulla distribuzione per Paesi, città, età e genere nel corso degli ultimi 14 e 90 giorni).

L'API Instagram Graph restituirà ancora informazioni demografiche per il mese precedente (cioè "this_month") e la settimana precedente (cioè "this_week"), analogamente a quelle dell'app Instagram al fine di assicurare coerenza tra le piattaforme.

Questo nuovo aggiornamento riduce eventuali fraintendimenti e aumenta l'affidabilità e la qualità dei nostri report.

Consulta la documentazione per gli sviluppatori per saperne di più.

Obsolescenze delle versioni dell'API:

Nell'ambito del programma di gestione delle versioni di Facebook per l'API Graph e l'API Marketing tieni conto delle obsolescenze programmate:

API Graph

  • 28 maggio 2024: l'API Graph v13.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

  • 17 settembre 2024: l'API Graph v14.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

  • 20 novembre 2024: l'API Graph v15.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

API Marketing

  • 13 agosto 2024: l'API Graph v18.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

  • 4 febbraio 2025: l'API Marketing v19.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

Per evitare disservizi, consigliamo di effettuare la migrazione di tutte le chiamate all'ultima versione dell'API lanciata oggi.

SDK di Meta Business

Rilascio dell'SDK di Meta Business v20

Il rilascio dell'SDK v20 di Meta Business avverrà poco dopo il rilascio dell'API Graph v20 e includerà risoluzioni di bug, aggiornamenti delle dipendenze, nuove funzioni e, soprattutto, un'interfaccia dell'API aggiornata per garantire la corrispondenza con l'API Graph v20.

In questa versione introdurremo anche supporto aggiuntivo per le API Instagram, nello specifico IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI e IGAccessTokenForIGOnlyAPI. Queste API consentono l'uso di più metodi oltre alle API Instagram esistenti che ti permettono di recuperare direttamente i contenuti multimediali. Puntiamo a incorporare più API che coprono altri prodotti di Meta per arricchire l'ecosistema dell'SDK Business.

Nell'ambito del nostro programma di obsolescenza di 2 anni per gli SDK Platform, ti ricordiamo le obsolescenze e le disattivazioni in programma:

  • Maggio 2024: SDK Platform v13.0 o versione precedente di Facebook verrà disattivato.