Guida alla migrazione: da Instagram (IX) all'estensione Meta Business, v2

In qualità di partner per i pulsanti di azione di Instagram, in base all'integrazione di Instant Experiences (IX), dovresti rispettare i seguenti requisiti per l'estensione Meta Business (MBE), v2, per mantenere i tuoi pulsanti di call to action Ordina cibo e le funzionalità relative agli adesivi delle storie sugli Ordini di cibo:

1. URL di autenticazione: per consentire alle tue aziende di registrarsi in MBE da Facebook o Instagram.
2. Webhook: per ricevere tempestivamente notifiche ogni volta che una delle tue aziende installa o disinstalla MBE.
3. Attivazione degli eventi di pixel: per aiutare le tue aziende a targetizzare meglio i nuovi clienti, aumentare le transazioni sui tuoi siti web e misurare direttamente l'impatto dell'integrazione MBE sui risultati ottenuti.

Dopo aver completato lo sviluppo e il testing di MBE, Meta controllerà e verificherà la tua integrazione. Una volta approvata, la tua app sarà disponibile per gli utenti pubblici.

Prima di iniziare

• Se non l'hai ancora fatto, registrati come sviluppatore di Meta per accedere agli strumenti per gli sviluppatori e creare app di Meta.
• Se non l'hai ancora fatto, crea un'app di Meta.
• Crea un'app test dalla tua app pubblicata/in produzione e usala per tutte le nuove operazioni di sviluppo e test.
• Le tue app (pubblicate/in produzione e test) devono essere di tipo aziendale e di proprietà di un Business Manager che sia un'azienda verificata. Scopri di più su come verificare la tua azienda e aggiungere le tue app.
• Contatta il tuo partner di Meta e condividi gli ID della tua app, in modo che possa concedere l'accesso alla funzionalità MBE manage_business_extension. Una volta ottenuta l'approvazione, potrai dedicarti all'implementazione.

Configura la tua integrazione tramite il Developer Panel (Panel per sviluppatori)

Meta Business Extension Developer Panel è un prodotto della Dashboard gestione app per sviluppatori. Una volta che viene concessa la funzionalità MBE alle tue app, dovresti usare il Panel per sviluppatori per configurare e convalidare l'integrazione (compreso l'URL di autenticazione e l'endpoint Webhook).

Passaggio 1: aggiungi MBE Developer Panel alle app Facebook Developer.

Passaggio 2: nella scheda Configurazione, seleziona Food and Drink come unico settore verticale, poi seleziona le funzioni Instagram Call to Action Button e Page Surface Call To Action Button e includi tutti i domini serviti dalla tua app nella scheda Domini wildcard.

Passaggio 3: dopo aver creato l'URL di autenticazione, usa la superficie delle app business nella scheda Configurazione per la convalida dell'URL (se ci sono errori, saranno elencati qui). Una volta ottenuto il segno di spunta verde, potrai accedere alle app business di Meta per un test completo.

Passaggio 4: dopo aver creato un webhook, configuralo nel prodotto Webhooks. Se la configurazione è stata effettuata correttamente, vedrai un segno di spunta verde sulla scheda Panoramica per l'elemento webhook convalidato.

Passaggio 5: dopo l'attivazione degli eventi del pixel necessari, completa il questionario del pixel (compreso un video per convalidare l'implementazione del pixel).

Passaggio 6: aiuta il nostro team a verificare e approvare la tua integrazione fornendo dettagli nella scheda Controllo dell'integrazione nella tab Controllo dell'integrazione. I dettagli dovrebbero includere le credenziali di accesso alla tua piattaforma per accedere al tuo URL di autenticazione. Aggiungi un link allo screencast che mostri l'esperienza di registrazione completa e le funzioni che hai abilitato.

Passaggio 7: una volta terminata l'implementazione MBE, completa l'elenco di controllo nella scheda Panoramica nel Panel per sviluppatori. Compila i moduli per i dettagli dell'app e il controllo dell'integrazione nella tab Controllo dell'integrazione. Cliccando sul pulsante Invia inizierà il processo di controllo. Una volta approvata l'integrazione, potrai rendere l'app disponibile per gli utenti pubblici dalla tab Avvio. Scopri di più sulla procedura di Controllo dell'integrazione e su come ricevere feedback e informazioni sullo stato attuale dal nostro team

Creazione di un URL di autenticazione

Le app business, disponibili sulle piattaforme Meta, sono il luogo in cui le aziende possono andare a scoprire e connettersi ad app business di terzi per configurare facilmente strumenti aziendali con un basso costo in termini di tecnologia al fine di crescere e raggiungere i propri obiettivi di business.

MBE, v2 usa un URL di autenticazione come canale affidabile per condividere la configurazione aziendale dell'utente (nome, URL per la CTA, ecc.) tra la tua piattaforma e Instagram/Facebook.

Il tuo URL di autenticazione deve accettare un parametro relativo alla query GET redirect_uri. Con questo URL ti consigliamo di:

1. Consentire agli utenti di accedere alla tua piattaforma e fornire un'opzione per registrare un nuovo account sulla tua piattaforma (ad es. "iscriviti").
2. Se supporti più aziende per account nella tua piattaforma, offri un'interfaccia utente che consenta all'utente di selezionare l'azienda sulla tua piattaforma che desidera associare alla propria presenza Facebook.
3. Ottenere il parametro della query ricevuto redirect_uri e aggiungere l'oggetto codificato extras come parametro della query.
4. Reindirizzare gli utenti all'URL risultante (solo se il redirect_uri ricevuto corrisponde alla nostra espressione regolare).

Esempio: usa l'oggetto extras per configurare un'azienda e abilitare la CTA del suo profilo Instagram e della pagina Facebook

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

Per dettagli sull'implementazione completa e il test, consulta app business.

Costruzione del webhook

Dopo che un utente ha installato, aggiornato o disinstallato la tua app tramite app business, riceverai i dettagli per quell'azione tramite webhook.

Per configurare un webhook è necessario:

1. Creare un endpoint su un server sicuro in grado di elaborare le richieste POST da Facebook.
2. Configurare il prodotto Webhooks nella dashboard gestione app della tua app per iscriverti al campo fbe_install dell'oggetto User.

Per dettagli sull'implementazione completa e la configurazione, consulta Webhook.

Attivazione degli eventi del pixel

Il pixel di Meta è parte integrante dell'estensione Meta Business, v2. Ti chiediamo di determinare in modo accurato l'attivazione degli eventi del pixel per ogni azienda integrata con MBE sulla tua piattaforma.

Eventi obbligatori

• Per tutte le pagine coinvolte nel processo di invio di ordini di cibo: attivare PageView
• Dopo l'invio dell'ordine: attivare Purchase

Eventi facoltativi

• Attivare AddToCart quando un articolo viene aggiunto all'ordine.

Tutti gli eventi standard possono essere attivati chiamando la funzione fbq('track') del pixel, con il nome dell'evento e (facoltativamente) un oggetto JSON contenente i parametri. Ad esempio, l'evento di acquisto richiede l'inclusione di valuta e valore come parametro:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Per dettagli sull'implementazione completa, consulta Attivazione degli eventi del pixel.

Pixel Helper

Consigliamo vivamente di installare la nostra estensione per Chrome Pixel Helper. Pixel Helper fornisce feedback estremamente preziosi che possono aiutarti a verificare che il pixel funzioni correttamente, soprattutto quando inizi a monitorare le conversioni, per le quali è facile riscontrare errori di formattazione.

Controllo e avvio dell'integrazione

Una volta terminata l'implementazione MBE, completa l'elenco di controllo nella tab Panoramica nel Pannello sviluppatore. Compila i moduli per i dettagli dell'app e il controllo dell'integrazione nella tab Controllo dell'integrazione. Cliccando sul pulsante Invia inizierà il processo di controllo.

Il controllo dell'integrazione è il processo in cui Meta verifica la tua integrazione dell'estensione Meta Business. Una volta approvata l'integrazione, potrai rendere l'app disponibile per gli utenti pubblici dalla tab Avvio. Scopri di più sulla procedura.

Dopo aver inviato la tua integrazione nella tab Controllo dell'integrazione nel Pannello sviluppatori, potrai visualizzare stato, aggiornamenti e feedback dei nostri addetti al controllo nella sezione della cronologia degli invii della scheda Controllo dell'integrazione.

I nostri addetti al controllo forniranno feedback dettagliati. Qualora la tua app venisse rifiutata, esegui tutti i passaggi obbligatori prima di iniziare una nuova procedura di controllo. Puoi farlo cliccando sul pulsante Invia di nuovo invio nella tab Controllo dell'integrazione.