Registrazione del Marketplace con l'estensione Facebook Business (FBE)

L'estensione Facebook Business (FBE) consente ai tuoi venditori di pubblicare con facilità le inserzioni in tutta la famiglia di app di Facebook collegando le risorse esistenti come una Pagina Facebook o il Business Manager oppure creando da zero nuove risorse. L'estensione Facebook Business può essere usata per registrare con facilità i venditori di Marketplace nelle soluzioni di Meta.

In basso sono riportati i passaggi chiave specifici per il flusso del Marketplace. Ti consigliamo di seguire questa procedura parallelamente alla documentazione principale per gli sviluppatori.

Flusso del Marketplace con l'estensione Facebook Business

Partner = Marketplace

FBE = estensione Facebook Business (interfaccia utente di proprietà di Facebook)

Prima di iniziare

La tua app deve essere di proprietà di un Business Manager che sia un'azienda verificata. Ulteriori informazioni su come verificare l'azienda.
Avrai bisogno di un'app di Facebook con le seguenti autorizzazioni approvate attraverso l'Analisi dell'app:

Autorizzazione privata
1. manage_business_extension: questa è un'autorizzazione privata che richiede al tuo rappresentante di Meta di aggiungere la tua app alla lista di app consentite.
Autorizzazioni pubbliche (il Marketplace le richiede attraverso l'Analisi dell'app).
1. business_management: obbligatoria per recuperare l'ID del Business Manager creato mediante FBE e per usare l'API Business Manager per la gestione delle risorse business.
2. ads_management: obbligatoria per la gestione delle inserzioni dei venditori per conto del cliente.

Passaggi chiave per FBE e l'API Collaborative Ads

Il venditore (brand) lancia la schermata a comparsa di configurazione di FBE attraverso il sito web del Marketplace
Il venditore completa il flusso di registrazione con FBE ed esegue la configurazione delle risorse principali (Business Manager, Pagina e così via)
FBE comunica che il venditore ha configurato correttamente gli ID delle risorse (tramite API o webhook). Una volta che il Marketplace ha ricevuto gli ID, il segmento del catalogo può essere creato/condiviso tramite API o interfaccia utente (usando lo strumento Centro per la collaborazione nel Business Manager).
Il venditore lancia la vista di gestione FBE, dove può visualizzare lo stato del segmento del catalogo creato e accettare le Condizioni d'uso (se è la prima volta che il venditore riceve una richiesta di segmento del catalogo dal Marketplace).
Il Marketplace reindirizza il venditore al flusso di creazione delle inserzioni (flusso del produttore esistente, Gestione inserzioni e così via).

Configurazioni richieste

Extras

Campo Tipo Descrizione

Campo	Tipo	Descrizione
`setup`	setup	Obbligatorio La configurazione di Facebook del venditore, come il suo identificativo unico (`external_business_id`) o la valuta del suo catalogo (`currency`). Fai riferimento ai dettagli sull'oggetto di configurazione.
`business_config`	business_config	Obbligatorio L'oggetto di configurazione utilizzato da Facebook Business Extension per configurare il flusso di lavoro di Facebook Business Extension. Fai riferimento ai dettagli sull'oggetto `business_config`.
`repeat`	booleano	Obbligatorio Imposta questo valore su `false`.

setup

setup

Obbligatorio

La configurazione di Facebook del venditore, come il suo identificativo unico (external_business_id) o la valuta del suo catalogo (currency). Fai riferimento ai dettagli sull'oggetto di configurazione.

business_config

business_config

Obbligatorio

L'oggetto di configurazione utilizzato da Facebook Business Extension per configurare il flusso di lavoro di Facebook Business Extension. Fai riferimento ai dettagli sull'oggetto business_config.

repeat

booleano

Obbligatorio

Imposta questo valore su false.

Configurazione

Campo	Descrizione
`external_business_id` Tipo: stringa	Obbligatorio. ID azienda unico che rappresenta l'azienda del tuo cliente. Lo usiamo come identificativo unico. Ad esempio, se l'azienda del venditore si chiama "Fubar", il suo `external_business_id` potrebbe essere "fubar-123".
`timezone` Tipo: stringa	Obbligatorio. Il fuso orario dell'azienda. Fai riferimento ai valori possibili dei fusi orari.
`currency` Tipo: stringa	Obbligatorio. Codice valuta ISO di tre lettere della valuta predefinita usata dagli articoli nel catalogo dell'azienda. Consulta i codici valuta supportati.
`business_vertical` Tipo: enum	Obbligatorio. Il settore associato all'azienda per Marketplace è `ECOMMERCE`
`merchant_settings_id` Tipo: stringa	Facoltativo. Usato quando si esegue l'aggiornamento dall'estensione Facebook Business, v1. Contatta il tuo rappresentante di Facebook se stai passando dalla v1 alla v2.
`channel` Tipo: enum	Obbligatorio. Fornisce un modo per il partner di esprimere l'intenzione per l'utente in relazione alle funzioni che richiedono passaggi o vincoli aggiuntivi. Nota: il `channel` per il flusso di FBE specifico del Marketplace è `MARKETPLACE`. Assicurati di passarlo nel campo `channel`.
`business_manager_id` Tipo: stringa	Facoltativo. ID Business Manager per il Business Manager esistente dell'utente che un partner può immettere per la preselezione per l'utente nel flusso di configurazione.
`page_id` Tipo: stringa	Facoltativo ID della Pagina Facebook esistente dell'utente che il partner può immettere per la preselezione per l'utente nel flusso di configurazione.

Business Config

Usa questo oggetto per configurare le impostazioni aziendali per un utente finale; questo include Messenger e altro ancora. Ogni campo include un "tipo" collegato alle rispettive tabelle in basso.

Campo	Descrizione
`business` FBEBusinessPropertiesConfigData	Obbligatorio. Informazioni per l'azienda dell'utente finale
`messenger_chat` FBEMessengerChatConfigData	Facoltativo. Funzioni della chat di Messenger sulla pagina Facebook dell'utente finale, come `enabled` e `domains`
`catalog_feed_scheduled` FBECatalogFeedConfigData	Facoltativo Abilita l'utilizzo da parte dell'estensione Facebook Business di un approccio a elenco, che recupera gli articoli del catalogo da un `feed_url`
`page_cta` FBEPageCtaConfigData	Facoltativo Pulsante di call to action (CTA) sulla pagina dell'utente finale, come `cta_button_text`, `cta_button_url` ecc.
`ig_cta` FBEIGCtaConfigData	Facoltativo Funzioni di call to action di Instagram, come `enabled`, `cta_button_text`, `cta_button_url` ecc.
`messenger_menu` FBEMessengerMenuConfigData	Facoltativo. Funzioni del menu always-on di Messenger, come `cta_button-text` e `cta_button_url`

Dopo l'installazione

Ottenere ID risorsa, verificare notifiche webhook ed eventi del pixel
Una volta ricevuti gli ID delle risorse, crea/condividi il segmento del catalogo tramite API o interfaccia utente (usando lo strumento Centro per la collaborazione nel Business Manager).
Una volta eseguita correttamente la chiamata API per la creazione del segmento del catalogo, clicca qui per i dettagli sull'apertura della finestra a comparsa della vista di gestione di FBE in cui il venditore potrà accettare i segmenti del catalogo condivisi e completare la registrazione.

Avvia la vista di gestione di FBE dopo che la configurazione FBE è stata completata e gli ID delle risorse sono stati restituiti con successo tramite webhook/API.