Integrazione della registrazione

La registrazione in Shops è un passaggio necessario per consentire ai venditori di eseguire l'integrazione nella piattaforma di vendita di Meta. Un'integrazione ottimale assicura che i prodotti del venditore siano aggiornati, che le informazioni sugli ordini siano sincronizzate correttamente, facili da riconciliare su base trimestrale o annuale e che le informazioni bancarie e sui pagamenti siano impostate correttamente per pagamenti e segnalazioni tempestivi.

Requisiti

Devi eseguire l'integrazione con l'estensione Facebook Business (FBE) per soddisfare i livelli di qualità dell'integrazione di Shops consentendo ai venditori di:

• scoprire facilmente l'integrazione di Meta nella piattaforma;
• collegare il proprio account di terzi alle risorse Meta (Business Manager, catalogo esistente se applicabile, pixel esistente se applicabile, Pagine, nomi utente Instagram);
• configurare e modificare le impostazioni del proprio shop sul sito (impostazioni sui resi, informazioni legali, dati bancari, dati fiscali);
• collegare altre risorse (Pagine, nomi utente Instagram) allo shop;
• modificare le proprie impostazioni;
• annullare la registrazione.

Prima di iniziare

1. Esegui l'integrazione della tua azienda verificata nell'estensione Facebook Business.
2. Aggiungi l'estensione Facebook Business alla tua app e ottieni accesso al panel per sviluppatori dell'estensione Facebook Business. Fai riferimento a questo schema per comprendere il flusso dell'estensione Facebook Business per la piattaforma di vendita.
3. Segui la Procedura di configurazione dell'estensione Facebook Business e invia la richiesta per il controllo dell'integrazione FBE. Questo include l'abilitazione dell'esperienza di gestione delle funzioni dell'estensione Facebook Business all'interno della tua piattaforma in modo che le aziende possano modificare le proprie funzioni o persino disinstallare la propria configurazione FBE.

Requisito 1: eseguire l'integrazione con l'estensione Facebook Business

L'estensione Facebook Business (FBE) è un'interfaccia di proprietà di Meta basata su popup che risiede su siti di terzi come plug-in e semplifica la procedura di integrazione generale con Meta. FBE consente alle aziende di configurare in tutta semplicità il pixel di Meta, il catalogo e gli shop. Inoltre, aiuta le aziende a connettere i propri prodotti e servizi con i canali Facebook e Instagram sulla tua piattaforma. Una volta effettuata la connessione, puoi aiutare le aziende a utilizzare un'ampia suite di potenti funzionalità.

In breve, la separazione delle responsabilità in un'integrazione basata su FBE è organizzata come descritto di seguito:

• Responsabilità di Meta: interfaccia, autenticazione, connessione e una superficie [(vista gestione FBE)](vista di gestione delle funzioni di FBE) per visualizzare le risorse connesse, gestire le funzioni installate e lo stato delle integrazioni di vendita.
• Responsabilità del partner: configurazione del pixel, caricamento dell'inventario sul catalogo Facebook tramite API.

Al termine della configurazione, qualsiasi azienda può iniziare un flusso di registrazione dell'estensione Facebook Business con le risorse esistenti o creandone di nuove, oppure combinando le due opzioni.

Passaggio 1: aggiunta di punti di accesso all'estensione Facebook Business alla tua app

Crea punti di accesso all'estensione Facebook Business dove l'utente seleziona, gestisce o crea le proprie risorse (ad es., Business Manager, catalogo, shop, pixel, ecc.). Questi punti di accesso possono assumere una di queste forme:

• Business Login (ovvero Facebook Login): consente alle aziende di avviare la propria connessione dalla tua piattaforma usando un pulsante disponibile sul tuo sito.
• App business: consentono alle aziende di avviare la propria connessione da una superficie di Meta. Per abilitare questo flusso e includere la tua app tra le app business di Meta, devi avere un'interfaccia utente con autenticazione personalizzata sul tuo sito. L'interfaccia utente deve consentire di selezionare la propria azienda per poi essere reindirizzati al flusso Meta con le informazioni selezionate.

Esempio

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   additionally use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "domain": "https://example-shop.partner-site.com/",
    "channel": "ECOMMERCE",
    "business_vertical": "ECOMMERCE"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "catalog_feed_scheduled": {
      "enabled": true,
      "feed_url": "https://partner-site.com/feed-url"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

A seconda della configurazione che hai scelto, puoi ottenere il token d'accesso dell'azienda per i passaggi successivi in diversi modi:

• Business Login: come avviene normalmente con Facebook Login, la fine di questo flusso restituisce un access_token, che usi per ottenere più risorse (ad es,. ID pixel, ID Pagina e ID business di Instagram).
• App business: tramite webhook.

Passaggio 2: configurazione dei webhook FBE_install

I webhook sono obbligatori per tutti i partner che vogliono essere inclusi nell'app store. Se non hai in programma di includere la tua app nell'app store, puoi scegliere di ignorare questa sezione o di tornarci in un secondo momento. Meta attiva eventi webhook ogni volta che una delle tue aziende installa, modifica o disinstalla l'estensione Facebook Business. Ogni volta che viene ricevuto un evento webhook, ci si aspetta che la tua app sfrutti questo evento e individui le risorse che l'azienda ha modificato, aggiunto o rimosso dalla sua connessione con la tua app. Il comportamento della tua app dovrebbe essere aggiornato sulla base delle risorse connesse più recenti. Ti consigliamo vivamente di implementare e testare la tua iscrizione al nostro webhook.

Per configurare un webhook:

1. Crea un endpoint su un server sicuro in grado di elaborare correttamente le richieste da Meta.
2. Nella Dashboard gestione app, configura una descrizione dei webhook FBE:
1. Nella tab Webhook della sezione FBE, digita l'URL di callback della tua app.
2. Immetti un token di verifica e convalida il tuo endpoint.

Al termine della configurazione, l'iscrizione al webhook fbe_install viene effettuata automaticamente.

Per una procedura più dettagliata, consulta Webhook.

Notifiche

Dopo aver ricevuto una notifica webhook di un'installazione, ecco cosa devi fare:

1. Memorizza il token d'accesso (e il relativo tipo) e registra le risorse per cui è stato concesso l'accesso alla tua app.
2. Abilita un insieme di funzioni in base alle risorse concesse.
3. Se manca una risorsa necessaria per una funzione specifica, disabilita solo quella funzione. Ad esempio, se alla tua app è stato concesso l'accesso a un catalogo, ma non a un pixel, implementa solo la funzione del catalogo e non quella del pixel.
4. Usa un aggiornamento per informare l'utente del comportamento della tua app in base alle risorse a cui ha accesso.

Dopo aver ricevuto un aggiornamento su un'installazione esistente, ecco cosa devi fare:

1. Aggiorna il token d'accesso e il registro delle risorse di cui disponi.
2. Aggiorna l'insieme di funzioni abilitate nella tua app per il venditore in base alle risorse che sono state concesse alla piattaforma.
3. Usa un aggiornamento per informare l'utente del comportamento della tua app in base alle risorse a cui ha accesso.

Dopo aver ricevuto una notifica di disinstallazione, ecco cosa devi fare:

1. Disabilita le funzioni che la tua app implementa per il venditore.
2. Informa il venditore della modifica alla sua configurazione.

Passaggio 3: recupero dei dettagli delle risorse con il token restituito

Puoi ottenere informazioni sulle aziende collegate alla tua piattaforma usando l'estensione Facebook Business tramite uno dei due metodi seguenti (o entrambi):

• Webhook: obbligatorio per tutti i partner che vogliono essere inclusi nell'app store. Con la configurazione di un webhook, i dettagli della registrazione o della modifica delle aziende con FBE saranno ricevuti tramite il payload webhook dalla configurazione webhook descritta al passaggio 2.
• Endpoint dell'API FBE Installs: consigliato per le aziende self-hosted. Per qualsiasi azienda che abbia installato l'estensione Facebook Business, puoi eseguire una query sulle rispettive informazioni di installazione di base usando l'endpoint fbe_installs. Usando un token d'accesso dell'azienda e un ID business esterno, puoi chiamare l'endpoint dell'API FBE Installs per informazioni dettagliate sulla configurazione.

Esempio: chiamata all'API FBE Installs

curl -i -X GET \   "https://graph.facebook.com/<version>/fbe_business/fbe_installs?fbe_external_business_id=<external business id>&access_token=<access token sanitized>"

Passaggio 4: recupero del token dell'utente di sistema

Dopo che un utente installa FBE, l'estensione genera un dipendente utente di sistema sul Business Manager del cliente. Tieni presente che questo utente di sistema non è più visibile nel Business Manager, ma esiste sul back-end. La denominazione per questo nuovo utente di sistema segue lo schema {App Name} System User (FBE).

Per farlo, effettua la seguente chiamata all'API:

curl -X POST \
  -F 'app_id={app_id}' \
  -F 'scope=ads_management,catalog_management,manage_business_extension' \ 
  -F 'access_token={user_access_token}' \
  -F 'fbe_external_business_id={fbe_external_business_id}' \ 
https://graph.facebook.com/<API_VERSION>/<client_business_manager_id>/access_token

Per il campo scope, usa l'autorizzazione manage_business_extension. A seconda del tuo caso d'uso (vedi il passaggio 5), con tutta probabilità saranno necessarie anche le autorizzazioni ads_management, catalog_management, pages_read_engagement, business_management, instagram_basic e manage_business_extension.

• Se la tua app ha bisogno di leggere e gestire l'account pubblicitario di un'azienda, richiedi l'autorizzazione ads_management. Con questa autorizzazione, puoi creare campagne pubblicitarie, recuperare metriche pubblicitarie, creare strumenti di gestione delle inserzioni e altro ancora.
• Se la tua app ha bisogno di creare, leggere, aggiornare o eliminare cataloghi prodotti di proprietà dell'azienda di cui questa è amministratore, devi richiedere l'autorizzazione catalog_management. Ti consigliamo questa autorizzazione per tutte le app, in quanto consente di creare inserzioni dinamiche di vendita e soluzioni di gestione dell'inventario.

Passaggio 5: configurazione di una vista di gestione

Per consentire alle aziende di configurare ulteriormente le proprie funzioni (oltre quanto specificato in fase di installazione), puoi reindirizzare le aziende alla nostra vista di gestione delle funzioni di FBE dalla tua piattaforma. Puoi usare l'SDK o l'URL di JavaScript per aggiungere un punto di accesso per lanciare la vista di gestione dell'estensione Facebook Business. Entrambi i metodi devono visualizzare un pulsante su cui cliccare per lanciare la finestra della vista di gestione dell'estensione Facebook Business.

Passaggio 6: aggiunta di un punto di accesso per disinstallare l'estensione Facebook Business

La tua piattaforma deve aggiungere un punto di accesso (ad es., un pulsante) che consenta alle aziende di disinstallare l'estensione Facebook Business. Ti consigliamo di farlo effettuando una richiesta DELETE all'endpoint pertinente.

Esempio: chiamata al nostro endpoint di eliminazione

curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Se hai implementato un webhook fbe_install, riceverai degli eventi qualora l'utente disinstalli l'estensione Facebook Business.

Ulteriori informazioni

• Estensione Facebook Business (FBE)
• Procedura di configurazione dell'estensione Facebook Business
• Panel per gli sviluppatori dell'estensione Facebook Business
• Disinstallazione dell'estensione Facebook Business
• Webhook