FAQ sull'estensione Meta Business

Risposte alle domande frequenti sull'integrazione dell'estensione Meta Business (MBE).

Installazione

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

Assicurati che la casella di controllo "Abilita catalogo" sia selezionata nella tab di FBE Pannello sviluppatori > Configurazione nella Dashboard gestione app.

Le aziende/I venditori possono configurare le funzioni aziendali nella Vista di gestione, ma non saranno in grado di aggiornare le risorse Facebook connesse a FBE come Business Manager, account pubblicitario, pagina, pixel, catalogo e così via. In alternativa, le aziende/i venditori possono modificare le impostazioni nel flusso di configurazione FBE in modo da connettersi con diverse risorse.

A seconda delle esigenze aziendali, puoi scegliere di configurare uno o più dei seguenti flussi configurando il valore appropriato in Configurazione > Canale:

  • Flusso predefinito (nessun parametro richiesto per il canale): consente ai venditori di impostare pixel di Facebook, Pagina Facebook, account pubblicitario e catalogo per inserzioni dinamiche.
  • COMMERCE: flusso che consente ai venditori di creare un account commerce con Facebook Shop e Canale Shopping su Instagram con check-out sul sito. Dimostra anche un'opzione per scegliere shop fuori dal sito all'interno del flusso.
  • COMMERCE_OFFSITE: flusso che consente ai venditori di creare un account commerce con lo shop Facebook fuori dal sito e lo Shopping su Instagram fuori dal sito.
  • FEED: flusso che consente ai rivenditori di sincronizzare gli aggiornamenti del catalogo. Consigliato solo per i partner che dispongono di funzionalità di elenco/catalogo e non dispongono di hosting di siti web.
  • MARKETPLACE: flusso specifico per marketplace integrati con FBE. Consigliato per i partner che necessitano solo dei passaggi Pagina e Business Manager nel flusso di configurazione di FBE e quindi sfruttano la Vista di gestione FBE per configurare le Inserzioni collaborative.
  • SIGNALS: flusso che consente agli utenti di attivare il pixel di Facebook e gli eventi dell'API Conversions. Questo flusso non supporta il catalogo di Facebook come risorsa. Consigliato solo per i partner che dispongono di funzionalità di hosting di siti web e non dispongono di funzionalità di catalogo.

Di seguito sono riportati alcuni scenari comuni che potresti incontrare quando selezioni le Pagine durante FBE Business Login. Tieni presente che i tooltip nel flusso FBE spiegheranno il motivo esatto per cui non sei in grado di selezionare una risorsa: il motivo può variare da uno scenario all'altro.

Una Pagina sarà disponibile per la selezione:

  • Se la Pagina selezionata non è di proprietà di alcun BM, la Pagina verrà rivendicata dal BM selezionato
  • Se la Pagina selezionata è di proprietà di un altro BM e non è una pagina principale di quel BM, la Pagina verrà trasferita al BM selezionato

Una Pagina non sarà disponibile per la selezione:

  • Se una Pagina è di proprietà di ed è anche una pagina principale di un altro BM
  • Se una Pagina è di proprietà di un BM che è stato disabilitato, ad esempio, per violazioni delle normative

I partner possono richiedere la funzione Page Public Metadata Access per la loro app, in modo che l'app possa inviare query relative ai campi pubblici della Pagina. Scopri di più su questa funzione in questo documento e anche qui.

Se il campo instagram_profiles non è incluso, significa che l'autorizzazione relativa a Instagram (ad esempio, instagram_basic) non è inclusa nel token d'accesso e/o che l'azienda non ha collegato alcun profilo Instagram aziendale a FBE. Per maggiori informazioni sull'API di installazione FBE, consulta questo documento.

Questo significa che nell'app manca un'autorizzazione. L'autorizzazione principale necessaria per le azioni correlate al Business Manager è business_management.

È supportata la maggior parte delle valute presenti in questo elenco ad eccezione di JMD, BGN, BYN, UAH, KIP, LKR.

Avvertenza: l'installazione di FBE non andrà a buone fine se nelle impostazioni di configurazione dell'URL di login vengono fornite valute non supportate. Consigliamo ai partner di verificare che i loro venditori utilizzino le valute supportate prima di consentire loro di lanciare FBE.

Assicurati di disporre dell'accesso amministratore in Facebook Business Manager associato alla connessione FBE attuale, oltre all'accesso amministratore alla tua Pagina aziendale di Facebook o al profilo Instagram Business. Segui queste istruzioni per aggiungere un amministratore al tuo Business Manager di Facebook.

Test

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

  1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

  2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

Risoluzione dei problemi

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

Generali

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

This is a closed beta. Please reach out to your Meta partner manager for more information.

Catalogo

Facebook Business Extension (FBE), v2 utilizza il Catalogo per acquisire l'inventario di un'azienda. Viene utilizzato per varie funzioni, come inserzioni dinamiche, shop e la scheda dei servizi della Pagina. È un passaggio facoltativo dell'integrazione, ma è necessario per tali funzioni.

Consulta la documentazione dell'API Catalog FBE per i dettagli sull'implementazione e i campi supportati.

L'app avrà bisogno di ottenere l'autorizzazione Catalogo approvata (catalog_management) tramite Analisi dell'app prima della pubblicazione.

Aggiungi l'autorizzazione catalog_management al parametro scope nell'implementazione di Business Login: consentirà alla tua app di creare, leggere, aggiornare ed eliminare i cataloghi di proprietà dell'azienda.

Invia una richiesta di Analisi dell'app non appena hai una demo che puoi utilizzare per mostrare come:

  • viene richiesta l'autorizzazione Catalog nel flusso di onboarding;
  • viene inviato l'inventario al Catalogo connesso;
  • vengono abilitate le funzioni del Catalogo dopo la sincronizzazione del Catalogo.

Il nostro team di Analisi dell'app utilizzerà le istruzioni e lo screencast fornito per testare e verificare l'integrazione Facebook della tua app per il Catalogo. Se hai ricevuto un rifiuto, assicurati di leggere il feedback fornito per capirne il motivo. Devi inviare nuovamente una richiesta di analisi con informazioni aggiornate che forniscono al revisore maggiori dettagli.

Visita la nostra Guida ai risultati dei rifiuti dell'Analisi dell'app per suggerimenti su come avere un'Analisi dell'app di successo e su come informare il tuo manager partner di Facebook dei tuoi rifiuti per ulteriore assistenza.

La selezione delle risorse è interconnessa, pertanto i motivi per cui l'operazione non è effettuabile possono essere molteplici. Tra questi:

  • La pagina selezionata è già collegata a un altro catalogo
  • Il tuo catalogo è associato a un altro account di vendita
  • Se il tuo catalogo è in uso con l'app test e non puoi utilizzare lo stesso catalogo per la produzione

Migrazione

In FBE 2.0, è possibile collegare una Pagina Facebook o un profilo Instagram può essere aziendale a più di una piattaforma partner (in base all'ID dell'app). Tuttavia, lo stesso profilo può essere collegato una sola volta per una data piattaforma partner.

No. Per la chat di Messenger, le piattaforme partner possono abilitarla impostando la messenger_chat di business_config in Business Login. Per lo Shop della Pagina, le aziende/i venditori devono abilitarla nella Vista di gestione dopo la migrazione.

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

Plug-in

No. Questi due plug-in sono stati eliminati dalla vista di gestione di FBE. La Chat di Messenger è l'unico plug-in supportato nel 2021.

Per i domini Messenger in allowlist, è necessario HTTPS. I partner devono convalidare gli URL del campo domains con l'ID del protocollo, https://

Scopri di più su come configurare l'oggetto FBEMessengerChatConfigData.

I partner potrebbero trovarsi in una posizione migliore per assicurarsi che il dominio Messenger sia valido ed evitare quindi che aziende/venditori debbano configurare i domini. I partner possono impostare messenger_chat.domains nel business_config di FBE Business Login e impostare messenger_chat.enabled=false

Le aziende/i venditori possono successivamente abilitare il plug-in Messenger in Vista di gestione oppure i partner possono fornire alle aziende/ai venditori un modo per farlo sulle loro piattaforme tramite l'API Feature Configuration.

Analisi dell'integrazione

L'analisi dell'integrazione è il processo in cui Facebook verifica la tua integrazione con FBE. Una volta completata l'analisi dell'integrazione della tua app, la tua app sarà disponibile per gli utenti pubblici (ovvero, utenti business e venditori).

Puoi richiedere l'analisi dell'integrazione nella tab Pannello sviluppatori > Panoramica FBE della tua app dopo aver implementato tutti i requisiti. Per accelerare il processo di analisi, dovresti anche condividere con i nostri revisori o il tuo rappresentante Facebook un video dimostrativo end-to-end di tutte le funzioni di FBE che hai implementato.

Solo gli amministratori e gli sviluppatori della tua app potranno avviare il flusso FBE fino a quando la tua app non avrà completato con successo l'analisi.

Please reach out to your Meta partner manager, or submit a new integration review.

SDK/API/Webhooks/Mobile

Sì, FBE è supportata sui browser mobili e può essere avviata anche con le visualizzazioni web attraverso la tua app Android/iOS nativa. Scopri di più sull'avvio di FBE su mobile.

Per effettuare chiamate all'API Graph sono necessari token d'accesso. I vari tipi di token d'accesso sono spiegati qui.

Puoi chiamare Facebook Login per ottenere l'access_token prima di lanciare la Vista di gestione e quindi usare tale access_token per chiamare l'API Feature Configuration.

Esempio di codice:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

Shop

Per usare Shopping su Instagram per i flussi fuori dal sito o sul sito, è necessario un account Instagram Business. Un account Instagram personale non è idoneo. Se il tuo account Instagram Business non ha una presenza stabilita o non vende beni idonei, il tuo account potrebbe non essere idoneo e puoi richiedere una nuova verifica tra sei (6) mesi. Consulta i requisiti di idoneità.

Un account commerce può avere sia shop fuori dal sito sia shop sul sito. Puoi anche convertire shop sul sito in shop fuori dal sito e viceversa. Se la tua azienda necessita di shop sia fuori dal sito sia sul sito, avrai bisogno di due flussi di onboarding con risorse diverse.

La selezione delle risorse è interconnessa, pertanto i motivi per cui l'operazione non è effettuabile possono essere molteplici. Alcuni dei motivi sono:

  • L'utente non è un amministratore del Business Manager che possiede la Pagina
  • La Pagina è associata a un Business Manager diverso

Contatti

Utilizza lo strumento Assistenza diretta in Business Manager per richiedere assistenza direttamente al nostro team:

  • Partner per richiesta di appuntamenti, prenotazioni e ordinazioni di cibo: occorre utilizzare l'argomento Facebook Business Extension per i servizi
  • Partner di vendita: occorre utilizzare l'argomento Marketing partner: assistenza tecnica o contattare direttamente il tuo partner manager di Facebook Partner.

Se non visualizzi l'argomento di interesse nel menu a discesa Assistenza diretta, rivolgiti al rappresentante del tuo partner manager di Facebook tramite e-mail per richiedere l'accesso.

L'Assistenza diretta è altamente integrata con il Business Manager. Assicurati di aggiungere tutti i membri del team che faranno uso dello strumento di Assistenza diretta per l'invio di domande e bug come utenti del Business Manager della tua azienda. Scopri come farlo seguendo le istruzioni fornite qui.

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.