Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 21 nov 2022

Panoramica

Ti invitiamo a leggere attentamente questa guida e a integrare il maggior numero possibile di elementi delle nostre API Commerce, idealmente tutti quelli rilevanti per il tuo caso d'uso.

Ambito del ruolo dello sviluppatore

In quanto sviluppatore, molto probabilmente rientri in una di queste categorie:

  • Venditore: fai parte di una società di e-commerce che dispone di un proprio stack tecnico personalizzato e desideri effettuare l'integrazione con le API Commerce di Meta per consentire a un singolo (o a una serie di) shop di operare con le tecnologie di Meta.

  • Partner/Fornitore di soluzioni tecnologiche: fai parte di una società di piattaforme di e-commerce o di un'azienda che fornisce servizi software ad attività di e-commerce esistenti, ma che non dispone di un proprio shop (ruolo indicato collettivamente come partner o fornitore di soluzioni tecnologiche di vendita) e desideri effettuare l'integrazione con le API Commerce di Meta per conto dei molteplici shop supportati dalla tua piattaforma.

In entrambe le categorie, la qualità della tua integrazione ha un impatto significativo quando i tuoi clienti interagiscono con prodotti e shop gestiti con le nostre API Commerce. Questa guida è specificamente incentrata sull'assistenza agli sviluppatori partner che desiderano:

  • effettuare l'integrazione con le nostre API Commerce;

  • una panoramica e il "quadro generale" di tutti i fattori coinvolti nella creazione di un'integrazione di alta qualità con le API Commerce di Meta;

  • scoprire in che modo l'integrazione può portare a esiti positivi per l'azienda, come trovare nuovi clienti, concludere più vendite e sfruttare con successo le inserzioni di Meta per ottenere gli stessi risultati.

Considerazioni sul ruolo dell'acquirente

Gli acquirenti hanno standard molto elevati quando devono prendere decisioni di acquisto. Ricercano informazioni dettagliate sui prodotti che stanno valutando di acquistare. Puntano a una buona offerta e si aspettano di trovare negli shop gli stessi sconti e le stesse promozioni presenti sul sito web del venditore. Vogliono ricevere aggiornamenti tempestivi in merito agli ordini effettuati con informazioni di spedizione, tracking e reso accurate.

Fornire tutto questo per Meta è fondamentale per far crescere i tassi di conversione degli acquirenti con Shops.

Flusso per sviluppatori di alto livello

In Meta, consentiamo a sviluppatori terzi di creare sistemi che si integrano con le nostre piattaforme Instagram e Facebook attraverso una raccolta di endpoint delle API Commerce, facenti collettivamente parte dell'API Graph. Qui descriviamo il flusso per sviluppatori di alto livello e i componenti coinvolti nella creazione di un'integrazione delle API Commerce di alta qualità.

Prerequisiti

  • Devi disporre di una configurazione business verificata su Meta.

  • È richiesta la firma di contratti di vendita obbligatori, inclusi l'Emendamento per i fornitori di soluzioni tecnologiche e le Condizioni supplementari.

  • Devi avere familiarità con i concetti dell'API Graph, che rappresenta la modalità principale di lettura e scrittura dei dati sulla piattaforma di vendita Meta.

Passaggio 1: creazione di un'app per sviluppatori

Per effettuare richieste a questi endpoint dell'API Graph, hai innanzitutto bisogno di creare un'app nel portale Meta for Developers. In questo contesto, un'app rappresenta una raccolta di funzionalità a cui il tuo software terzo ha accesso sui sistemi di Meta. Ogni chiamata all'API che effettui ai sistemi di Meta è associata con questa app e le tue funzionalità determinano le chiamate all'API a cui il tuo software ha accesso. Questa app è associata alla tua entità business su Meta. Il modello di dati di Meta è progettato in modo tale che tutte le risorse che crei perché la tua azienda sia operativa su Meta siano di proprietà di questo oggetto entità business. Lo stesso oggetto entità business che possiede la tua app può anche disporre di una Pagina Facebook, un account Instagram, un account pubblicitario e un catalogo prodotti.

Passaggio 2: creazione di un token d'accesso (usando un account test)

Come parte della procedura di approvazione preliminare dell'app, devi fornire un token d'accesso con ciascuna chiamata all'API. Questo token d'accesso consente alla tua app di accedere alle piattaforme Meta per conto di un utente. Un token d'accesso è l'equivalente di una chiave digitale che mantiene un utente connesso a Facebook così che non debba reinserire la password ogni volta che il tuo software terzo richiede l'accesso alle piattaforme Meta per suo conto.

In qualità di sviluppatore partner che vuole creare un'integrazione per le vendite dove gestire più shop, dovrai memorizzare diversi token d'accesso, uno per ogni shop che sostieni e che vende sui canali Facebook e Instagram.

Per iniziare, crea un account test per le vendite, associando le risorse e generando un token d'accesso corrispondente da usare per lo sviluppo dell'integrazione delle API Commerce.

Ti consigliamo di usare token d'accesso che si appoggiano a un utente di sistema per accedere all'API Commerce, poiché i token d'accesso ottenuti da un utente tipico possono essere invalidati dopo un certo periodo di tempo oppure nel caso in cui l'utente modifichi la propria password di Facebook. Gli utenti di sistema rappresentano i server o i software che effettuano chiamate all'API alle risorse possedute o gestite da un Business Manager. Per istruzioni dettagliate, consulta la configurazione dell'integrazione di API.

Passaggio 3: creazione di integrazioni delle API Commerce (usando un account test)

Inizia effettuando l'integrazione con le API di catalogo, gestione ordini e promozioni (offerte) in parallelo usando l'account test per le vendite creato al passaggio 2. Effettua l'integrazione con le API per il catalogo per configurare e gestire un catalogo aggiornato di qualità elevata che migliori l'esperienza di acquisto e influenzi le decisioni degli acquirenti. Effettua l'integrazione con le API per la gestione degli ordini per gestire il ciclo di vita degli ordini effettuati dagli acquirenti sui canali Facebook e Instagram. Effettua l'integrazione con le API per le promozioni per sincronizzare diversi tipi di promozioni e gestire acquisti e rimborsi in presenza di promozioni.

Scopri come effettuare l'integrazione con queste API per soddisfare i nostri livelli di qualità per gli shop.

Passaggio 4: invio per l'Analisi dell'app

L'Analisi dell'app è una parte integrante della procedura di sviluppo di un'app. Per avviare l'Analisi dell'app devi richiedere specifiche autorizzazioni e descrivere in che modo queste saranno utilizzate dalla tua app per migliorare le aziende che supporti. Questa procedura ci consente di verificare che la tua app utilizzi i nostri prodotti e le nostre API in modo approvato. Scopri di più sulla procedura di Analisi dell'app.

Passaggio 5: implementazione del flusso per la registrazione dei venditori sulla piattaforma di vendita Meta

Implementa il percorso migliore per la registrazione dei tuoi venditori sulla piattaforma di vendita Meta. Al termine di questo flusso, viene generato un token d'accesso per ogni venditore che supporti, che dovrai memorizzare e utilizzare quando effettui chiamate all'API per conto di quel venditore.

Scopri di più su come creare un'integrazione della registrazione ideale in modo da soddisfare i nostri livelli di qualità per gli shop.

Passaggio 6: ottimizzazione dell'integrazione delle API Commerce (usando un account di produzione)

Ottimizza la tua integrazione così da gestire diversi scenari di casi limite ed errori nel migliore dei modi. Comprendi e metti in pratica le best practice consigliate per l'integrazione descritte nella guida alle best practice. Infine, testa la tua integrazione con ordini reali.

Livelli di qualità per le integrazioni

La tabella sotto elenca i lavori da svolgere (JTBD) per il venditore raggruppati per categoria, livello di priorità (dove 0 è il livello più alto), specificità per Meta o applicabilità ad altri canali, requisiti dei livelli di qualità per le integrazioni della piattaforma per le vendite Meta associati e miglioramenti in termini di potenziale.

Categoria Lavori da svolgere (JTBD) del venditore Priorità Multicanale/Specifico per Meta Livelli di qualità: requisito minimo Livelli di qualità: miglioramenti

Registrazione e gestione shop

Registrazione su Shops

0

Specifico per Meta

Le terze parti devono usare l'estensione Facebook Business.

Visualizzazione e risoluzione dei problemi con lo shop (inclusi i problemi BI)

0

Insight e consigli per lo shop

1

Specifico per Meta

N.d.

Personalizzazione dell'aspetto dello shop

2

Specifico per Meta

N.d.

Risposta/Comunicazione con gli acquirenti Meta

0

Entrambi (diversi venditori preferiscono utilizzare Messenger/IGDM/WhatsApp per rispondere ai clienti, mentre altri si affidano a strumenti di terzi per le comunicazioni con i clienti)

N.d.

Gestione catalogo

Aggiunta/Rimozione/Modifica di prodotti per mantenere un catalogo fornito e aggiornato

0

Multicanale

Le terze parti devono sincronizzare il catalogo prodotti con Meta e gestire gli errori. I campi non volatili richiedono un meccanismo di sincronizzazione scalabile (sincronizzazione catalogo completa ogni 24 ore e sincronizzazione delta ogni ora). Gli aggiornamenti dei campi ad alta volatilità (inventario e listino prezzi) devono essere sincronizzati quasi in tempo reale (almeno ogni 15 minuti).

Le terze parti devono sincronizzare la raccolta di insiemi di prodotti con Meta.

Visualizzazione e risoluzione dei problemi con i prodotti specifici per Meta (ad es., contrassegni BI)

0

Multicanale (nonostante l'effettiva risoluzione del problema può avvenire su una piattaforma Meta, come i ricorsi BI)

Le terze parti devono mostrare la diagnostica con una call to action (CTA) chiara ai venditori.

Controllo e utilizzo dei contenuti della community (contenuti generati dagli utenti)

1

Specifico per Meta

N.d.

Merchandising/Pubblicazione di inserzioni per lo shop

Pubblicazione di inserzioni per lo shop

0

Specifico per Meta

Le terze parti devono disporre di una configurazione dei venditori e rimandare segnali delle inserzioni tramite il pixel.

Le terze parti devono disporre di una configurazione dei venditori e rimandare segnali delle inserzioni tramite il CAPI.

Visualizzazione di prestazioni e dati statistici (inserzioni)

0

Multicanale

N.d.

Visualizzazione di prestazioni e dati analitici (vendite organiche)

1

Entrambi (sebbene siano disponibili strumenti per l'aggregazione di metriche di alto livello, oggi le metriche per le vendite organiche più profonde le forniamo tramite Gestore delle vendite)

N.d.

Pubblicazione di promozioni (offerte)

0

Multicanale

Le terze parti devono elaborare gli ordini (evasione, annullamenti, rimborsi) a cui sono associati sconti finanziati da Meta e i seguenti sconti standard finanziati dal venditore: sconti assegnati a singoli articoli di un ordine; sconti distribuiti tra gli articoli di un ordine (potenzialmente con promemoria); sconti per spedizione gratuita; sconti di tipo Acquisti X ottieni Y.

Se la terza parte è l'origine dei dati per gli sconti, deve sincronizzare gli sconti standard con Meta usando l'API Offers (attualmente una funzionalità con accesso limitato), altrimenti deve mostrare un link di reindirizzamento al Gestore delle vendite ai venditori per sincronizzare tutti gli sconti standard con Meta.

Esecuzione di lanci di prodotti su Instagram

2

Specifico per Meta

N.d.

Esecuzione di eventi di shopping in diretta su Instagram

2

Specifico per Meta

N.d.

Creazione di post organici con prodotti taggati

2

Specifico per Meta

N.d.

Pagamenti gestiti

Gestione dei dettagli di pagamento per gli acquisti sul sito

0

Specifico per Meta

Le terze parti devono usare l'estensione Facebook Business.

Ricezione di pagamenti/Elaborazione di rimborsi di pagamenti

0

Multicanale

Le terze parti devono consentire la consultazione dei report finanziari ottenuti da Meta.

Ricezione di pagamenti/Elaborazione di rimborsi di pagamenti

0

Multicanale

Gestione dei chargeback

0

Entrambi

Generazione di report fiscali e riconciliazione delle vendite

0

Multicanale

Elaborazione ed evasione ordini

Gestione degli ordini man mano che vengono ricevuti

0

Multicanale

Le terze parti devono ricevere e confermare gli ordini da Meta a OMS.

Evasione degli ordini

0

Multicanale

Le terze parti devono sincronizzare gli stati degli ordini (evasione, annullamento, rimborso) da OMS a Meta.

Gestione di resi e rimborsi avviati da acquirenti e venditori

0

Multicanale

Le terze parti devono sincronizzare gli stati degli ordini (evasione, annullamento, rimborso) da OMS a Meta.

Le terze parti devono elaborare i resi avviati dagli acquirenti attraverso Meta.